← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/upgrade.txt

  • Committer: William Grant
  • Date: 2009-02-23 23:47:02 UTC
  • mfrom: (1099.1.211 new-dispatch)
  • Revision ID: grantw@unimelb.edu.au-20090223234702-db4b1llly46ignwo
Merge from lp:~ivle-dev/ivle/new-dispatch.

Pretty much everything changes. Reread the setup docs. Backup your databases.
Every file is now in a different installed location, the configuration system
is rewritten, the dispatch system is rewritten, URLs are different, the
database is different, worksheets and exercises are no longer on the
filesystem, we use a templating engine, jail service protocols are rewritten,
we don't repeat ourselves, we have authorization rewritten, phpBB is gone,
and probably lots of other things that I cannot remember.

This is certainly the biggest commit I have ever made, and hopefully
the largest I ever will.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/upgrade.txt
 
1
Upgrade Procedure for IVLE
 
2
==========================
 
3
 
 
4
Upgrading to a new version of IVLE is generally fairly painless, but
 
5
there are several steps involved.
 
6
 
 
7
Firstly, in the IVLE checkout, bring your codebase up to date:
 
8
 
 
9
  svn up
 
10
 
 
11
Then build IVLE:
 
12
 
 
13
  ./setup.py build
 
14
 
 
15
Now comes the time to block external access to IVLE. Stopping Apache
 
16
on each server in the cluster and killing any remaining python-console
 
17
processes is highly recommended.
 
18
 
 
19
You should then run any outstanding database migrations. A note of the
 
20
latest applied migration should probably be kept somewhere to avoid
 
21
running the same one twice. This command must be run once for each.
 
22
 
 
23
  sudo -u postgres psql ivle < userdb/migrations/YYYYMMDD-NN.sql
 
24
 
 
25
Now we can install the new version, and update the jails:
 
26
 
 
27
  sudo ./setup.py install
 
28
  sudo ivle-buildjail
 
29
 
 
30
Note that this will not perform a full rebuild of the template jail -
 
31
only the IVLE files inside the jail will be updated. To force a full
 
32
jail rebuild, give ivle-buildjail the -r option.
 
33
 
 
34
... and remake the user jails, as this will occasionally be needed:
 
35
 
 
36
  ivle-remakeuser --all --verbose
 
37
 
 
38
Restart the usrmgt-server and all Apaches, reenable external access,
 
39
check that everything works, and you're done!