Chapter 4. Override Ceph behavior

As a storage administrator, you need to understand how to use overrides for the Red Hat Ceph Storage cluster to change Ceph options during runtime.

4.1. Prerequisites

  • A running Red Hat Ceph Storage cluster.

4.2. Setting and unsetting Ceph override options

You can set and unset Ceph options to override Ceph’s default behavior.


  • A running Red Hat Ceph Storage cluster.
  • Root-level access to the node.


  1. To override Ceph’s default behavior, use the ceph osd set command and the behavior you wish to override:

    ceph osd set FLAG

    Once you set the behavior, ceph health will reflect the override(s) that you have set for the cluster.

  2. To cease overriding Ceph’s default behavior, use the ceph osd unset command and the override you wish to cease.

    ceph osd unset FLAG


Prevents OSDs from being treated as in the cluster.


Prevents OSDs from being treated as out of the cluster.


Prevents OSDs from being treated as up and running.


Prevents OSDs from being treated as down.


Makes a cluster appear to have reached its full_ratio, and thereby prevents write operations.


Ceph will stop processing read and write operations, but will not affect OSD in, out, up or down statuses.


Ceph will prevent new backfill operations.


Ceph will prevent new rebalancing operations.


Ceph will prevent new recovery operations.


Ceph will prevent new scrubbing operations.


Ceph will prevent new deep scrubbing operations.


Ceph will disable the process that is looking for cold/dirty objects to flush and evict.

4.3. Ceph override use cases

  • noin: Commonly used with noout to address flapping OSDs.
  • noout: If the mon osd report timeout is exceeded and an OSD has not reported to the monitor, the OSD will get marked out. If this happens erroneously, you can set noout to prevent the OSD(s) from getting marked out while you troubleshoot the issue.
  • noup: Commonly used with nodown to address flapping OSDs.
  • nodown: Networking issues may interrupt Ceph 'heartbeat' processes, and an OSD may be up but still get marked down. You can set nodown to prevent OSDs from getting marked down while troubleshooting the issue.
  • full: If a cluster is reaching its full_ratio, you can pre-emptively set the cluster to full and expand capacity.


    Setting the cluster to full will prevent write operations.

  • pause: If you need to troubleshoot a running Ceph cluster without clients reading and writing data, you can set the cluster to pause to prevent client operations.
  • nobackfill: If you need to take an OSD or node down temporarily, for example, upgrading daemons, you can set nobackfill so that Ceph will not backfill while the OSDs is down.
  • norecover: If you need to replace an OSD disk and don’t want the PGs to recover to another OSD while you are hotswapping disks, you can set norecover to prevent the other OSDs from copying a new set of PGs to other OSDs.
  • noscrub and nodeep-scrubb: If you want to prevent scrubbing for example, to reduce overhead during high loads, recovery, backfilling, and rebalancing you can set noscrub and/or nodeep-scrub to prevent the cluster from scrubbing OSDs.
  • notieragent: If you want to stop the tier agent process from finding cold objects to flush to the backing storage tier, you may set notieragent.