Before performing the upgrade
Please verify that the version you are upgrading to does not require a full installation by referring to the Cascade CMS Release Note for the version to which you are about to upgrade.
Upgrading
Assuming that the version you are upgrading to does not require a full installation:
- Stop Cascade CMS.
- Copy any custom plug-ins (Publish Triggers, Custom Authentication Modules, Asset Factory Plugins, Workflow Triggers) from the
tomcat/webapps/ROOT/WEB-INF/lib
directory into a temporary location. (NOTE: Only perform this step if your organization has created one or more custom JAR files. DO NOT copy the entire contents of the directory. If there are no custom JAR files to be copied, this step should be skipped.) - Delete the following files/folders:
tomcat/webapps/ROOT
,tomcat/webapps/ROOT.war
,tomcat/work
- Delete all files within the
tomcat/temp
directory (making sure not to remove the temp folder itself) - Place the new
ROOT.war
file into thetomcat/webapps
directory. - Start the Cascade CMS process and wait until the login screen can be reached via a browser.
- Log in to verify that the software has been upgraded by visiting Help->About.
Re-install custom plugins
If there were custom JAR files in your previous installation:
- Stop Cascade CMS once again
- Copy the custom plug-ins (Publish Triggers, Custom Authentication Modules, Asset Factory Plugins, Workflow Triggers) from the temporary storage location back into
tomcat/webapps/ROOT/WEB-INF/lib
. - Start Cascade CMS.