Skip to main content
RunBook Academy

← All break/fix scenarios in Proxmox VE

intermediateCeph~20 min

Ceph OSD is down and the cluster is in HEALTH_WARN

Reported symptoms

  • ceph -s reports health: HEALTH_WARN with 1 osds down
  • PGs in active+clean+remapped state
  • One OSD host has higher I/O wait than the others
  • No alert email from the storage team yet (within SLA)

Evidence

  • · ceph osd tree shows osd.5 down with host pve-02
  • · ceph osd df tree shows osd.5 with weight 0 but capacity still reported
  • · journalctl -u ceph-osd@5 on pve-02 shows OSD crashed 4 hours ago
  • · dmesg on pve-02 shows I/O errors against /dev/sdc
Diagnosis and resolutionclick to reveal

Root cause

The disk backing osd.5 (here /dev/sdc on pve-02) has developed I/O errors. The OSD process crashed, but the cluster didn't remove the OSD from the CRUSH map because the disk is still physically present. PGs that were on osd.5 are remapped to other OSDs but data is degraded.

Remediation

1. Pull the disk: `ceph osd purge osd.5 --yes-i-really-mean-it` (use `purge` if the OSD is permanently down and you want to skip the recovery wait; use `out` then `down` then `purge` for the safer path). 2. Replace the disk physically. 3. Recreate the OSD on the new disk: `ceph-volume lvm create --data /dev/sdc`. 4. Verify CRUSH weight: `ceph osd tree` should show osd.5 with the full weight and `up`. 5. Watch recovery: `ceph -w` (live console) shows PGs transitioning from active+clean+remapped to active+clean.

Verification

- `ceph -s` reports health: HEALTH_OK - `ceph osd tree` shows osd.5 up with full weight - All PGs are `active+clean` (no remapped or degraded) - `ceph df` shows the expected usable capacity

Prevention

- Add SMART monitoring for disks backing OSDs - Configure ZFS / mdadm scrubbing for non-Ceph redundancy layers - Alert on `HEALTH_WARN` rather than only `HEALTH_ERR` - Test the OSD replacement procedure in a lab before you need it

Ceph OSD down: replace and recover

This is the bread-and-butter Ceph incident. The cluster is degraded but still serving data. Your goal is to remove the bad OSD cleanly, replace the disk, and bring it back without overloading the survivors during recovery.