Chapter 11. Uninstalling OpenShift AI
Use Red Hat OpenShift Cluster Manager to uninstall Red Hat OpenShift AI from your OpenShift cluster.
11.1. Understanding the uninstallation process
Installing Red Hat OpenShift AI created several custom resource instances on your OpenShift cluster for various components of OpenShift AI. After installation, users likely created several additional resources while using OpenShift AI. Uninstalling OpenShift AI removes the resources that were created by the Operator, but retains the resources created by users to prevent inadvertently deleting information you might want.
What is deleted
Uninstalling OpenShift AI removes the following resources from your OpenShift cluster:
-
DataScienceCluster
custom resource instance -
DSCInitialization
custom resource instance -
FeatureTracker
custom resource instances created during or after installation -
ServiceMesh
custom resource instance created by the Operator during or after installation -
KNativeServing
custom resource instance created by the Operator during or after installation -
redhat-ods-applications
,redhat-ods-monitoring
, andrhods-notebooks
namespaces created by the Operator -
Workloads in the
rhods-notebooks
namespace -
Subscription
,ClusterServiceVersion
, andInstallPlan
objects -
KfDef
object (version 1 Operator only)
What might remain
Uninstalling OpenShift AI retains the following resources in your OpenShift cluster:
- Data science projects created by users
- Custom resource instances created by users
- Custom resource definitions (CRDs) created by users or by the Operator
While these resources might still remain in your OpenShift cluster, they are not functional. After uninstalling, Red Hat recommends that you review the data science projects and custom resources in your OpenShift cluster and delete anything no longer in use to prevent potential issues, such as pipelines that cannot run, notebooks that cannot be undeployed, or models that cannot be undeployed.
Additional resources
11.2. Backing up storage data from Amazon EBS
Red Hat recommends that you back up the data on your persistent volume claims (PVCs) regularly. Backing up your data is particularly important before deleting a user and before uninstalling OpenShift AI, as all PVCs are deleted when you uninstall OpenShift AI.
Prerequisites
- You have credentials for Red Hat OpenShift Cluster Manager (https://console.redhat.com/openshift/).
- You have administrator access to the OpenShift Dedicated cluster.
- You have credentials for the Amazon Web Services (AWS) account that the OpenShift Dedicated cluster is deployed under.
Procedure
Determine the IDs of the persistent volumes (PVs) that you want to back up.
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Home
Projects. Click the rhods-notebooks project.
The Details page for the project opens.
Click the PersistentVolumeClaims in the Inventory section.
The PersistentVolumeClaims page opens.
Note the ID of the persistent volume (PV) that you want to back up.
NoteThe persistent volumes (PV) that you make a note of are required to identify the correct EBS volume to back up in your AWS instance.
Locate the EBS volume containing the PVs that you want to back up.
See Amazon Web Services documentation: Create Amazon EBS snapshots for more information.
- Log in to AWS (https://aws.amazon.com) and ensure that you are viewing the region that your OpenShift Dedicated cluster is deployed in.
- Click Services.
-
Click Compute
EC2. Click Elastic Block Storage
Volumes in the side navigation. The Volumes page opens.
In the search bar, enter the ID of the persistent volume (PV) that you made a note of earlier.
The Volumes page reloads to display the search results.
-
Click the volume shown and verify that any
kubernetes.io/created-for/pvc/namespace
tags contain the valuerhods-notebooks
, and anykubernetes.io/created-for/pvc/name
tags match the name of the persistent volume that the EC2 volume is being used for, for example,jupyter-nb-user1-pvc
.
Back up the EBS volume that contains your persistent volume (PV).
Right-click the volume that you want to back up and select Create Snapshot from the list.
The Create Snapshot page opens.
- Enter a Description for the volume.
Click Create Snapshot.
The snapshot of the volume is created.
- Click Close.
Verification
- The snapshot that you created is visible on the Snapshots page in AWS.
Additional resources
11.3. Backing up storage data from Google Persistent Disk
Red Hat recommends that you back up the data on your persistent volume claims (PVCs) regularly. Backing up your data is particularly important before deleting a user and before uninstalling OpenShift AI, as all PVCs are deleted when OpenShift AI is uninstalled.
Prerequisites
- You have credentials for Red Hat OpenShift Cluster Manager (https://console.redhat.com/openshift/).
- You have administrator access to the OpenShift Dedicated cluster.
- You have credentials for the Google Cloud Platform (GCP) account that the OpenShift Dedicated cluster is deployed under.
Procedure
Determine the IDs of the persistent volumes (PVs) that you want to back up.
- In the OpenShift Dedicated web console, change into the Administrator perspective.
-
Click Home
Projects. Click the rhods-notebooks project.
The Details page for the project opens.
Click the PersistentVolumeClaims in the Inventory section.
The PersistentVolumeClaims page opens.
Note the ID of the persistent volume (PV) that you want to back up.
The persistent volume (PV) IDs are required to identify the correct persistent disk to back up in your GCP instance.
Locate the persistent disk containing the PVs that you want to back up.
- Log in to the Google Cloud console (https://console.cloud.google.com) and ensure that you are viewing the region that your OpenShift Dedicated cluster is deployed in.
- Click the navigation menu (≡) and then click Compute Engine.
From the side navigation, under Storage, click Disks.
The Disks page opens.
In the Filter query box, enter the ID of the persistent volume (PV) that you made a note of earlier.
The Disks page reloads to display the search results.
-
Click the disk shown and verify that any
kubernetes.io/created-for/pvc/namespace
tags contain the valuerhods-notebooks
, and anykubernetes.io/created-for/pvc/name
tags match the name of the persistent volume that the persistent disk is being used for, for example,jupyterhub-nb-user1-pvc
.
Back up the persistent disk that contains your persistent volume (PV).
Select CREATE SNAPSHOT from the top navigation.
The Create a snapshot page opens.
- Enter a unique Name for the snapshot.
- Under Source disk, verify the persistent disk you want to back up is displayed.
- Change any optional settings as needed.
Click CREATE.
The snapshot of the persistent disk is created.
Verification
- The snapshot that you created is visible on the Snapshots page in GCP.
Additional resources
11.4. Uninstalling OpenShift AI
You can use Red Hat OpenShift Cluster Manager to safely uninstall Red Hat OpenShift AI from your OpenShift cluster.
Prerequisites
- Credentials for Red Hat OpenShift Cluster Manager (https://console.redhat.com/openshift/).
- Administrator access to the OpenShift cluster.
- For AWS clusters, you have backed up the EBS volume containing your Persistent Volume Claims (PVCs). See Amazon Web Services documentation: Create Amazon EBS snapshots for more information.
- For GCP clusters, you have backed up the persistent disk containing your Persistent Volume Claims (PVCs). See Google Cloud documentation: Create and manage disk snapshots for more information.
Procedure
- Log in to Red Hat OpenShift Cluster Manager (https://console.redhat.com/openshift/).
Click Clusters.
The Clusters page opens.
Click the name of the cluster that hosts the instance OpenShift AI to uninstall.
The Details page for the cluster opens.
- Click the Add-ons tab and locate the Red Hat OpenShift AI tile.
Click Uninstall.
This process takes approximately 30 minutes to complete. Do not manually delete any resources while uninstalling OpenShift AI, as this can interfere with the uninstall process.
OpenShift AI is uninstalled and any persistent volume claims (PVCs) associated with your OpenShift AI instance are deleted. However, any user groups for OpenShift AI that you previously created remain on your cluster.
Verification
-
In Red Hat OpenShift Cluster Manager, on the Add-ons tab for the cluster, confirm that the OpenShift AI tile does not show the
Installed
state. In your OpenShift cluster, click Home
Projects and confirm that the following project namespaces are not visible: -
redhat-ods-applications
-
redhat-ods-monitoring
-
redhat-ods-operator
-