Upgrading with the Full Installer

Some upgrades require full installations in order to take advantage of updated technologies used by the application (Tomcat, JVM). The following steps should be taken when performing an upgrade via the full installer:

  • Leave the current installation directory as is (you will need to reference files from the existing installation)
  • Follow the full installation instructions for the appropriate Operating System (Windows, Mac OS X, Linux). When the installer prompts for the installation directory, be sure to select a new location on the hard drive. When prompted to enter database connection information, configure the application to point to the existing Cascade Server database. Previous database connection information can be referenced from the old/existing tomcat/conf/context.xml file.

At this point, you'll need to manually apply any further customization you've made to Cascade including:

  • customizations to the tomcat/conf/context.xml file not including the database configuration (which is set by the installer)
  • customizations to the tomcat/conf/server.xml file not including the HTTP port (which is set by the installer)
  • customizations to the tomcat/conf/web.xml file
  • copying custom Asset Factory plugins, Publish Triggers, custom authentication modules from the old/existing tomcat/webapps/ROOT/WEB-INF/lib directory to the new installation folder's tomcat/webapps/ROOT/WEB-INF/lib directory. ( NOTE: The tomcat/webapps/ROOT/WEB-INF/lib directory will not exist in the new installation until the application has been deployed at least one time. For this reason, the application will need to be started (make sure you can log in) and then shut down before copying custom JAR files).

IMPORTANT: The following files should not be copied from the old installation into the new installation as they can cause compatibility problems:

  • tomcat/conf/context.xml
  • tomcat/conf/server.xml
  • tomcat/conf/web.xml

Instead, they should be used only as a reference for updating the corresponding files in the new installation.