Moodle Docs: Upgrading

From d6cd6ec4f667df1dd1a5d460668a880e517fc100 Mon Sep 17 00:00:00 2001 From: moodler Date: Tue, 29 Oct 2002 03:47:43 +0000 Subject: [PATCH] New upgrading page (replaces the old UPGRADING.txt) --- doc/contents.html | 1 + doc/upgrade.html | 110 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 111 insertions(+) create mode 100755 doc/upgrade.html diff --git a/doc/contents.html b/doc/contents.html index 11f67fae18..52d952177e 100755 --- a/doc/contents.html +++ b/doc/contents.html @@ -13,6 +13,7 @@

Future diff --git a/doc/upgrade.html b/doc/upgrade.html new file mode 100755 index 0000000000..dd76309210 --- /dev/null +++ b/doc/upgrade.html @@ -0,0 +1,110 @@ + + Moodle Docs: Upgrading + + + + +

Upgrading Moodle

+ +

Moodle is designed to upgrade cleanly from any earlier version to any later + version.

When upgrading a Moodle installation you should follow these steps:

1. Backup important data

+
Although it is not strictly necessary, it is always a good idea to make a + backup of any production system before a major upgrade, just in case you need + to revert back to the older version for some reason. In fact, it's a good + idea to automate your server to backup your Moodle installation daily, so + that you can skip this step.
+
There are three areas that need backing up:
+
+
1. The Moodle software directory itself
+
+
Make a separate copy of these files before the upgrade, so that you can + retrieve your config.php and any modules you have added like themes, languages + etc
+
+
+
2. Your data directory.
+
+
This is where uploaded content resides (such as course resources and + student assignments) so it is very important to have a backup of these + files anyway. Sometimes upgrades may move or rename directories within + your data directory.
+
+
+
3. Your database
+
+
Most Moodle upgrades will alter the database tables, adding or changing + fields. Each database has different ways to backup. One way of backing + up a MySQL database is to 'dump' it to a single SQL file. The following + example shows Unix commands to dump the database called "moodle":
+
+
mysqldump moodle > moodle-backup-2002-10-26.sql
+
+
You can also use the "Export" feature in Moodle's "Manage + Database" web interface to do the same thing on all platforms.
+
+
+

2. Install the new Moodle software

+
Using a downloaded archive
+
+
Do not overwrite an old installation unless you know what you are doing + ... sometimes old files can cause problems in new installations. The best + way it to rename the current Moodle directory to something else, then unpack + the new Moodle archive into the old location.
+
+
mv moodle moodle.backup
+ tar xvzf moodle-1.0.6.tgz
+
+
Next, copy across your config.php and any other plugins such as custom + themes:
+
+
cp moodle.backup/config.php moodle
+ cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
+
+
+
Using CVS
+
+
If you are using CVS, just go into the Moodle root directory and update + to the new files:
+
+
cvs update -dP
+
+
Make sure you use the "d" parameter to create new directories + if necessary, and the "P" parameter to prune empty directories.
+
If you have been editing Moodle files, watch the messages very closely + for possible conflicts. All your customised themes and non-standard plugins + will be untouched.
+
+

+

3. Finishing the upgrade

+
The last step is to trigger the upgrade processes within Moodle.
+
To do this just visit the admin page of your + installation.
+
+
http://example.com/moodle/admin
+
+
It doesn't matter if you are logged in as admin or not.
+
Moodle will automatically detect the new version and perform all the database + or filesystem upgrades that are necessary. If there is anything it can't do + itself (very rare) then you will see messages telling you what you need to + do.
+

Assuming all goes well (no error messages) then you can start using your new + version of Moodle and enjoy the new features!

If you have trouble with the upgrade, visit moodle.com + and post on the Installation + Support Forum.

Moodle Documentation

Version: $Id$

+ + -- 2.39.5