IBM Support

Watson Explorer Deep Analytics Edition V12.0.2.1 Readme

Fix Readme


Abstract

IBM Watson Explorer Deep Analytics Edition Version 12.0.2.1 includes programs for upgrading Watson Explorer Version 12.0 to the latest level.

Content

Installing / Upgrading to Watson Explorer oneWEX Version 12.0.2.1

Installing / Upgrading to Watson Explorer Analytical Components Version 12.0.2 or Foundational Components Version 12.0.2.1

Fix list of Watson Explorer Deep Analytics Edition Version 12.0.2.1


Installing / Upgrading to Watson Explorer oneWEX Version 12.0.2.1

Installing / Upgrading to oneWEX for ICP Version 12.0.2.1

Planning - Before you deploy Watson Explorer oneWEX for ICP Version 12.0.2.1

To deploy Watson Explorer oneWEX for ICP, the Persistent Volumes listed in the Resources Required section in the Watson Explorer oneWEX Helm Chart README are required unless you use dynamic persistent volume provisioning.

See Installing Watson Explorer oneWEX on IBM Cloud Private before you install Watson Explorer oneWEX for ICP Version 12.0.2.1 Also, make sure to select the proper storage type (NFS, Glusterfs, etc.) that supports the listed access mode based on the Watson Explorer oneWEX Helm Chart README.

Notes:

  • Watson Explorer oneWEX Helm Chart README is found after you install Watson Explorer oneWEX on IBM Cloud Private. Login to IBM Cloud Private, go to Catalog then select ibm-wex-prod.
  • See Watson Explorer oneWEX for ICP KC known issues also if you plan to copy the yaml templates from the Knowledge Center. Some part of the description needs to be corrected.
  • Security Bulletin for supported ICP version is available. See Security Bulletin: IBM Cloud Private is affected by a privilege escalation vulnerability in Kubernetes API server for details and how to download the fix.
  • Upgrading to ICP Version 3.1.1 from previous ICP Versions are not supported at the moment. If you want to use oneWEX Version 12.0.2.1 on ICP Version 3.1.1, install ICP Version 3.1.1 freshly and install oneWEX Version 12.0.2.1.

 

Performing a fresh installation of Watson Explorer oneWEX for ICP

You can install Watson Explorer oneWEX for ICP Version 12.0.2.1 directly without installing Watson Explorer oneWEX for ICP Version 12.0.0 GA, Version 12.0.0.1, Version 12.0.1 or Version 12.0.2. To perform a fresh installation of Watson Explorer oneWEX for ICP Version 12.0.2.1, follow the steps as described in Installing Watson Explorer oneWEX on IBM Cloud Private. Note that Watson Explorer oneWEX for ICP Version 12.0.2.1 supports ICP Version 2.1.0.3, Version 3.1.0 and Version 3.1.1 with fresh installation.

 

Upgrading to Watson Explorer oneWEX for ICP Version 12.0.2.1 on ICP 3.1.0

Following scenario is supported to upgrade to Watson Explorer oneWEX for ICP Version 12.0.2.1 on ICP Version 3.1.0.

  • Upgrade from Watson Explorer oneWEX for ICP Version 12.0.1 or Version 12.0.2 on ICP Version 2.1.0.3 to Watson Explorer oneWEX for ICP Version 12.0.2.1 on ICP Version 3.1.0.

 

There are two paths for the upgrading:

  • Upgrade ICP Version 2.1.0.3 to Version 3.1.0 first, then upgrade oneWEX for ICP from Version 12.0.1 or Version 12.0.2.
  • Upgrade oneWEX for ICP Version 12.0.1 or Version 12.0.2 to Version 12.0.2.1 first, then upgrade ICP Version 2.1.0.3 to Version 3.1.0.

 

Upgrading Watson Explorer oneWEX for ICP

To upgrade Watson Explorer oneWEX for ICP Version 12.0.1 or Version 12.0.2 to Version 12.0.2.1:

  1. Install oneWEX for ICP Version 12.0.2.1 with following steps 3-6 in Installing Watson Explorer oneWEX on IBM Cloud Private.

  2. If you upgrade from oneWEX for ICP Version 12.0.1 and you do not use dynamic persistent volume provisioning, create wex-disk-log persistent volume that is newly introduced in oneWEX for ICP Version 12.0.2. You can create the persistent volume by executing:
    kubectl create -f <yaml-file>
    Refer to the Watson Explorer oneWEX Helm Chart README for template of yaml-file for wex-disk-log persistent volume.

  3. Upgrade helm release of oneWEX for ICP to Version 12.0.2.1. See "Upgrade Helm release version" in Managing Helm releases.

Special instructions when upgrading Watson Explorer oneWEX for ICP from Version 12.0.2 to Version 12.0.2.1:

Especially when upgrading oneWEX for ICP Version 12.0.2 to Version 12.0.2.1, an error about Ingestion statefulset such as follows would appear in the ICP console.

Invalid request : rpc error: code=Unknown desc=StatefulSet.apps "wex-icp-ibm-wex-prod-ingestion" is invalid: spec: Forbidden:updates to statefulset spec for fields other than 'replicas', 'templates', and 'updateStrategy' are forebidden.

Or, if you proceed the upgrade without noticing the error, you might see 2 Helm releases of oneWEX in the ICP console after the upgrade.

Follow the steps below to have Ingestion pod work with new configuration:

  1. Run the kubectl command to create a yaml file (named ingestion-statefulset.yaml in this example) of the Ingestion statefulset.
    kubectl -n YOUR_NAMESPACE get statefulset <YOUR_RELEASE>-ibm-wex-prod-ingestion -o yaml > ingestion-statefulset.yaml
  2. Edit the yaml file (ingestion-statefulset.yaml) to apply the following changes.
    1. Add "serviceName" to "spec" (around at line 19, with 2-space indent)
      spec:
       podManagementPolicy: Parallel
       serviceName: <YOUR_RELEASE>-ibm-wex-prod-ingestion-headless
      
    2. Add the following security keys (securityContext and its sub keys) to "spec.template.spec". (around at line 133, with 6-space indent)
      spec:
      ...
       template:
      ...
         spec:
      ...
           dnsPolicy: ClusterFirst
           securityContext:
             runAsNonRoot: false
             runAsUser: 0
    3. Update the image tag from "12.0.2.417-linux-amd64" to "12.0.2.489-linux-amd64". (around at line 75)
      image: mycluster.icp:8500/default/ibm-wex-ee:12.0.2.489-linux-amd64
  3. Delete the current statefulset with kubectl command.
    kubectl -n YOUR_NAMESPACE delete statefulset <YOUR_RELEASE>-ibm-wex-prod-ingestion
  4. Create the modified statefulset with the yaml file (ingestion-statefulset.yaml in this example)
    kubectl -n YOUR_NAMESPACE create -f ingestion-statefulset.yaml

 

Upgrading IBM Cloud Private

To upgrade ICP 2.1.0.3 to ICP 3.1.0, see Upgrading from IBM Cloud Private Version 2.1.0.3 to 3.1.0.

 


Installing / Upgrading to oneWEX for single container deployment Version 12.0.2.1

Performing a fresh installation of Watson Explorer oneWEX for single container deployment Version 12.0.2.1

You can install Watson Explorer oneWEX for single container deployment Version 12.0.2.1 directly without installing Watson Explorer oneWEX for single container deployment Version 12.0.0.1, Version 12.0.1 or Version 12.0.2. To perform a fresh installation of Watson Explorer oneWEX for single container deployment Version 12.0.2.1, follow the steps as described in Installing Watson Explorer oneWEX on Docker.

 

Upgrading to Watson Explorer oneWEX for single container deployment Version 12.0.2.1

You can upgrade from Watson Explorer oneWEX for single container deployment Version 12.0.0.1, Version 12.0.1, or Version 12.0.2 to Watson Explorer oneWEX for single container deployment Version 12.0.2.1 without uninstalling Watson Explorer oneWEX for single container deployment Version 12.0.0.1, Version 12.0.1 or 12.0.2. To upgrade to Watson Explorer oneWEX for single container deployment Version 12.0.2.1, follow the steps as described in Installing Watson Explorer oneWEX on Docker to install Watson Explorer oneWEX for single container deployment Version 12.0.2.1.

 


Installing / Upgrading to Watson Explorer Analytical Components Version 12.0.2.1 or Foundational Components Version 12.0.2.1

Performing a fresh installation of Foundational Components Version 12.0.2.1

You can install Watson Explorer Foundational Components Version 12.0.2.1 directly without installing Watson Explorer Foundational Components Version 12.0.2 GA . To perform a fresh installation of Foundational Components Version 12.0.2.1, follow the steps as described in Installing and Integrating IBM Watson Explorer Foundational Components for Foundational Components.

Performing a fresh installation of Watson Explorer Analytical Components Version 12.0.2.1

You cannot install Watson Explorer Analytical Components Version 12.0.2.1 directly without installing Watson Explorer Analytical Components Version 12.0.2 GA . To perform a fresh installation of Watson Explorer Analytical Components Version 12.0.2.1, you must install Watson Explorer Analytical Components Version 12.0.2 first and apply the Fix Pack 1. Follow the steps as described in Installing Watson Explorer Content Analytics for Analytical Components.

Upgrading to Watson Explorer Analytical Components Version 12.0.2.1 or Foundational Components Version 12.0.2.1

See Upgrading to Watson Explorer 12.0.x for detailed steps. Same steps are applicable when you are upgrading from Watson Explorer Analytical Components Version 12.0.0 or Watson Explorer Foundational Components Version 12.0.0.

For other versions, upgrading to Watson Explorer Version 12 is supported only from Watson Content Analytics (WCA) v3.5 to WEX  Analytical Components (AC) v12, from WEX AC v11.0.2 to WEX AC v12, and from WEX Foundational Components (FC) v11.0.2 to WEX FC v12. From other versions, upgrading to WCA v3.5, WEX FC v11.0.2, or WEX AC v11.0.2 is required before upgrading to WEX Version 12. For upgrading from those versions, see Upgrading to Watson Explorer 12.0.x

 


Fix list of Watson Explorer Deep Analytics Edition Version 12.0.2.1

IBM Watson Explorer oneWEX, Version 12.0.2 Fix Pack 1

List of fixes
Version 12.0.2 Fix Pack 1 provides fixes for the following problems.

Issue Description
PH06639

Internal enhancements delivered in Watson Explorer oneWEX, Version 12.0.2.1:

Application Builder:
- Project list page becomes blank

Admin UI:
- Field indexing options in the collection configuration are not changed before generating indexed data

Intrastructure:
- wexDocker.sh backup fails when it takes more than 300 seconds

Converter:
- Garbled characters are shown in the search result if meta tag has incorrect charset in html

Core:
- When a field value contains double quote, query with un-quoted string returns no documents
- Classifier's predicted facets are not exported

 

IBM Watson Explorer Foundational Components, Version 12.0.2 Fix Pack 1

List of fixes
Version 12.0.2 Fix Pack 1 provides fixes for the following problems.

Issue Description
PH01471 WITH A SHARED FOLDER ENABLED, each CLUSTER LABEL SHOW AN INCORRECT NUMBER OF RESULTS next to it
PI92501 SOAP Request/Response message validation fails on IBM DataPower Gateway

 

IBM Watson Explorer Analytical Components, Version 12.0.2 Fix Pack 1

List of fixes
Version 12.0.2 Fix Pack 1 provides fixes for the following problems.

Issue Description
IT26769 REPORT BUTTON ON THE SEARCH UI PRODUES EMPTY RESULTS WHEN non-ascii character is used in the query string
IT26890 "ESADMIN SYSTEM STOPLOCAL" command does not stop all the sessions as expected
PH04882 The language and locale settings are not honored for the CSV import and the auto language detection is enforced instead
PH06638

Internal enhanceents delivered in Watson Explorer Analytical Component, Version 12.0.2.1:

Query runtime:
- The frequency value of facet pair with contextual view differs in Document page.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS8NLW","label":"Watson Explorer"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"12.0.2.1","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
20 December 2018

UID

ibm10791383