Install and Configure Apache Tomcat 8.5.16.

CA SDM 14.1 provides out-of-the-box Apache Tomcat 7.0.23. This topic provides information to upgrade to Apache Tomcat 8.5.16.
casm1401
CA SDM 14.1 provides out-of-the-box Apache Tomcat 7.0.23. This topic provides information to upgrade to Apache Tomcat 8.5.16.
Follow these steps:
  1. Shut down CA SDM Daemon Service or CA SDM Proctor Service, or both on the relevant CA SDM server (primary or secondary, or both).
  2. Download Tomcat 8.5.16.
  3. Unzip apache-tomcat-8.5.16.zip and copy the files at <drive>:\<install_directory>\CA\SC\tomcat\8.5.16
    After unzipping, ensure that <drive>:\<install_directory>\CA\SC\tomcat\8.5.16 contains conf, bin, webapps, and other directories.
    <drive>:\<install_directory>\CA\SC\tomcat\8.5.16 must NOT contain <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\apache-tomcat-8.5.16. Presence of this directory indicates that the unzipping was done incorrectly. 
  4. Take a backup of the NX.ENV directory, located at the CA SDM install directory (NX_ROOT).
  5. Modify NX.ENV as follows:
    @NX_TOMCAT_INSTALL_DIR=C:\Program Files\CA\SC\tomcat\8.5.16
  6. Backup NX_ROOT\bopcfg\www\CATALINA_BASE\conf and the following directories (whichever exist):
    • $NX_ROOT\bopcfg\www\CATALINA_BASE_SA\conf
    • $NX_ROOT\bopcfg\www\CATALINA_BASE_REST\conf
    • $NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ\conf
    • $NX_ROOT\bopcfg\www\CATALINA_BASE_FS\conf
    • $NX_ROOT\bopcfg\www\CATALINA_BASE_WF\conf
  7. Copy all the files:
    • From <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\conf to NX_ROOT\bopcfg\www\CATALINA_BASE_SA\conf
    • From
       
      <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\conf to NX_ROOT\bopcfg\www\CATALINA_BASE\conf
    • From <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\conf to NX_ROOT\bopcfg\www\CATALINA_BASE_VIZ\conf
    • From <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\conf to NX_ROOT\bopcfg\www\CATALINA_BASE_FS\conf
    • From <drive>:\<install_directory>\CA\SC\tomcat\8.5.16\conf to NX_ROOT\bopcfg\www\CATALINA_BASE_REST\conf
  8. 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. Complete the following steps to verify:
    1. <Server port="8085" shutdown="SHUTDOWN">
    2. <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
    3. Ensure no other ports are used as follows. If it is used, you must comment them according to the original server.xml file.
      <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
    If any other changes were made to the original server.xml file, then make the same changes to the new server.xml file.
  9. Edit 
    NX_ROOT\bopcfg\www\CATALINA_BASE\conf\catalina.properties
     using the text editor and modify the 
    shared.loader=
     
     to the following as shown below:
    shared.loader=${catalina.base}/shared/lib/*.jar
    Save the file.
  10. For REST Tomcat, open and edit the 
    NX_ROOT\bopcfg\www\CATALINA_BASE_REST\conf\catalina.properties
     file and locate the line 
    common.loader=
     and modify the following:
    common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar"
    to 
    common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.base}/../../../java/lib/CXF/*.jar"
    After making the above changes, Restart REST Tomcat or CA SDM.
  11. If CA Support Automation is installed, verify that the server.xml file located at NX_ROOT\bopcfg\www\CATALINA_BASE_SA\conf has the same startup (connector) and shutdown ports as defined in the original server.xml file.
    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.
  12. Modify config.properties located at NX_ROOT\site, as follows:
    web.tomcat_home=<drive>\:\\<install_directory>\\CA\\SharedComponents\\tomcat\\8.5.16 
    web.tomcat.version=8.5.16 
    web.cawf_tomcat_home==<drive>\:\\<install_directory>\\CA\\SharedComponents\\tomcat\\8.5.16
    web.tomcat.service_name=Apache Tomcat 7.0
    To
    web.tomcat.service_name=Apache Tomcat 8.5 
  13. If CA Advanced Workflow is installed, copy the pm.xml and wl.xml files from the backup of the conf directory you created in step 6 to the following location:
    <drive>:\<install_directory>\CA\Service Desk Manager\bopcfg\www\CATALINA_BASE_WF\conf\Catalina\localhost
    If this step is not performed then the applications will not deploy properly when Tomcat is started.
  14. Start Service Desk.
    Similar to Support Automation, if Visualizer, Federated Search or REST Tomcats are installed, then appropriate changes can be performed similar to the approaches as suggested from step 1 to step 9.
  15. Apply the following Support Automation Digital Patches:
    • For CA SDM 12.9:
      OS
      Patch
      Windows  
      RO81494
      Linux
      RO81495
      AIX
      RO81496
      Solaris
      RO81497
    • For CA SDM 14.1:
      OS
      Patch
      Windows  
      RO81482
      Linux
      RO81483
      AIX
      RO81484
      Solaris
      RO81485