Validate the cluster after a major recovery
1 · Prerequisites
Confirm every item is in place before any state change.
- A major recovery has just completed
- The cluster is HEALTH_OK
- The cluster needs to be validated
2 · Pre-checks
Read-only diagnostic commands. If any of these don't match expected output, stop and investigate further.
- · Capture the cluster state: ceph -s, ceph health detail
- · Check ceph osd tree: all OSDs up + in
- · Check ceph pg stat: no stuck PGs
- · Check ceph df: usable capacity is as expected
- · Run a scrub / deep scrub if needed
- · Run a benchmark to validate performance
3 · Procedure
Execute each step in order. Verify the expected output of a step before moving to the next.
- 1Document the cluster state in the runbook
- 2Verify each pools policy is correct
- 3Run a benchmark for the applications expected load
- 4Update capacity forecast if needed
- 5Update the runbook with any new findings
4 · Verification
Confirm the procedure actually fixed the problem.
- ✓The cluster is HEALTH_OK
- ✓Performance is at baseline
- ✓Capacity forecast is current
- ✓Runbook is up to date
5 · Rollback
If verification fails, undo the procedure in reverse order.
- ↶If the cluster is not HEALTH_OK: identify the issue
- ↶If performance is below baseline: investigate
- ↶If capacity forecast is wrong: re-plan
6 · Escalation
When the runbook isn't enough, contact:
- · Storage team
Validate the cluster after a major recovery
This runbook covers Validate the cluster after a major recovery on a Ceph Tentacle cluster.
When to use
- Active production scenario matching the impact (
service-affecting) - The prerequisites are met
Prerequisites
Before starting this runbook, verify each prerequisite has been met. If a prerequisite is not met, resolve it first or escalate.
- A major recovery has just completed
- The cluster is HEALTH_OK
- The cluster needs to be validated
Pre-checks
Collect evidence before taking action. Evidence is the proof the runbook worked.
# Capture the cluster state: ceph -s, ceph health detail
# Check ceph osd tree: all OSDs up + in
# Check ceph pg stat: no stuck PGs
# Check ceph df: usable capacity is as expected
# Run a scrub / deep scrub if needed
# Run a benchmark to validate performance
Procedure
Step 1
Document the cluster state in the runbook
Step 2
Verify each pools policy is correct
Step 3
Run a benchmark for the applications expected load
Step 4
Update capacity forecast if needed
Step 5
Update the runbook with any new findings
Verification
After completing the procedure, verify the result:
# The cluster is HEALTH_OK
# Performance is at baseline
# Capacity forecast is current
# Runbook is up to date
Rollback
If the procedure does not produce the expected verification, roll back:
- If the cluster is not HEALTH_OK: identify the issue
- If performance is below baseline: investigate
- If capacity forecast is wrong: re-plan
Escalation
If you cannot roll back or the rollback fails, escalate:
- Storage team