Additionally, send an email notifying users who may not login to the Service Portal during the period the Message Of The Day is active.

Staging Upgrade Process

Users rarely encounter Commander upgrade failures, but when failures occur the problem often lies with information in the database being in an unexpected format. As such Snow Software recommends maintaining a staging environment so you can test upgrades prior to upgrading your production environment.

Your Commander license permits the upkeep of a staging environment, but you should let your Account Manager and/or the Support team know that you have one running. A permanent staging environment is also useful for trying out new workflows or policies, and becoming familiar with new Commander features before implementing them as solutions in your production environment.

If you do not want a persistent staging environment, you can also clone your app server and do a test run, if you are installed using the default Postgres SQL database. Installations against SQL databases will require a bit more work, but can be similarly handled following the procedure below.

1. Backup the SQL database.
2. Create a new "dummy" database on your SQL Server.
3. Install the version of Commander you are currently running against the dummy database. This install will be upgraded as your test. Once you've completed the testing you can destroy the database.
4. Stop the Commander Windows service.
5. Restore the backup of your SQL database, overwriting the dummy database.
6. Restart the Commander Windows service.
7. Perform the upgrade.

Production Upgrade Process

1. When required, notify Snow Software Technical Support ahead of your planned upgrade date and time. If needed a support resource can be on standby for your upgrade (during regular business hours based on your geographical location and resource availability).
2. Notify users of the outage timeframe for the production system by setting the "Message Of The Day " in the Service Portal and by emailing users who do not log in frequently.
3. Backup the associated Commander SQL Database.
4. Take a snapshot of your Commander application server
5. Download the latest Commander release from the Support Downloads. For legacy versions please contact Support.
6. Copy "Commander <version> Installer.zip" to the Commander server and unblock the file before extracting. Remember to run any executable file on the server using Run as Administrator
7. Follow the instructions available on our Documentation - Upgrade Commander page to proceed with the remainder of the required necessary steps.

Note: During the upgrade, the Installer will retain the SQL connection, service account settings and port configuration from the previous installation.  If the service account password has changed it will need to be updated during the install process and credentials in Commander will also need to be updated after the upgrade.

Please follow this article if credentials have changed.

Roll Back Process

1. Restore the Commander database using the backup taken prior to upgrading. 
2. Restore the Commander application server to the snapshot taken prior to upgrading. 
3. Restart the Commander Windows services or reboot the application server. 

Post-Upgrade Activity

Once you have successfully upgraded your Commander, remember to complete the following activities:

• Turn off or update the Service Portal Message of the Day.
• Test the most common actions that your users employ when working with Commander. If you experience any failures or unusual behavior, contact Snow Software Technical Support, providing as much detail as possible. This may include diagnostics packages, screenshots, or a backup of the upgraded database itself.
• Take database backups and/or snapshots of the Commander application server.

See Also

• Resolving Commander Installation or Upgrade Failures
• System Requirements
• What Upgrade Paths Are Supported?
• Platform Migration - Commander Application