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.
./cpd-cli uninstall --help
Procedure
From your installation node:
- From the web client, remove any provisioned
instances of Cognos Analytics:
- Log in to the Cloud Pak for Data web client as an administrator.
- From the menu, select .
- Filter the list to show only ca service instances.
- Delete all of the instances of the service.
- Change to the directory where you placed the Cloud Pak for Data command-line interface.
- Log in to your Red Hat® OpenShift® cluster as a project
administrator:
oc login OpenShift_URL:port
- 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
- 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. - 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