Skip to content

A task to remove Advanced Cluster Management (ACM) from an OpenShift cluster

Advanced Cluster Management Cleanup Task

This task performs a comprehensive cleanup of Red Hat Advanced Cluster Management (ACM) from an OpenShift cluster. It removes all ACM-related resources including the MultiClusterHub, operator subscription, and associated resources.

Requirements

Parameters

  • openshift/acm-namespace: Namespace containing ACM installation

Cluster Access

  • Administrative access to the OpenShift cluster
  • Valid kubeconfig with cluster-admin privileges
  • Required permissions for resource deletion

Usage

Basic Cleanup

# Apply cleanup task
drpcli machines tasks add <machine-uuid> openshift-cluster-acm-cleanup

# Verify removal
oc get mch -n open-cluster-management
oc get csv -n open-cluster-management

Cleanup Process

The task removes resources in the following order: 1. MultiClusterHub instance 2. Operator subscription 3. ClusterServiceVersions 4. OperatorGroup 5. InstallPlans 6. Supporting resources: - Secrets - ConfigMaps - ServiceAccounts - Routes - Services - Deployments - StatefulSets - PersistentVolumeClaims 7. ACM namespace

Verification Steps

# Verify namespace removal
oc get namespace open-cluster-management

# Check for remaining resources
oc get multiclusterhub --all-namespaces
oc get subscription --all-namespaces | grep advanced-cluster-management

Important Notes

  • Backup any important data before running cleanup
  • Ensure no managed clusters are still connected
  • Process may take several minutes to complete
  • Some resources may require manual cleanup if stuck in terminating state