Uninstalling the Platform UI

Uninstall the IBM Cloud Pak Platform UI instance by deleting the PlatformNavigator custom resource, using either the Platform UI or the CLI.

You must be a Cloud Pak for Integration admin to uninstall the Platform UI. For more information, see "Client roles for the Cloud Pak for Integration installation" in Cloud Pak roles and permissions.

Important:
  • Some instances for which the Platform UI is a dependency will break when the Platform UI is uninstalled. For that reason, you should uninstall instances before uninstalling the Platform UI. To remove the Platform UI only from an existing installation, consult the table in the "Uninstalling the Platform UI only" section at the end of the page.
  • Draft instances are deleted when you uninstall the Platform UI instance.

Uninstalling by using the Platform UI

  1. Log into the Platform UI.

  2. In the Platform UI table row you want to uninstall, click the overflow menu (three-dot icon).

  3. In the dropdown menu, click Delete.

  4. Review the note about implications, then enter your Platform UI instance name and click Delete.

The Platform UI instance is now uninstalled.

The applications menu item for the Platform UI instance remains after the instance is uninstalled. To delete the ConsoleLink for the Platform UI you uninstalled:

  1. Click Administration > CustomResourceDefinitions.

  2. From the list of customer resource definitions, click ConsoleLink.

  3. Click the Instances tab.

  4. Delete the relevant console link.

Uninstalling by using the CLI

  1. Log into your OpenShift cluster, using your OpenShift user credentials:

    oc login

  2. Get the list of Platform UI instances running on your OpenShift cluster:

    oc get pn --all-namespaces

  3. Identify the instance you want to delete and run this command, replacing <instance-name> with the name of the instance, and <namespace> with the namespace where it is installed:

    oc delete pn <instance-name> -n <namespace>

The Platform UI instance is now uninstalled.

The applications menu item for the Platform UI instance remains after the instance is uninstalled. To delete the ConsoleLink for the Platform UI you uninstalled:

  1. Get the list of Platform UI console links on your OpenShift cluster:

    oc get consolelink | grep "IBM Cloud Pak for Integration"

  2. Identify the console link you want to delete and run this command, replacing <consolelink-name> with the name of the console link:

    oc delete consolelink <consolelink-name>

Uninstalling the Platform UI without deleting instances

You can remove the IBM Cloud Pak Platform UI instance from an existing Cloud Pak for Integration installation without removing instances.

This task can be performed by a cluster administrator or namespace administrator. For more information, see OpenShift roles and permissions.

Important: Only a few instances for which the Platform UI is a dependency continue to function after the Platform UI is uninstalled. Consult the following table for details about which instances support this removal.
Instance type Supports removal Additional information
Automation assets No This instance can only be used with a Platform UI installed.
API Connect cluster No A form factor migration is needed instead.
API Yes
API Product Yes
Event Manager Yes
Event Gateway Yes
Event Processing Yes
Flink Yes
High speed transfer server Yes
Integration dashboard No
Integration design No
Integration runtime Yes
Queue manager Yes
Kafka cluster Yes
Kafka topic Yes
Kafka user Yes
Kafka Connect runtime Yes
Kafka connector Yes
Enterprise gateway Partial Enterprise gateway images are longer automatically selected. To use those images, users must manually specify them in the custom resource.
Messaging server Yes
Messaging queue Yes
Messaging channel Yes
Messaging user Yes
Policy Yes
Policy binding Yes

  1. Follow the main procedure for uninstalling the Platform UI in the previous sections.

  2. Delete all the Cp4iServicesBindings in the scope of this installation:

    • If the operators were installed using the All namespaces on the cluster mode, run the following command:

      oc delete Cp4iServicesBindings --all --all-namespaces

    • If the operators were installed using the A specific namespace on the cluster mode, run the following command, replacing <namespace> with your installation namespace:

      oc delete Cp4iServicesBindings --all -n <namespace>

  3. After a few minutes, the operators update the instances so they automatically function without the Platform UI.

  4. Test to confirm that all instances function as expected.