You can change the JRE of active servers by editing their configuration
files.
Important: Beginning in
version 7.0.2, the IBM® UrbanCode® Deploy server and
agent relays require a Java™ Runtime Environment
(JRE) or Java Development Kit (JDK) version
11.
Note:
- Any certificates that you imported to the old JRE cacerts file must be imported into
your new JRE cacerts file as well. SeeConfiguring SSL on Apache Tomcat and LDAP servers for more
information.
- Starting from v7.2.1, the keystore converter utility is no more needed, and IBM UrbanCode Deploy handles any
necessary conversions itself.
-
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 with
IBM UrbanCode 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.