Changing or updating the JRE of servers#
You can change the JRE of active servers by editing their configuration files.
The new JRE must be from the same vendor as the current JRE.
Important: Beginning in version 6.2.2, the UrbanCode™ Deploy server and agent relays require a Java™ Runtime Environment (JRE) or Java Development Kit (JDK) version 8.
-
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. 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 JAVA_HOME system variable and install.java.home property because they now point to the new JRE.
Note: The value of the JAVA_HOME system variable must match the value of the install.java.home property.
Note: If you are upgrading to Java 9 or above and are moving off Oracle Java to AdoptOpenJDK you must manually remove the -Djava.endorsed.dir entry from the server_install/bin/set_env file.
-
If the server is running as a service on Windows:™
-
Open the file server_install\bin\service\_service.cmd in a text editor.
-
Edit the line that starts with the code
set JAVA_HOME
to the path to the new JRE. -
Open a command prompt as an administrator.
-
Go to the server_install\bin\service folder.
-
Remove the service by running the following command:
service.cmd remove service\_name
Use the name of the service for
service\_name
. To find the service name, open the services view and find the entry that starts withUrbanCode Deploy
. The service name is in parentheses in this entry. -
Reinstall the service by running the following command:
service.cmd install service\_name
-
-
Start the server.
Parent topic: Server settings and configuration