Updating WebSphere Liberty 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 stopall" command.
3. Move or delete the $ES_INSTALL_ROOT/wlp directory. For example, move to $ES_INSTALL_ROOT/wlp.old directory.
4. 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-22.0.0.3.zip -d $ES_INSTALL_ROOT to extract to the $ES_INSTALL_ROOT directory.
5. Edit classpath entry in the $ES_INSTALL_ROOT/configurations/interfaces/indexservice__interface.ini file as follows:

   1. Find "com.ibm.websphere.javaee.servlet.*.jar" in the $ES_INSTALL_ROOT/wlp/dev/api/spec/ directory and overwrite the version of "com.ibm.websphere.javaee.servlet" in classpath of indexservice__interface.ini with that version.
      For example, if you find a file named "com.ibm.websphere.javaee.servlet.3.0_1.0.62.jar" in $ES_INSTALL_ROOT/wlp/dev/api/spec/ directory on Analytical Component version 12.0.3.9, edit classpath in indexservice__interface.ini as follows

      From:
      classpath=nekohtml.jar,tika/apache-mime4j-core-0.8.3.jar,tika/apache-mime4j-dom-0.8.3.jar,tika/asm-9.1.jar,tika/bcmail-jdk15on-1.68.jar,tika/bcpkix-jdk15on-1.68.jar,tika/bcprov-jdk15on-1.68.jar,tika/boilerpipe-1.1.0.jar,tika/bzip2-0.9.1.jar,tika/commons-codec-1.15.jar,tika/commons-collections4-4.4.jar,tika/commons-compress-1.21.jar,tika/commons-csv-1.8.jar,tika/commons-exec-1.3.jar,tika/commons-io-2.8.0.jar,tika/commons-lang3-3.12.0.jar,tika/commons-logging-1.2.jar,tika/commons-math3-3.6.1.jar,tika/curvesapi-1.06.jar,tika/cxf-core-3.4.3.jar,tika/cxf-rt-frontend-jaxrs-3.4.3.jar,tika/cxf-rt-rs-client-3.4.3.jar,tika/cxf-rt-security-3.4.3.jar,tika/cxf-rt-transports-http-3.4.3.jar,tika/dd-plist-1.23.jar,tika/dec-0.1.2.jar,tika/error_prone_annotations-2.5.1.jar,tika/failureaccess-1.0.1.jar,tika/fontbox-2.0.24.jar,tika/grib-4.5.5.jar,tika/gson-2.8.6.jar,tika/guava-30.1.1-jre.jar,tika/HikariCP-java7-2.4.13.jar,tika/httpclient-4.5.13.jar,tika/httpcore-4.4.13.jar,tika/httpmime-4.5.13.jar,tika/isoparser-1.9.41.4.jar,tika/istack-commons-runtime-4.0.0.jar,tika/j2objc-annotations-1.3.jar,tika/jackcess-4.0.0.jar,tika/jackcess-encrypt-4.0.1.jar,tika/jai-imageio-core-1.4.0.jar,tika/jakarta.activation-2.0.0.jar,tika/jakarta.annotation-api-1.3.5.jar,tika/jakarta.ws.rs-api-2.1.6.jar,tika/jakarta.xml.bind-api-3.0.0jar,tika/java-libpst-0.9.3.jar,tika/javax.annotation-api-1.3.2.jar,tika/jaxb-core-3.0.0,tika/jaxb-runtime-3.0.0.jar,tika/jbig2-imageio-3.0.3.jar,tika/jcip-annotations-1.0.jar,tika/jcl-over-slf4j-1.7.30.jar,tika/jcommander-1.81.jar,tika/jempbox-1.8.16.jar,tika/jmatio-1.5.jar,tika/json-simple-1.1.1.jar,tika/jsr305-3.0.2.jar,tika/jul-to-slf4j-1.7.30.jar,tika/juniversalchardet-1.0.3.jar,tika/listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar,tika/metadata-extractor-2.15.0.1.jar,tika/openjson-1.0.12.jar,tika/opennlp-tools-1.9.3.jar,tika/parso-2.0.14.jar,tika/pdfbox-2.0.24.jar,tika/pdfbox-tools-2.0.23.jar,tika/poi-4.1.2.jar,tika/poi-ooxml-4.1.2.jar,tika/poi-ooxml-schemas-4.1.2.jar,tika/poi-scratchpad-4.1.2.jar,tika/preflight-2.0.23.jar,tika/protobuf-java-3.15.6.jar,tika/quartz-2.3.2.jar,tika/rome-1.15.0.jar,tika/rome-utils-1.15.0.jar,tika/sentiment-analysis-parser-0.1.jar,tika/sis-feature-1.0.jar,tika/sis-metadata-1.0.jar,tika/sis-netcdf-1.0.jar,tika/sis-referencing-1.0.jar,tika/sis-storage-1.0.jar,tika/sis-utility-1.0.jar,tika/slf4j-api-1.7.30.jar,tika/SparseBitSet-1.2.jar,tika/stax2-api-4.2.1.jar,tika/tagsoup-1.2.1.jar,tika/tika-core-1.26.jar,tika/tika-parsers-1.26.jar,tika/txw2-3.0.0.jar,tika/unit-api-1.0.jar,tika/vorbis-java-core-0.8.jar,tika/vorbis-java-tika-0.8.jar,tika/woodstox-core-6.2.4.jar,tika/xercesImpl-2.12.1.jar,tika/xml-apis-1.4.01.jar,tika/xmlbeans-3.1.0.jar,tika/xmlschema-core-2.2.5.jar,tika/xmpbox-2.0.23.jar,tika/xmpcore-shaded-6.1.11.jar,tika/xz-1.9.jar,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.56.jar,es.rdf.jar,bcprov-jdk15-1.44.jar,/opt/ibm/sire/lib/noarch/json.org.jar
      To:
      classpath=classpath=nekohtml.jar,tika/apache-mime4j-core-0.8.3.jar,tika/apache-mime4j-dom-0.8.3.jar,tika/asm-9.1.jar,tika/bcmail-jdk15on-1.68.jar,tika/bcpkix-jdk15on-1.68.jar,tika/bcprov-jdk15on-1.68.jar,tika/boilerpipe-1.1.0.jar,tika/bzip2-0.9.1.jar,tika/commons-codec-1.15.jar,tika/commons-collections4-4.4.jar,tika/commons-compress-1.21.jar,tika/commons-csv-1.8.jar,tika/commons-exec-1.3.jar,tika/commons-io-2.8.0.jar,tika/commons-lang3-3.12.0.jar,tika/commons-logging-1.2.jar,tika/commons-math3-3.6.1.jar,tika/curvesapi-1.06.jar,tika/cxf-core-3.4.3.jar,tika/cxf-rt-frontend-jaxrs-3.4.3.jar,tika/cxf-rt-rs-client-3.4.3.jar,tika/cxf-rt-security-3.4.3.jar,tika/cxf-rt-transports-http-3.4.3.jar,tika/dd-plist-1.23.jar,tika/dec-0.1.2.jar,tika/error_prone_annotations-2.5.1.jar,tika/failureaccess-1.0.1.jar,tika/fontbox-2.0.24.jar,tika/grib-4.5.5.jar,tika/gson-2.8.6.jar,tika/guava-30.1.1-jre.jar,tika/HikariCP-java7-2.4.13.jar,tika/httpclient-4.5.13.jar,tika/httpcore-4.4.13.jar,tika/httpmime-4.5.13.jar,tika/isoparser-1.9.41.4.jar,tika/istack-commons-runtime-4.0.0.jar,tika/j2objc-annotations-1.3.jar,tika/jackcess-4.0.0.jar,tika/jackcess-encrypt-4.0.1.jar,tika/jai-imageio-core-1.4.0.jar,tika/jakarta.activation-2.0.0.jar,tika/jakarta.annotation-api-1.3.5.jar,tika/jakarta.ws.rs-api-2.1.6.jar,tika/jakarta.xml.bind-api-3.0.0jar,tika/java-libpst-0.9.3.jar,tika/javax.annotation-api-1.3.2.jar,tika/jaxb-core-3.0.0,tika/jaxb-runtime-3.0.0.jar,tika/jbig2-imageio-3.0.3.jar,tika/jcip-annotations-1.0.jar,tika/jcl-over-slf4j-1.7.30.jar,tika/jcommander-1.81.jar,tika/jempbox-1.8.16.jar,tika/jmatio-1.5.jar,tika/json-simple-1.1.1.jar,tika/jsr305-3.0.2.jar,tika/jul-to-slf4j-1.7.30.jar,tika/juniversalchardet-1.0.3.jar,tika/listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar,tika/metadata-extractor-2.15.0.1.jar,tika/openjson-1.0.12.jar,tika/opennlp-tools-1.9.3.jar,tika/parso-2.0.14.jar,tika/pdfbox-2.0.24.jar,tika/pdfbox-tools-2.0.23.jar,tika/poi-4.1.2.jar,tika/poi-ooxml-4.1.2.jar,tika/poi-ooxml-schemas-4.1.2.jar,tika/poi-scratchpad-4.1.2.jar,tika/preflight-2.0.23.jar,tika/protobuf-java-3.15.6.jar,tika/quartz-2.3.2.jar,tika/rome-1.15.0.jar,tika/rome-utils-1.15.0.jar,tika/sentiment-analysis-parser-0.1.jar,tika/sis-feature-1.0.jar,tika/sis-metadata-1.0.jar,tika/sis-netcdf-1.0.jar,tika/sis-referencing-1.0.jar,tika/sis-storage-1.0.jar,tika/sis-utility-1.0.jar,tika/slf4j-api-1.7.30.jar,tika/SparseBitSet-1.2.jar,tika/stax2-api-4.2.1.jar,tika/tagsoup-1.2.1.jar,tika/tika-core-1.26.jar,tika/tika-parsers-1.26.jar,tika/txw2-3.0.0.jar,tika/unit-api-1.0.jar,tika/vorbis-java-core-0.8.jar,tika/vorbis-java-tika-0.8.jar,tika/woodstox-core-6.2.4.jar,tika/xercesImpl-2.12.1.jar,tika/xml-apis-1.4.01.jar,tika/xmlbeans-3.1.0.jar,tika/xmlschema-core-2.2.5.jar,tika/xmpbox-2.0.23.jar,tika/xmpcore-shaded-6.1.11.jar,tika/xz-1.9.jar,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.62.jar,es.rdf.jar,bcprov-jdk15-1.44.jar,/opt/ibm/sire/lib/noarch/json.org.jar

   2. Save the change.

6. Replace at most 6 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.websphere.appserver.spi.kernel.service_*.jar
      • com.ibm.ws.kernel.boot_*.jar
      • com.ibm.websphere.appserver.spi.logging_*.jar
      • com.ibm.ws.logging_*.jar
      • com.ibm.ws.crypto.passwordutil_*.jar
      • com.ibm.ws.security.common_*.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.kernel.boot_*.jar
      • com.ibm.ws.logging_*.jar
      • com.ibm.ws.crypto.passwordutil_*.jar
      • com.ibm.ws.security.common_*.jar
   3. 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/dev/spi/ibm directory:
      • com.ibm.websphere.appserver.spi.kernel.service_*.jar
      • com.ibm.websphere.appserver.spi.logging_*.jar
7. Restart Watson Explorer Analytical Components with "esadmin system startall" 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.