|
|
| Line 1: |
Line 1: |
| {{Installing Moodle}}
| | #redirect [[Upgrading]] |
| Note: You can only upgrade to Moodle 2.3 from Moodle 2.2 or later. If upgrading from earlier versions, you must [https://docs.moodle.org/22/en/Upgrading_to_Moodle_2.2 upgrade to 2.2] as a first step.
| |
| | |
| '''We advise that you test the upgrade first on a COPY of your production site, to make sure it works as you expect.'''
| |
| | |
| ==System requirements==
| |
| | |
| * PHP must be '''5.3.2''' or later
| |
| ** Required PHP extensions: iconv, curl, ctype, zip, simplexml, spl, pcre, dom, xml, json
| |
| ** Required PHP memory_limit at least 40MB (64MB or more recommended if you have a choice)
| |
| * Databases should be one of the following:
| |
| ** MySQL 5.1.33 or later (InnoDB storage engine highly recommended)
| |
| ** PostgreSQL 8.3 or later
| |
| ** Oracle 10.2 or later
| |
| ** MS SQL 2005 or later
| |
| * Any standards-supporting browser from the past few years, for example:
| |
| ** Firefox 4 or later
| |
| ** Safari 5 or later
| |
| ** Google Chrome 11 or later
| |
| ** Opera 9 or later
| |
| ** MS Internet Explorer 8 or later
| |
| | |
| ==Before upgrading please... ==
| |
| | |
| '''NOTE''': The upgrade process will irreversibly modify the contents of your database '''and''' your moodledata file storage area. If something goes wrong you '''cannot''' go back. It is vital that you take good backups of both moodledata and the database in case you have problems with the upgrade. If you are not sure how see [[Site backup]] or ask in the moodle.org forums (explaining what your operating system is).
| |
| | |
| * Read the [[:dev:Moodle 2.3 release notes|Moodle 2.3 release notes]] and check the [[:Category:New features|list of new features]]
| |
| * Check your site to make sure it meets all system requirements for 2.3 in ''Settings > Site administration > Server > [[Environment]]''
| |
| * '''Do a full database backup!'''
| |
| * '''Do a full moodledata backup'''
| |
| * '''Check your backups carefully'''
| |
| * Remember to purge PHP cache if using any PHP accelerator
| |
| | |
| ==Possible issues that may affect you==
| |
| | |
| === Two assignment modules ===
| |
| | |
| A new assignment module has been added in Moodle 2.3. The old assignment module is still available (renamed 'Assignments 2.2') and sites which have upgraded from previous versions will have both versions available.
| |
| | |
| It is recommended that admins upgrade all existing assignments to use the new assignment module as soon as possible, as described in [[Upgrade tool|Assignment upgrade tool]], then disable the old assignment module, to avoid the confusion of having two assignment modules.
| |
| | |
| ===Google registration required for Google Docs and Picasa plugins===
| |
| | |
| Due to a change in Google's service, Moodle 2.3 has switched to a more secure and more user-friendly system for communicating with Google called 'OAuth 2.0'. As a result, any Google Docs and Picasa plugins (the Google Docs and Picasa repositories and the Google Docs and Picasa portfolios) used previously on the site will be disabled when the site is upgraded.
| |
| | |
| To re-enable these plugins, an administrator must register their site with Google, as described in [[Google OAuth 2.0 setup]], and obtain a client ID and secret. The client ID and secret can then be used to configure all Google Docs and Picasa plugins.
| |
| | |
| ===RTL theme fixes===
| |
| | |
| Moodle 2.3 includes many right-to-left (RTL) theme fixes (MDL-30337) and so sites using RTL languages, such as Arabic and Hebrew, are recommended to perform additional testing, particularly with any custom themes to ensure everything is working fine.
| |
| | |
| ==Checking database schema - old sites==
| |
| | |
| If your Moodle site has been upgraded through many prior versions it is possible that there will be some problems with the database schema (compared to a fresh 2.3 installation). This may cause the upgrade to fail. If your site started life prior to Moodle 2.0 it is a very good idea to check and correct the database schema before upgrading. See [[Verify Database Schema]]. You should also run the database integrity checks in the XMLDB editor, see the 'See also' for a link to extra scripts to check for other discrepancies.
| |
| | |
| ==Now upgrade==
| |
| | |
| Once you have satisfied the requirements for Moodle 2.3, follow the instructions on the [[Upgrading|upgrading]] page.
| |
| | |
| On Linux servers, Moodle 2.3 supports running the [[CLI|upgrade from the command line]], rather than through a web browser. This is likely to be more reliable, particularly for large sites.
| |
| | |
| ==After upgrade==
| |
| | |
| The config.php file from your 2.2 installation should work fine but if you take a look at config-dist.php that came with Moodle 2.3 there are more/different options available (e.g. database drivers and settings). It's a good idea to map your old config.php settings to a new one based on the 2.3 config-dist.php.
| |
| | |
| ==See also==
| |
| | |
| * [[dev:Moodle 2.3 release notes|Moodle 2.3 release notes]]
| |
| | |
| [[fr:Mise à jour à Moodle 2.3]]
| |
| [[ja:Moodle2.3へのアップグレード]]
| |
