This shows you the differences between two versions of the page.
— |
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|}} |