This document is for a development version of Ceph.
cephadm is a utility that is used to manage a Ceph cluster.
Here is a list of some of the things that
cephadm can do:
cephadmcan add a Ceph container to the cluster.
cephadmcan remove a Ceph container from the cluster.
cephadmcan update Ceph containers.
cephadm does not rely on external configuration tools like Ansible, Rook,
or Salt. However, those external configuration tools can be used to automate
operations not performed by cephadm itself. To learn more about these external
configuration tools, visit their pages:
cephadm manages the full lifecycle of a Ceph cluster. This lifecycle starts
with the bootstrapping process, when
cephadm creates a tiny Ceph cluster on
a single node. This cluster consists of one monitor and one manager.
cephadm then uses the orchestration interface to expand the cluster, adding
hosts and provisioning Ceph daemons and services. Management of this lifecycle
can be performed either via the Ceph command-line interface (CLI) or via the
cephadm to get started with Ceph, follow the instructions in
Deploying a new Ceph cluster.
cephadm was introduced in Ceph release v15.2.0 (Octopus) and does not
support older versions of Ceph.
- Compatibility and Stability
- Deploying a new Ceph cluster
- Converting an existing cluster to cephadm
- Host Management
- Service Management
- MON Service
- MGR Service
- OSD Service
- RGW Service
- MDS Service
- NFS Service
- iSCSI Service
- Custom Container Service
- Monitoring Services
- SNMP Gateway Service
- Tracing Services
- Service Status
- Daemon Status
- Service Specification
- Daemon Placement
- Extra Container Arguments
- Extra Entrypoint Arguments
- Custom Config Files
- Removing a Service
- Disabling automatic deployment of daemons
- Upgrading Ceph
- Cephadm operations
- Client Setup
- Pausing or disabling cephadm
- Per-service and per-daemon events
- Checking cephadm logs
- Gathering log files
- Collecting systemd status
- List all downloaded container images
- Manually running containers
- SSH errors
- Failed to infer CIDR network error
- Accessing the admin socket
- Calling miscellaneous ceph tools
- Restoring the MON quorum
- Manually deploying a MGR daemon
- Analyzing core dumps
- Cephadm Feature Planning