diff options
| author | Zac Dover <zac.dover@proton.me> | 2024-04-24 13:48:20 +0200 |
|---|---|---|
| committer | Zac Dover <zac.dover@proton.me> | 2024-04-24 13:48:20 +0200 |
| commit | 44085c0dc9a8dd0d48d1ca731cff8f15d5a8d089 (patch) | |
| tree | 85cf3cf2d32766cd445e719eb6d319ee5977feb1 /doc | |
| parent | Merge pull request #56745 from ronen-fr/wip-rf-pgtell (diff) | |
| download | ceph-44085c0dc9a8dd0d48d1ca731cff8f15d5a8d089.tar.xz ceph-44085c0dc9a8dd0d48d1ca731cff8f15d5a8d089.zip | |
doc/rados: improve t-shooting pg
Incorporate Anthony D'Atri's suggestions from
https://github.com/ceph/ceph/pull/57022 into the text in
doc/rados/troubleshooting/troubleshooting-pg.rst.
Signed-off-by: Zac Dover <zac.dover@proton.me>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/rados/troubleshooting/troubleshooting-pg.rst | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/doc/rados/troubleshooting/troubleshooting-pg.rst b/doc/rados/troubleshooting/troubleshooting-pg.rst index 9b204ef1e9b..1e73bf7c88b 100644 --- a/doc/rados/troubleshooting/troubleshooting-pg.rst +++ b/doc/rados/troubleshooting/troubleshooting-pg.rst @@ -573,11 +573,11 @@ and Ceph :ref:`Clock Settings <mon-config-ref-clock>` for more information. More Information on PG Repair ----------------------------- Ceph stores and updates the checksums of objects stored in the cluster. When a -scrub is performed on a PG, the OSD attempts to choose an authoritative copy -from among its replicas. Only one of the possible cases is consistent. After -performing a deep scrub, Ceph calculates the checksum of an object that is read -from disk and compares it to the checksum that was previously recorded. If the -current checksum and the previously recorded checksum do not match, that +scrub is performed on a PG, the lead OSD attempts to choose an authoritative +copy from among its replicas. Only one of the possible cases is consistent. +After performing a deep scrub, Ceph calculates the checksum of each object that +is read from disk and compares it to the checksum that was previously recorded. +If the current checksum and the previously recorded checksum do not match, that mismatch is considered to be an inconsistency. In the case of replicated pools, any mismatch between the checksum of any replica of an object and the checksum of the authoritative copy means that there is an inconsistency. The discovery @@ -585,10 +585,10 @@ of these inconsistencies cause a PG's state to be set to ``inconsistent``. The ``pg repair`` command attempts to fix inconsistencies of various kinds. If ``pg repair`` finds an inconsistent PG, it attempts to overwrite the digest of -the inconsistent copy with the digest of the authoritative copy. If ``pg -repair`` finds an inconsistent replicated pool, it marks the inconsistent copy -as missing. In the case of replicated pools, recovery is beyond the scope of -``pg repair``. +the inconsistent copy with the digest of the authoritative copy. When ``pg +repair`` finds an inconsistent copy in a replicated pool, it marks the +inconsistent copy as missing. In the case of replicated pools, recovery is +beyond the scope of ``pg repair``. In the case of erasure-coded and BlueStore pools, Ceph will automatically perform repairs if ``osd_scrub_auto_repair`` (default ``false``) is set to |