]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
doc/rados: document require_osd_release 68608/head
authorKefu Chai <k.chai@proxmox.com>
Fri, 24 Apr 2026 13:41:29 +0000 (21:41 +0800)
committerKefu Chai <k.chai@proxmox.com>
Mon, 27 Apr 2026 03:04:02 +0000 (11:04 +0800)
commitf510ed3a8bce19b408c2e2c14fc1a9aac5c4969e
treedcc6ebcc0b956081289b3b77a06b1358d343786a
parentbe0fc7e03d0b843ae2f506dc28e985065ad666a9
doc/rados: document require_osd_release

Add a standalone concept page for the OSDMap require_osd_release field,
the upgrade-gate counterpart to require_min_compat_client. Cover:

 - how to set it and how to check it;
 - the full set of pre-commit guards the monitor runs, rendered as a
   table with each guard's error text and bypass status;
 - which commands and features become available as the flag is raised,
   per release;
 - the OSD boot window that refuses OSDs more than two releases ahead
   of the flag;
 - the OSD_UPGRADE_FINISHED health warning that prompts admins to set
   the flag after an upgrade;
 - the initial value on new clusters and the two mon_debug_* knobs
   that override it for testing.

Also cross-link the new page from the related-flags table on
require-min-compat-client.rst, and from the rados operations index.

Signed-off-by: Kefu Chai <k.chai@proxmox.com>
doc/rados/operations/health-checks.rst
doc/rados/operations/index.rst
doc/rados/operations/require-osd-release.rst [new file with mode: 0644]