This procedure explains how to upgrade a point release of Apache Tomcat.
For more information on the supported releases, see Compatible web application servers in Talend Data Fabric Installation Guide.
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, the new files must be downloaded and must
replace the existing installation. Some files from the following folders will need to be
migrated:
Procedure
-
Download Apache Tomcat from https://tomcat.apache.org/download-90.cgi
-
Check the Apache Tomcat configuration file differences from 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.
-
Stop Talend Identity and Access Management.
-
Rename the existing apache-tomcat folder to
OLDapache-tomcat, for example.
Example: The folder name must not start with
apache.
-
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
permissions set for OLDapache-tomcat.
-
Copy the contents of OLDapache-tomcat\conf to
\iam\apache-tomcat\conf.
-
Copy the contents of OLDapache-tomcat\webapps to
\iam\apache-tomcat\webapps.
The following five folders are already existing from Apache Tomcat and can be
deleted if you do not need them in your production environment:
-
docs
-
examples
-
host-manager
-
manager
-
root
-
Copy the following files from OLDapache-tomcat\bin to
\iam\apache-tomcat\bin:
-
For Windows installations, you also need to copy the following files from
OLDapache-tomcat\bin to
\iam\apache-tomcat\bin:
-
Copy the following folders from OLDapache-tomcat to
\iam\apache-tomcat:
- app
- clients
- idp
- oidc
- syncope
-
Copy ststrust from OLDapache-tomcat
to \iam\apache-tomcat.
-
Copy the following JARs 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
-
Comment the following line from the
\iam\apache-tomcat\conf\server.xml file.
<Connector port="9009" protocol="AJP/1.3" redirectPort="9443"
/>
-
Start Talend Identity and Access Management.