= Upgrading =
[wiki:UserGuide Back to User Guide Index] [[BR]]

== Upgrades *must* be tested against a *backup* of your live database! ==
 * A test environment with a standalone server and a test database is highly recommended. [[BR]]

'''Upgrading the web application side:'''
 * Download a released war file or build a custom version. [[BR]]
 * Stop the running servlet (e.g. Tomcat). [[BR]]
 * Move the old war file and deployed folder to a backup location. [[BR]]
 * Place the new war file in the webapps directory and start the servlet. [[BR]]

'''Upgrading the database side:'''
 * Where there are no changes to the schema (domain class folder) between versions nothing further needs to be done. [[BR]]
 * Officially released versions (1.0.0, 1.1.2 etc) will have upgrade scripts released either here or with the software. [[BR]]
 * Upgrade scripts will be sequential (to upgrade from 1.0.0 to 1.0.2 may have two sets of scripts that must be executed in order). [[BR]]