Replacing failed disk/OSD in Ceph

There are quite a few guides out there on how to do what I'd consider a pretty essential part of manager a Ceph storage cluster, yet the ones I came across never took me through the entire procedure:

  1. On a healthy cluster, run a script to map OSDs to disk serial numbers such that you can yank out the correct drive in event of failure 🙂
  2. Identify which OSD has gone down
  3. Safely remove the damaged drive from the cluster
  4. Pull out the drive
  5. Insert the new drive
  6. Add the new drive to the cluster

Let's start by creating the script which will map serial numbers to the corresponding OSD:

Create a file


DISKS=`ceph-disk list | grep "ceph data"`
#echo $DISKS
for DISK in $DISKS; do
        DEV=`awk '{print $1}' <<< $DISK`
        OSD=`awk '{print $7}' <<< $DISK`
        DEV=`echo $DEV | sed -e 's//dev///g'`
        ID=`ls -l /dev/disk/by-id | grep $DEV | awk '{print $9}' | egrep -v "wwn"`
        echo $OSD $ID

Next, add executable permissions to this file

chmod +x

Then run this file to output the OSD and the associated disk serial number with the following:


Next, identify which OSD has gone down:

ceph osd tree

Let's assume OSD 9 has gone down

Next, run the following commands in order to remove OSD 9 from the cluster:

ceph osd crush reweight osd.9 0
ceph osd out osd.9
ceph osd crush remove osd.9
systemctl stop ceph-osd@9.service
ceph auth del osd.9
ceph osd rm osd.9
umount /var/lib/ceph/osd/ceph-9

Next, match the failed OSD with the correct disk serial number and pull out the failed disk from the drive bay.

Next, insert the new disk and take note of its mount point by running the following command:


Assuming the mount point is /dev/sdn, run the following command:

ceph-disk prepare --zap --cluster ceph --cluster-uuid f3a876fa-36c3-457a-9883-a4194f652da0 --fs-type xfs /dev/sdn /dev/sdn2

The cluster uuid can be obtained by running:

ceph -s

Finally, run:

ceph-disk activate /dev/sdn1

Ceph will now rebalance and your new OSD will be up and in the cluster.