This document is for a development version of Ceph.
Converting an existing cluster to cephadm¶
It is possible to convert some existing clusters so that they can be managed
cephadm. This statment applies to some clusters that were deployed
This section of the documentation explains how to determine whether your
clusters can be converted to a state in which they can be managed by
cephadm and how to perform those conversions.
Cephadm works only with BlueStore OSDs. FileStore OSDs that are in your cluster cannot be managed with
Make sure that the
cephadmcommand line tool is available on each host in the existing cluster. See Install cephadm to learn how.
Prepare each host for use by
cephadmby running this command:
Choose a version of Ceph to use for the conversion. This procedure will work with any release of Ceph that is Octopus (15.2.z) or later, inclusive. The latest stable release of Ceph is the default. You might be upgrading from an earlier Ceph release at the same time that you’re performing this conversion; if you are upgrading from an earlier release, make sure to follow any upgrade-releated instructions for that release.
Pass the image to cephadm with the following command:
cephadm --image $IMAGE <rest of command goes here>
The conversion begins.
Confirm that the conversion is underway by running
cephadm lsand making sure that the style of the daemons is changed:
Before starting the converstion process,
cephadm lsshows all existing daemons to have a style of
legacy. As the adoption process progresses, adopted daemons will appear with a style of
Make sure that the ceph configuration has been migrated to use the cluster config database. If the
/etc/ceph/ceph.confis identical on each host, then the following command can be run on one single host and will affect all hosts:
ceph config assimilate-conf -i /etc/ceph/ceph.conf
If there are configuration variations between hosts, you will need to repeat this command on each host. During this adoption process, view the cluster’s configuration to confirm that it is complete by running the following command:
ceph config dump
Adopt each monitor:
cephadm adopt --style legacy --name mon.<hostname>
Each legacy monitor should stop, quickly restart as a cephadm container, and rejoin the quorum.
Adopt each manager:
cephadm adopt --style legacy --name mgr.<hostname>
ceph mgr module enable cephadm ceph orch set backend cephadm
Generate an SSH key:
ceph cephadm generate-key ceph cephadm get-pub-key > ~/ceph.pub
Install the cluster SSH key on each host in the cluster:
ssh-copy-id -f -i ~/ceph.pub root@<host>
It is also possible to import an existing ssh key. See ssh errors in the troubleshooting document for instructions that describe how to import existing ssh keys.
Tell cephadm which hosts to manage:
ceph orch host add <hostname> [ip-address]
This will perform a
cephadm check-hoston each host before adding it; this check ensures that the host is functioning properly. The IP address argument is recommended; if not provided, then the host name will be resolved via DNS.
Verify that the adopted monitor and manager daemons are visible:
ceph orch ps
Adopt all OSDs in the cluster:
cephadm adopt --style legacy --name <name>
cephadm adopt --style legacy --name osd.1 cephadm adopt --style legacy --name osd.2
Redeploy MDS daemons by telling cephadm how many daemons to run for each file system. List file systems by name with the command
ceph fs ls. Run the following command on the master nodes to redeploy the MDS daemons:
ceph orch apply mds <fs-name> [--placement=<placement>]
For example, in a cluster with a single file system called foo:
ceph fs ls
name: foo, metadata pool: foo_metadata, data pools: [foo_data ]
ceph orch apply mds foo 2
Confirm that the new MDS daemons have started:
ceph orch ps --daemon-type mds
Finally, stop and remove the legacy MDS daemons:
systemctl stop ceph-mds.target rm -rf /var/lib/ceph/mds/ceph-*
Redeploy RGW daemons. Cephadm manages RGW daemons by zone. For each zone, deploy new RGW daemons with cephadm:
ceph orch apply rgw <svc_id> [--realm=<realm>] [--zone=<zone>] [--port=<port>] [--ssl] [--placement=<placement>]
where <placement> can be a simple daemon count, or a list of specific hosts (see Placement Specification), and the zone and realm arguments are needed only for a multisite setup.
After the daemons have started and you have confirmed that they are functioning, stop and remove the old, legacy daemons:
systemctl stop ceph-rgw.target rm -rf /var/lib/ceph/radosgw/ceph-*
Check the output of the command
ceph health detailfor cephadm warnings about stray cluster daemons or hosts that are not yet managed by cephadm.