How to Upgrade the Tomcat used by Service Catalog

Products

• CA Service Catalog
• CA Service Management - Asset Portfolio Management
• CA Service Management - Service Desk Manager

Issue/Introduction

By default, Service Catalog uses a default Tomcat version included in the installation.

How can I upgrade Service Catalogs version of Tomcat?

Environment

Catalog 17.3.x

Cause

Due to security vulnerability issues with Tomcat itself, we may need to upgrade the Tomcat version that catalog is using. 

Resolution

As Tomcat releases new versions, various vulnerabilities are fixed.   

To upgrade Tomcat Apache:

1. Download Tomcat from https://archive.apache.org/dist/tomcat/

2.  On Service Catalog server, go to Service Catalog installation home folder,  double click usm.cmd to invoke Service catalog's command line 

(Note, this is important. You need to use Service Catalog's command line instead of simply DOS command line ) 

3.  Stop the CA Service Catalog service 

4.   In Service Catalog's command line, issue the following command :

           ant upgrade-tomcat

for example :

-------------------------------------------

C:\Program Files\CA\Service Catalog>ant upgrade-tomcat

Buildfile: build.xml

_start-maintenance-log:

[mkdir] Created dir: C:\Program Files\CA\Service Catalog\conf-backup\20160817-1533

[echo] Maintenance started: Wednesday August 17, 2016 03:33:34 PM IST by Administrator

_services-warning: [echo] Please shutdown all related services before continuing

[input] Press Return key to continue...

upgrade-tomcat:

[input] Location of new tomcat zip:

C:\temp\apache-tomcat-x.x.xx-windows-x64.zip

[input] What is the version of the new Apache Tomcat (e.g. 6.0.38):x.x.xx

[input] Are you sure you want to upgrade tomcat to 7.0.61? (y, n)

Y

[unzip] Expanding: C:\temp\apache-tomcat-7.0.78-windows-x64.zip into C:\Users\ADMINI~1\AppData\Local\Temp\1\tomcat-x.x.xx

[mkdir] Created dir: C:\Program Files\CA\Service Catalog\embedded\tomcat-20160817-1533

[echo] Copying the current tomcat to C:\Program Files\CA\Service Catalog/embedded/tomcat-20160817-1533

copy] Copying 653 files to C:\Program Files\CA\Service Catalog\embedded\tomcat-20160817-1533

[copy] Copied 113 empty directories to 2 empty directories under C:\Program Files\CA\Service Catalog\embedded\tomcat-20160817-1533

[echo] Copied the current tomcat to C:\Program Files\CA\Service Catalog/embedded/tomcat-20160817-1533

[copy] Copying 637 files to C:\Program Files\CA\Service Catalog\embedded\tomcat

[echo] Apache Tomcat X.X.XX has been successfully installed.

BUILD SUCCESSFUL

Total time: 42 seconds

C:\Program Files\CA\Service Catalog>

---------------------------------------------------------------------------------

 5. Restart the CA Service Catalog service 

 

 

Additional Information

Ensure you are using a supported version of Apache Tomcat by checking the Supportability Matrix:

https://techdocs.broadcom.com/us/en/ca-enterprise-software/business-management/ca-service-management/17-3/Release-Information/CA-Service-Management-17-3-Release-Notes/supportability-matrix.html

Regarding how to check the Tomcat version that your Service Catalog server is using, please check https://knowledge.broadcom.com/external/article?articleId=15999