Skip to main content
RunBook Academy

← All runbooks in Ceph

medium riskdata loss risk~30 min

Back up an RBD workload

1 · Prerequisites

Confirm every item is in place before any state change.

  • A backup window is scheduled
  • A backup target is available

2 · Pre-checks

Read-only diagnostic commands. If any of these don't match expected output, stop and investigate further.

  • · ceph -s is HEALTH_OK
  • · The pool exists
  • · rbd info shows the image
  • · The application can be quiesced

3 · Procedure

Execute each step in order. Verify the expected output of a step before moving to the next.

  1. 1Quiesce the application: flush the filesystem, freeze the database if needed
  2. 2Snapshot the RBD: rbd snap create <pool>/<image>@<date>
  3. 3Protect the snapshot: rbd snap protect <pool>/<image>@<date>
  4. 4Export the snapshot: rbd export <pool>/<image>@<date> <file>
  5. 5Transfer to the backup target
  6. 6Verify the backup

4 · Verification

Confirm the procedure actually fixed the problem.

  • Backup file is on the backup target
  • Verification confirms the backup is restorable
  • Application is resumed

5 · Rollback

If verification fails, undo the procedure in reverse order.

  • If the export fails: try rbd export-diff (incremental)
  • If the verification fails: re-take the snapshot
  • If the application was not quiesced: re-take

6 · Escalation

When the runbook isn't enough, contact:

  • · Storage team
  • · Application team to quiesce

Back up an RBD workload

This runbook covers Back up an RBD workload on a Ceph Tentacle cluster.

When to use

  • Active production scenario matching the impact (data-loss-risk)
  • 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 backup window is scheduled
  • A backup target is available

Pre-checks

Collect evidence before taking action. Evidence is the proof the runbook worked.

# ceph -s is HEALTH_OK
# The pool exists
# rbd info shows the image
# The application can be quiesced

Procedure

Step 1

Quiesce the application: flush the filesystem, freeze the database if needed

Step 2

Snapshot the RBD: rbd snap create <pool>/<image>@<date>

Step 3

Protect the snapshot: rbd snap protect <pool>/<image>@<date>

Step 4

Export the snapshot: rbd export <pool>/<image>@<date> <file>

Step 5

Transfer to the backup target

Step 6

Verify the backup

Verification

After completing the procedure, verify the result:

# Backup file is on the backup target
# Verification confirms the backup is restorable
# Application is resumed

Rollback

If the procedure does not produce the expected verification, roll back:

  • If the export fails: try rbd export-diff (incremental)
  • If the verification fails: re-take the snapshot
  • If the application was not quiesced: re-take

Escalation

If you cannot roll back or the rollback fails, escalate:

  • Storage team
  • Application team to quiesce

References

  1. Ceph documentation