Chapter 4. Configuring cluster storage
4.1. Adding cluster storage to your data science project
For data science projects that require data to be retained, you can add cluster storage to the project. Additionally, you can also connect cluster storage to a specific project’s workbench.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project that you can add cluster storage to.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project that you want to add the cluster storage to.
A project details page opens.
- Click the Cluster storage tab.
Click Add cluster storage.
The Add storage dialog opens.
- Enter a name for the cluster storage.
- Enter a description for the cluster storage.
- Under Persistent storage size, enter a new size in gibibytes. The minimum size is 1 GiB, and the maximum size is 16384 GiB.
- Optional: Select a workbench from the list to connect the cluster storage to an existing workbench.
- If you selected a workbench to connect the storage to, enter the storage directory in the Mount folder field.
- Click Add storage.
Verification
- The cluster storage that you added appears in the Cluster storage tab for the project.
- A new persistent volume claim (PVC) is created with the storage size that you defined.
- The persistent volume claim (PVC) is visible as an attached storage in the Workbenches tab for the project.
4.2. Updating cluster storage
If your data science work requires you to change the identifying information of a project’s cluster storage or the workbench that the storage is connected to, you can update your project’s cluster storage to change these properties.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project that contains cluster storage.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project whose storage you want to update.
A project details page opens.
- Click the Cluster storage tab.
Click the action menu (⋮) beside the storage that you want to update and then click Edit storage.
The Edit storage page opens.
Update the storage’s properties.
- Update the name for the storage, if applicable.
- Update the description for the storage, if applicable.
Increase the Persistent storage size for the storage, if applicable.
Note that you can only increase the storage size. Updating the storage size restarts the workbench and makes it unavailable for a period of time that is usually proportional to the size change.
- Update the workbench that the storage is connected to, if applicable.
- If you selected a new workbench to connect the storage to, enter the storage directory in the Mount folder field.
- Click Update storage.
If you increased the storage size, the workbench restarts and is unavailable for a period of time that is usually proportional to the size change.
Verification
- The storage that you updated appears in the Cluster storage tab for the project.
4.3. Deleting cluster storage from a data science project
You can delete cluster storage from your data science projects to help you free up resources and delete unwanted storage space.
Prerequisites
- You have logged in to Red Hat OpenShift AI.
-
If you are using specialized OpenShift AI groups, you are part of the user group or admin group (for example,
rhoai-usersorrhoai-admins) in OpenShift. - You have created a data science project with cluster storage.
Procedure
From the OpenShift AI dashboard, click Data Science Projects.
The Data Science Projects page opens.
Click the name of the project that you want to delete the storage from.
A project details page opens.
- Click the Cluster storage tab.
Click the action menu (⋮) beside the storage that you want to delete and then click Delete storage.
The Delete storage dialog opens.
- Enter the name of the storage in the text field to confirm that you intend to delete it.
- Click Delete storage.
Verification
- The storage that you deleted is no longer displayed in the Cluster storage tab for the project.
- The persistent volume (PV) and persistent volume claim (PVC) associated with the cluster storage are both permanently deleted. This data is not recoverable.
