Periodically you may need to update java on the server hosting AutoPilot. In many cases, this is transparent to AutoPilot Domain, CEP and web services. However, if you encounter problems, this document provides steps required.
Linux is generally more forgiving than Windows. But in both cases, if java is in the path, there should be no requirement to make additional changes, however, should you need to, follow the instructions using the guidelines below.
We recommend that a 64 bit Java is installed by your server administrators. This allows regular maintenance to be applied and is generally transparent to AutoPilot as we certify versions well in advance of most customers installing them. In these cases, you will get the java location from the system.
Note: Installing the new version in the same location as the old version can simplify steps related to changing the location.
Note when using an Express Deployment Pack installation option on Linux
With the express options, such as the deployment pack, using tar files for Navigator and XRay, the java location is one level above the AutoPilotM6 folder. It is referenced using a link "current." To install a new version, stop all services, point the link to the new location and restart.
How AutoPilot finds the java version
If no other JRE is available, the location of the java executable is stored within lax files (ATPNAMES.lax, ATPNODE.lax and so on). You will need to edit each of these files to change to the new location. Edit each file and change the current setting to either a specific or relative path. For example:
lax.nl.current.vm=C:\\nastel\\AutoPilotM6\\Java\\bin\\java.exe
I changed java and received an error that server is not available
The most common error when starting the service is an error stating that the server is missing. If this occurs, edit the lax files and locate the optional parameters line and remove -server, retaining any other parameters you may have specified. For example:
lax.nl.java.option.additional=-Djava.awt.headless=true ...
If you get an error that indicates the wrong major version, this indicates that you are using a version of java that is too old. Review the AutoPilot release notes for the specific version required.
Apache Tomcat on Windows using an AutoPilot domain install
For Windows, you need to set JAVA_HOME and then delete and reinstall the service. At a command prompt enter the command m6service remove|install and follow the instructions provided. You can also choose to reinstall the Apache Tomcat service using the instructions in this FAQ.
I installed Apache Tomcat on Unix/Linux using an AutoPilot domain install
On Linux, the Apache Tomcat server sets the location for java during installation. You can modify this script to change the explicit location to using a variable (such as JAVA_HOME) to simplify changing java versions. Edit Catalina.sh and change the line that says:
JAVA_HOME=/your/java/path
You can also choose to reinstall the Apache Tomcat service using the instructions in this FAQ.