Install and Configure Apache Tomcat 7.0.59

CA SDM 14.1 provides out-of-the-box Apache Tomcat 7.0.23. This topic provides information to upgrade to Apache Tomcat 7.0.59.
casm1401
CA SDM 14.1 provides out-of-the-box Apache Tomcat 7.0.23. This topic provides information to upgrade to Apache Tomcat 7.0.59.
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 7.0.59 (apache-tomcat-7.0.59.zip) from http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.59/bin/
    CA SDM supports service packs and point releases of Operating Systems, Databases, Web Servers, Web Browsers, Java, Servlets, and so on. This may not be noted in the certification matrix as long as the reported problem is reproducible with versions that are listed in the matrix. CA reserves the right to refuse support of new point releases should the reported problem require a major rework or redesign to function properly. Both Technical Support and Sustaining Engineering does 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 you to escalate your request for certification to your local account team.
  3. Unzip apache-tomcat-7.0.59.zip and copy the files at <drive>:\<install_directory>\CA\SC\tomcat\7.0.59
    After unzipping, ensure that <drive>:\<install_directory>\CA\SC\tomcat\7.0.59 contains conf, bin, webapps, and other directories.
    <drive>:\<install_directory>\CA\SC\tomcat\7.0.59 must NOT contain <drive>:\<install_directory>\CA\SC\tomcat\7.0.59\apache-tomcat-7.0.59. 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\7.0.59
  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 files from
     <drive>:\<install_directory>\CA\SC\tomcat\7.0.59\conf 
    to 
    NX_ROOT\bopcfg\www\CATALINA_BASE\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 
    shared.loader=
    as 
    shared.loader=${catalina.base}/shared/lib/*.jar. 
    Save the file.
  10. 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.
  11. Modify config.properties located at NX_ROOT\site, as follows:
    web.tomcat_home=<drive>\:\\<install_directory>\\CA\\SharedComponents\\tomcat\\7.0.59 
    web.tomcat.version=7.0.59 web.cawf_tomcat_home==<drive>\:\\<install_directory>\\CA\\SharedComponents\\tomcat\\7.0.59
  12. 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.
  13. 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.
  14. 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