Updating WebSphere Liberty used in IBM Watson Explorer Analytical Components

Content

Follow these steps after you download the required interim fix for your operating system from Fix Central.

1. Log in as the Content Analytics administrator on the target system.
2. Stop the Analytical Components, such as "esadmin system stop" command and "stopccl" (stopccl.sh on UNIX platforms) command.
3. Extract esctrl.jar file from the interim fix, and overwrite the old version of esctrl.jar with the fixed version in the $ES_INSTALL_ROOT/lib directory.
4. Move or delete the $ES_INSTALL_ROOT/wlp directory. For example, move to $ES_INSTALL_ROOT/wlp.old directory.
5. Extract wlp-core-embeddable-version.zip file from the interim fix, and expand in the $ES_INSTALL_ROOT directory. The wlp directory is created. For example, unzip wlp-core-embeddable-19.0.0.12.zip -d $ES_INSTALL_ROOT to extract to the $ES_INSTALL_ROOT directory.

6. Edit classpath entry in the $ES_INSTALL_ROOT/configurations/interfaces/indexservice__interface.ini file as follows:

   1. Find "wlp/dev/api/spec/com.ibm.websphere.javaee.servlet.3.0_1.0.*.jar" or "wlp/dev/api/spec/com.ibm.ws.javaee.servlet.3.0_1.0.*.jar" in the classpath and replace it with "wlp/dev/api/spec/com.ibm.websphere.javaee.servlet.3.0_1.0.35.jar".
      For example,

      From:
      classpath=es.indexservice.jar,antlr-2.7.2.jar,cloudscape/lib/derbyclient.jar,cloudscape/lib/derby.jar,an_icm.jar,es.dock.jar,oze_search.jar,wlp/dev/api/spec/com.ibm.websphere.javaee.servlet.3.0_1.0.22.jar,es.rdf.jar,pdfbox-2.0.3.jar,fontbox-2.0.3.jar,bcprov-jdk15-1.44.jar,/opt/ibm/sire/lib/noarch/json.org.jar

      To:
      classpath=es.indexservice.jar,antlr-2.7.2.jar,cloudscape/lib/derbyclient.jar,cloudscape/lib/derby.jar,an_icm.jar,es.dock.jar,oze_search.jar,wlp/dev/api/spec/com.ibm.websphere.javaee.servlet.3.0_1.0.35.jar,es.rdf.jar,pdfbox-2.0.3.jar,fontbox-2.0.3.jar,bcprov-jdk15-1.44.jar,/opt/ibm/sire/lib/noarch/json.org.jar

   2. Save the change.

7. Replace at most 5 jar files.

   1. Rename or remove the following *.jar files to *.jar.bak in the $ES_INSTALL_ROOT/wlpapps/servers/admin/apps/ESAdmin.ear/ESAdmin.war/WEB-INF/lib directory. Some of these files may not exist.
      
      com.ibm.ws.crypto.passwordutil_1.0.*.jar
com.ibm.ws.kernel.service_1.3.*.jar
com.ibm.ws.logging_1.0.*.jar
com.ibm.ws.kernel.boot_1.0.*.jar
com.ibm.ws.security.common_1.0.*.jar

   2. Copy the following *.jar files into the $ES_INSTALL_ROOT/wlpapps/servers/admin/apps/ESAdmin.ear/ESAdmin.war/WEB-INF/lib directory from the $ES_INSTALL_ROOT/wlp/lib directory:
      
      com.ibm.ws.crypto.passwordutil_1.0.35.jar
com.ibm.ws.kernel.service_1.3.35.jar
com.ibm.ws.logging_1.0.35.jar
com.ibm.ws.kernel.boot_1.0.35.jar
com.ibm.ws.security.common_1.0.35.jar

8. For IBM Watson Explorer Analytical Components Version 10.0:

   1. Rename or remove the following es.security.jar to es.security.jar.bak:
      
      $ES_INSTALL_ROOT/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/admin/apps/ESAdmin.ear/ESAdmin.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/admin/apps/ESAdminRestServer.ear/ESAdminRestServer.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/admin/apps/ESAdminRestServer20.ear/ESAdminRestServer20.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/searchapp/apps/ESRestServer.ear/ESRestServer.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/searchapp/apps/analytics.ear/analytics.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/searchapp/apps/commonui.ear/commonui.war/WEB-INF/lib/es.security.jar
$ES_INSTALL_ROOT/wlpapps/servers/searchapp/apps/search.ear/search.war/WEB-INF/lib/es.security.jar

   2. Extract es.security.jar file from the interim fix, and copy it into all of the above directories

9. Restart Watson Explorer Analytical Components with "startccl" (startccl.sh on UNIX platforms) command and "esadmin system start" command, or start the session that you stopped.

Notes:

• This operation is applicable for the master server (where admin session is running) and search server (where searchapp.nodeN session is running). Repeat the steps if Analytical Components is installed on distributed servers.
• If you want to keep the system up and running on distributed servers, stop the session in question with "esadmin admin stop" or "esadmin searchapp.nodeN stop" command on the target system respectively, then replace the files.