2020-03-15 13:45:46 +00:00
|
|
|
.. _cephadm:
|
2020-02-03 15:31:36 +00:00
|
|
|
|
2020-03-15 13:45:46 +00:00
|
|
|
=======
|
|
|
|
|
Cephadm
|
|
|
|
|
=======
|
2019-10-04 17:40:05 +00:00
|
|
|
|
2022-10-23 01:09:18 +00:00
|
|
|
``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:
|
|
|
|
|
|
|
|
|
|
- ``cephadm`` can add a Ceph container to the cluster.
|
|
|
|
|
- ``cephadm`` can remove a Ceph container from the cluster.
|
|
|
|
|
- ``cephadm`` can 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
|
2022-10-24 03:48:47 +00:00
|
|
|
configuration tools, visit their pages:
|
2022-10-23 01:09:18 +00:00
|
|
|
|
|
|
|
|
* https://github.com/ceph/cephadm-ansible
|
2022-10-24 03:48:47 +00:00
|
|
|
* https://rook.io/docs/rook/v1.10/Getting-Started/intro/
|
2022-11-03 14:16:34 +00:00
|
|
|
* https://github.com/ceph/ceph-salt
|
2022-10-23 01:09:18 +00:00
|
|
|
|
|
|
|
|
``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
|
|
|
|
|
dashboard (GUI).
|
|
|
|
|
|
2022-10-24 03:48:47 +00:00
|
|
|
To use ``cephadm`` to get started with Ceph, follow the instructions in
|
2022-10-23 01:09:18 +00:00
|
|
|
:ref:`cephadm_deploying_new_cluster`.
|
|
|
|
|
|
|
|
|
|
``cephadm`` was introduced in Ceph release v15.2.0 (Octopus) and does not
|
|
|
|
|
support older versions of Ceph.
|
2020-02-26 10:40:51 +00:00
|
|
|
|
|
|
|
|
.. toctree::
|
2021-09-13 15:15:33 +00:00
|
|
|
:maxdepth: 2
|
2020-02-26 10:40:51 +00:00
|
|
|
|
2021-03-03 13:00:51 +00:00
|
|
|
compatibility
|
2020-03-15 13:45:46 +00:00
|
|
|
install
|
|
|
|
|
adoption
|
2021-02-18 12:43:09 +00:00
|
|
|
host-management
|
2021-09-13 15:12:01 +00:00
|
|
|
Service Management <services/index>
|
2020-03-15 21:38:42 +00:00
|
|
|
upgrade
|
2020-03-15 13:45:46 +00:00
|
|
|
Cephadm operations <operations>
|
2019-11-25 18:38:49 +00:00
|
|
|
Client Setup <client-setup>
|
2020-03-15 13:45:46 +00:00
|
|
|
troubleshooting
|
2020-09-14 11:15:55 +00:00
|
|
|
Cephadm Feature Planning <../dev/cephadm/index>
|
