User Tools

Site Tools


replicator_agent_upgrade_java

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

replicator_agent_upgrade_java [2017/10/16 10:59] (current)
jackson.davenport created java upgrade
Line 1: Line 1:
 +====== 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 
 +  - Stop the Replicator Agent
 +  - Modify the path for Java
 +  - 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.
 +
 +<​code>​
 +set.JAVA_HOME=C:​\Program Files\Java\jre1.8.0_131
 +</​code>​
 +
 +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.
 +
 +<​code>​
 +set.JAVA_HOME=C:​\Program Files\Java\jre1.8.0_144
 +</​code>​
 +
 +====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.
 +
 +<​code>​
 +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
 +</​code>​
 +
 +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.
 +
 +<​code>​
 +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
 +</​code>​
 +
 +===== 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:
 +
 +{{::​javaupgrade_servicefailedtostart.jpg|}}
 +<​code>​
 +Windows could not start the Perspectium Replicator Agent service on Local Computer.
 +Error 1067: The process terminated unexpectedly
 +</​code>​
 +
 +Or similar messages in the Replicator Agent'​s log file:
 +{{:​javaupgrade_failedtostartlogs.jpg|}}
replicator_agent_upgrade_java.txt ยท Last modified: 2017/10/16 10:59 by jackson.davenport