Notes on Upgrading

If you have been running a previous version of Management Console this section will inform you how to upgrade to 9.4.9

Upgrading involves the following steps

Create a backup

Check the online documentation of your previous version of Management Console to learn how to create a backup. 9.2 9.1 9.0 8.2 8.1 8.0 7.2 7.1 7.0

Users upgrading from version 9.2 can also consult our notes on upgrading and the Data Migration Tutorial section.

Install Management Console

Follow the next steps in this guide to learn how to install the Management Console. If you are upgrading from 8.1 or later you can reuse your old Configuration.xml, see next section.

Upgrade Management Console configuration

If you are upgrading from version 8.0 or earlier, you will have to re-configure your new Management Console from scratch. Prior to version 8.1 some configuration was done in web.xml this is no longer the case. You may no longer copy or modify the web.xml.

Most configuration is done in Configuration.xml. This file may be copied from previous versions. Copy the Configuration.xml from the previous version into WEB-INF/ overriding the version already there. Once you start Management Console it will create a new Configuration.xml based on your old version, you must then copy the upgraded version into WEB-INF/ overriding your old configuration. Instruction should display when you access Management Console web interface.

As of version 8.2 , LDAP integration is no longer container managed. If you used LDAP for authentication in a previous version, you should remove the Realm definition in the ManagementConsole.xml inside Tomcat's conf/Catalina/localhost/. LDAP integration is now configured in WEB-INF/login.xml, as described in LDAP Integration

Restore the backup

Check the Management Console user's guide for details on how to restore a backup.