Difference between revisions of "Installing AMP"

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.2. Up-to-date documentation for the latest stable version is available here: Installing AMP.

m (Windows)
(First a word about PostgreSQL)
 
(40 intermediate revisions by 15 users not shown)
Line 1: Line 1:
AMP or AMPPlite stands for '''A'''pache, '''M'''ySQL & '''P'''HP. Moodle is written in a scripting language called [[PHP]] and stores most of its data in a database. The recommended database is [[MySQL]]. Before installing Moodle you must have a working PHP installation and a working database to turn your computer into a functional web server platform. XAMP is a Windows and MAMP is a Mac OS version.
+
{{Installing Moodle}}
Moodle does have [[Complete install packages]] in the [http://download.moodle.org/ download section] as well as the Moodle only package.
+
AMP, stands for '''A'''pache, '''M'''ySQL & '''P'''HP. This is not the only platform on which Moodle runs but is the most common and fine for basic installations.  
  
The AMP individual applications can be tricky to set up for average computer users. This page has been written to try to make this process as simple as possible for different platforms.    
+
'' 'All-in-one' Moodle installers for Windows and OSX are available at http://httpd.apache.org/docs/2.0/install.html (not intended for 'production' sites). ''
  
 +
== First a word about PostgreSQL ==
  
== Hosting Service ==
+
If you would prefer to use the PostgreSQL database (and you should consider it) you can - when using the package type installers - just install it instead of MySQL. MySQL tends to be the universal choice with the simpler 'one-click' installers. For a 'one-click' installer with PostgreSQL, Apache and PHP you can check [http://bitnami.org BitNami], it supports Windows ([http://bitnami.org/stack/wappstack WAPP]), Linux ([http://bitnami.org/stack/lappstack LAPP]) and Mac ([http://bitnami.org/stack/mappstack MAPP]).
 
 
Unfortunately hosting services vary quite a lot in the way they work. Some will even install Moodle for you.
 
 
 
Most will offer a web-based control panel to control your site, create databases and set up cron. Some may also offer terminal access via ssh, so that you can use the command shell to do things.
 
 
 
You should work your way through the [[Installing Moodle|Installation guide]] and take each step at a time. Ask your hosting provider if you get stuck.
 
 
 
  
 
== Mac OS X ==
 
== Mac OS X ==
  
The easiest way to do this is use the [[Apache]] server that Apple provides, and add PHP and MySQL using Marc Liyanage's packages. Both of the pages below come with good instructions that we won't duplicate here:
+
OSX comes with a suitable [[Apache]] web server and a not so suitable PHP (it doesn't have all the required extensions).  
  
* '''PHP''': Download from here: http://www.entropy.ch/software/macosx/php/
+
Here are some other possibilities (all are documented so this is not repeated here):
* '''MySQL''': Download here: http://www.entropy.ch/software/macosx/mysql/
+
* Liip 'one click' installer from http://php-osx.liip.ch/. Note that it is primarily biased towards developers.
 +
* [http://www.mamp.info/ MAMP]: One click installer - easy to use and well documented. Probably only suitable for personal use.
 +
* [http://www.ampps.com/   Softaculous AMPPS]: Another one click installer - for both Windows and OSX this time.
 +
* [http://www.macports.org/ MacPorts]: A complete Linux-style package repository. You will find the AMP components here. See [https://trac.macports.org/wiki/howto/MAMP Getting Apache, MySQL, and PHP Running under MacPorts]
 +
* [http://www.finkproject.org/ Fink]: an alternative to MacPorts.
 +
* [http://bitnami.org/stack/mampstack BitNami MAMPStack]: On 'one-click' installer with for MySQL, Apache and PHP which supports the BitNami applications modules to installed on top of it like the [http://bitnami.org/stack/moodle#nativeInstaller BitNami Moodle module].
  
Once these are installed the standard [[Installing Moodle|Installation guide]] should be fairly straightforward.
+
== Linux ==
 +
You should install the packages from your distribution's repository for [[Apache]], [[PHP]] and MySQL. You will almost certainly need additional extensions for [[PHP]] (e.g. the extension for the database). The packaged versions of Moodle are not recommended (it's not much harder to install from moodle.org download)
  
Go here for a [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] (not server) Mac.
+
See (for example):
 +
* Ubuntu - https://help.ubuntu.com/community/ApacheMySQLPHP
 +
* Debian - http://wiki.debian.org/LaMp
 +
* RedHat / Centos - http://www.howtoforge.com/quick-n-easy-lamp-server-centos-rhel
 +
* SuSE / OpenSuSE - http://www.susegeek.com/internet-browser/install-configure-lamp-apachemysqlphp-in-opensuse-110/
  
== Red Hat Linux ==
+
While one-click installers (e.g. XAMPP or BitNami LAMP Stack) exist for Linux, it is so simple to install the components the "right" way that they seem pointless. Using the standard method will make it much easier for you to obtain help and support.
  
You should install all available RPM packages for Apache, PHP and MySQL. One package that people frequently forget is the php-mysql package which is necessary for PHP to talk to MySQL.
+
Of course, if you wish to (or you need a particularly new version) you can compile all or some of the elements from source. All the elements have good documentation. The tricky one is PHP and some guidance for Debian/Ubuntu is here: [[Compiling PHP from source]]
 
 
Once these are installed the standard [[Installing Moodle|Installation guide]] should be fairly straightforward.
 
 
 
A more detailed walkthrough is here: [[RedHat Linux installation]]
 
  
 
== Windows ==
 
== Windows ==
  
Installing Moodle '''for the first time''' on a [[Localhost]] (a stand alone computer) is easy and can be a very useful tool even if a web based production Moodle Server is available for use. These instructions work on a Windows XP computer.
+
Windows has slightly more variations as you can use [[Apache]] or Microsoft's [[IIS]] web servers. Again, here are some pointers
#On the [http://download.moodle.org/windows/ Windows packages] download page, choose the version you would like. Click on the download link in the rightmost column. This will download a large zip file.
 
#Unzip the downloaded file at c: and keep the path structure for all the files. 
 
#Rename the just created c:\moodle to c:\xampplite (c:\xampplite will be our example) but you could rename it c:\moodle16 or c:\moodle17 or C:\testMoodle or whatever .
 
#Using Windows Explorer run the file c:\xampplite\setup_xampp.bat which will make sure all the configuration files use c:\xampplite as the home or root directory.
 
#The following steps assume that the web server will be able to use port 80 on your computer. See [[Windows_installation_using_XAMPP#Skype |troubleshooting if you are running Skype]] which also likes to use this port as a default.
 
#Be sure that you are administrator or at least that you have rights to install new services.
 
#There many ways to start the localhost webserver from this point for the Moodle install.  Here are two ways.
 
##Slightly faster
 
###Using Windows Explorer run the file c:\xampplite\restart_xampp.bat and do not close the window that opens.
 
##Still fast
 
###In Windows Explorer click on  c:\xampplite\apache_start to start the Apache web server. This opens a new window that you should leave open.
 
###In Windows Explorer click on  c:\xampplite\mysql_start to start the MySQL database server. This opens yet another new window that you should leave open.
 
#In your favorite Web browser, go to the address bar and type "localhost" or "127.0.0.1" and press enter or click go.
 
#This will start the Moodle Install process, which the [[Installing Moodle]] [[Installing_Moodle#Go_to_the_admin_page_to_continue_configuration| MoodleDoc page section]] describes in a little bit more detail. This can take some time for a new user. '''Don't panic''', you can change things later and the install process will tell you what you absolutely have to fill in or correct.
 
 
 
===Easier Moodle restarts===
 
There are lots of ways to start a Moodle after an install.  Most Moodlers will have one or more "localhost" links on their computer installed in "Favorites" or even as a browser's default opening screen. But first a web server has to be started. Here are two ways to start them. 
 
====Automatic Windows services startup====
 
In order to make starting Moodle more convenient in the future you could install the web and database servers as Windows services that are started automatically. To do this go to Start -> Run... and type the command "c:/xampplite/service.exe -install" into Open box. Then click OK.
 
 
 
Start Moodle by typing localhost in the web browser and/or adding localhost as a favorite site.
 
====Single button service startups====
 
Sometimes there are more than one localhost installed on a computer. Create a shortcut on the start menu, favorites or desktop that points to each specific file like c:\xampplite\restart_xampp.bat . Label each shortcut to a localhost differently, for example C_MoodleXampp, or Moodle16 or Moodle17 or whatever. 
 
 
 
Start Moodle by placing localhost in the web browser or adding it as a favorite site. Whichever localhost you restarted, that is the Moodle your web browser will find.
 
  
==Other install options==
+
* [http://www.apachefriends.org/en/xampp-windows.html XAMPP]: Probably the best known one-click installer for Windows. Lots of documentation and discussion around. Definitely only for a personal web server
Instead of using this package you can also install XAMPP and Moodle separately as explained on the page [[Windows_installation_using_XAMPP]].  
+
* [http://www.easyphp.org/ EasyPHP]: Another popular alternative to the above
 +
* [http://bitnami.org/stack/wampstack BitNami WAMPStack]: On 'one-click' installer with for MySQL, Apache and PHP which supports the BitNami applications modules to installed on top of it like the [http://bitnami.org/stack/moodle#nativeInstaller BitNami Moodle module].
 +
* [http://php.net/manual/en/install.windows.php Official PHP Documentation]: A lengthy list of instructions for installing PHP on all manner of Windows and web server variations
 +
* [http://www.mysql.com/downloads/mysql/ MySQL]: Select Windows and download installer.
 +
* [http://www.postgresql.org/download/windows/ PostgreSQL]: Download installer for Windows
  
As an alternative to the above package you could use a package like EasyPHP that bundles all the software you need into a single Windows application.  Note that the EasyPHP 1.8 uses older versions of the software that are too old for Moodle 1.6.  Also many menus for EasyPHP are still in French. EasyPHP may be a good option again once its version 2.0 is released.
+
=== Installer packages and components ===
  
Here you can find steps for an [[IIS]]: [[Windows installation]] for XAMPP or Windows 2003 .
+
As a reference, the following table lists each package, its version and its components (as of July 30, 2012):
  
==Testing PHP==
+
{| style="width:75%; height:75px" border="0"
Once you have installed your web server and PHP you should be able to create a file (for example phpinfo.php in the document root) with the following in it:
+
|-
 +
| '''Product''' || '''Version''' || '''Httpd (Apache)''' || '''PHP''' || '''MySQL''' || '''PHPMyAdmin''' || '''Address'''
 +
|-
 +
| WampServer || 2.2e || 2.2.22 || 5.3.13 || 5.5.24 || 3.4.10.1 || [http://www.wampserver.com/en/ Web page]
 +
|-
 +
| BitNami WAMP Stack || 5.3.15 || 2.2.22 || 5.3.15 || 5.5.21 || 3.5.2 || [http://bitnami.org/stack/wampstack/ Web page]
 +
|-
 +
| BitNami WAMP Stack || 5.4.5-0 dev || 2.4.2 || 5.4.5 || 5.5.21 || 3.5.2 ||
 +
|-
 +
| EasyPHP || 12.0 || 2.4.2 VC9 || 5.4.4 VC9, 5.3.14 VC9, 5.2.17 || 5.5.25a || 3.5.1 || [http://www.easyphp.org/ Web page]
 +
|-
 +
| EasyPHP || 5.3.8.1 || 2.2.21 VC9 || 5.3.8 VC9 || 5.5.16 || 3.4.5 || [http://www.easyphp.org/ Web page]
 +
|-
 +
| XAMPP || 1.8.0 || 2.4.2 || 5.4.4 || 5.5.25a || 3.5.2 || [http://www.apachefriends.org/en/xampp-windows.html Web page]
 +
|-
 +
| ----------------- || --------- || ---------- || -------------------------- || ------ || ------- ||
 +
|-
 +
| XAMPP || 1.7.4 || 2.2.17 || 5.3.5 || 5.5.8 || 3.3.9 ||
 +
|-
 +
| XAMPP || 1.7.1 || 2.2.11 || 5.2.9 || 5.1.33 || 3.1.3.1 ||
 +
|}
  
  <?php phpinfo()?>
+
Versions 1.7.1 and 1.7.4 of the XAMPP package were included because those are the versions on which the [http://download.moodle.org/windows/ Windows Moodle Package] are built (1.9.18+ is under 1.7.1, and 2.1.7+, 2.2.4+ & 2.3.1+ are under 1.7.4).
  
You should be able to open this file in a web browser by going to to the URL '''localhost/phpinfo''' and see a web page that has PHP status information in it such as [[phpinfo|this]].
+
==Vista and Windows 7==
  
==See also==
+
Many people have trouble installing the stand alone local [http://download.moodle.org/windows/ Moodle for Windows] on Vista and Windows 7.
  
*[[Installing Moodle]]
+
Here are some things you might want to try:
*[[Installation FAQ]]
 
*[[Upgrading Moodle]]
 
*[[Debian GNU/Linux installation]]
 
*[[Complete install packages]], also includes instructions for creating a stand alone (localhost) installation on a single computer.
 
  
[[Category:Installation]]
+
* A simple one is to use http://bitnami.org/stack/moodle
 +
* Another solution is to look at these videos at [http://www.sebastiansulinski.co.uk/web_design_tutorials/tutorial/7/install_apache_php_and_mysql_on_windows_vista Sebastian Sulinski Design] for Windows Vista.
 +
* For personal (evaluation) use - install XAMPP or EasyPHP and then Moodle using the normal installation instructions.
  
 
[[es:Instalación AMP]]
 
[[es:Instalación AMP]]
Line 90: Line 87:
 
[[ja:AMPのインストール]]
 
[[ja:AMPのインストール]]
 
[[ru:Установка AMP]]
 
[[ru:Установка AMP]]
 +
[[pl:Instalacja AMP]]
 +
[[de:Installation von Apache, MySQL und PHP]]

Latest revision as of 10:55, 8 November 2012

AMP, stands for Apache, MySQL & PHP. This is not the only platform on which Moodle runs but is the most common and fine for basic installations.

'All-in-one' Moodle installers for Windows and OSX are available at http://httpd.apache.org/docs/2.0/install.html (not intended for 'production' sites).

First a word about PostgreSQL

If you would prefer to use the PostgreSQL database (and you should consider it) you can - when using the package type installers - just install it instead of MySQL. MySQL tends to be the universal choice with the simpler 'one-click' installers. For a 'one-click' installer with PostgreSQL, Apache and PHP you can check BitNami, it supports Windows (WAPP), Linux (LAPP) and Mac (MAPP).

Mac OS X

OSX comes with a suitable Apache web server and a not so suitable PHP (it doesn't have all the required extensions).

Here are some other possibilities (all are documented so this is not repeated here):

Linux

You should install the packages from your distribution's repository for Apache, PHP and MySQL. You will almost certainly need additional extensions for PHP (e.g. the extension for the database). The packaged versions of Moodle are not recommended (it's not much harder to install from moodle.org download)

See (for example):

While one-click installers (e.g. XAMPP or BitNami LAMP Stack) exist for Linux, it is so simple to install the components the "right" way that they seem pointless. Using the standard method will make it much easier for you to obtain help and support.

Of course, if you wish to (or you need a particularly new version) you can compile all or some of the elements from source. All the elements have good documentation. The tricky one is PHP and some guidance for Debian/Ubuntu is here: Compiling PHP from source

Windows

Windows has slightly more variations as you can use Apache or Microsoft's IIS web servers. Again, here are some pointers

  • XAMPP: Probably the best known one-click installer for Windows. Lots of documentation and discussion around. Definitely only for a personal web server
  • EasyPHP: Another popular alternative to the above
  • BitNami WAMPStack: On 'one-click' installer with for MySQL, Apache and PHP which supports the BitNami applications modules to installed on top of it like the BitNami Moodle module.
  • Official PHP Documentation: A lengthy list of instructions for installing PHP on all manner of Windows and web server variations
  • MySQL: Select Windows and download installer.
  • PostgreSQL: Download installer for Windows

Installer packages and components

As a reference, the following table lists each package, its version and its components (as of July 30, 2012):

Product Version Httpd (Apache) PHP MySQL PHPMyAdmin Address
WampServer 2.2e 2.2.22 5.3.13 5.5.24 3.4.10.1 Web page
BitNami WAMP Stack 5.3.15 2.2.22 5.3.15 5.5.21 3.5.2 Web page
BitNami WAMP Stack 5.4.5-0 dev 2.4.2 5.4.5 5.5.21 3.5.2
EasyPHP 12.0 2.4.2 VC9 5.4.4 VC9, 5.3.14 VC9, 5.2.17 5.5.25a 3.5.1 Web page
EasyPHP 5.3.8.1 2.2.21 VC9 5.3.8 VC9 5.5.16 3.4.5 Web page
XAMPP 1.8.0 2.4.2 5.4.4 5.5.25a 3.5.2 Web page
----------------- --------- ---------- -------------------------- ------ -------
XAMPP 1.7.4 2.2.17 5.3.5 5.5.8 3.3.9
XAMPP 1.7.1 2.2.11 5.2.9 5.1.33 3.1.3.1

Versions 1.7.1 and 1.7.4 of the XAMPP package were included because those are the versions on which the Windows Moodle Package are built (1.9.18+ is under 1.7.1, and 2.1.7+, 2.2.4+ & 2.3.1+ are under 1.7.4).

Vista and Windows 7

Many people have trouble installing the stand alone local Moodle for Windows on Vista and Windows 7.

Here are some things you might want to try: