DTP ships with a fixed instance of Tomcat server that is used to run the applications included with DTP. Refer to the release notes for information about any Tomcat upgrades associated with each release. The following instructions are intended to provide guidance The version of Tomcat that ships with DTP is the only one that has been verified to work with it, but if you need to upgrade the Tomcat server shipped with DTP and cannot wait until for the next DTP release. The example instructions below pertain to the following specific upgrade scenario, but the same general process can be used for subsequent versions of DTP and Tomcat:
...
, the following instructions are provided as guidance. This should be done to upgrade Tomcat only; do not attempt to downgrade Tomcat. The procedure below has some Linux-specific details, but it applies generally to any OS.
| Note |
|---|
...
We cannot verify that |
...
any |
...
given version |
...
of DTP will function as expected |
...
with any version of Tomcat other than the one with which it was shipped. This procedure is provided for reference only; upgrading your Tomcat server on your own is not recommended. |
To upgrade your Tomcat server:
- Stop DTP Server, Data Collector, and Enterprise Pack. See Stopping DTP Services.
Download the Tomcat version to which you wish to upgrade (for example, apache-tomcat-9.0.41<VERSION>.tar.gz) to download_dir and unarchive the .gz filegz file:
Code Block language bash theme Midnight tar -xvzf apache-tomcat-9<VERSION>.0.41.tar.gz
Rename the directory to
tomcat:Code Block language bash theme Midnight mv apache-tomcat-9.0.41<VERSION> tomcat
Delete web apps shipped with
tomcat:Code Block language bash theme Midnight cd tomcat/webapps rm -rf *
Make copies of the following configuration files and save them outside <DTP_INSTALL>:
<DTP_INSTALL>/tomcat/conf/server.xml
<DTP_INSTALL>/tomcat/conf/catalina.properties
(Optional) Your keystore file if you are using a file other than the .keystore file shipped with DTP in the <DTP_INSTALL>/tomcat/conf/ directory
Copy the new
tomcat(9.0.41) directory into the <DTP directory into the <DTP_INSTALL> directory. This will upgrade Tomcat shipped with DTP:Code Block language bash theme Midnight cp -rfv download_dir/tomcat/ <DTP_INSTALL>/ > cp.txt
Verify that copy command has executed successfully by checking the cp.txt file
Remove the existing
ecj-4.15<VERSION>.jarlibrary that is no longer needed:Code Block language bash theme Midnight rm <DTP_INSTALL>/tomcat/lib/ecj-4.15<VERSION>.jar
Copy the configuration files you saved from the original <DTP_INSTALL>/tomcat/conf/ directory (step 5) into the <DTP_INSTALL>/tomcat/conf/:
Code Block language bash theme Midnight cp server.xml <DTP_INSTALL>/tomcat/conf/ cp catalina.properties <DTP_INSTALL>/tomcat/conf/ cp <YOUR_KEYSTORE_FILE> <DTP_INSTALL>/tomcat/conf/.keystore
Start DTP Server, Data Collector, and Enterprise Pack. See Starting DTP Applications.