IBM Support

IBM Software Hub Version 5.2.0 - Day 0 patch

Fix Readme


Abstract

After you install or upgrade to IBM Software Hub Version 5.2.0, you must apply the Version 5.2.0 - Day 0 patch if you have any services with a dependency on the common core services.

Content

If you have any of the following services on your environment, apply the Version 5.2.0 - Day 0 patch after you install or upgrade to IBM Software Hub Version 5.2.0:
  • AI Factsheets
  • Cognos Analytics
  • Cognos Dashboards
  • Data Privacy
  • Data Product Hub
  • Data Replication 
  • DataStage
  • Data Virtualization 
  • Decision Optimization
  • Execution Engine for Apache Hadoop
  • IBM Knowledge Catalog
  • IBM Knowledge Catalog Premium
  • IBM Knowledge Catalog Standard
  • IBM Manta Data Lineage
  • IBM Match 360
  • MANTA Automated Data Lineage
  • Orchestration Pipelines
  • RStudio Server Runtimes
  • SPSS Modeler
  • Synthetic Data Generator
  • Unstructured Data Integration
  • Watson Machine Learning
  • Watson Studio
  • Watson Studio Runtimes
  • watsonx.ai
  • watsonx Assistant (with GPU features enabled)
  • watsonx Code Assistant
  • watsonx Code Assistant for Red Hat Ansible Lightspeed
  • watsonx Code Assistant for Z
  • watsonx Code Assistant for Z Code Explanation 
  • watsonx.data
  • watsonx.data Premium 
  • watsonx.data intelligence
  • watsonx.governance
The Version 5.2.0 - Day 0 patch includes critical fixes for the common core services and the following services:
  • Data Privacy
  • IBM Knowledge Catalog
  • IBM Knowledge Catalog Premium
  • IBM Knowledge Catalog Standard
  • IBM Manta Data Lineage
  • MANTA Automated Data Lineage
  • Unstructured Data Integration 
  • watsonx.data intelligence
The Version 5.2.0 - Day 0 patch addresses the following known issues:
You can run the attached script to apply the Version 5.2.0 - Day 0 patch to your environment.
The script will automatically install the following packages on the client workstation if they are not already installed:
  • jq
  • podman
  • skopeo
Before you begin
  1. If you upgraded your environment, ensure that you complete the following task before you apply the 5.2.0 - Day 0 patch:
    Completing the catalog-api service migration
     
  2. Source your IBM Software Hub installation environment variables script: 
    source ./cpd_vars.sh
Procedure
To apply the patch:
  1. Log in to the Red Hat OpenShift Container Platform cluster where IBM Software Hub Version 5.2.0 is installed. 
  2. Download the attached script, 5.2.0-day0-patch-v5.sh, to your client workstation. 
  3. Make the script executable: 
    chmod +x ./5.2.0-day0-patch-v5.sh
  4. If your cluster pulls images from a private container registry, copy the images for the Version 5.2.0 - Day 0 patch from the IBM Entitled Registry to your private container registry: 
    nohup ./5.2.0-day0-patch-v5.sh \
--load ${PRIVATE_REGISTRY_LOCATION} \
--as ${PRIVATE_REGISTRY_PUSH_USER} \
--with ${PRIVATE_REGISTRY_PUSH_PASSWORD} \
--entitlement ${IBM_ENTITLEMENT_KEY} \
--operator ${PROJECT_CPD_INST_OPERATORS} \
--yes > load_patch_images_output.log &
  5. Optional. To preview the commands that the script will execute, run the following command: 
    ./5.2.0-day0-patch-v5.sh \
--operator ${PROJECT_CPD_INST_OPERATORS} \
--plan \
--yes
  6. Apply the patch by running the following command: 
    nohup ./5.2.0-day0-patch-v5.sh \
--operator ${PROJECT_CPD_INST_OPERATORS} \
--yes > patch_install_output.log &
    Important: The script can take approximately an hour to complete. If your environment includes multiple services that require patches, the script might take longer. 

    Tip: To view the commands that were executed by the script, see the latest Apply.Day0.Patch.NNN.log file in the local directory.
  7. If Data Product Hub is installed on the instance and you upgraded your environment, complete the following steps to ensure that the catalog is synchronized:
    1. Set the SWH_INSTANCE environment variable to the URL of the instance of IBM Software Hub that you upgraded: 
      export SWH_INSTANCE=<instance-url>
    2. Generate a bearer token for the instance of IBM Software Hub that you upgraded and set the BEARER_TOKEN environment variable to the token: 
      export BEARER_TOKEN=<token>
    3. Get the GUID of the Data Product Hub catalog:   
      curl -k -H "Authorization:bearer ${BEARER_TOKEN}" \
-X GET https://${SWH_INSTANCE}/v2/catalogs/ibm-default-hub
    4. Run a bulk sync job to sync the assets for global search. When you see the following prompt, provide the GUID of the catalog:
      “Please provide the list of containers to synchronize”
Removing the Day-0 Patch 
 
To remove the patch and restore all the image versions back to the versions that were released with IBM Software Hub Version 5.2.0:
 
  1. Optional. To preview the commands that the script will execute, run the following command: 
    ./5.2.0-day0-patch-v5.sh \
--operator ${PROJECT_CPD_INST_OPERATORS} \
--remove \
--plan \
--yes
  2. To remove the patch, run the following command: 
    nohup ./5.2.0-day0-patch-v5.sh \
--operator ${PROJECT_CPD_INST_OPERATORS} \
–-remove \
--yes > patch_remove_output.log &
    Important: The script can take approximately an hour to complete. If your environment includes multiple services that require patches, the script might take longer. 

    Tip: To view the commands that were executed by the script, see the latest Remove.Day0.Patch.NNN.log in the local directory.

[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSNFH6","label":"IBM Software Hub"},"ARM Category":[{"code":"a8m3p000000UoRRAA0","label":"Administration-\u003EUpgrade"},{"code":"a8m3p000000UoS5AAK","label":"Installation"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.2.0"}]

Document Information

Modified date:
07 July 2025

UID

ibm17236425

Page Feedback