AutoPilot ships a version of Apache Tomcat to simplify getting started. Once installed, this version is not maintained by Nastel service updates. Configuration such as LDAP security policies or SSL can be setup for this server, and Nastel support can assist, but we cannot provide the necessary certificates or credentials.
Alternately, we support running our web applications in an application server supported by your normal support teams. With this method, you do not have to install or maintain the AutoPilot Tomcat server.
If you chose to use the sample version, in the case of security exposures, you may want to upgrade your tomcat server. There are 2 options for this.
A current version of Apache Tomcat can be downloaded and installed separately either from the apache downloads directly or as an update package or deployment pack. You will then need to move any installed web applications and configuration files to the new server. Note, it may not be possible to copy the server.xml config file as is depending on which versions you are migrating from and to. In this case, only stanzas that were added need to be inserted in the new configuration since the rest of the content changes from version to version. Renaming the existing apache-tomcat folder and installing the new apache into apache-tomcat is the quickest method.
The AutoPilot full installation Domain package is periodically updated with recent versions of Apache Tomcat (see the release notes for the most recent domain package for details). It is possible to rerun the domain installation package and select just the web component to install that version. When doing this, install from a different location than you originally installed AP to avoid reusing the installer.properties. During installation, installing into a different folder also ensures the existing installation is not changed. Once installed, follow the same procedures as above for updating the webapps and configuration.
Note: Some versions of Tomcat may also require later versions of Java. Ensure your installed java meets the minimum. If you need to update Java, see related FAQ.
As an example, you may follow these steps when upgrading Apache Tomcat on Linux:
- Stop Apache Tomcat (catalina process)
- Rename (recommended) or backup existing /nastel/AutoPilotM6/apache-tomcat directory
- Download and install updated Apache Tomcat either as apache-tomcat (recommended) or a new folder
- You will then need to copy any installed web applications and configuration files to the new server. Copy the following files from the old installation to the new one in the same directory structure:
- From /conf directory, copy tomcat-users.xml but you must edit server.xml as it is not possible to copy as is. Copy the stanzas that were added and insert into the new configuration since the rest of the content changes from version to version.
- From /webapps directory, copy all .war files
- From /bin directory, edit catalina.sh copy the AutoPilot environment variables settings found at the top of the existing script to the new one.
- From /lib directory, copy JDBC drivers
- Start Apache Tomcat catalina.sh and test your web applications (navigator, apodwsm)