Upgrade Apache Tomcat via manual filesystem deployment for JasperReports
Article ID: 376891
Updated On:
Products
Issue/Introduction
This document will describe how to upgrade the JasperServer Tomcat on a Windows server.
In this document, we describe upgrading for a minor version upgrade, one within the same overall version, for example from Tomcat 9.0.90 to 9.0.93
The instructions will replace/overwrite the existing Tomcat installation with the target release.
Environment
CA Service Desk Manager 17.4
JasperSoft Server 9.0
All Supported Windows Operating Systems
Resolution
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 or jasperreportsTomcatw.exe as administrator
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 latest Tomcat 9.0.x release Windows 64bit ZIP from:
Tomcat 9 Software Downloads
Note: Do not download the Windows Service Installer of the Tomcat distributable. Download the file that has a ZIP extension
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
We recommend testing all changes/upgrades in a non-PROD environment first.
This instruction set assumes the use of a manual method to install Tomcat, where the binaries are deployed into a filesystem instead of using the Windows installer wizard, in order to create the Tomcat installation. To use the the Windows installer, please review Upgrade Apache Tomcat via Windows Installer for JasperReports
Broadcom does not distribute Tomcat Apache, the process described in this document is provided as a courtesy 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 Jasper Invalid license
Feedback
