Subvolumes

This section covers managing Subvolume Groups and individual Subvolumes for organizing and controlling access to storage within a larger volume.

Accessing Subvolumes

To access the Subvolume section:

• Go to Sidebar Menu ➝ Click on Volumes ➝ Select Subvolume Group or Subvolumes

Subvolume Groups

Overview

The Subvolume Group interface allows users to:

• Create logical groupings of subvolumes.
• Allocate space and assign access permissions.
• Edit or delete existing groups.

Subvolume Group List View

The main table provides a summary of existing Subvolume Groups:

Click “Add Subvolume Group” (top-right) to create a new one.

Creating a Subvolume Group

Click on Add Subvolume Group to open the creation form.

Fields

Permissions (Mode Section)

Set read/write/execute access for:

• ✅ Owner
• ✅ Group
• ✅ Others
• ✅ All (applies to everyone)

Buttons

• 🔵 Create Subvolume Group – to save.
• ⚪ Cancel – to discard the operation.

Editing a Subvolume Group

Click the ✏️ Edit button in the list view.

Edit the following:

• Name, Size, UID/GID, and Permissions.

Click Update Subvolume Group to save changes.

Deleting a Subvolume Group

Click the 🗑️ Delete icon. A confirmation modal will appear.

Subvolumes

Overview

The Subvolumes page allows users to manage individual subvolumes under specific subvolume groups. Subvolumes are logical units used for organizing and controlling access to storage within a larger volume (e.g., cephfs).

Users can create, edit, and delete subvolumes, define their sizes, ownership, and set access permissions.

Accessing the Subvolumes Page

To navigate to the Subvolumes section:

1. In the left sidebar, click on “Volumes”.
2. Select “Subvolumes”.

Subvolumes Interface Overview

The page is split into two panels:

• Left Panel (Groups): Displays available Subvolume Groups (e.g., datnass). Select a group to view its subvolumes.
• Right Panel (Subvolumes): Displays subvolumes under the selected group.

Columns Displayed

Add a Subvolume

To create a new subvolume:

1. Click the "+ Add Subvolume" button (top-right).
2. Fill in the following fields:

3. Click “Create Subvolume”.

Edit a Subvolume

To modify an existing subvolume:

1. Click the Edit icon (pencil) in the Actions column.
2. You can update:
   • Size
   • Permissions
   • UID / GID
3. The name cannot be changed once created.
4. Click “Update Subvolume”.

Delete a Subvolume

To delete a subvolume:

1. Click the red trash icon in the Actions column.
2. In the confirmation dialog:
   • Verify the Resource Name to ensure you are deleting the correct subvolume.
   • (Optional) Check Retain snapshots if you want to keep the snapshots of the subvolume while deleting the main resource.
3. Click REMOVE SUBVOLUME to confirm deletion, or CANCEL to abort.

Permissions Reference

Permissions control the access levels for different user types:

Permission Types

Permission Examples