Uninstalling watsonx.data Premium

An instance administrator can uninstall watsonx.data Premium.

Who needs to complete this task?

Instance administrator To uninstall watsonx.data Premium, you must be an instance administrator. An instance administrator has permission to manage software in the following projects:

The operators project for the instance

The operators for this instance of IBM® Software Hub are installed in the operators project. In the uninstall commands, the ${PROJECT_CPD_INST_OPERATORS} environment variable refers to the operators project.

The operands project for the instance

The IBM Software Hub control plane and the services for this instance of IBM Software Hub are installed in the operands project. In the uninstall commands, the ${PROJECT_CPD_INST_OPERANDS} environment variable refers to the operands project.

When do you need to complete this task?

Complete this task if you want to remove watsonx.data Premium from an instance of IBM Software Hub.

Repeat as needed If you are responsible for multiple instances of IBM Software Hub, you can repeat this task to remove other instances of watsonx.data Premium on the cluster.

Information you need to complete this task

Review the following information before you uninstall watsonx.data Premium:

Environment variables
The commands in this task use environment variables so that you can run the commands exactly as written.
  • If you don't have the script that defines the environment variables, see Setting up installation environment variables.
  • To use the environment variables from the script, you must source the environment variables before you run the commands in this task. For example, run:
    source ./cpd_vars.sh

About this task

When you install watsonx.data™ Premium, watsonx.data Premium automatically installs the following services if they are not already installed:

  • Unstructured Data Integration
  • watsonx.ai™
  • watsonx.data
  • watsonx.data intelligence

By default, when you uninstall watsonx.data Premium, all of the preceding services are also uninstalled.

If you want to uninstall watsonx.data Premium, you must decide which services you want to uninstall:
Software to uninstall Choose this option if...
watsonx.data Premium only Choose this option if one or more of the following statements applies to you:
  • You have entitlement to the automatically installed dependencies because you purchased a license for the service.

    For example, if you purchased the IBM watsonx.ai license, you are entitled to use watsonx.ai.

  • You installed one or more of the automatically installed dependencies before you installed watsonx.data Premium
  • You plan to use one or more of the automatically installed dependencies after you uninstall watsonx.data Premium
watsonx.data Premium and all of its dependencies Choose this option if one or more of the following statements applies to you:
  • You don't have entitlement to the automatically installed dependencies other than through watsonx.data Premium
  • You did not explicitly install any of the automatically installed dependencies
  • You don't need any of the automatically installed dependencies other than for watsonx.data Premium

Uninstalling watsonx.data Premium only

To uninstall watsonx.data Premium without removing all of the services that it is dependent on:

  1. Log the cpd-cli in to the Red Hat® OpenShift® Container Platform cluster:
    ${CPDM_OC_LOGIN}
    Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
  2. Determine which of the following services you want to keep:
    Service To prevent the service from being removed...
    Unstructured Data Integration
    oc patch datasift datasift-cr \
    --namespace=${PROJECT_CPD_INST_OPERANDS} \
    --type='json' \
    --patch='[{"op": "remove", "path": "/metadata/ownerReferences"}]'
    watsonx.data
    oc patch WxdAddon wxdaddon \
    --namespace=${PROJECT_CPD_INST_OPERANDS} \
    --type='json' \
    --patch='[{"op": "remove", "path": "/metadata/ownerReferences"}]'
    watsonx.data intelligence
    oc patch WatsonxDataIntelligence watsonxdataintelligence-cr \
    --namespace=${PROJECT_CPD_INST_OPERANDS} \
    --type='json' \
    --patch='[{"op": "remove", "path": "/metadata/ownerReferences"}]'
  3. Delete the custom resource for watsonx.data Premium.
    cpd-cli manage delete-cr \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --components=watsonx_data_premium
    Wait for the cpd-cli to return the following message before you proceed to the next step:
    [SUCCESS]... The delete-cr command ran successfully
  4. Delete the OLM objects for watsonx.data Premium.
    Restriction: If you want to keep watsonx.data on this instance of IBM Software Hub, skip this step. The OLM objects for watsonx.data Premium are shared with the watsonx.data service.
    cpd-cli manage delete-olm-artifacts \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --components=watsonx_data_premium
    Wait for the cpd-cli to return the following message:
    [SUCCESS]... The delete-olm-artifacts command ran successfully

If you want to delete any of the other automatically installed components, see the following topics:

Uninstalling watsonx.data Premium and all of its dependencies

To uninstall watsonx.data Premium and all of the services that it has a dependency on:

  1. Log the cpd-cli in to the Red Hat OpenShift Container Platform cluster:
    ${CPDM_OC_LOGIN}
    Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
  2. Delete the custom resource for watsonx.data Premium.
    cpd-cli manage delete-cr \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --components=watsonx_data_premium \
    --include_dependency=true
    Wait for the cpd-cli to return the following message before you proceed to the next step:
    [SUCCESS]... The delete-cr command ran successfully
  3. Delete the OLM objects for watsonx.data Premium:
    cpd-cli manage delete-olm-artifacts \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --components=watsonx_data_premium
    Wait for the cpd-cli to return the following message:
    [SUCCESS]... The delete-olm-artifacts command ran successfully

If you want to delete the operators for the other automatically installed components, see the following topics: