Note: You are currently viewing documentation for Moodle 2.5. Up-to-date documentation for the latest stable version of Moodle may be available here: Windows installation.

Windows installation: Difference between revisions

From MoodleDocs
No edit summary
Line 14: Line 14:
The following is a step by step guide to installing Moodle on a computer running Windows XP using the XAMPP package.
The following is a step by step guide to installing Moodle on a computer running Windows XP using the XAMPP package.


==Preparation==
===Preparation===


===Get Moodle!===
====Get Moodle!====


Download the version of Moodle you wish to install from Moodle.org
Download the version of Moodle you wish to install from Moodle.org
Line 22: Line 22:
[[Image: 14a.gif]].
[[Image: 14a.gif]].


===Get XAMPP!===
====Get XAMPP!====


Download XAMPP for Windows from www.apachefriends.org. This example assumes that you have downloaded the “installer” package.
Download XAMPP for Windows from www.apachefriends.org. This example assumes that you have downloaded the “Installer” package.


[[image:Xampp1.png]]


 
====Allow yourself some time====
===Allow yourself some time===
Say 45 minutes.
Say 45 minutes.


Image 1
====OK, Let's get going...====


Run the installer, eventually you will be presented with an option about where to install the package.
Run the installer, eventually you will be presented with an option about where to install the package.


Image 2
[[image:Xampp2.gif]]


In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location.
In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location.
Line 41: Line 41:
Continue with the installation, this will take a while!
Continue with the installation, this will take a while!


Image 3
[[image:Xampp3.gif]]


Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.
Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.


Image 4
[[image:Xampp4.gif]]


It’s probably best to choose “No” for now. You can always enable these as services later.
It’s probably best to choose “No” for now. You can always enable these as services later.
Line 51: Line 51:
Next you’ll be asked if you want to start the XAMPP Control Panel.
Next you’ll be asked if you want to start the XAMPP Control Panel.


Image 5
[[image:Xampp5.gif]]


Click the “No” button.
Click the “No” button.


==Change PHP version==
===Change PHP version===


It’s a good idea to use PHP version 4.x so before installing Moodle. Roll back to an earlier version of PHP as follows:
It’s a good idea to use PHP version 4.x before installing Moodle. Roll back to an earlier version of PHP as follows:


From the “Start” menu located the program group for apachefriend > xampp
From the “Start” menu locate the program group for apachefriends > xampp


Image 20
[[image:Xampp20.gif]]


Select “php switch”
Select “php switch”


Image 21
[[image:Xampp21.gif]]


Follow the instructions in the window.
Follow the instructions in the window.


Image 22
[[image:Xampp22.gif]]
 
===Launch XAMPP Control Panel ===
 
On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.


==Launch XAMPP Control Panel ==
When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.


On your Desktop, locate the XAMPP icon and double click to launch the Control panel.
[[image:Xampp6.gif]]


When the XAMPP control panel has launched, click the “Start” buttons for Apache and MySQL. If all is well you will see something like this:
If all is well you will see something like this.


Image 6
[[image:Xampp31.gif]]


==Create the database==
===Create the database===


To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.
To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.
Line 85: Line 89:
To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.
To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.


Image 8
[[image:Xampp8.gif]]


The XAMPP default page is displayed, click the link for your preferred language – we will be using English.
The XAMPP default page is displayed, click the link for your preferred language – we will be using English.


Image 9
[[image:Xampp9.gif]]


From the menu on the left, click on “phpMyAdmin”
From the menu on the left, click on “phpMyAdmin”


Image 10
[[image:Xampp10.gif]]


When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.
When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.


Image 11
[[image:Xampp11.gif]]


Click the “Create” button to create the database.
Click the “Create” button to create the database.


Image 12
[[image:Xampp12.gif]]


The new database should be present in the dropdown list when the page has refreshed.
The new database should be present in the dropdown list when the page has refreshed.


Image 13
[[image:Xampp13.gif]]


==Move the downloaded Moodle files to the correct location.==
===Move the downloaded Moodle files to the correct location.===


Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.
Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.
Line 113: Line 117:
Open the XAMPP Control Panel and click on the “Explore” button.
Open the XAMPP Control Panel and click on the “Explore” button.


Image 15
[[image:Xampp15.gif]]


A Windows Explorer view similar to the one below will be displayed.
A Windows Explorer view similar to the one below will be displayed.


Image 16
[[image:Xampp16.gif]]


Open the “htdocs” folder.
Open the “htdocs” folder.


Image 17
[[image:Xampp17.gif]]


Image 18
[[image:Xampp18.gif]]


Paste the file cut/copied earlier into this folder.
Paste the file cut/copied earlier into this folder.
Line 129: Line 133:
Extract the Moodle files from the file downloaded (in this example WinZip is installed on the computer). A default folder named “moodle” is created with the Moodle files within.
Extract the Moodle files from the file downloaded (in this example WinZip is installed on the computer). A default folder named “moodle” is created with the Moodle files within.


Image 19
[[image:Xampp19.gif]]


==Start the installation==
===Start the installation===


In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s http://localhost/Moodle.
In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s http://localhost/Moodle.


Image 23
[[image:Xampp23.gif]]


The initial install page is displayed.
The initial install page is displayed.


Image 24
[[image:Xampp24.gif]]


Choose your preferred language (English is used in this example and click the “Next” button.
Choose your preferred language (English is used in this example and click the “Next” button.
Line 145: Line 149:
A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.
A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.


Image 25
[[image:Xampp25.gif]]


Click the “Next” button to continue.
Click the “Next” button to continue.
Line 151: Line 155:
The paths for your Moodle installation are shown – accept these or amend as desired.
The paths for your Moodle installation are shown – accept these or amend as desired.


Image 26
[[image:Xampp26.gif]]


Click the “Next” button to continue.
Click the “Next” button to continue.
Line 157: Line 161:
In this screen we enter the database settings. The fields are populated with some suggested values.
In this screen we enter the database settings. The fields are populated with some suggested values.


Image 27
 
[[image:Xampp27.gif]]


In this example the database created is “moodle153”. The “root” user will be used without a password.
In this example the database created is “moodle153”. The “root” user will be used without a password.
Line 163: Line 168:
DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS IS VULNERABLE FROM A SECURITY POINT OF VIEW.
DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS IS VULNERABLE FROM A SECURITY POINT OF VIEW.


Image 28
[[image:Xampp28.gif]]


When the fields have been populated, click the “Next” button to continue.
When the fields have been populated, click the “Next” button to continue.
Line 169: Line 174:
Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.
Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.


Image 29
[[image:Xampp29.gif]]


Click the “ Continue” button to proceed.
Click the “ Continue” button to proceed.
Line 175: Line 180:
The Moodle copyright / licence notices are displayed.
The Moodle copyright / licence notices are displayed.


Image 30
[[image:Xampp30.gif]]


Click the “Yes” button to continue, then follow the instructions on the following screens.
Click the “Yes” button to continue, then follow the instructions on the following screens.

Revision as of 02:22, 5 February 2006

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 your "main" Moodle site.

Installation guide for Windows using XAMPP

XAMPP is a package which installs PHP, Apache and MySql (amongst other things) and will enable you to run Moodle on a Windows PC, Laptop or Server.

The following is a step by step guide to installing Moodle on a computer running Windows XP using the XAMPP package.

Preparation

Get Moodle!

Download the version of Moodle you wish to install from Moodle.org

File:14a.gif.

Get XAMPP!

Download XAMPP for Windows from www.apachefriends.org. This example assumes that you have downloaded the “Installer” package.

Xampp1.png

Allow yourself some time

Say 45 minutes.

OK, Let's get going...

Run the installer, eventually you will be presented with an option about where to install the package.

Xampp2.gif

In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location.

Continue with the installation, this will take a while!

Xampp3.gif

Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

Xampp4.gif

It’s probably best to choose “No” for now. You can always enable these as services later.

Next you’ll be asked if you want to start the XAMPP Control Panel.

Xampp5.gif

Click the “No” button.

Change PHP version

It’s a good idea to use PHP version 4.x before installing Moodle. Roll back to an earlier version of PHP as follows:

From the “Start” menu locate the program group for apachefriends > xampp

File:Xampp20.gif

Select “php switch”

File:Xampp21.gif

Follow the instructions in the window.

File:Xampp22.gif

Launch XAMPP Control Panel

On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

Xampp6.gif

If all is well you will see something like this.

Xampp31.gif

Create the database

To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

Xampp8.gif

The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

Xampp9.gif

From the menu on the left, click on “phpMyAdmin”

Xampp10.gif

When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

Xampp11.gif

Click the “Create” button to create the database.

Xampp12.gif

The new database should be present in the dropdown list when the page has refreshed.

Xampp13.gif

Move the downloaded Moodle files to the correct location.

Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

Open the XAMPP Control Panel and click on the “Explore” button.

Xampp15.gif

A Windows Explorer view similar to the one below will be displayed.

Xampp16.gif

Open the “htdocs” folder.

Xampp17.gif

Xampp18.gif

Paste the file cut/copied earlier into this folder.

Extract the Moodle files from the file downloaded (in this example WinZip is installed on the computer). A default folder named “moodle” is created with the Moodle files within.

Xampp19.gif

Start the installation

In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s http://localhost/Moodle.

Xampp23.gif

The initial install page is displayed.

Xampp24.gif

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.

Xampp25.gif

Click the “Next” button to continue.

The paths for your Moodle installation are shown – accept these or amend as desired.

Xampp26.gif

Click the “Next” button to continue.

In this screen we enter the database settings. The fields are populated with some suggested values.


Xampp27.gif

In this example the database created is “moodle153”. The “root” user will be used without a password.

DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS IS VULNERABLE FROM A SECURITY POINT OF VIEW.

Xampp28.gif

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.

Xampp29.gif

Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

Xampp30.gif

Click the “Yes” button to continue, then follow the instructions on the following screens.

Installation guide for Windows using EasyPHP

Moodle requires that Apache, PHP and MySQL 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