User Tools

Site Tools


replicator_agent_upgrade_java

Agent Upgrading Java

If you are upgrading your Java version or moving from 32 bit to a 64 bit version of Java here are the steps necessary to do so.

Note: 64 Bit Java is supported on windows following the Argon release of the Replicator Agent.

Upgrade Process

The upgrade process is relatively simple, assuming you download the correct Java version. The steps are to

  1. Stop the Replicator Agent
  2. Modify the path for Java
  3. Start the Agent

To modify the path for Java you will open up the Replicator Agent's conf directory and open up the file wrapper.conf.

Argon Version and above

At the bottom of this file there should be the following lines corresponding to the installed directory of Java and your current version.

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_131

Modify the set.JAVA_HOME variable to the location of your new version of Java. In this case I am upgrade from Java 1.8.0_131 to 1.8.0_144.

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_144

Version below 3.24.0

At the bottom of this file there should be the following lines corresponding to the installed directory of Java and your current version.

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_131
wrapper.java.command=%JAVA_HOME%\bin\java
wrapper.java.additional.3=-Dfile.encoding=UTF-8

Modify the set.JAVA_HOME variable to the location of your new version of Java. In this case I am upgrade from Java 1.8.0_131 to 1.8.0_144.

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_144
wrapper.java.command=%JAVA_HOME%\bin\java
wrapper.java.additional.3=-Dfile.encoding=UTF-8

Troubleshoting

If you did not perform these steps and the version of Java was upgraded on the Agent's VM than it will run into issues. It will likely crash and fail to start up. You may see a message like the following:

Windows could not start the Perspectium Replicator Agent service on Local Computer.
Error 1067: The process terminated unexpectedly

Or similar messages in the Replicator Agent's log file:

replicator_agent_upgrade_java.txt · Last modified: 2017/10/16 10:59 by jackson.davenport