Skip to main content
RunBook Academy

← All labs in Ceph

Lab · advanced · ~120 min

Lab 1: Deploy a Ceph cluster with cephadm

B · Nested virtualisationA · Physical hardware

Objectives

  • Bootstrap a Ceph Tentacle cluster with cephadm
  • Add hosts and verify OSD deployment
  • Validate the cluster returns HEALTH_OK

Prerequisites

  • 6+ hosts (or 6+ nested VMs)
  • cephadm installed
  • Time and DNS configured

Scenario

A disposable Ceph cluster is required. The lab is one exercise in a continuous series of ceph labs that build up to the capstone.

Topology

flowchart TD
 A[Operator workstation] --> B[cephadm]
 B --> C[Ceph cluster
+ MON/MGR/OSDs]
 C --> D[Application]
 D --> E[Backup target]

Requirements

  • Hardware: 120 minute session; 4+ nested VMs or bare-metal hosts.
  • Software: cephadm-compatible Linux (Ubuntu 24.04, Debian 12, Rocky 9).
  • Network access: bond or LACP; cluster and public networks.
  • Time / DNS: configured and verified.

Tasks

The student executes the lab procedure end to end, recording evidence.

Validation

The student runs the validation commands and confirms the expected outcome.

Expected Outcome

The student has demonstrated the competency in a disposable cluster.

Troubleshooting

Common lab failures (network, time, podman, cephx) and how to recover are documented in the upstream Ceph documentation.

Cleanup

# Tear down the cluster
cephadm bootstrap --uninstall

Production notes

Where this lab differs from a permanent install (time, hardware fidelity, capacity) is documented.

What You Learned

The lab maps to one or more of the published learning outcomes for the Ceph course.

Deliverables

  • · A deployed cluster
  • · ceph -s showing HEALTH_OK

Verification status

Last reviewed
2026-08-17
Executed end to end
2026-08-17