IBM Support

Updating IBM Java Runtime in IBM Watson Explorer Analytical Components

Fix Readme


Abstract

Follow the procedures in this document to update the version of IBM Runtime Environment, Java Technology Edition, that is provided with IBM Watson Explorer Content Analytics.

Content

Follow these steps after you download the required version of IBM Java Runtime for your operating system from Fix Central:

  1. On the master server, log in as the Content Analytics administrator.
  2. Change to the ES_INSTALL_ROOT/bin directory and enter the command "esadmin stop" to stop the system.
  3. Enter the command "stopccl" (stopccl.sh on UNIX platforms) to stop the Common Communication Layer.
  4. Rename the following directories (e.g., _jvm.orig).
    • On AIX and Linux (including Linux on System z and PowerLinux BE):
      • %ES_INSTALL_ROOT%\_jvm
        %ES_INSTALL_ROOT%\_jvm64
    • On Windows:
      • $ES_INSTALL_ROOT/_jvm
        $ES_INSTALL_ROOT/_jvm64
  5. Create empty directories, _jvm and _jvm64, at the same locations.
  6. Copy the files that you extracted from the 32-bit (or 31-bit, if you use Linux on System z) and 64-bit JRE packages to the _jvm and _jvm64 directories, respectively.
  7. On UNIX systems, enter the command "ls -la" to see whether the read/write/execute privileges and ownership settings for the new _jvm and _jvm64 files match the settings for the original directories. If they do not match, run the chown command to change the settings. In these examples, "esadmin" is the Content Analytics administrator ID and "staff" is the primary group assigned to the Content Analytics administrator ID:
    • chown -R esadmin:staff ES_INSTALL_DIR/_jvm
    • chown -R esadmin:staff ES_INSTALL_DIR/_jvm64
  8. For a multiple server installation, run steps 3 - 7 on all servers.
  9. Follow the steps below depending on your platform.
    • On AIX and Linux (including Linux on System z and PowerLinux BE):
      1. Stop all WEX processes on all servers.
      2. On all servers, log in as the Content Analytics administrator, open ES_INSTALL_ROOT/nodeinfo/esprofile file by using a text editor, and change the line as follows in one line:
        From:
        IBM_JAVA_OPTIONS="-Dcom.ibm.tools.attach.enable=no $IBM_JAVA_OPTIONS"
        To:
        IBM_JAVA_OPTIONS="-Dcom.ibm.tools.attach.enable=no  -XX:+HeapManagementMXBeanCompatibility $IBM_JAVA_OPTIONS"
    • On Windows:
      1. Stop all WEX processes including WEX Windows service.
      2. Open command prompt with "Run as Administrator" option and run the command "sc delete ICAService" to delete the WEX service.
      3. Confirm the WEX service has been deleted on Windows Service. If it still exists with "delete" mark, you might be still opening Services window.
      4. Open the %ES_INSTALL_ROOT%\bin\install_service.bat file by using a text editor and insert the following line in line 69 in one line:
        %UPDATE% ++Environment="IBM_JAVA_OPTIONS='-XX:+HeapManagementMXBeanCompatibility'"
      5. Run the install_service command to re-create WEX Windows service. For example, issue the command as follows:

        C:\PROGRA~1\IBM\es\bin\install_service.bat C:\PROGRA~1\IBM\es C:\PROGRA~1\IBM\es\esadmin ICAService "IBM Watson Explorer Content Analytics" .\esadmin PASSWORD

        Note: The actual arguments can be found in %ES_NODE_ROOT%\logs\install\<HOSTNAME>\v<VERSION>installLog.txt.
      6. Confirm a WEX service is visible and can be started on Windows Service.
  10. On all servers, log in as the Content Analytics administrator, change to the ES_INSTALL_ROOT/bin directory, and enter the command "startccl" (startccl.sh on UNIX platforms) to start the Common Communication Layer.
  11. On the master server, enter the command "esadmin system startall" to start the Watson Explorer Content Analytics system.
 

Agent for Windows File Systems


If you installed the Agent for Windows File Systems, follow these steps to update IBM Java Runtime on the agent server:
  1. On the agent server, change to the ES_AGENT_INSTALL_ROOT\bin directory and enter the command "esagent stop" to stop the agent server.
  2. Rename the following directory (e.g., _jvm.orig):
    • %ES_AGENT_INSTALL_ROOT%\_jvm
  3. Create an empty directory, _jvm, at the same location.
  4. Copy the files that you extracted from the 32-bit JRE package (or 31-bit, if you use Linux on System z) to the _jvm directory.
  5. Enter the command "esagent start" to start the agent server.

[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS8NLW","label":"IBM Watson Explorer"},"ARM Category":[{"code":"a8m0z000000cvvoAAA","label":"Documentation"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"10.0.0;11.0.0;11.0.1;11.0.2;12.0.3"}]

Document Information

Modified date:
03 December 2020

UID

swg21700620