WARNINGS:

• MySQL 4.0 is no longer supported as of Cascade Server 5.x. MySQL must be upgraded to version 4.1 or later before attempting to upgrade. MySQL 5 is recommended.
• Due to heavy database restructuring and optimizations, upgrading from Cascade Server 4.x may take several hours.  *DO NOT* interrupt the upgrade process until you can reach the log-in screen!
• Contact Hannon Hill Support if deploying Cascade Server for the first in a load-balanced environment, as this will require a special license.
• If you were involved with any Cascade Server 5 beta testing, make sure that you're upgrading against your 4.x database, as opposed to any intermediate 5.x beta databases.

Upgrade Steps

NOTE: %CASCADE_HOME% is used to refer to the root directory for the Cascade installation.

1. Shut down your currently running Cascade Server instance.
2. Back-up your production database.
3. Set up a test instance and perform a trial run of the upgrade. All customers are entitled to a test license for this purpose.
4. Copy all custom plug-ins (Publish Triggers, Custom Authentication Modules, Asset Factory Plugins, Workflow Triggers) from the cascade lib directory into a temporary location.
   1. If upgrading from 4.x to 5.x, this directory is in %CASCADE_HOME%/cascade/server/default/lib
   2. If upgrading from 5.x to 5.x, this directory is in %CASCADE_HOME%/tomcat/webapps/ROOT/WEB-INF/lib
5. Apply the upgrade (via one of the available installers or manually).
6. Start the server and wait for startup to complete. The log will contain a message like:

INFO: Server startup in 149977 ms

7. After upgrading and starting the server, move all custom plugins into the %CASCADE_HOME%/tomcat/webapps/ROOT/WEB-INF/lib directory and restart the server.