Steps to upgrade the out-of-the-box Apache Tomcat version of CA Service Desk Manager (CA SDM) to Apache Tomcat 7.0.55

Document ID : KB000017661
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction

CA Service Desk Manager (CA SDM) 12.9 provides out-of-the-box Apache Tomcat 7.0.23.

This document will provide steps to upgrade the out-of-the-box Apache Tomcat version of CA SDM 12.9 to Apache Tomcat 7.0.55.

Note:  Although this document explicitly indicates Apache Tomcat 7.0.55, the same steps can be followed for any Apache Tomcat 7.0.xx version.  All Apache Tomcat 7.0.xx downloads can be located at http://archive.apache.org/dist/tomcat/tomcat-7

Instructions

  1. Shut down the CA Service Desk Daemon Service and/or Service Desk Proctor Service on the relevant Service Desk Server (primary and/or secondary).
  2. Download Tomcat 7.0.55 (apache-tomcat-7.0.55.zip) from: http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.55/bin/

    Note: CA SDM will support service packs and point releases of Operating Systems, Databases, Web Servers, Web Browsers, Java, Servlets, etc., not necessarily noted on the certification matrix as long as the problem reported is reproducible with versions that are listed on the matrix. CA reserves the right to refuse support of new point releases should the reported problem require a major SDM rework or redesign in order to function properly. Both Technical Support and Sustaining Engineering will do their best to resolve any issues that occur in a timely manner. If the resolution to the problem is determined to be outside the realm of their support responsibilities, they may ask that you escalate your request for certification to your local account team.
  3. Unzip apache-tomcat-7.0.55.zip and place files in to <drive>:\<install_directory>\CA\SC\tomcat\7.0.55

    Note:
    After unzipping, ensure that <drive>:\<install_directory>\CA\SC\tomcat\7.0.55 contains conf, bin, webapps and other directories. <drive>:\<install_directory>\CA\SC\tomcat\7.0.55 should NOT contain <drive>:\<install_directory>\CA\SC\tomcat\7.0.55\apache-tomcat-7.0.55 which means the unzipping was done improperly.
  4. Make a backup copy of the NX.ENV located at the CA SDM install directory (NX_ROOT) 
     
  5. Modify NX.ENV located at the CA SDM install directory (NX_ROOT) as follows:

    @NX_TOMCAT_INSTALL_DIR=C:\Program Files\CA\SC\tomcat\7.0.55
     
  6. Backup directory NX_ROOT\bopcfg\www\CATALINA_BASE\conf 
     
  7. If CA Visualizer is installed, backup directory NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ
     
  8. Copy all files in directory

    <drive>:\<install_directory>\CA\SC\tomcat\7.0.55\conf
    to
    NX_ROOT\bopcfg\www\CATALINA_BASE\conf 
     
  9. If CA Visualizer is installed, copy all files in directory

    <drive>:\<install_directory>\CA\SC\tomcat\7.0.55\conf
    to
    NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ\conf 
     
  10. Verify that the server.xml file located in directory NX_ROOT\bopcfg\www\CATALINA_BASE\conf has the same startup (connector) and shutdown ports as defined in the original server.xml file.

    Note: If any other changes were made to the original server.xml file, then they would need to be made to the new server.xml file.
  11. Edit the file NX_ROOT\bopcfg\www\CATALINA_BASE\conf\catalina.properties with a text editor.

Look for the below entry in the file

shared.loader=

Modify it to look like:

shared.loader=${catalina.base}/shared/lib/*.jar,

Save the file

 12. If CA Visualizer is installed, verify that the server.xml file located in directory NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ\conf has the same startup (connector) and shutdown ports as defined in the original server.xml file.

Note: If any other changes were made to the original server.xml file, then they would need to be made to the new server.xml file.

13. Edit the file  NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ\conf\catalina with a text editor.

Look for the below entry in the file

shared.loader=

Modify it to look like:

shared.loader=${catalina.base}/shared/lib/*.jar,

Save the file

14. Modify config.properties located in directory NX_ROOT\site as follows: 

web.tomcat_home=<drive>\:\\<install_directory>\\CA\\SharedComponents\\tomcat\\7.0.55
web.tomcat.version=7.0.55 \


Note:
If this step is not performed then the applications will not deploy properly when Tomcat is started.

NOTE: Similar to Visualizer, if Federated Search or REST Tomcats are installed, then appropriate changes could be performed similar to the approaches suggested above Visualizer Tomcat. 

16. Start the CA SDM service.

Additional Information

Tomcat not running properly after upgrading to Tomcat - http://www.ca.com/us/services-support/ca-support/ca-support-online/knowledge-base-articles.tec1320377.html

Upgrade Apache Tomcat in CA Service Desk Manager (CA SDM) 14.1 - https://docops.ca.com/ca-service-management/14-1/en/implementing/implementing-ca-service-management-14-1/step-4-install-or-upgrade/implementing-ca-service-desk-manager/how-to-install-ca-sdm/step-3-install-other-components/install-and-configure-apache-tomcat-7-0-59

 

File Attachments:
TEC616742.zip