Installing Tomcat
The Tomcat servlet container is called Catalina. In the Tomcat Catalina documentation, you may see the installation directory referred to as CATALINA_HOME. However, for Arbortext Publishing Engine, we'll refer to the Tomcat Catalina installation directory as TOMCAT_HOME.
Apache Tomcat is included in the DVD and download archive for Arbortext Publishing Engine in the \server\tomcat directory.
To install Tomcat 8.0 on Windows
1. Uninstall your previous version of Tomcat.
2. From the Arbortext Publishing Engine distribution archive, locate server\tomcat\apache-tomcat-8_0_22.exe.
3. Install Tomcat in the location of your choice. You'll need to remember this path as TOMCAT_HOME. You'll be prompted to confirm the location of the Java Virtual Machine that Tomcat should use.
4. Make sure you choose to install Tomcat as a service. Keep the default Windows service name to allow Arbortext Publishing Engine Configuration to start and stop the service.
5. Make sure you choose the Apache Portable Runtime (APR) as well.
6. If you will be transmitting file names that contain non-ASCII characters to Arbortext Publishing Engine for publishing, you will need to be sure the URLs are properly encoded for UTF-8. You need to add the URIEncoding attribute to each active Connector in the Tomcat server.xml configuration file (such as the one that enables HTTPS support). Enter the attribute and value URIEncoding="UTF-8", like the following example.
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8333" URIEncoding="UTF-8" />
Consult the Tomcat documentation for information on URI encoding.
7. All the other choices are optional for Arbortext Publishing Engine. Tomcat's documentation and sample applications are optional but helpful.
|
You must also ensure that Tomcat is configured in line with current security best practices.
|
By default, the Windows service is named is named Tomcatn, where n is the major release number of Tomcat (for example, Tomcat8). Do not rename the Tomcat service because the Arbortext Publishing Engine Configuration utility will not be able to find it. Having a different name prevents the ability of Arbortext Publishing Engine Configuration to start and stop the service.
For more information about using
Arbortext Publishing Engine Configuration to manage integration with Tomcat, see the
Configuration Guide for Arbortext Publishing Engine.