Uninstalling DataStage

An instance administrator can uninstall DataStage.

Who needs to complete this task?

Instance administrator To uninstall DataStage, 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 Cloud Pak for Data 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 Cloud Pak for Data control plane and the services for this instance of Cloud Pak for Data 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 DataStage from an instance of Cloud Pak for Data.

Repeat as needed If you are responsible for multiple instances of Cloud Pak for Data, you can repeat this task to remove other instances of DataStage on the cluster.

Information you need to complete this task

Review the following information before you uninstall DataStage:

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

Procedure

Complete the following tasks to uninstall DataStage:

  1. Specifying which edition to uninstall
  2. Uninstalling the service

Specifying which edition to uninstall

DataStage is available in two different editions: DataStage Enterprise and DataStage Enterprise Plus. You must specify which edition to uninstall.

Set the ${DATASTAGE_TYPE} variable to the edition of DataStage that you want to uninstall:
  • For DataStage Enterprise, run
    export DATASTAGE_TYPE=datastage_ent
  • For DataStage Enterprise Plus, run
    export DATASTAGE_TYPE=datastage_ent_plus

Uninstalling the service

To uninstall DataStage:

  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 DataStage.
    cpd-cli manage delete-cr \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --components=${DATASTAGE_TYPE} \
    --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 DataStage:
    cpd-cli manage delete-olm-artifacts \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --components=${DATASTAGE_TYPE}
    Wait for the cpd-cli to return the following message:
    [SUCCESS]... The delete-olm-artifacts command ran successfully