Appendix D - Java Version Change

Owned by Kevin Wu
Last updated: Oct 08, 2024 by Jenni Wallin
2 min read

This section describes how to replace the JDK and JRE products on an existing installation. For information about required third-party products Refer to System Requirements.

Platform Container

To change the Java version on the Platform Container:

  1. Ensure that the memory settings for Java are set correctly in STR.

Container

Default Settings

Container

Default Settings

Platform

Default settings when using an Oracle database:

$ mzsh topo set topo://container:<container>/pico:platform/obj:config.jvmargs \ 'xmx:["-Xmx1024M"] xms:["-Xms128M"] maxMetaspace:["-XX:MaxMetaspaceSize=256M"]

Default settings when using a Derby database:

$ mzsh topo set topo://container:<container>/pico:platform/obj:config.jvmargs \ 'xmx:["-Xmx1024M"] xms:["-Xms192"] maxMetaspace:["-XX:MaxMetaspaceSize=256M"]

EC

Default settings:

$ mzsh topo set topo://container:<container>/pico:<pico-name>/obj:config.jvmargs \ 'xmx:["-Xmx256M"] xms:["-Xms64M"] maxMetaspace:["-XX:MaxMetaspaceSize=196M"] maxDirect:["-XX:MaxDirectMemorySize=4096M"] args : ["-server"]'

  1. Install the new JDK. Do not remove the old version.

  2. Disable all workflow groups from the Execution Manager in Desktop, or by entering an mzsh command, for example:

Note!

If you use the wfgroupdisable command, make sure that you enable all system tasks again when you are done.

  1. Stop all workflows that are not disconnected and let them finish execution.

  2. Ensure that all users shut down any connected Desktops.
    If you want to see which Desktops that are connected, you can use the following command:

Note!

This command will also display other pico instances, such as Execution Contexts.

  1. Shut down the Platform and all ECs.

  2. If you have set the environment variable JAVA_HOME, change it to the install path of the new JDK. Set the variable in both the current shell and the login script. This is only required if you want to override the default value in the mzsh script.

Example - Setting JAVA_HOME in the Shell

  1. Set JAVA_HOME in MZ_HOME/bin/mzsh to the install path of the new JDK.

  1. Start the Platform and ECs.

  2. Start the real-time workflows.

  3. Enable the workflow groups.

Execution Container

To change the Java version on an Execution Container:

  1. Install the new JDK. Do not remove the old version.

  2. If you have set the environment variable JAVA_HOME, change it to the install path of the new JDK. Set the variable in both the current shell and the login script. This is only required if you want to override the default value in the mzsh script.

  1. Set JAVA_HOME in MZ_HOME/bin/mzsh to the install path of the new JDK.

  1. Restart the ECs and Stop the real-time workflows. To minimize downtime, restart the ECs one by one. 

    To restart an EC:

  2. Start the workflows on the restarted ECs.

Legacy Desktop Client

To change the Java version for the Legacy Desktop:

  1. Shut down all connected Legacy Desktops.

  2. Uninstall the existing JDK or JRE.

  3. Install the new JDK or JRE.

  4. Set the environment variable JAVA_HOM to the new JDK/JRE install path.