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

Upgrade Procedure for IVLE

==========================

Upgrading to a new revision of IVLE SVN is generally fairly painless,

but there are several steps involved.

Firstly, in the IVLE checkout, bring your codebase up to date:

  svn update

Then configure and build IVLE. New configuration options may sometimes

be added, so the configuration questions should be watched closely.

  ./setup.py listmake

  ./setup.py config

  ./setup.py build

Note that this will not perform a full rebuild of the template jail -

only the IVLE files inside the jail will be updated. To force a full

jail rebuild, give the build command the -j option.

Now comes the time to block external access to IVLE. Stopping Apache

on each server in the cluster and killing any remaining python-console

processes is highly recommended.

You should then run any outstanding database migrations. A note of the

latest applied migration should probably be kept somewhere to avoid

running the same one twice. This command must be run once for each.

  sudo -u postgres ivle < userdb/migrations/YYYYMMDD-NN.sql

Now we can install the new version:

  ./setup.py install

... and remake the user jails, as this will occasionally be needed:

  ./remakeuser.py --all --verbose

Restart the usrmgt-server and all Apaches, reenable external access,

check that everything works, and you're done!