Updating the JDK after installation

If the Sterling Order Management System Software installation directory contains a JDK, you can use the updateJDK tool to update the JDK in the Sterling Order Management System Software run time.

About this task

For example, if you upgrade the JDK to a new version, you must replace the JDK in the Sterling Order Management System Software run time with the new version JDK.
Note:
  • If your Sterling Order Management System Software installation directory does not contain a JDK, you cannot use the updateJDK tool to update your JDK for Sterling Order Management System Software. Instead, copy the following jar files, which are included in the IBM Sterling Order Management System Software software installer image, to the <JAVA_HOME>/jre/lib/endorsed directory:
    • serializer.jar
    • xalan.jar
    • xercesImpl.jar
    • xml-apis.jar
    If the endorsed directory is not present in <JAVA_HOME>/jre/lib, create a new directory and name it endorsed.

Procedure

  1. In the <INSTALL_DIR>/bin directory, invoke the following command:
    • Windows updateJDK.cmd REPLACE <path to new JDK>
    • UNIXLINUX updateJDK.sh REPLACE <path to new JDK>

    where,

    <path to new JDK> is the location of the new version JDK.

    The updateJDK REPLACE command performs the following tasks:
    • moves the existing JDK from <INSTALL_DIR>/jdk to <INSTALL_DIR>/jdk_<timestamp>

      where,

      <timestamp> is the time when jdk_<timestamp> is created.

      If you want to restore the old JDK for any reason, you can locate the directory at <INSTALL_DIR>/jdk_timestamp.

    • copies <path to new JDK> to <INSTALL_DIR>/jdk.
    • copies the following jar files into <INSTALL_DIR>/jdk/jre/lib/endorsed:
      • serializer.jar
      • xalan.jar
      • xercesimpl.jar
      • xml-apis.jar
  2. To verify the Java version that Sterling Order Management System Software is using, go to the <INSTALL_DIR>/bin directory and run the ./setupfiles.sh command for Linux or the setupfiles.cmd command for Windows.