Upgrading the Tomcat application

This version of TrueSight Smart Reporting - Platform contains an inbuilt Apache Tomcat application version 9.0.30. You can upgrade the Tomcat application to a 9.0.x version that is later than 9.0.30.

Important: Monitor and control Tomcat upgrades

The TrueSight Smart Reporting - Platform installer does not include a Tomcat upgrade. Ensure that you monitor and control Tomcat upgrades to mitigate security risks.

Do the following:

  1. Download a Tomcat application to a 9.0.x version that is later than 9.0.30 from the following website:
    https://tomcat.apache.org/download-90.cgi

  2. Stop the TrueSight Smart Reporting - Platform service.
  3. Take a backup of the following directories:
    • <install_directory>/appserver/lib
    • <install_directory>/appserver/bin
  4. Delete all files from the <install_directory>/appserver/lib directory.
  5. From the Tomcat directory that you downloaded, copy all .jar files from the /lib directory.
  6. From the /bin directory, copy the following files and paste them into the <install_directory>/appserver/bin folder:
    • All .jar files.
      If there are any files with the same name, replace them.
    • (Windows) All tomcatx executable files, where x is the version number.
      For example tomcat9.exe, tomcat9.exe.x64, and tomcat9w.exe
  7. Ensure that the files in the following directories are given all permissions as before:
    • <install_directory>/appserver/lib
    • <install_directory>/appserver/bin
  8. Open the <install_direcotory>/appserver/conf/server.xml file.
  9. Search for the Connector tag and add the following parameter at the end of the tag:
    server="Application Server"
    For example, see the following image:
    tomcat.PNG
     
  10. Start the TrueSight Smart Reporting - Platform service.
  11. Verify that Tomcat application is upgraded. Do the following:
    1. Run the following URL:
      https://<hostname>:<port>/info.jsp
    2. Verify that the Application Sever property displays the upgraded application version.

 

 

 

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*