File System

This content is not available in your language yet.

The File System page allows you to manage Ceph File Systems (CephFS) and Network File System (NFS) exports. CephFS provides a POSIX-compliant file system on top of the Ceph cluster, while NFS exports allow you to share these file systems with standard NFS clients.

The page is divided into two main sections: NFS and Group.

NFS

The NFS section allows you to manage subvolumes and export them via NFS.

Statistics Overview

At the top of the page, you will find a dashboard summarizing the state of NFS exports configured in the system:

NFS

The total number of NFS exports created from CephFS subvolumes.

Introduction

The NFS table displays a list of subvolumes. The table includes the following information:

Column	Description
Name	The name of the subvolume.
Pool Name	The data pool where the subvolume is stored.
Export	Displays the NFS export host. Click the information icon in the Export column to view the export IP, path, allowed clients, and the mount command. Use the copy icon to copy the mount command directly.
Usage	A progress bar showing the storage capacity usage (Used Space / Quota Size).
Created Time	Displays how long ago the NFS export was created, relative to the current time.
Snapshots	The number of snapshots taken of this subvolume. Clicking the external link icon opens a detailed view of the snapshots.

Create NFS Export

You can create new subvolumes and export them via NFS.

Click the Create button.
Name: Enter a unique name for the subvolume.
Group: Displays the current subvolume group (default is default).
Quota Size: Specify the size limit for the subvolume (e.g., 10 GB).
Click Confirm to create the subvolume.

Mount NFS Export

After an NFS export is created and access is granted, clients can mount the export using standard NFS commands.

Prerequisites

An NFS export has been created.
The client IP address (or CIDR range) has been granted access to the export.
The client has NFS utilities installed.

Open the information icon in the Export column of the NFS table.
Copy the mount command using the copy icon.
Log in to the target client machine.
Create a mount directory if it does not already exist:
Terminal window
```
    sudo mkdir -p /mnt/nfs
```

Run the copied mount command:

    sudo mount -t  nfs4 -o nfsvers=4.1 -v <NFS_IP>:<EXPORT_PATH> /mnt/nfs

Verify that the file system is mounted successfully:
Terminal window
```
    mount | grep nfs
```

Manage NFS Exports

You can manage access, modify quotas, or delete NFS exports using the Actions menu.

Grant/Revoke Access

Control which clients can access the NFS export.

Grant Access: Adds a client IP address to the allowed list. For example, You can specify a single IP address 192.168.10.151 or a CIDR range 192.168.10.0/24.
Revoke Access: Removes a client IP address from the allowed list.

Edit NFS Export

Allows you to resize the subvolume quota.

Select Edit from the actions menu (pencil icon).
Update the Quota Size.
Click Confirm to save changes.

Delete NFS Export

Permanently removes the subvolume and its export.

Select Delete from the actions menu (trash icon).
Type the name of the subvolume to confirm deletion.
Click Confirm to permanently delete the subvolume.

Manage Snapshots

Snapshots provide a read-only copy of the subvolume at a specific point in time. You can view and manage snapshots by clicking the external link icon in the Snapshots column.

Snapshot List

The snapshot list displays the following information:

Column	Description
Name	The name of the snapshot.
Pending Clones	Indicates if there are any pending clones based on this snapshot.
Created Time	Displays how long ago the snapshot was created, relative to the current time.

Snapshot Actions

Create Snapshot

Create Snapshot allows you to capture a read-only point-in-time copy of the subvolume.

Click the external link icon in the Snapshots column to open the snapshot list.
Click the Create button.
Name: Enter a unique name for the snapshot.
Click Confirm to create the snapshot.

Delete Snapshot

Delete Snapshot permanently removes an existing snapshot.

Click the external link icon in the Snapshots column to open the snapshot list.
Open the Actions menu for the target snapshot.
Select Delete.
Type the name of the snapshot to confirm deletion.
Click Confirm to permanently delete the snapshot.

Group

The Group section allows you to manage subvolume groups, which are used to organize subvolumes.

Statistics Overview

At the top of the page, you will find a dashboard summarizing the state of subvolume groups configured in the file system:

Group

The total number of subvolume groups defined in the file system.

Introduction

The Group table displays a list of subvolume groups. The table includes the following information:

Column	Description
Name	The name of the subvolume group.
Pool Name	The data pool associated with the group.
Usage	A progress bar showing the cumulative usage of all subvolumes in the group.
Created Time	Displays how long ago the subvolume group was created, relative to the current time.

Create Group

You can create new subvolume groups to organize your file systems.

Click the Create button.
Name: Enter a unique name for the group.
Quota Size: Optionally set a quota for the group.
Click Confirm to create the group.

Manage Groups

Edit Group

Allows you to resize the group quota.

Select Edit from the actions menu (pencil icon).
Update the Quota Size.
Click Confirm to save changes.

Delete Group

Permanently removes a subvolume group.

Select Delete from the actions menu (trash icon).
Type the name of the group to confirm deletion.
Click Confirm to permanently delete the group.