Storage

Distributed File System - User Guide | Storage Section

This section contains storage-only workflows:

  • Pools

  • File System

  • NFS Shares

Note

Input values shown in storage steps are reference examples. Use your own names, paths, quotas, and policy values for your environment.

Note

Cluster health and infrastructure readiness are covered in Karios DFS Overview and Dashboard.

Storage Setup Order

Follow this order for storage configuration:

  1. Create a pool in Pools.

  2. Verify pool PG status reaches active+clean.

  3. Open File System and create a new file system if none exists yet.

  4. Verify Active MDS and standby MDS are healthy.

  5. Create an export in NFS (NFS Shares page).

  6. Test client mount and read/write behavior.

Storage Action Intent (Why, Impact, When)

Section

Action

Why

Impact

When

Pools

Create Pool

Defines protected storage space for upcoming workloads.

Adds a new managed storage domain with policy controls.

Before any file system, block, or object data onboarding.

Pools

Edit/Delete Pool

Aligns or retires pool policy over time.

Edit can rebalance data; delete is permanent data loss.

Edit during policy change; delete only after dependency cleanup.

File System

Snapshot/Subvolume/Delete

Protects data, segments workloads, or decommissions filesystem.

Snapshot adds rollback point; delete destroys filesystem data.

Snapshot before risky change; delete only after backup and unmount checks.

NFS

Create/Edit/Delete Export

Controls how clients access DFS data over network.

Changes client access behavior immediately.

During access onboarding, policy updates, or export retirement.

Storage-Only Quick Checklist

#

What to Do

Where to Go

How

Success Looks Like

1

Create storage pool

Storage > Pools

Click + Create Pool and fill required fields

Pool listed, active+clean in 1-2 minutes

2

Confirm pool readiness

Storage > Pools > Details

Check PG state and usage

Pool is ready for filesystem use

3

Create or open file system

Storage > File System

Use + Create File System when no file system exists, otherwise expand the row and open Details

File system exists and Active MDS / Standby MDS are visible

4

Validate filesystem health

File System > Details

Check active + standby MDS and usage bars

Healthy MDS state and safe utilization

5

Create NFS export

Storage > NFS Shares

Click + Create Export and configure export values

Export listed with Export ID

6

Test mount from client

Client terminal

Run NFS mount command using pseudo path

Mount works and data is accessible

Storage Actions Summary

Section

Action

How to Access

What It Does

Result

Pools

Create Pool

+ Create Pool

Opens pool creation form

Pool appears and converges to active+clean

Pools

Edit Pool

Actions menu Edit Pool

Updates pool settings

Changes apply immediately

Pools

Delete Pool

Actions menu Delete Pool

Removes pool and its data

Irreversible data loss

File System

Create File System

+ Create File System

Creates a new CephFS file system with metadata and data pools

File system row appears and MDS services converge

File System

View File System Details

Expand filesystem row (>)

Opens tabbed details view for the selected filesystem

Details/MDS/Clients/Subvolumes/Performance tabs are available

File System

Create Snapshot

Camera icon

Captures point-in-time state

Snapshot available via .snap on mount

File System

Create Subvolume

Folder-plus icon

Creates quota-scoped subvolume

Subvolume visible in Subvolumes tab

File System

Delete File System

Red trash icon

Deletes filesystem data

Data removed permanently; pools remain

NFS

Create Export

+ Create Export

Creates new NFS share

Export appears and is mountable

NFS

Edit Export

Pencil icon or details panel Edit

Modifies export settings

Changes apply immediately

NFS

Delete Export

Trash icon

Removes export access path

Client access removed; backend data remains