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

Environment: Difference between revisions

From MoodleDocs
No edit summary
(small tidying up)
 
(23 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Location: ''Administration > Server > Environment''
{{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]].


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


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]].
=== Hardware ===
* Disk Space: 160MB min
* Memory (RAM): 256 min, 1GB reccomnded, 50 users per 1GB RAM


 
=== Software ===  
==Moodle version 1.5.3==
* Web server software. Such as [[Apache]] or [[IIS]].
 
* [[PHP]] scripting language. The exact requirements for PHP in Moodle 2.0 are [[#php_requires|below.]]
*MySQL version - 3.23 or later is required
<span id="php_requires">'''''</span>
*PHP version - 4.1.0 or later is required
*The php_extension mbstring is recommended to be installed/enabled
 
==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==
===PHP ===
* PHP version 4.3.0 or later is required
* 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 16M (32M is recommended for Moodle 1.7 and 40M for Moodle 1.8 or later). 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 ON.
** ''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 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.
** Other PHP extensions may be required.
 
===Database===
* Database (pick one):
** MySQL 4.1.16 or
** Postgres 8.0 or
** MSSQL 9.0 or
** Oracle 9.0
 
===See also ===
*[[Installing Moodle 1.9]]
*[[Upgrading to Moodle 1.9]]
 
==Moodle version 2.0==
===PHP Configuration ===
===PHP Configuration ===
* Version: 5.2.8 or later, it will not supportany earlier version.
* 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.  
** 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
*** ''register_globals'' '''MUST''' be OFF
Line 83: Line 29:
** PHP Extensions and libraries
** PHP Extensions and libraries
*** The mbstring extension is recommended.
*** The mbstring extension is recommended.
*** The iconv 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)
*** [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 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.
Line 93: Line 39:
*** The xmlrpc extension is required for the Moodle network functionality.
*** The xmlrpc extension is required for the Moodle network functionality.
*** The ctype extension is recommended.
*** 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).
*** 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|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 ===
===See also ===
Line 100: Line 55:


[[Category:Environment]]
[[Category:Environment]]
[[Category:Moodle 2.0]]
[[Category:Moodle 1.9]]
[[Category:Moodle 1.8]]
[[Category:Moodle 1.6]]
[[Category:Moodle 1.5.3]]


[[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