Difference between revisions of "Environment"

Jump to: navigation, search

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

(small tidying up)
 
(31 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 +
{{Server settings}}
 +
An administrator can check that their site meets all system requirements for the current and future versions of Moodle in ''Settings > Site administration > Server > Environment''. It is important to check system requirements prior to [[Upgrading|upgrading]].
  
Location: ''Administration > Server > Environment''
+
Note: some of the PHP extensions are included as standard in later distributions of PHP, depending on platform:
 +
* Iconv is included in PHP from 5.0 onwards on Windows [http://uk3.php.net/manual/en/iconv.installation.php]
 +
* Tokenizer is included in PHP from 4.3.0 onwards [http://uk2.php.net/manual/en/tokenizer.installation.php]
 +
* Ctype is included by default from PHP 4.2.0 onwards http://uk.php.net/manual/en/ctype.installation.php
  
 +
=== Hardware ===
 +
* Disk Space: 160MB min
 +
* Memory (RAM): 256 min, 1GB reccomnded, 50 users per 1GB RAM
  
The environment page enables you to check that your site meets all system requirements for your current and future versions of Moodle. It is important to check system requirements prior to [[Upgrading|upgrading]].
+
=== Software ===
 +
* Web server software. Such as [[Apache]] or [[IIS]].
 +
* [[PHP]] scripting language. The exact requirements for PHP in Moodle 2.0 are [[#php_requires|below.]]
 +
<span id="php_requires">'''''</span>
 +
===PHP Configuration ===
 +
* Version: 5.2.8 or later, it will not support any earlier version.
 +
** PHP Settings. Check these settings in your php.ini or .htaccess file (if you're using Apache). For settings which use ON/OFF as their values, you can substitute 1 for ON and 0 for OFF if you prefer.
 +
*** ''register_globals'' '''MUST''' be OFF
 +
*** ''safe_mode'' needs to be OFF.
 +
*** ''memory_limit'' should be at least 128M. Large sites may need more than 128M. PHP 5.2.x requires higher memory_limit values than previous versions of PHP. 64bit operating systems require even more memory.
 +
*** ''session.save_handler'' needs to be set to FILES.
 +
*** ''magic_quotes_gpc'' should be OFF. Unlike earlier versions of Moodle.
 +
*** ''magic_quotes_runtime'' needs to be OFF.
 +
*** ''file_uploads'' needs to be ON.
 +
*** ''session.auto_start'' needs to be OFF.
 +
*** ''session.bug_compat_warn'' needs to be OFF.
 +
** PHP Extensions and libraries
 +
*** The mbstring extension is recommended.
 +
*** The iconv extension is recommended
 +
*** [http://www.libgd.org/ GD library] and the [http://www.freetype.org/ FreeType 2] library and extensions are needed to be able to look at the dynamic graphs that the logs pages make. (Freetype support is available as part of the GD extension for the 5.x versions of PHP)
 +
*** The mysql extension is required if you are using the MySQL database. Note that in some Linux distributions (notably Red Hat) this is an optional installation.
 +
*** The pgsql extension is required if you are using the PostgreSQL database.
 +
*** The pdo and pdo_sqlite extensions are required for the (experimental) SQLite 3 database support.
 +
*** The curl extension is recommended.
 +
*** The tokenizer extension is recommended.
 +
*** The curl and openssl extensions are required for the Moodle network functionality.
 +
*** The xmlrpc extension is required for the Moodle network functionality.
 +
*** The ctype extension is recommended.
 +
*** The intl extension is recommended. It is used to improve internationalization support, such as locale aware sorting.
 +
*** Other PHP extensions may be required to support optional Moodle functionality, especially external authentication and/or enrolment (e.g. LDAP extension for LDAP authentication and the sockets extension for Chat server).
  
 
+
=== Database ===
==Moodle version 1.5.3==
+
* A working database server: [[MySQL]] or [[PostgreSQL]] are completely supported and recommended for use with any version of Moodle. MySQL is ''the'' choice for many people because it is very popular, but there are some [[Arguments in favour of PostgreSQL|arguments in favour of PostgreSQL]], especially if you are planning a large deployment.
 
+
** MySQL 5.0.25 or  
*MySQL version - 3.23 or later is required
+
** Postgres 8.3 or  
*PHP version - 4.1.0 or later is required
+
** MSSQL 9.0 or  
*The php_extension mbstring is recommended to be installed/enabled
+
** Oracle 10.2
 
+
** SQLite 3 (experimental)
==Moodle version 1.6==
 
 
 
*MySQL version 4.1.12 or later for sites that are exclusively [http://czyborra.com/charsets/iso8859.html Latin-1], 4.1.16 if you have other languages, or PostgreSQL 7.4.x or later
 
*PHP version 4.3.0 or later is required (but don't use versions 5.0.0 to 5.0.6 which were buggy)
 
*The php_extension iconv is recommended to be installed/enabled
 
*The php_extension mbstring is recommended to be installed/enabled
 
 
 
==Moodle version 1.8==
 
 
 
*MySQL version 4.1.16 or later is required, or PostgreSQL 7.4.x or later
 
*PHP version 4.3.0 or later is required (but don't use versions 5.0.0 to 5.0.6 which were buggy)
 
*[[admin/environment/unicode|Unicode]] is required
 
*The [[admin/environment/php extension/curl|php_extension curl]] is recommended to be installed/enabled
 
*The [[admin/environment/php extension/iconv|php_extension iconv]] is recommended to be installed/enabled
 
*The [[admin/environment/php extension/mbstring|php_extension mbstring]] is recommended to be installed/enabled
 
*The [[admin/environment/php extension/openssl|php_extension openssl]] is recommended to be installed/enabled
 
*The [[admin/environment/php_extension/tokenizer|php_extension tokenizer]] is recommended to be installed/enabled
 
*The [[admin/environment/php_extension/xmlrpc|php_extension xmlrpc]] is recommended to be installed/enabled
 
*The [[admin/environment/php_extension/ctype|php_extension ctype]] is recommended to be installed/enabled
 
 
 
==Moodle version 1.9==
 
 
 
*MySQL version 4.1.16 or later is required, or PostgreSQL 8.0 or later
 
 
 
==Moodle version 2.0==
 
 
 
===Requirements ===
 
* PHP version 5.2.8 or later is required
 
* Database (pick one):
 
** MySQL 4.1.16 or
 
** Postgres 8.0 or
 
** MSSQL 9.0 or
 
** Oracle 9.0
 
** SQLite 3 (experimental)  
 
  
 
===See also ===
 
===See also ===
 
*[[Installing Moodle 2.0]]
 
*[[Installing Moodle 2.0]]
 
*[[Upgrading to Moodle 2.0]]
 
*[[Upgrading to Moodle 2.0]]
 
===Last edit ===
 
--[[User:Rhodry Korb|Rhodry Korb]] 06:06, 13 February 2009 (CST)
 
  
 
[[Category:Environment]]
 
[[Category:Environment]]
[[Category:Moodle 2.0]]
 
  
 
[[eu:Ingurunea]]
 
[[eu:Ingurunea]]
 
[[fr:Environnement]]
 
[[fr:Environnement]]
[[ja:環境]]
+
[[ja:動作環境]]

Latest revision as of 07:29, 20 October 2011

An administrator can check that their site meets all system requirements for the current and future versions of Moodle in Settings > Site administration > Server > Environment. It is important to check system requirements prior to upgrading.

Note: some of the PHP extensions are included as standard in later distributions of PHP, depending on platform:

Hardware

  • Disk Space: 160MB min
  • Memory (RAM): 256 min, 1GB reccomnded, 50 users per 1GB RAM

Software

  • Web server software. Such as Apache or IIS.
  • PHP scripting language. The exact requirements for PHP in Moodle 2.0 are below.

PHP Configuration

  • Version: 5.2.8 or later, it will not support any earlier version.
    • PHP Settings. Check these settings in your php.ini or .htaccess file (if you're using Apache). For settings which use ON/OFF as their values, you can substitute 1 for ON and 0 for OFF if you prefer.
      • register_globals MUST be OFF
      • safe_mode needs to be OFF.
      • memory_limit should be at least 128M. Large sites may need more than 128M. PHP 5.2.x requires higher memory_limit values than previous versions of PHP. 64bit operating systems require even more memory.
      • session.save_handler needs to be set to FILES.
      • magic_quotes_gpc should be OFF. Unlike earlier versions of Moodle.
      • magic_quotes_runtime needs to be OFF.
      • file_uploads needs to be ON.
      • session.auto_start needs to be OFF.
      • session.bug_compat_warn needs to be OFF.
    • PHP Extensions and libraries
      • The mbstring extension is recommended.
      • The iconv extension is recommended
      • GD library and the FreeType 2 library and extensions are needed to be able to look at the dynamic graphs that the logs pages make. (Freetype support is available as part of the GD extension for the 5.x versions of PHP)
      • The mysql extension is required if you are using the MySQL database. Note that in some Linux distributions (notably Red Hat) this is an optional installation.
      • The pgsql extension is required if you are using the PostgreSQL database.
      • The pdo and pdo_sqlite extensions are required for the (experimental) SQLite 3 database support.
      • The curl extension is recommended.
      • The tokenizer extension is recommended.
      • The curl and openssl extensions are required for the Moodle network functionality.
      • The xmlrpc extension is required for the Moodle network functionality.
      • The ctype extension is recommended.
      • The intl extension is recommended. It is used to improve internationalization support, such as locale aware sorting.
      • Other PHP extensions may be required to support optional Moodle functionality, especially external authentication and/or enrolment (e.g. LDAP extension for LDAP authentication and the sockets extension for Chat server).

Database

  • A working database server: MySQL or PostgreSQL are completely supported and recommended for use with any version of Moodle. MySQL is the choice for many people because it is very popular, but there are some arguments in favour of PostgreSQL, especially if you are planning a large deployment.
    • MySQL 5.0.25 or
    • Postgres 8.3 or
    • MSSQL 9.0 or
    • Oracle 10.2
    • SQLite 3 (experimental)

See also