Skip to content

Commit 44085c0

Browse files
committed
doc/rados: improve t-shooting pg
Incorporate Anthony D'Atri's suggestions from ceph#57022 into the text in doc/rados/troubleshooting/troubleshooting-pg.rst. Signed-off-by: Zac Dover <[email protected]>
1 parent 45d9f53 commit 44085c0

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

doc/rados/troubleshooting/troubleshooting-pg.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -573,22 +573,22 @@ and Ceph :ref:`Clock Settings <mon-config-ref-clock>` for more information.
573573
More Information on PG Repair
574574
-----------------------------
575575
Ceph stores and updates the checksums of objects stored in the cluster. When a
576-
scrub is performed on a PG, the OSD attempts to choose an authoritative copy
577-
from among its replicas. Only one of the possible cases is consistent. After
578-
performing a deep scrub, Ceph calculates the checksum of an object that is read
579-
from disk and compares it to the checksum that was previously recorded. If the
580-
current checksum and the previously recorded checksum do not match, that
576+
scrub is performed on a PG, the lead OSD attempts to choose an authoritative
577+
copy from among its replicas. Only one of the possible cases is consistent.
578+
After performing a deep scrub, Ceph calculates the checksum of each object that
579+
is read from disk and compares it to the checksum that was previously recorded.
580+
If the current checksum and the previously recorded checksum do not match, that
581581
mismatch is considered to be an inconsistency. In the case of replicated pools,
582582
any mismatch between the checksum of any replica of an object and the checksum
583583
of the authoritative copy means that there is an inconsistency. The discovery
584584
of these inconsistencies cause a PG's state to be set to ``inconsistent``.
585585

586586
The ``pg repair`` command attempts to fix inconsistencies of various kinds. If
587587
``pg repair`` finds an inconsistent PG, it attempts to overwrite the digest of
588-
the inconsistent copy with the digest of the authoritative copy. If ``pg
589-
repair`` finds an inconsistent replicated pool, it marks the inconsistent copy
590-
as missing. In the case of replicated pools, recovery is beyond the scope of
591-
``pg repair``.
588+
the inconsistent copy with the digest of the authoritative copy. When ``pg
589+
repair`` finds an inconsistent copy in a replicated pool, it marks the
590+
inconsistent copy as missing. In the case of replicated pools, recovery is
591+
beyond the scope of ``pg repair``.
592592

593593
In the case of erasure-coded and BlueStore pools, Ceph will automatically
594594
perform repairs if ``osd_scrub_auto_repair`` (default ``false``) is set to

0 commit comments

Comments
 (0)