04 Upgrading

The upgrading procedure is always the same:

1. download the sources of the new release
2. uncompress the sources at the same place you did for the previous (already installed) release (for instance, uncompress esup-helpdesk[-quick-start]-x.y.z-t.zip to the folder /usr/local/helpdesk/src, which creates the folder /usr/local/helpdesk/src/esup-helpdesk[-quick-start]-x.y.z)
3. stop the previous release by running ant stop (from the folder of the previous release)
4. recover the configuration and the customizations of the previous release by running ant recover-config (from the folder of the new release, see Recovering previous configuration and customizations when upgrading)
5. edit the configuration files if claimed by the ChangeLog
6. deploy the new release by running ant deploy
7. upgrade the structure of the database by running ant upgrade (needed for the minor upgrades only, not for patch upgrades)
8. restart the application by runnning ant start

   Recovering the previous configuration and customizations

   When upgrading to a newer release, the new release must be installed at the same place that the previous release, for instance /usr/local/helpdesk/src, or the ant task recover-config will not work.

See also:

• Recovering previous configuration and customizations when upgrading
• Migrating from 2.x to 3.x (in French)