Object Storage

Distributed File System - User Guide | Object Storage Section

1. What Is Object Storage?

Object Storage in Karios DFS provides S3 and Swift-compatible storage for unstructured data such as files, images, backups, logs, and documents. Unlike file system mounts or block-device attachments, object storage uses standard HTTP-based API calls.

The three components of Object Storage in Karios DFS:

Component

What It Is

What You Do With It

Users

S3/Swift user accounts with access credentials

Create users, issue access keys, set storage quotas

Gateway

The RADOS Gateway (RGW) daemon, the S3/Swift API endpoint

Monitor gateway health and performance

Buckets

Named containers that hold your objects

Create buckets, assign owners, manage settings

Correct setup order for a new deployment:

  1. Go to Gateway first and confirm at least one gateway daemon is Running.

  2. Go to Users and create a user account.

  3. Retrieve that user’s S3 Access Key and Secret Key.

  4. Go to Buckets and create a bucket owned by that user.

  5. Configure your S3 client with gateway endpoint, access key, and secret key.

Tip

Use the endpoint URL defined for your environment (for example a load balancer or DNS name). Do not assume clients must connect directly to a single gateway host.

Prerequisite check before using Object Storage:

  • At least one pool exists in Storage > Pools with Application = rgw.

  • At least one Object Gateway daemon is running in Object Storage > Gateway.

  • Dashboard shows Object Gateways count greater than 0.

Note

If no gateway daemon is running, contact your Karios administrator to deploy the RGW service via Infrastructure > Services.

Note

Screenshot values shown in this section are environment-specific UI examples. Do not treat any displayed value as a fixed preset.

2. Quick Reference - Object Storage Setup Sequence

Use this checklist for a first-time Object Storage setup.

#

What To Do

Where To Go

How

Success Looks Like

1

Confirm gateway is running

Object Storage > Gateway > Gateways

Check daemon rows show Status = Running

At least one daemon is Running

2

Note the gateway endpoint

Object Storage > Gateway > Gateways

Record hostname and port for a running daemon

You have the environment-approved endpoint URL (protocol, host, and port)

3

Create a user

Object Storage > Users > + Create User

Enter User ID and Full Name, keep auto-generate key enabled, click Create User

User appears in list with Suspended = No

4

Retrieve S3 credentials

Users > expanded row > Keys

Reveal Secret Key and copy both keys

You have Access Key ID and Secret Key

5

Create a bucket

Object Storage > Buckets > + Create Bucket

Enter Bucket Name, select Owner, click Create

Bucket appears with Objects = 0 and Size = 0 B

6

Verify bucket details

Buckets > expanded row > Details

Confirm Owner, Versioning, Encryption, and Object Locking

Details match your expected configuration

7

Configure S3 client

Your S3 client application

Set endpoint URL, Access Key, Secret Key, and bucket name

Client can list and upload objects

8

Test upload

S3 client

Upload a test file

Object appears in bucket

9

Verify object in UI

Buckets > expanded row > Objects

Confirm object name and size

Uploaded object is listed

3. All Actions - Object Storage Summary

Section

Action

How To Access

What It Does

Result

Users

Create User

+ Create User button

Opens the form to create an S3/Swift user account

User is created with auto-generated S3 credentials

Users

Edit User

Expanded row > then Edit

Modifies name, email, max buckets, suspended state, and quotas

Changes apply immediately

Users

Delete User

Trash icon on user row

Permanently removes user and access keys

User and keys are deleted; buckets remain unless handled separately

Users

View Keys

Expanded row > then Keys

Shows Access Key and masked Secret Key

Reveal icon shows full Secret Key

Users

Edit Quota

Expanded row > then Quota button

Sets Max Size and Max Objects limits

Quota enforcement updates immediately

Roles

Create Role

Roles tab then + Create Role

Creates an IAM role with trust policy

Role appears with ARN

Gateway

View Gateways

Gateway > Gateways tab

Lists RGW daemons and status

Live gateway health view

Gateway

View Performance

Gateway > Overall Performance tab

Shows total daemon, zone, and zone-group metrics

Summary metrics are visible

Buckets

Create Bucket

+ Create Bucket button

Opens bucket creation form

Bucket is created and ready for uploads

Buckets

Edit Bucket

Pencil icon or expanded row Edit

Changes owner, versioning, quota, and object-lock settings

Changes apply immediately

Buckets

Delete Bucket

Trash icon on bucket row

Permanently removes the bucket

Bucket is deleted (must be empty first)

Buckets

View Objects

Expanded row > then Objects

Lists objects stored in bucket

Object list is available for verification

Object Storage Sections