Migrating Cascade CMS to a new server

Overview

The following is a general overview of steps you can take to migrate your instance of Cascade CMS to a new application server:

1. Request a license for the new application server. To do this, send an email to support [at] hannonhill.com and be sure to include:
   • The internal host name of the machine in question. To get this value, open a command prompt/terminal on the machine and enter:  hostname
   • The type of environment where you're installing Cascade CMS (production, test, development, etc).
2. Download the Cascade CMS installer. Visit our downloads page to obtain an installer whose version matches - or is newer than - the version that you currently use (on the machine you're migrating away from).
3. Make a backup of your Cascade CMS database. Create a backup of your database or verify that you have available backups from the previous night (just in case anything goes wrong).
4. Install Cascade CMS. Follow the steps for your O/S vendor to install/configure Cascade CMS. When prompted to enter the database connection information, be sure to enter the connection information for your existing Cascade CMS database.
   
   Warning: Before starting Cascade CMS on the new machine, be sure to STOP any other Cascade CMS processes on the old app server(s) that are running against the existing database.
5. Start Cascade CMS. Using the steps in your O/S vendor installation instructions, start Cascade CMS. When the application starts up, it will connect to your existing database (or whichever database you configured the app to point to during installation/configuration). When you browse to the login screen for the first time, you will be prompted to enter license (at which point you will enter the license key that you received from Hannon Hill in step 1).