Troubleshooting Steps for Tomcat Upgrade Failure

Troubleshooting Steps for Tomcat Upgrade Failure

  1. Verify Folder Existence:
    Check if the ApplicationsManager/working/apache/tomcat_new_9 folder exists. If it does, please delete this folder.

  2. Download and Extract Tomcat:

    1. Download the required zip file from the following link:
      Tomcat 9 Download

    2. Extract the content and locate the tomcat_new_9 folder.

    3. Copy tomcat_new_9 to the AppManager/working/apache/ directory.

  3. Rename the Existing Tomcat Folder:

    1. Rename the existing AppManager/working/apache/tomcat folder to include the base build version, e.g., tomcat_old_9_16861.

  4. Rename the New Tomcat Folder:

    1. Rename the newly copied AppManager/working/apache/tomcat_new_9 folder to tomcat.

  5. Copy Keystore File:

    1. Copy appmanager.keystore from the old Tomcat directory (AppManager/working/apache/tomcat_old_9_16861) to the new Tomcat directory (AppManager/working/apache/tomcat) if exists.

  6. Copy Configuration Backup:

    1. Copy the content of the conf/backup folder from the previous Tomcat directory (AppManager/working/apache/tomcat_old_9_16861/conf/backup) to the conf folder in the new Tomcat directory (AppManager/working/apache/tomcat/conf).

  7. Copy the Webapps Folder:

    1. Copy the webapps folder from the previous Tomcat directory (AppManager/working/apache/tomcat_old_9_16861/webapps) to the new Tomcat directory (AppManager/working/apache/tomcat) if exists.

  8.  Update Keystore and Truststore Files in server.xml  

    1. Open the server.xml file in the AppManager/working/apache/tomcat_old_9_16861/conf/backup directory.

    2. Locate the <Connector> element(s) with the SSLEnabled attribute set to true.

    3. Note down the paths for truststoreFile and keystoreFile attributes, if they exist.

    4. Copy the noted files (e.g., keystore and truststore) from the old Tomcat directory to the same relative location in the new Tomcat directory i.e AppManager/working/apache/tomcat.

    5. Update the server.xml file in the new Tomcat configuration to reflect these paths if necessary.

  9. Update TLSv1.3 Ciphers

    1. Open the server.xml file in the AppManager/working/apache/tomcat/conf/backup directory.

    2. Locate the <Connector> element(s) with the SSLEnabled attribute set to true.

    3. Add or set useServerCipherSuitesOrder="true" in the <Connector>

    4. Update Ciphers:

      1. Check the ciphers attribute. If it exists, prepend TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256

      2. If the ciphers attribute is missing, add it as: ciphers="TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256"


                  New to ADSelfService Plus?