Ceph cluster recovery

A Ceph cluster with down OSDs and degraded placement groups needs state preservation before recovery remaps data.

Ceph can continue serving some data while OSDs are down or placement groups are degraded. Automatic remapping and recovery are normal availability features, but they also change where object copies live and can complicate evidence after multiple failures.

Understand the symptom

Down, out, degraded, incomplete, and unfound describe different recovery conditions.

WHY

What is happening

An OSD can be down but still in the cluster, after which monitors may mark it out and remap placement groups. Degraded PGs may remain readable, while incomplete or unfound objects require surviving histories and replicas. Network faults, full ratios, failed devices, stale maps, and simultaneous node loss must be separated before replacing or reinitializing OSDs.

What you may see

Symptoms that change the recovery path.

01

OSD is down and in

The daemon or host is unavailable while CRUSH still assigns data to that OSD.

02

PGs are degraded or undersized

The cluster has fewer available replicas than the pool policy expects.

03

PGs are incomplete or peering

Ceph cannot establish an authoritative object history from the currently available set.

04

Objects are unfound

Expected object versions are not present on reachable OSDs.

Protect the source

Actions that can make the situation worse.

01

Marking out triggers remapping

Large-scale recovery writes can change surviving replicas and increase load during an unstable incident.

02

OSD recreation destroys local evidence

Zap, purge, or redeploy operations can erase BlueStore metadata and object data.

03

Declaring objects lost is irreversible

Lost-object commands can remove references when the missing OSD or history might still be recoverable.

Do this now

Safe steps before evaluation.

01

Freeze unnecessary changes

Pause automation, upgrades, balancing, scrubbing, and OSD replacement while the incident is recorded.

02

Capture cluster state

Save ceph status, health detail, osd tree, df, pg states, maps, crash reports, and relevant logs.

03

Preserve OSD devices

Keep failed drives, DB or WAL devices, encryption keys, labels, host assignments, and original servers.

04

Document the timeline

Record power, network, fullness, maintenance, replacements, noout flags, and commands that preceded the failure.

NEPFOSYS process

How a data-first evaluation proceeds.

01

Cluster-state analysis

NEPFOSYS correlates maps, PG histories, CRUSH placement, OSD metadata, device health, and business priorities.

02

Source preservation

Relevant OSD, DB, WAL, and host storage are acquired or held unchanged before destructive remediation.

03

Object and filesystem extraction

Recoverable pools, RBD images, filesystems, or priority objects are reconstructed from protected sources.

A clear next step

Preserve the original device before another repair or recovery attempt.

Start a case with the exact symptoms, incident timeline, prior attempts, encryption details, and the files that matter most. NEPFOSYS will route the case to the appropriate DFW intake or nationwide mail-in path.

Start with a case review

Questions, answered

What customers ask before starting.

Does degraded mean all data is lost?

No. Many degraded PGs remain active and readable, but redundancy is reduced and the condition should be stabilized before more failures occur.

Should I mark a down OSD out immediately?

Not automatically during a multi-failure recovery. Marking out initiates remapping and should follow a review of capacity, replicas, device condition, and the incident timeline.

What should be preserved from each OSD host?

Keep the data devices, BlueStore DB and WAL devices, keys, labels, OSD IDs, logs, maps, configuration, and host-to-device assignments.

DFW local · Nationwide mail-in

Protect the device. Start with the facts.

Start my recovery case