/
Install ServiceManager Deploying ServiceManager Server Updating and Removing ServiceManager
Document toolboxDocument toolbox

Install ServiceManager Deploying ServiceManager Server Updating and Removing ServiceManager

Owned by Andrew Hill (Deactivated)
Last updated: Nov 02, 2017Version comment

There are two basic types of ServiceManager upgrades: either a full upgrade requiring a reinstallation of the complete application suite, or a minor/patch upgrade requiring reinstallation of the ServiceManager web application.

Full Upgrade

Minor Upgrade

For any/all major releases of ServiceManager it is recommended that the previous installation be removed.  Full upgrades, or major releases, will typically contain newer versions of Tomcat, the JRE and ServiceManager and as such the safest option is to remove the previous version prior to the upgrade.

StepAction
1Stop Tomcat
2Remove the existing Tomcat service
3

Delete the complete old ServiceManager installation (that is all of the files/directories including Tomcat and Java from the ServiceManager installed subdirectory).

For Windows installations where the MSI installer has been used, it should be employed to perform the removal of the old ServiceManager installation. 
Note the removal of ServiceManager should only be performed after the application server (Tomcat) has been stopped and, if deployed to Windows, removed as a service.
4Install the new ServiceManager installation
5Install new Tomcat service
6

Restart Tomcat

If the ServiceManager upgrade is minor (such that only the ServiceManager web application has been modified) then a minor upgrade can be performed.  Here the existing JRE and application server may be reused, only the old ServiceManager web application need be removed:

StepAction
1Stop Tomcat
2Remove old SERVICEManager.war from CATALINA_HOME\webapps
3Delete expanded archive of old SERVICEManager from CATALINA_HOME\webapps
4Delete Tomcat's cache of SERVICEManager application files CATALINA_HOME\work\Catalina\localhost\SERVICEManager
5Copy new SERVICEManager.war into CATALINA_HOME\webapps
6Restart Tomcat

If any ServiceManager modules were also installed before ServiceManager had been successfully started then the following additional steps need to be taken…

StepActionNotes
7Stop Tomcat 
8Restart Tomcat a second time.The double restart of Tomcat is required to ensure that all the correct modules within the ServiceManager application are installed and initialised correctly.

Changes to ServiceManager modules only

Normally ServiceManager modules would be upgraded as part of the upgrade of ServiceManager itself, but it is possible to upgrade, install or uninstall the ServiceManager modules independently. If this is done, it requires that the main ServiceManager web application should be redeployed so that the correct set of modules is available:

StepAction

1

Stop Tomcat
2Delete expanded archive of ServiceManager from CATALINA_HOME\webapps
3Delete Tomcat's cache of ServiceManager application files CATALINA_HOME\work\Catalina\localhost\SERVICEManager
4 Restart Tomcat
5Stop Tomcat
6Restart Tomcat – these last 2 steps ensure modules libraries are correctly deployed so that the modules become available.