This document is not restricted to specific software and hardware versions.
CMS Server 2.5.1.
Putty or similar application.
WinSCP (or similar application).
Note: This procedure applies for all version of CMS from 2.0 to 2.6.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
Key points to be noted before proceed with the upgrade.
Ensure you copy the cms.lic file and certificates along with backup, those files are overwritten on the rollback process (in case it is needed). The .JSON file is not overwritten and does not need to be re-uploaded.
The process explained in this document is the same for all CMS nodes in a cluster.
Step 1. Take a Backup of CMS configuration.
Use putty to Log in to CMS Server Command Line Interface (CLI).
Run the command backup snapshot <filename>.
Use winSCP to Log in to CMS server via SFTP on port 22.
Download backup file created to a safe location.
In the example shown in this document, backup.bak.
Step 2. Upgrade the server.
Extract the downloaded software package zip file.
The extracted file must be called upgrade.img.
Use WinSCP (or similar application) to Log in to CMS Server using SFTP on port 22.
Upload the upgrade.img file to the server.
Use Putty to Log in to CMS Server CLI.
Run the command upgrade.
Ensure to enter capital letter Y when the CMS asks for confirmation.
Note: If the CMS is clustered ensure you Upgrade all Core servers one by one. Start with the non-database servers first, followed by the slave database servers, and the master database server last. After CMS upgrade, run the command database cluster status on all servers. Once all database servers are connected and in sync, navigate to current master database server and run the command database cluster upgrade_schema.
Step 1. Downgrade the server.
Follow exact same process for upgrade in order to downgrade back to old version.
Once CMS server is downgraded, Log in to CMS Server CLI.
Run the command factory_reset app and wait for CMS server to reboot from factory reset.
Caution: The factory reset command deletes the CMS configuration, it is important to take the backup in order to restore the previous configuration. It is important to note, that the CMS version where the backup was taken, must match with the CMS version where the CMS was downgraded.
Step 3. Rollback the configuration.
Once system comes back, Log in to CMS Server CLI.
Run the command backup rollback <name> to revert backup taken before upgrade.
In the example shown in this document, backup rollback backup.bak
Caution: The backup rollback command overwrites the current configuration as well as the license.dat file, certificates and private keys on the system, and reboots the CMS. Therefore it must be used with caution. Ensure you copy your existing cms.lic file and certificates before, because they are overwritten in the backup rollback process. The .JSON file is not overwritten and does not need to be re-uploaded.
Log in to CMS Server CLI.
Run the command version.
Validate the CMS is in the ciorrect version.
Aditionally this can be validated in the web interface.