DTP ships with a fixed instance of Tomcat server that is used to run the applications included with DTP. 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 and cannot wait until for the next DTP release, 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.

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:

  1. Stop DTP Server, Data Collector, and Enterprise Pack. See Stopping DTP Services.

  2. Download the Tomcat version to which you wish to upgrade (for example, apache-tomcat-<VERSION>.tar.gz) to download_dir and unarchive the .gz file:

    tar -xvzf apache-tomcat-<VERSION>.tar.gz

  3. Rename the directory to tomcat:

    mv apache-tomcat-<VERSION> tomcat

  4. Delete web apps shipped with tomcat:

    cd tomcat/webapps
rm -rf *

  5. 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

  6. Copy the new tomcat directory into the <DTP_INSTALL> directory. This will upgrade Tomcat shipped with DTP:

    cp -rfv download_dir/tomcat/ <DTP_INSTALL>/ > cp.txt

  7. Verify that copy command has executed successfully by checking the cp.txt file

  8. If there are multiple versions of ecj-<VERSION>.jar libraries, remove the existing ecj-<VERSION>.jar library that is no longer needed:

    rm <DTP_INSTALL>/tomcat/lib/ecj-<VERSION>.jar

  9. Copy the configuration files you saved from the original <DTP_INSTALL>/tomcat/conf/ directory (step 5) into the <DTP_INSTALL>/tomcat/conf/:

    cp server.xml <DTP_INSTALL>/tomcat/conf/
cp catalina.properties <DTP_INSTALL>/tomcat/conf/
cp <YOUR_KEYSTORE_FILE> <DTP_INSTALL>/tomcat/conf/.keystore

  10. Start DTP Server, Data Collector, and Enterprise Pack. See Starting DTP Applications.

  • No labels

Need assistance? Visit our support page