Changing the JRE of UrbanCode Deploy Server and Agents

Beginning in version 6.2.2, the IBM UrbanCode Deploy Server (and agent relays) require Java Runtime Environment (JRE) or Java Development Kit (JDK) version 8.

Are you planning an update of your uDeploy Server and Agents? Do you have an old JRE?  Here the steps to update you JRE*:

*The new JRE must be from the same vendor as the current JRE

Changing or updating the JRE of Server
  • Install the new JRE
  • Stop the Server
  • Update the location of the JRE in the following files:
    • In the file
      server_install/bin/set_env

      set the value of the JAVA_HOME system variable to the location of the JRE.

    • In the file
      server_install/conf/server/installed.properties

      set the value of the install.java.home property to the location of the JRE.

  • Start the Server

Changing or updating the JRE of Agents
  • Install the new JRE
  • On the Agent system, stop the Agent. Do not use the server UI to stop it.
  • Update the location of the JRE in the following places:
    • 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

  • 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.

Operations Engineer working with Cloud Infrastructure, Containers, Kubernetes, CI/CD pipelines, CDRA processes, GitOps.