Note: You are currently viewing documentation for Moodle 3.6. Up-to-date documentation for the latest stable version of Moodle is likely available here: Windows installation.

Windows installation: Difference between revisions

From MoodleDocs
(category)
(Installation for Windows 2003 with IIS)
Line 1: Line 1:
== Complete install packages ==
== Complete install packages ==


From November 2005 complete install packages are available from [http://download.moodle.org/ Moodle Downloads].
From November 2005, complete install packages are available from [http://download.moodle.org/ Moodle Downloads].


These packages allow Moodle to be installed, along with the prerequisites i.e. PHP, a web server and database (Apache and MySQL in this case) on most recent  computers using a Windows operating system.  Using one of these packages is likely to be easier than using the EasyPHP method detailed below.
These packages allow Moodle to be installed, along with the prerequisites i.e. PHP, a web server and database (Apache and MySQL in this case) on most recent  computers using a Windows operating system.  Using one of these packages is likely to be easier than using the EasyPHP method detailed below.
Line 9: Line 9:
Note: The latest versions included in these packages my not be backwardly compatible with earlier versions of Moodle. Always check version compatibility if you intend to develop materials on a later version of Moodle than the version installed on you "main" Moodle site.
Note: The latest versions included in these packages my not be backwardly compatible with earlier versions of Moodle. Always check version compatibility if you intend to develop materials on a later version of Moodle than the version installed on you "main" Moodle site.


== Installation guide for Windows - using EasyPHP ==
== Installation guide for Windows using EasyPHP ==


Moodle requires Apache, PHP and MySQL to be installed to run on Windows. This may be achieved by using EasyPHP, a package that bundles all the software you need into a single Windows application. Please note however, that EasyPHP is not designed to be used for a production server. Here are the steps from start to finish:
Moodle requires Apache, PHP and MySQL to be installed to run on Windows. This may be achieved by using EasyPHP, a package that bundles all the software you need into a single Windows application. Please note however, that EasyPHP is not designed to be used for a production server. Here are the steps from start to finish:


# Firstly, if you have ever installed MySQL before (even as part of another package), uninstall it all, delete all the MySQL files and make sure you delete '''c:\my.cnf''' and '''c:\windows\my.ini'''. You might want to do a search and delete ANY file called '''my.cnf''' or '''my.ini'''.
# Firstly, if you have ever installed MySQL before (even as part of another package), uninstall it all, delete all the MySQL files and make sure you delete ''c:\my.cnf'' and ''c:\windows\my.ini''. You might want to do a search and delete ANY file called ''my.cnf'' or ''my.ini''.
# If you've ever installed PHP before delete any files called php4ts.dll from around your Windows directory, as well as any files called php.ini.
# If you've ever installed PHP before delete any files called php4ts.dll from around your Windows directory, as well as any files called php.ini.
# Download EasyPHP from here: http://www.easyphp.org/telechargements/dn.php?F=easyphp1-7 (approx 10 Mb)
# Download EasyPHP from here: http://www.easyphp.org/telechargements/dn.php?F=easyphp1-7 (approx 10 Mb)
# Run the downloaded file: '''easyphp1-7_setup.exe'''. The installation process is in French but is otherwise much like installing any other Windows program - I advise accepting the defaults and letting it all install. Note that "Suivant" means Next and "Oui" means Yes.
# Run the downloaded file: ''easyphp1-7_setup.exe''. The installation process is in French but is otherwise much like installing any other Windows program - I advise accepting the defaults and letting it all install. Note that "Suivant" means Next and "Oui" means Yes.
# At the end of the install leave the checkbox selected to "Lancer EasyPHP" (Start EasyPHP) and hit the "Terminer" button. You might be taken to a information web page which you can safely ignore.
# At the end of the install leave the checkbox selected to "Lancer EasyPHP" (Start EasyPHP) and hit the "Terminer" button. You might be taken to a information web page which you can safely ignore.
# If all went well - congratulations! Apache, PHP and MySQL are all installed and running! You should see a black E in your toolbar tray. You can right click on it to get a menu which will let you control the running programs, but you won't be needing that for now.
# If all went well - congratulations! Apache, PHP and MySQL are all installed and running! You should see a black E in your toolbar tray. You can right click on it to get a menu which will let you control the running programs, but you won't be needing that for now.
#Some things may be in French and you may prefer English. You can download this file http://www.easyphp.org/telechargements/dn.php?F=indexUS_1.7 which contains English versions of www and home folder in the EasyPHP1-7 folder. These can be copied over the default files.
#Some things may be in French and you may prefer English. You can download this file http://www.easyphp.org/telechargements/dn.php?F=indexUS_1.7 which contains English versions of www and home folder in the EasyPHP1-7 folder. These can be copied over the default files.
#  The next thing you need to do is to set up a database for Moodle to use. Right-click the black E in the toolbar tray and choose Administration, then click DB Management (beside PHPMyAdmin). Alternatively, using a browser, go to http://localhost/mysql/ (note the final slash).
#  The next thing you need to do is to set up a database for Moodle to use. Right-click the black E in the toolbar tray and choose Administration, then click DB Management (beside PHPMyAdmin). Alternatively, using a browser, go to http://localhost/mysql/ (note the final slash).
# If asked for a username, use "'''root'''" with a '''blank password'''. You should see a phpMyAdmin web interface that allows you to create a new databases and user accounts.
# If asked for a username, use "''root''" with a ''blank password''. You should see a phpMyAdmin web interface that allows you to create a new databases and user accounts.
# Create a new database by typing "moodle" into the field and hitting the "Create" button. That was easy!
# Create a new database by typing "moodle" into the field and hitting the "Create" button. That was easy!
# You can also create a new user to access your database if you want. This can be a bit tricky for a first-time user, so you might just want to use the existing user "root" with no password in your Moodle config for now, and fix this later.
# You can also create a new user to access your database if you want. This can be a bit tricky for a first-time user, so you might just want to use the existing user "root" with no password in your Moodle config for now, and fix this later.
# You're ready to install Moodle! Download the latest release of Moodle from http://moodle.org/download, then unzip the archive.
# You're ready to install Moodle! Download the latest release of Moodle from http://moodle.org/download, then unzip the archive.
# Copy your moodle files into '''C:\Program Files\EasyPHP\www'''. You can either copy the entire moodle directory (ie '''C:\Program Files\EasyPHP\www\moodle''') or copy all the ''contents'' of the moodle directory. If you choose this second option then you will be able to access your Moodle home page using '''<nowiki>http://localhost/</nowiki>''' instead of '''<nowiki>http://localhost/moodle/</nowiki>'''.
# Copy your moodle files into ''C:\Program Files\EasyPHP\www''. You can either copy the entire moodle directory (ie ''C:\Program Files\EasyPHP\www\moodle'') or copy all the ''contents'' of the moodle directory. If you choose this second option then you will be able to access your Moodle home page using ''<nowiki>http://localhost/</nowiki>'' instead of ''<nowiki>http://localhost/moodle/</nowiki>''.
# Make a new empty folder somewhere else for Moodle to store uploaded files in, eg: '''C:\moodledata'''
# Make a new empty folder somewhere else for Moodle to store uploaded files in, eg: ''C:\moodledata''
# Go into your Moodle folder. Make a copy of '''config-dist.php''', and call it '''config.php'''
# Go into your Moodle folder. Make a copy of ''config-dist.php'', and call it ''config.php''
# Edit '''config.php''' using a text editor (Notepad will do, just be careful that it doesn't add unwanted spaces at the end).
# Edit ''config.php'' using a text editor (Notepad will do, just be careful that it doesn't add unwanted spaces at the end).
# Put in all your new database info:
# Put in all your new database info:
#* $CFG->dbtype = 'mysql';
# $CFG->dbtype = 'mysql';
#* $CFG->dbhost = 'localhost';
#* $CFG->dbhost = 'localhost';
#* $CFG->dbname = 'moodle';
#* $CFG->dbname = 'moodle';
Line 42: Line 42:
#* $CFG->dataroot = 'C:\moodledata';
#* $CFG->dataroot = 'C:\moodledata';
#Save config.php - you can ignore the other settings if there are any.
#Save config.php - you can ignore the other settings if there are any.
# You're nearly there now! The rest of the setup is all web-based. Visit '''<nowiki>http://localhost/moodle/admin/</nowiki>''' with your browser to continue the setup via your browser.
# You're nearly there now! The rest of the setup is all web-based. Visit ''<nowiki>http://localhost/moodle/admin/</nowiki>'' with your browser to continue the setup via your browser.
# To use zip files with Moodle (for example the backups use zip) you might need to enable "zlib". You can do this by going to your EasyPHP directory (C:\Program Files\EasyPHP), and running the program phpini.exe in there. Put a mark in the checkbox next to "zlib.dll". Close that window, then go to the black E in your toolbar and right-click it to get a menu - select "Restart" from this menu.
# To use zip files with Moodle (for example the backups use zip) you might need to enable "zlib". You can do this by going to your EasyPHP directory (C:\Program Files\EasyPHP), and running the program phpini.exe in there. Put a mark in the checkbox next to "zlib.dll". Close that window, then go to the black E in your toolbar and right-click it to get a menu - select "Restart" from this menu.
# Lastly, you need to set up some sort of cron. See the [[Installing Moodle#Set up cron|Installation guide]] for more details on this.
# Lastly, you need to set up some sort of cron. See the [[Installing Moodle#Set up cron|Installation guide]] for more details on this.
Line 49: Line 49:
*  Make sure you enable the GD module so Moodle can process images - you may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd2.dll'.
*  Make sure you enable the GD module so Moodle can process images - you may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd2.dll'.
* Make sure you enable the Zlib module so that you can create and unpack zip files from within Moodle.
* Make sure you enable the Zlib module so that you can create and unpack zip files from within Moodle.
* Make sure sessions is turned on - you may have to edit php.ini and fix the directory for '''session.save_path''' - instead of the default "/tmp" use a Windows directory like "c:/temp".
* Make sure sessions is turned on - you may have to edit php.ini and fix the directory for ''session.save_path'' - instead of the default "/tmp" use a Windows directory like "c:/temp".
 
== Installation for Windows 2003 with IIS ==
 
Firstly install PHP and check it's working.
 
'''External links'''
*[http://www.peterguy.com/php/install_IIS6.html How to install PHP 5.x on Windows Server 2003 with IIS 6]


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

Revision as of 23:41, 20 December 2005

Complete install packages

From November 2005, complete install packages are available from Moodle Downloads.

These packages allow Moodle to be installed, along with the prerequisites i.e. PHP, a web server and database (Apache and MySQL in this case) on most recent computers using a Windows operating system. Using one of these packages is likely to be easier than using the EasyPHP method detailed below.

Versions are available which incorporate a recent STABLE build or a recent UNSTABLE development build. The instructions on the download page provide guidance on which version is likely to be most suitable.

Note: The latest versions included in these packages my not be backwardly compatible with earlier versions of Moodle. Always check version compatibility if you intend to develop materials on a later version of Moodle than the version installed on you "main" Moodle site.

Installation guide for Windows using EasyPHP

Moodle requires Apache, PHP and MySQL to be installed to run on Windows. This may be achieved by using EasyPHP, a package that bundles all the software you need into a single Windows application. Please note however, that EasyPHP is not designed to be used for a production server. Here are the steps from start to finish:

  1. Firstly, if you have ever installed MySQL before (even as part of another package), uninstall it all, delete all the MySQL files and make sure you delete c:\my.cnf and c:\windows\my.ini. You might want to do a search and delete ANY file called my.cnf or my.ini.
  2. If you've ever installed PHP before delete any files called php4ts.dll from around your Windows directory, as well as any files called php.ini.
  3. Download EasyPHP from here: http://www.easyphp.org/telechargements/dn.php?F=easyphp1-7 (approx 10 Mb)
  4. Run the downloaded file: easyphp1-7_setup.exe. The installation process is in French but is otherwise much like installing any other Windows program - I advise accepting the defaults and letting it all install. Note that "Suivant" means Next and "Oui" means Yes.
  5. At the end of the install leave the checkbox selected to "Lancer EasyPHP" (Start EasyPHP) and hit the "Terminer" button. You might be taken to a information web page which you can safely ignore.
  6. If all went well - congratulations! Apache, PHP and MySQL are all installed and running! You should see a black E in your toolbar tray. You can right click on it to get a menu which will let you control the running programs, but you won't be needing that for now.
  7. Some things may be in French and you may prefer English. You can download this file http://www.easyphp.org/telechargements/dn.php?F=indexUS_1.7 which contains English versions of www and home folder in the EasyPHP1-7 folder. These can be copied over the default files.
  8. The next thing you need to do is to set up a database for Moodle to use. Right-click the black E in the toolbar tray and choose Administration, then click DB Management (beside PHPMyAdmin). Alternatively, using a browser, go to http://localhost/mysql/ (note the final slash).
  9. If asked for a username, use "root" with a blank password. You should see a phpMyAdmin web interface that allows you to create a new databases and user accounts.
  10. Create a new database by typing "moodle" into the field and hitting the "Create" button. That was easy!
  11. You can also create a new user to access your database if you want. This can be a bit tricky for a first-time user, so you might just want to use the existing user "root" with no password in your Moodle config for now, and fix this later.
  12. You're ready to install Moodle! Download the latest release of Moodle from http://moodle.org/download, then unzip the archive.
  13. Copy your moodle files into C:\Program Files\EasyPHP\www. You can either copy the entire moodle directory (ie C:\Program Files\EasyPHP\www\moodle) or copy all the contents of the moodle directory. If you choose this second option then you will be able to access your Moodle home page using http://localhost/ instead of http://localhost/moodle/.
  14. Make a new empty folder somewhere else for Moodle to store uploaded files in, eg: C:\moodledata
  15. Go into your Moodle folder. Make a copy of config-dist.php, and call it config.php
  16. Edit config.php using a text editor (Notepad will do, just be careful that it doesn't add unwanted spaces at the end).
  17. Put in all your new database info:
  18. $CFG->dbtype = 'mysql';
    • $CFG->dbhost = 'localhost';
    • $CFG->dbname = 'moodle';
    • $CFG->dbuser = 'root';
    • $CFG->dbpass = '';
    • $CFG->dbpersist = true;
    • $CFG->prefix = 'mdl_';
  19. And put in all your file paths
    • $CFG->wwwroot = 'http://localhost/moodle'; // Use an external address if you know it.
    • $CFG->dirroot = 'C:\Program Files\EasyPHP\www\moodle';
    • $CFG->dataroot = 'C:\moodledata';
  20. Save config.php - you can ignore the other settings if there are any.
  21. You're nearly there now! The rest of the setup is all web-based. Visit http://localhost/moodle/admin/ with your browser to continue the setup via your browser.
  22. To use zip files with Moodle (for example the backups use zip) you might need to enable "zlib". You can do this by going to your EasyPHP directory (C:\Program Files\EasyPHP), and running the program phpini.exe in there. Put a mark in the checkbox next to "zlib.dll". Close that window, then go to the black E in your toolbar and right-click it to get a menu - select "Restart" from this menu.
  23. Lastly, you need to set up some sort of cron. See the Installation guide for more details on this.

If you don't or can't use EasyPHP, here are a few tips to make sure your PHP is set up correctly and avoid common problems:

  • Make sure you enable the GD module so Moodle can process images - you may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd2.dll'.
  • Make sure you enable the Zlib module so that you can create and unpack zip files from within Moodle.
  • Make sure sessions is turned on - you may have to edit php.ini and fix the directory for session.save_path - instead of the default "/tmp" use a Windows directory like "c:/temp".

Installation for Windows 2003 with IIS

Firstly install PHP and check it's working.

External links