Uninstalling instances

You can uninstall instances by using the UI or the CLI.

Uninstalling by using the Platform UI

  1. Log in to Platform UI.

  2. In the Instances table, identify the instance to uninstall.

  3. Click the overflow menu (three-dot icon) for that instance, then click Delete.

  4. The Delete instance modal opens. Review the note about implications, then enter your instance name and click Delete. The instance is uninstalled.

  5. (Optional) Permanently delete persistent data and PVCs from the instance.

    1. Log in to the OpenShift web console with your OpenShift cluster admin credentials.

    2. In the navigation pane, click to expand the Storage section and select PersistentVolumeClaims.

    3. For Project, ensure you have selected the namespace from which you uninstalled the instance.

    4. In the table, find the names of the PVCs for the instance.

    5. At the end of the table row for the PVC that you want to remove, click the overflow menu (three-dot icon), then click Delete PersistentVolumeClaim.

    6. Click Delete in the confirmation dialog.

Uninstalling by using the CLI

  1. Log into your OpenShift cluster with your OpenShift user credentials:

    oc login
  2. Get a list of all instances (of the instance type that you want to delete) by running the following command. For the value of <custom-resource-kind>, see the table at the end of this section and find the value that corresponds to your instance type.

    oc get <custom-resource-kind> --all-namespaces

    For example, to return Integration dashboard instances, run:

    oc get Dashboard --all-namespaces
  3. Find the instance that you want to delete (uninstall), then run the following command. Replace <instance-name> with the name of the instance, and <namespace> with the namespace where it is installed:

    oc delete <custom-resource-kind> <instance-name> -n <namespace>

    For example, to delete an Integration dashboard, run:

    oc delete Dashboard db-01-quickstart -n integration

    The instance is now uninstalled.

  4. (Optional) Permanently delete persistent data and PVCs from the instance.

    1. Get a list of all PVCs that exist in the namespace from which you uninstalled the instance.

      oc get pvc -n <namespace>
    2. Find the PVCs for the uninstalled instance.

    3. Delete the PVC that you want removed, by name:

      oc delete pvc <name> -n <namespace>

Custom resource kinds for each instance type

Instance type Custom resource kind
Automation assets AssetRepository
Assembly IntegrationAssembly
API Connect cluster APIConnectCluster
API Manager ManagementCluster
API Analytics AnalyticsCluster
API Portal PortalCluster
API Gateway GatewayCluster
Event Manager EventEndpointManagement
Event Gateway EventGateway
Event Processing EventProcessing
Flink FlinkDeployment
Integration dashboard Dashboard
Integration design DesignerAuthoring
Integration runtime IntegrationRuntime
Integration server IntegrationServer
Configuration Configuration
Switch server SwitchServer
Queue manager QueueManager
Messaging server MessagingServer
Messaging queue MessagingQueue
Messaging channel MessagingChannel
Messaging user MessagingUser
Kafka cluster EventStreams
Kafka topic KafkaTopic
Kafka user KafkaUser
Kafka Connect runtime KafkaConnect
Kafka connector KafkaConnector
Enterprise gateway DataPowerService
High-speed transfer server IbmAsperaHsts