LinuxCommandLibrary

ceph

distributed storage cluster management

TLDR

Check cluster health status

$ ceph status
copy
Check cluster usage stats
$ ceph df
copy
Get placement group statistics
$ ceph pg dump --format [plain]
copy
Create a storage pool
$ ceph osd pool create [pool_name] [page_number]
copy
Delete a storage pool
$ ceph osd pool delete [pool_name]
copy
Rename a storage pool
$ ceph osd pool rename [current_name] [new_name]
copy
Self-repair pool storage
$ ceph pg repair [pool_name]
copy

SYNOPSIS

ceph [options] command

DESCRIPTION

ceph is the command-line interface for managing Ceph distributed storage clusters. Ceph provides unified object, block, and file storage with automatic data replication, self-healing, and no single point of failure.
The command communicates with the Ceph monitor daemons to perform cluster administration tasks including checking health status, managing OSDs (Object Storage Daemons), configuring placement groups, and handling authentication. It serves as the primary tool for day-to-day cluster operations and troubleshooting.
Ceph organizes data into pools, which contain placement groups that map to OSDs across the cluster. The `ceph status` command provides a quick overview of cluster health, while more specific subcommands allow fine-grained control over individual components.

PARAMETERS

-s, --status

Show cluster status
--format format
Output format: json, plain
-c file
Use alternate config file

CONFIGURATION

/etc/ceph/ceph.conf

Main cluster configuration including monitor addresses, authentication settings, and OSD parameters.
/etc/ceph/ceph.client.admin.keyring
Admin authentication keyring for cluster access.

SUBCOMMANDS

status

Show cluster health and status
df
Show cluster disk usage
osd
Manage Object Storage Daemons
pg
Manage placement groups
mon
Manage monitor daemons
mds
Manage metadata servers
auth
Manage authentication

CAVEATS

Requires proper Ceph configuration and authentication. Cluster operations may take time to complete. Some commands require specific permissions.

SEE ALSO

cephadm(8), rbd(8), rados(8)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community