Upgrade esup-print-channel

esup-print-channel is very easy to upgrade thanks to the ant target recover-config. It is however up to the portal administrator to use the classical installation procedure at each upgrade.

Please read carefully the instructions below not to dammage your working installation. In any case, it is recommended to save your database before upgrading.

Very quick upgrading guide

Impatient people can use these very simple guidelines:

  • install the sources
  • ant recover-config
  • edit configuration files (if needed)
  • ant undeploy
  • ant deploy
  • ant upgrade

General instructions

Upgrading from a previous release always needs to uninstall the previous release, do some specific actions (optional), compile the source code and install it in the uPortal webapps folder. This can be done the following way:

0. backup your database!

1. Uninstall the previous release

  • a. go to your previous installation directory
  • b. run 'ant undeploy'

This step is optional most of times, but it is recommended to do it however to remove useless files from the deployment hierarchy.

2. Install the sources

  • a. unzip esup-print-channel-x.y.z-t.zip wherever you like (at the level where you installed previous releases if you want to recover you previous configuration files automatically)
  • b. move to esup-print-channel-x.y.z/esup-print-channel/ new folder

3. Upgrade your configuration

  • a. recover your previous configuration files by running 'ant recover-config' (previous configuration files are expected to be in ../esup-print-channel-<previous-release>)
  • b. make changes in the configuration files if needed (see the specific instructions below)
  • c. make changes in the database if needed (major releases only, see the specific instructions below)

Read output of step 3a; steps 3b and 3c should be done very carefully, according to the specific upgrading instructions.

4. Deploy into uPortal

  • d. run 'ant deploy' and then 'ant upgrade' from the main folder.

5. Restart uPortal and test

Specific instructions

No specific instruction was needed to upgrade existing installations until now.