Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Complete install packages.

Complete install packages: Difference between revisions

From MoodleDocs
(→‎See also: alternative windows instructions)
 
(30 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Complete install packages are available from [http://download.moodle.org/ Moodle Downloads], located on a tab for each of the operating systems.  The packages are designed for new installations on a server or standalone computer. Please note the standard distributions only contain the Moodle code.
Complete install packages are designed for new installations on a small server or standalone computer.  They are available from [http://download.moodle.org/ Moodle Downloads].


This document provides instructions for using the Windows packages. Separate instructions are available for [[Complete Install Packages for Mac OS X|Mac OS X packages]].
There are two types of "complete install packages": one set for [[Complete install packages for Windows|Windows]] and another for [[Complete Install Packages for Mac OS X|Mac]] operating systems.  However, there are other options to install Moodle on larger servers or with different databases.


For installation on a Windows 2000 or Windows 2003 server it is good practice to perform a manual install (see the manual installation section in [[Windows_installation|Windows Installation]]).  
There are also additional plugins and contributed modules which can be loaded after a complete install package is installed.


After installing the Windows package, note that there are other downloads (e.g. additional modules and plugins) that may involve more customization of configuration files.
*Please note the "Generic packages" only contain the Moodle code and this is included in a "complete" package.


The complete install packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. The instructions on the download page provide guidance on which version is likely to be most suitable.
==System requirements==
 
The complete install packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case).  
Note: The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site.  In short, complete install packages are designed for first time install on a "clean" machine. 


==System requirements==
   + 256 MB RAM (minimum), 512 MB RAM (recommended)
   + 256 MB RAM (minimum), 512 MB RAM (recommended)
   + 160 MB free Fixed Disk (more space will be needed depending on user uploads)
   + 160 MB free Fixed Disk (more space will be needed depending on user uploads)
  + Windows 98/ME (minimum)
  + Windows NT/2000/XP (recommended)
==Install complete package ==
===First install Apache, MySQL, PHP===
Step 1:  [http://download.moodle.org/ Download] the packed-zip file from Moodle.
Step 2: Unpack the file you downloaded to a drive or partition of your choice and let the default create C:\moodle or W:\moodle or something like this. It is a good practice at this point to rename the C:\moodle to something like C:\Web or C:\Xampplite.  There will be a folder under this called \moodle.
Step 3: Start the "setup_xampp.bat" in the top folder.  This will configure Xammplite. Note: XAMPP makes no entries in the windows registry and no settings for the system variables.
Step 4: Now you are ready to start your webserver.  Use the Xampp_start file.  Once the Xampp_start is open, don't close it, use Xampp_stop for that purpose.  Xampp program(s) control both Apache and MySQL.  Alternatively you can individually start and stop Apache and MySQL with the bat files found in the top folder such as C:\xampplite .
Step 5: Start your browser and type <nowiki> http://127.0.0.1 or http://localhost </nowiki>in the address bar. You will either start your first time Moodle installation or if it is already install enter your homepage.
===Start the Moodle installation===
*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle, in the above example it would be http://localhost</nowiki>.
*The initial install page is displayed.
[[image:Xampp24.gif|thumb|center|600px]]
*Choose your preferred language (English is used in this example) and click the “Next” button.
*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.
[[image:Xampp25.gif|thumb|center|600px]]


*Click the “Next” button to continue.
Note: The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site.  In short, complete install packages are designed for first time install on a "clean" machine.


*The paths for your Moodle installation are shown – accept the ones that are shown on your screen.
==Windows install packages ==


[[image:Xampp26.gif|thumb|center|400px]]
The''' [[Complete install packages for Windows]]''' page has the best instructions for the Windows packages. The 2008 download packages uses XAMPP to provide the Apache, MySQL and PHP in a format that crosses  most stand-alone Windows platforms, and of course Moodle. The Xampp installer should not be considered suitable for anything more than single user or very small LAN use. 


*For installation on any '''Windows server''', for a larger installation, it is good practice to perform a manual install (see the manual installation section in [[Windows_installation|Windows Installation]]) of a Standard Moodle package.


*Click the “Next” button to continue.
==Mac install packages ==
 
The '''[[Complete Install Packages for Mac OS X]]''' page has the best instructions for the Mac OS packages.  The 2008 download packages uses MAMP to provide the Apache, MySQL and PHP files along with Moodle.
*What you enter in the "Host Server" field depends on what you intend to use the new Moodle installation for.
If you are just going to use it for local testing, then use 'localhost'.
If you are going to test the new installation on a LAN, and will be accessing it from other machines on that LAN, then put the private IP address or network name of the serving machine, followed by a forward slash and moodle: Host Server - 192.168.1.1/moodle
If you are going to test the installation on the internet, then you will need to put the public ip address followed by a forward slash and moodle: your_ip_address/moodle or you can put your domain name here instead.
 
*In the next fields, we enter the database settings. The fields are populated with some suggested values.
 
*We strongly recommend you place a user name and password in this screen. (Don't forget them).
 
*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY
[[image:Xampp27.gif|thumb|center|600px]]
 
 
*When the fields have been populated, click the “Next” button to continue.
 
*Provided the Moodle folder is writable, a message confirming the configuration has been completed will be displayed.
 
[[image:Xampp29.gif|thumb|center|400px]]
 
*Click the “ Continue” button to proceed.
 
The Moodle copyright / licence notices are displayed.
 
[[image:Xampp30.gif|thumb|center|400px]]
 
 
*Click the “Yes” button to continue.  In most cases this will be followed by a series of screens that have a continue button on the bottom.  In Moodle 1.8 look for the "Unattended" checkoff box.  This will press the continue button at the bottom of the screen for you. This process stops with Admin user profile settings which needs to be filled out, then goes to the site setting page.
 
===Congratulations===
This finishes the installation of a complete package.  Type http://localhost in your browser and Moodle will open.
 
Your next task will be to configure Moodle.  See [[Administrator_documentation#Configuration]] or [[Administrator_documentation]]Don't worry, it is easy to change any of the settings once Moodle is running.
 
== Installing Apache and MySQL as services==
(This is only for NT4 | Windows 2000 | Windows XP operating systems)
 
\xampplite\apache\apache_installservice.bat =
==> Install Apache 2 as service 
 
\xampplite\apache\apache_uninstallservice.bat =
==> Uninstall Apache 2 as service 
 
\xampplite\mysql\mysql_installservice.bat =
==> Install MySQL as service 
 
\xampplite\mysql\mysql_uninstallservice.bat =
==> Uninstall MySQL as service 
 
==> After all Service (un)installations, please restart your system!
 
== Security matters (A MUST READ!)==
 
As mentioned before, XAMPP is not meant for production use but only for developers
in a development environment. The way XAMPP is configured is to be open as possible
and allowing the developer anything he/she wants. For development environments this
is great but in a production environment it could be fatal. Here a list of missing security
in XAMPP:
 
The MySQL administrator (root) has no password.
The MySQL daemon is accessible via network.
phpMyAdmin is accessible via network.
Examples are accessible via network.
 
To fix most of the security weaknesses simply call the following URL:
 
http://localhost/security/
 
The root password for MySQL + phpMyAdmin and also a XAMPP directory protection can be established here.
 
==Apache Notes==
 
You should use the apache_start and apache_stop bat files to start and stop apache from running.
 
==MySQL notes==
 
(1) The MySQL server can be started by double-clicking (executing)
    mysql_start.bat. This file can be found in the same folder you installed
    xampp in, most likely this will be C:\xampplite\.
    The exact path to this file is X:\xampplite\mysql_start.bat, where
    "X" indicates the letter of the drive you unpacked xampp into.
    This batch file starts the MySQL server in console mode. The first
    intialization might take a few minutes.
   
    Do not close the DOS window or you'll crash the server!
    To stop the server, please use mysql_shutdown.bat, which is located in the same
    directory.
 
(2) To use the MySQL Daemon with "innodb" for better performance,
    please edit the "my" (or "my.cnf") file in the /xampplite/mysql/bin
    directory or for services the c:\my.cnf for windows NT/2000/XP.
    In there, activate the "innodb_data_file_path=ibdata1:30M"
    statement. Attention, "innodb" is not recommended for 95/98/ME.
   
    To use MySQL as Service for NT/2000/XP, simply copy the "my"
    / "my.cnf" file to C:\my, or C:\my.cnf. Please note that this
    file has to be placed in C:\ (root), other locations are not permitted. Then
    execute the "mysql_installservice.bat" in the mysql folder.
   
 
(3) MySQL starts with standard values for the user id and the password. The preset
    user id is "root", the password is "" (= no password). To access MySQL via PHP
    with the preset values, you'll have to use the following syntax:
    mysql_connect("localhost","root","");
    If you want to set a password for MySQL access, please use of mysqladmin.
    To set the passwort "secret" for the user "root", type the following:
    \xampplite\mysql\bin\mysqladmin -u root password secret
   
    After changing the password you'll have to reconfigure phpMyAdmin to use the
    new password, otherwise it won't be able to access the databases. To do that,
    open the file config.inc.php in \xampplite\phpmyadmin\ and edit the
    following lines:   
   
    $cfg['Servers'][$i]['user']            = 'root';  // MySQL user
    $cfg['Servers'][$i]['auth_type']      = 'http';  // HTTP authentificate
 
    So first the 'root' password is queried by the MySQL server, before phpMyAdmin
    may access.
     
 


Have a lot of fun! Viel Spaß! Bonne Chance!
Have a lot of fun! Viel Spaß! Bonne Chance!
Line 178: Line 28:
==See also==
==See also==
*[[Administrator_documentation]] for links that help configure Moodle.
*[[Administrator_documentation]] for links that help configure Moodle.
*[[Installation guide - Moodle for Windows on a USB Memory Stick]]
*'''Mac installation'''
*Return to [[Windows installation]]
**[[Complete Install Packages for Mac OS X]]
*[[Windows 1 computer many servers |Multiple web servers, on 1 computer]] similar to windows installation page, with some tips
*'''[[Windows installation]]'''
*[https://docs.moodle.org/en/Windows_installation_using_XAMPP#Troubleshooting Troubleshooting]if you are running Skype.  
**[[Complete install packages for Windows]]
*[[Installing_AMP]] lots of XAMPP stuff.  XAMPP stands for XP, Apache, MySQL,PHP and Perl. XAMPPlite does not include Perl. MAMP stands for Mac, Apache, MySQL and PHP. 
**[[Installation guide - Moodle for Windows on a USB Memory Stick]]
*[[Complete Install Packages for Mac OS X]]
**[[Windows 1 computer many servers |Multiple web servers, on 1 computer]] similar to windows installation page, with some tips
 
**[[Windows_installation_using_XAMPP#Troubleshooting|Troubleshooting]] if you are running Skype.  
**[[Bitnami_Moodle_Stack|BitNami Stack]] Alternate Windows Packages
*[[Installing_AMP]]: AMP stands for Apache, MySQL, PHP. This page has information on other ways to install.


[[es:Paquetes_para_Instalaci%C3%B3n_Completa]]
[[es:Paquetes_para_Instalaci%C3%B3n_Completa]]
[[pl:Kompletne pakiety instalacyjne]]
[[ja:コンプリート・インストールパッケージ]]


[[Category:Administrator]]
[[Category:Administrator]]
[[Category:Installation]]
[[Category:Installation]]

Latest revision as of 14:13, 3 September 2010

Complete install packages are designed for new installations on a small server or standalone computer. They are available from Moodle Downloads.

There are two types of "complete install packages": one set for Windows and another for Mac operating systems. However, there are other options to install Moodle on larger servers or with different databases.

There are also additional plugins and contributed modules which can be loaded after a complete install package is installed.

  • Please note the "Generic packages" only contain the Moodle code and this is included in a "complete" package.

System requirements

The complete install packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case).

 + 256 MB RAM (minimum), 512 MB RAM (recommended)
 + 160 MB free Fixed Disk (more space will be needed depending on user uploads)

Note: The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

Windows install packages

The Complete install packages for Windows page has the best instructions for the Windows packages. The 2008 download packages uses XAMPP to provide the Apache, MySQL and PHP in a format that crosses most stand-alone Windows platforms, and of course Moodle. The Xampp installer should not be considered suitable for anything more than single user or very small LAN use.

  • For installation on any Windows server, for a larger installation, it is good practice to perform a manual install (see the manual installation section in Windows Installation) of a Standard Moodle package.

Mac install packages

The Complete Install Packages for Mac OS X page has the best instructions for the Mac OS packages. The 2008 download packages uses MAMP to provide the Apache, MySQL and PHP files along with Moodle.

Have a lot of fun! Viel Spaß! Bonne Chance!

See also