Updating the JRE location for agents

If you upgrade the JRE and change the JRE location on agents, you must also update the JRE location in the agent Java configuration file.

  • Verify the supported Java version for agents. See Prerequisite software.
  • You have installed the new JRE on the target agent and set the JAVA_HOME environment variable of the system.
Important: Do not use the server UI to restart the agent.
  1. On the agent system, stop the agent.
  2. Edit the location of the JRE in the Java home configuration file.
    • On Linux™ or AIX, edit the installation_directory/conf/agent/javahome file.
    • On Windows™, edit the installation_directory\conf\agent\javahome.conf file.
      Note: For example, add the new location of the JRE on Windows as:
      C:\Program Files\Java\jdk-17.0.0
    • If the agent is running as a service on Windows, remove and reinstall the service. See Removing and reinstalling agents as Windows services.
      Note: For the Windows service of agents, you must update the JAVA_HOME property in installation_directory\conf\agent\javahome.conf file with the new location of Java, and then recreate the Windows service.
  3. On the agent system, start the agent.
You have updated the JRE of the active agents.