Verifying a Ceph cluster's health

The Rook toolbox is a container with common tools used for rook debugging and testing. Let's perform the following steps to deploy the Rook toolbox to verify cluster health:

  1. Deploy the Rook toolbox:
$ kubectl apply -f toolbox.yaml
  1. Verify that the toolbox is running:
$ kubectl -n rook-ceph get pod -l "app=rook-ceph-tools"
NAME READY STATUS RESTARTS AGE
rook-ceph-tools-6fdfc54b6d-4kdtm 1/1 Running 0 109s
  1. Connect to the toolbox:
$ kubectl -n rook-ceph exec -it $(kubectl -n rook-ceph get pod -l "app=rook-ceph-tools" -o jsonpath='{.items[0].metadata.name}') bash
  1. Verify that the cluster is in a healthy state (HEALTH_OK):
# ceph status
cluster:
id: 6b6e4bfb-bfef-46b7-94bd-9979e5e8bf04
health: HEALTH_OK
services:
mon: 3 daemons, quorum a,b,c (age 12m)
mgr: a(active, since 12m)
osd: 3 osds: 3 up (since 11m), 3 in (since 11m)
data:
pools: 0 pools, 0 pgs
objects: 0 objects, 0 B
usage: 49 GiB used, 241 GiB / 291 GiB avail
pgs:
  1. When you are finished troubleshooting, remove the deployment using the following command:
$ kubectl -n rook-ceph delete deployment rook-ceph-tools

Now you know how to deploy the Rook toolbox with its common tools that are used to debug and test Rook.