Chapter 6. OSD removal tool


OpenShift Data Foundation provides a tool to automate the process of object storage device (OSD) removal. This tool helps to avoid the possible data loss while removing OSDs.

Prerequisites

Procedure

  1. Identify the OSD that needs to be removed. The OSD that needs removal is in CrashLoopBackOff or Error state.

    $ oc get -n openshift-storage pods -l app=rook-ceph-osd -o wide
    Copy to Clipboard Toggle word wrap

    Example output:

    rook-ceph-osd-0-6d77d6c7c6-m8xj6    0/1    CrashLoopBackOff    0    24h   10.129.0.16   compute-2   <none>           <none>
    Copy to Clipboard Toggle word wrap
  2. Run the following command to remove OSD 0:

    $ odf purge-osd 0
    Copy to Clipboard Toggle word wrap
  3. [Optional] If removal of the OSD affects placement group (PG) status, enter yes-force-destroy-osd.
  4. Verify that the last line of the command output contains cephosd: completed removal of OSD 0.
  5. Verify the corresponding deployment is removed:

    $ oc get deployment rook-ceph-osd-0
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat