Changing or updating the JRE of agents
You can change the JRE of active agents by editing their configuration files.
- Install the new JRE.
-
On the agent system, stop the agent.
Do not use the server UI to stop the agent.
-
If the agent is installed on Linux™, update the
location of the JRE in the following places.
Note: As a shortcut, you can delete the old JRE and move the new JRE into the location of the old JRE. In this case, you do not need to update the properties in the following files because they now point to the new JRE.
- In the file installation_directory/bin/configure-agent, set the value of the JAVA_HOME property to the location of the JRE.
- In the file installation_directory/bin/agent, set the value of the JAVA_HOME property to the location of the JRE.
-
In the file
installation_directory/conf/agent/installed.properties,
set the value of the IBM\ UrbanCode\ Deploy/java.home property to
the location of the JRE.
If the JRE is in /opt/ibm/java-x86_64-110/jre, use the following code:
IBM\ UrbanCode\ Deploy/java.home=/opt/ibm/java-x86_64-110/jre
-
If the agent is installed on Windows™, update the
location of the JRE in the following places.
Note: As a shortcut, you can move the new JRE into the location of the old JRE. In this case, you do not need to update the properties in the following files because they now point to the new JRE.
- In the file installation_directory\bin\configure-agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
- In the file installation_directory\bin\agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
- In the file installation_directory\bin\service\_agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
-
In the file
installation_directory\conf\agent\installed.properties,
set the value of the IBM\ UrbanCode\ Deploy/java.home property to
the location of the JRE.
For example, if the JRE is in C:\Program Files\IBM\Java110\jre, use the following code:
IBM\ UrbanCode\ Deploy/java.home=C\:\\Program Files\\IBM\\Java110\\jre
-
If the agent is running as a service on Windows,
remove and reinstall the service
For the Windows service of agents, you must update the JAVA_HOME property in $agent_install\bin\service\_agent.cmd file with the new location of Java, and then recreate the Windows service.
-
On the agent system, start the agent.
Do not use the server UI to restart the agent because in this case the JRE is not updated.