Uninstalling the Platform UI

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

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

Important: Some capabilities for which the Platform UI is a dependency will break when the Platform UI is uninstalled. For that reason, you should uninstall capabilities 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 bottom of the page.

Uninstallation procedure

Using the OpenShift web console:

Log into the OpenShift web console with your OpenShift cluster admin credentials.
Ensure you have selected the namespace that contains the Platform UI you are uninstalling.
In the navigation panel, click Operators > Installed Operators.
In the list on the Installed Operators panel, find and click IBM Cloud Pak for Integration.
Click the Platform UI tab.
Click the overflow menu (three-dot menu) for the instance that you intend to uninstall.
Click Delete PlatformNavigator.
Click Delete in the confirmation dialog box.

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:

Click Administration > CustomResourceDefinitions.
From the list of customer resource definitions, click ConsoleLink.
Click the Instances tab.
Delete the relevant console link.

Using the CLI:

Log into your cluster, using your OpenShift user credentials:
```
oc login
```
Get the list of Platform UI instances running on your cluster:
```
oc get pn --all-namespaces
```
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:

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

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

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 capabilities

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

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

Important: Only a few capabilities for which the Platform UI is a dependency will continue to function after the Platform UI is uninstalled. Consult the following table for details about which capabilities allow for this removal.

Capability name	Allows removal	Additional information
Automation assets	No	This capability can only be used with a Platform UI installed.
Integration tracing	No	This capability can only be used with a Platform UI installed.
API management	No	A form factor migration is needed instead.
Event Endpoint Management	No	A form factor migration is needed instead.
Integration dashboard	No
Integration designer	No
Messaging	Yes
Event streams	Yes
Gateway	Partial	Cloud Pak for Integration gateway images will no longer be automatically selected. To use those images, users must manually specify them in the custom resource.

Follow the main procedure for uninstalling the Platform UI in the previous section.
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>
```
After a few minutes, the capability operators update the instances so they automatically function without the Platform UI.
Test to confirm that all capabilities work as expected.
After you finish validating the capabilities, you can uninstall the IBM Cloud Pak for Integration operator, following the instructions in Uninstalling the operators and catalog sources.