How to Upgrade JasperServer's Apache Tomcat minor version

Products

• CA Identity Suite

Issue/Introduction

This document will describe how to upgrade the JasperServer Tomcat engine's minor version on a Windows server. 

A minor version upgrade is one within the same overall version, for example from Tomcat 9.0.90 to 9.0.93 

Environment

JasperServer 8.2 
Apache Tomcat
Windows

Resolution

 

How to upgrade the minor version of Tomcat. 

1.  Open the Windows Services panel and locate the Apache Tomcat service being used and open the properties:

Make note of the Executable Path.  Example from above screenshot:

"C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin\Tomcat9.exe" //RS//Tomcat9

 

2.  Open Windows Explorer and navigate to the Tomcat bin directory.  From the above Executable Path:

C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin

3. Locate and Run the Tomcat9w.exe 

NOTE:
If this does not exist, then copy the tomcat9.exe and rename it to tomcat9w.exe

4.  Take a screenshot or otherwise record the account set on the 'Log On' tab

 

5.  On the Java tab, backup all Java Parameters

The following are examples, you will need to confirm each for the specific installation of JasperServer:

Java Virtual Machine:
C:\Program Files\Eclipse Adoptium\jdk-8.0.372.7-hotspot\jre\bin\server\jvm.dll

Java ClassPath:
C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin\bootstrap.jar;C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin\tomcat-juli.jar

Java Options: 
-Dcatalina.home=C:\Program Files\Apache Software Foundation\Tomcat 9.0
-Dcatalina.base=C:\Program Files\Apache Software Foundation\Tomcat 9.0
-Djava.io.tmpdir=C:\Program Files\Apache Software Foundation\Tomcat 9.0\temp
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-Djava.util.logging.config.file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf\logging.properties

Java 9 Options:
--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.io=ALL-UNNAMED
--add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED

Initial Memory Pool:
1024

Maximum Memory Pool:
2048

Thread stack Size:
2000

6. Perform the Tomcat provided steps to upgrade Tomcat 

a. Backup existing \Apache Software Foundation\Tomcat 9.0\ folder.

b. Downloaded the 9.0.93 Windows 64bit ZIP from:
https://tomcat.apache.org/download-90.cgi 

c. Extract the zip contents to a different folder from the original Tomcat installation. 

d. Copy the contents of the /Tomcat/ directory from the extracted location, and overwrite the existing /tomcat/ directory.

If there is an error copying on the /bin/ folder:

Open Task Manager and kill the Apache Commons Daemon Service Runner service, then click "Try Again" 

7.  Once completed open the tomcat9w.exe and replace any missing or changed variables under the "Log On" and "Java" tabs from step 5.

 

Tomcat should now be version 9.0.93. 

Additional Information

Broadcom does not distribute Tomcat Apache, the process described in this document is provided as a curtesy to help our clients running JasperServer on the Tomcat engine, and should be performed with the assistance of your Tomcat Administrator. 

If you encounter an error "Invalid License" jasperserver.license was not found  please see KB 265720 Jasper Invalid license

1) Located Jasperserver.license file under Jasper installation package



It can also be found under the user that did the original installation in a folder similar to: C:\Users\install_user\

2) Copy and place the jasperserver.license in Windows\system32\config\systemprofile folder and restarted the tomcat engine.