3.
Upgrading
Up one level
Upgrading an existing installation to a newer version
In general, upgrading is supported only within the same major version of the services. For example, you can upgrade from version 5.0 to 5.1, but not from 3.1 to 5.0 (for which you will have to do a full new installation).
Upgrading can be done via the Tomcat Web Application Manager using the following procedure:
- Start up Tomcat and select "Tomcat Manager" from the Administration menu.
- Locate the package from the Applications sections.
- Select undeploy from the Commands column.
- On Windows XP (only) you should now stop and then restart tomcat.
- Scroll down to the WAR file to deploy subsection, within the Deploy section. Beside the "Select WAR file to upload" box, click the browse icon and select the WAR file from the unpacked distribution.
- Click the Deploy button. An OK message at the top of the page indicates that the WAR has been successfully deployed to Tomcat.
Having successfully deployed the war file, you can invoke it by just clicking on the link in the Applications section.
After deploying a new version and returning to the administration page in your browser, the system will lead you through any remaining upgrade tasks:
- You will be asked to select a configuration directory. To upgrade ensure that you select the configuration directory used in the previous installation.
- You will be asked to restart tomcat.
- You may be informed that your access control policies are out-of-date. Go to the access control page and undeploy the highlighted policies.
When you return to the main administration page, the new default policies will be installed. If you have modified any policies then you will need to merge your changes into the new version.
Upgrading access control policies
