Uninstalling Cognos Analytics

A project administrator can uninstall Cognos Analytics from IBM® Cloud Pak for Data.

Before you begin

Required role: To complete this task, you must be an administrator of the project (namespace) where Cognos Analytics is installed.

Before you uninstall Cognos Analytics, ensure that the machine from which you will run the commands meets the following requirements:

  • Can connect to the cluster.
  • Has the oc command-line interface.
  • Has the Cloud Pak for Data command-line interface.
  • Has a cpd-cli profile. Ensure that the profile points to the instance of Cloud Pak for Data where Cognos Analytics is installed. For details, see Creating a cpd-cli profile.

Removing Cognos Analytics will remove all of the data that is associated with this instance of Cognos Analytics.

Tip: For a list of all available options, enter the following command:
./cpd-cli uninstall --help

Procedure

From your installation node:

  1. From the web client, remove any provisioned instances of Cognos Analytics:
    1. Log in to the Cloud Pak for Data web client as an administrator.
    2. From the menu, select Services > Instances.
    3. Filter the list to show only ca service instances.
    4. Delete all of the instances of the service.
  2. Change to the directory where you placed the Cloud Pak for Data command-line interface.
  3. Log in to your Red Hat® OpenShift® cluster as a project administrator:
    oc login OpenShift_URL:port
  4. Run the following command to ensure that there are no remaining Cognos Analytics service instances in the project where Cognos Analytics is deployed:
    ./cpd-cli service-instance list\
--service-type cognos-analytics-app \
--profile Profile_name \
    Replace Profile_name with the name of your local profile. For details, see Creating a cpd-cli profile.
    Important: To ensure that the command returns all of the service instances, the profile must be associated with a Cloud Pak for Data user who has one of the following permissions:
    • Administer platform
    • Manage and monitor platform
  5. Run the following command to preview the changes that will be made to the cluster when you remove Cognos Analytics:
    ./cpd-cli uninstall \
--assembly ca \ 
--namespace Project \
--include-dependent-assemblies \ 
--profile Profile_name
--dry-run

    Replace the following values:

    Variable Replace with
    Project The Red Hat OpenShift project where Cognos Analytics is deployed.
    Profile_name The name of your local profile.
    Important: Review the output of the command to understand what software will be removed.

    The --include-dependent-assemblies flag automatically removes any dependencies that are not required by other services.

    For example, if Cognos Analytics is the only service installed on Cloud Pak for Data, this command will uninstall Cognos Analytics and the Cloud Pak for Data control plane.

    In this scenario, if you don't want to uninstall the Cloud Pak for Data control plane, you can remove the --include-dependent-assemblies flag from the command.

  6. Rerun the previous command without the --dry-run flag to remove Cognos Analytics.

What to do next

Run the following command if there are no Cognos® Analytics instances running that are less than version 3.2.0:

oc project Project_Name
oc delete scc ibm-cognos-analytics-prod-scc