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.
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. As an example, install the updated one in the folder, apache-tomcat_new. You will then need to move any installed web applications and configuration files to the new server. Note, it is not possible to copy the server.xml config file as is, only stanzas that were added need to be inserted in the new configuration since the rest of the content changes from version to version.
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. To do this, install from a different location than you originally installed AP to avoid reusing the installer.properties. During installation, either install into a different folder (apache-tomcat_new) or rename the apache-tomcat folder (apache-tomcat-back) and install into the default location. Once installed, follow the same procedures as above for updating the webapps and configuration.
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.
You may follow these steps when upgrading Apache Tomcat:
- Stop Apache Tomcat (catalina process)
- Backup existing /nastel/AutoPilotM6/apache-tomcat directory
- Download and install updated Apache Tomcat
- You will then need to move 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 and server.xml (as mentioned above, it is not possible to copy the server.xml config file as is, only stanzas that were added need to be inserted 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, copy catalina.sh (no need to copy the whole file, only the contents of the environment variables if there are any)
- From /lib directory, copy JDBC driver
- Start Apache Tomcat (catalina.sh for Unix, or catalina.bat for Windows) and test your web applications (navigator, apodwsm)