Skip to main content Skip to complementary content

Upgrading Apache Tomcat used by Talend Identity and Access Management

This procedure explains how to upgrade a point release of Apache Tomcat. For more information on the supported releases, see Compatible web application servers.

This procedure assumes the default installation path for Apache Tomcat with Talend Identity and Access Management. If Apache Tomcat was installed in a different location, make the appropriate path changes.

To upgrade Apache Tomcat to a newer release, you download the new files and replace them in the existing installation. Some files from the following folders must be migrated:

  • \iam\apache-tomcat\conf
  • \iam\apache-tomcat\webapps
  • \iam\apache-tomcat\bin

Procedure

  1. Download Apache Tomcat from Apache Tomcat website.
  2. Compare the Apache Tomcat configuration file against the Apache Tomcat migration guide to verify there are no impacting differences.
    If changes are needed for the versions being upgraded, see the Apache Tomcat documentation for guidance.
  3. Stop Talend Identity and Access Management.
  4. Rename the existing apache-tomcat folder with a name that does not start with apache. For example: OLDapache-tomcat.
  5. Extract the new Apache Tomcat version to the apache-tomcat folder using 7-Zip.
    Make sure the file permissions are set appropriately and are the same as for OLDapache-tomcat.
  6. Copy the contents of OLDapache-tomcat\conf to \iam\apache-tomcat\conf.
  7. Copy the contents of OLDapache-tomcat\webapps to \iam\apache-tomcat\webapps.
    The following folders already exist from Apache Tomcat and can be deleted if you do not need them in your production environment:
    • docs
    • examples
    • host-manager
    • manager
    • root
  8. Copy the following files from OLDapache-tomcat\bin to \iam\apache-tomcat\bin:
    • setenv.sh
    • setenv.bat
  9. Copy the following folders from OLDapache-tomcat to \iam\apache-tomcat:
    • app
    • clients
    • idp
    • oidc
    • syncope
  10. Copy ststrust.jks from OLDapache-tomcat to \iam\apache-tomcat.
  11. Copy the following JAR files from OLDapache-tomcat\lib to \iam\apache-tomcat\lib:
    • h2-1.4.193.jar
    • postgresql-9.4.1211.jre7.jar
    • tomcat-tld-libs-1.3.1-SNAPSHOT.jar
    • bcpkix-jdk15on-1.6.8.jar
    • bcprov-jdk-15on-1.68.jar
    • jakarta.activation-1.2.1.jar
    • jaxb-api-2.3.1.jar
    • jaxws-api-2.3.1.jar
  12. If it is not already commented out, comment the following line from the \iam\apache-tomcat\conf\server.xml file:
    <Connector protocol="AJP/1.3" address="::1" port="9009" redirectPort="9443" />
  13. Start Talend Identity and Access Management.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!