1.9. Uninstalling

When you uninstall Red Hat Advanced Cluster Management for Kubernetes, there are two different levels of the process.

The first level is a custom resource removal. It is the most basic type of unistallation that removes the custom resource of the MultiClusterHub instance, but leaves other required components. This level of uninstallation is helpful if you plan another installation that uses the same settings and components of the one that you are removing. Your time to install the next version is reduced when you have all of the other components already installed.

The second level is a more complete uninstallation, except for a few items, like custom resource definitions. This adds the removal of other required components and settings to the items that are removed. When you continue with this step, it removes all of the components and subscriptions that were not removed with the custom resource removal. If you complete this level of uninstallation, you must reinstall the operator before reinstalling the custom resource.

重要

Before you uninstall the Red Hat Advanced Cluster Management hub cluster, you must detach all of the clusters that are managed by that hub cluster. See, Troubleshooting failed uninstallation because resources exist for the work around.

1.9.1. Removing a MultiClusterHub instance by using commands

  1. Change to your project namespace by entering the following command: 

    oc project <namespace>

    Replace namespace with the name of your project namespace.

  2. Enter the following command to remove the MultiClusterHub custom resource: 

    oc delete multiclusterhub --all
    提示

    If you plan to reinstall a new version and want to keep your other information, you can skip the rest of the steps in this procedure and reinstall.

  3. Enter the following command to remove all of the related components and subscriptions: 

    oc delete subs --all

1.9.2. Deleting both components by using the console

When you use the Red Hat OpenShift Container Platform console to uninstall, you remove the operator. Complete the following steps to unistall by using the console:

  1. In the Red Hat OpenShift Container Platform console navigation, select Operators > Installed Operators > Advanced Cluster Manager for Kubernetes.
  2. Select the tab for Multiclusterhub operator.
  3. Select the Options menu for the MultiClusterHub operator.

  4. Select Delete MultiClusterHub.

    提示

    If you plan to reinstall a new version and want to keep your other information, you can skip the rest of the steps in this procedure and reinstall.

  5. Navigate to Installed Operators.
  6. Remove the Red Hat Advanced Cluster Management operator by selecting the Options menu and selecting Uninstall operator.