Updating IBM Semeru Runtime in IBM Watson Explorer Foundational Components (version 12.0.3.17 or later)

Procedures for Linux:

IBM Semeru Runtime may be present in one or more of the following folders. You need to update it under each of the listed folders.

• /opt/ibm/WEX/Engine/java
• /opt/ibm/WEX/AppBuilder/java
• /opt/ibm/WEX/ZooKeeper/java

Follow the steps after you download the required version of IBM Semeru Runtime for your operating system from Fix Central. The folders and file names used in the steps are shown for example purpose only. Replace the sample file name with the name of the file that you downloaded.

1. Download the required IBM Semeru Runtimes version from IBM Semeru Runtimes Downloads.
   Note: IBM Semeru Runtime version 21 is supported except AppBuilder. AppBuilder supports IBM Semeru Runtime version 8. Using other versions (e.g. 25) causes compatibility issues.
2. Copy the java.tgz file that you downloaded into the directory. Do this for all the folders as shown in the example:
   • cp ibm-semeru-open-jre_x64_linux_21.0.9_10_openj9-0.56.0.tar.gz /opt/ibm/WEX/Engine/java
   • cp ibm-semeru-open-jre_x64_linux_21.0.9_10_openj9-0.56.0.tar.gz /opt/ibm/WEX/ZooKeeper/java
   • cp ibm-semeru-open-jre_x64_linux_8u472b08_openj9-0.56.0.tar.gz /opt/ibm/WEX/AppBuilder/java
3. Shut down the following services in order:
   • service appbuilder-service stop
   • service zookeeper-service stop
   • /opt/ibm/WEX/Engine/bin/velocity-shutdown
4. Uncompress the .tgz file that you copied earlier using gunzip. Do this for all the folders.
   For example, Fgunzip ibm-semeru-open-jre_x64*.tgz
5. Extract the JRE from the tar file. Perform this for all the folders:
   • tar --strip-components=1 -xvf ibm-semeru-open-jre_x64_*.tar
   • Extracting the JRE unpacks the files into the correct locations.
6. Change the ownership of the new files to the correct owner and group, on the directory where you extracted the JRE:
   • cd /opt/ibm/WEX/AppBuilder
     chown -R wex-appbuilder:ibm-wex java
   • cd /opt/ibm/WEX/ZooKeeper
     chown -R wex-zookeeper:ibm-wex java
   • cd /opt/ibm/WEX/Engine/java
     chown -R apache:apache jre properties docs copyright *.txt
7. Restart the following services in order:
   • /opt/ibm/WEX/Engine/bin/velocity-startup
   • service zookeeper-service start
   • service appbuilder-service start

Procedures for Windows:

1. Copy the java .zip file that you downloaded into the directory. Do this for all the folders as shown in the example:
   If you use Windows Explorer, you can drag the .zip file from where you downloaded it to the top level of the Engine directory.
   • copy ibm-semeru-open-jre_x64_windows_21.0.9_10_openj9-0.56.0.zip C:\Program Files\IBM\WEX\Engine
   • copy ibm-semeru-open-jre_x64_windows_21.0.9_10_openj9-0.56.0.zip C:\Program Files\IBM\WEX\ZooKeeper
   • copy ibm-semeru-open-jre_x64_windows_8u472b08_openj9-0.56.0.zip C:\Program Files\IBM\WEX\AppBuilder
2. Shut down the following services in order:
   • Use "Services" to stop AppBuilder
   • Use "Services" to stop ZooKeeper
   • Stop the Engine: C:\Program Files\IBM\WEX\Engine\bin\velocity-shutdown.exe
3. Extract the JRE from the zip file that you copied in the java.zip file earlier. Do this for all the folders.

   1. cd "C:\Program Files\IBM\WEX\Engine"
      Expand-Archive -Path ibm-semeru-open-jre_x64_windows_21.0.9_10_openj9-0.56.0.zip -DestinationPath .
      Remove-Item -Path "java" -Recurse -Force
      name-Item -Path "jdk-21.0.9+10-jre" -NewName "java"

   2. If you use Windows Explorer, double-click the .zip file and extract all files.
4. Restart Watson Explorer Engine, ZooKeeper, and AppBuilder in order:
   • C:\Program Files\IBM\WEX\Engine\bin\velocity-startup.exe
   • Use "Services" to start ZooKeeper
   • Use "Services" to start AppBuilder