forked from vitalif/vitastor
Slightly improve scrub docs
parent
ce02f47de6
commit
aea567cfbd
|
@ -39,8 +39,8 @@ them, even without restarting by updating configuration in etcd.
|
||||||
- [throttle_target_parallelism](#throttle_target_parallelism)
|
- [throttle_target_parallelism](#throttle_target_parallelism)
|
||||||
- [throttle_threshold_us](#throttle_threshold_us)
|
- [throttle_threshold_us](#throttle_threshold_us)
|
||||||
- [osd_memlock](#osd_memlock)
|
- [osd_memlock](#osd_memlock)
|
||||||
- [no_scrub](#no_scrub)
|
|
||||||
- [auto_scrub](#auto_scrub)
|
- [auto_scrub](#auto_scrub)
|
||||||
|
- [no_scrub](#no_scrub)
|
||||||
- [scrub_interval](#scrub_interval)
|
- [scrub_interval](#scrub_interval)
|
||||||
- [scrub_queue_depth](#scrub_queue_depth)
|
- [scrub_queue_depth](#scrub_queue_depth)
|
||||||
- [scrub_sleep](#scrub_sleep)
|
- [scrub_sleep](#scrub_sleep)
|
||||||
|
@ -343,23 +343,28 @@ doesn't need to be changed.
|
||||||
Lock all OSD memory to prevent it from being unloaded into swap with
|
Lock all OSD memory to prevent it from being unloaded into swap with
|
||||||
mlockall(). Requires sufficient ulimit -l (max locked memory).
|
mlockall(). Requires sufficient ulimit -l (max locked memory).
|
||||||
|
|
||||||
## no_scrub
|
|
||||||
|
|
||||||
- Type: boolean
|
|
||||||
- Default: false
|
|
||||||
- Can be changed online: yes
|
|
||||||
|
|
||||||
Disable data scrubbing (background consistency check), even if it is scheduled.
|
|
||||||
|
|
||||||
## auto_scrub
|
## auto_scrub
|
||||||
|
|
||||||
- Type: boolean
|
- Type: boolean
|
||||||
- Default: false
|
- Default: false
|
||||||
- Can be changed online: yes
|
- Can be changed online: yes
|
||||||
|
|
||||||
Schedule data scrubbing to run every `scrub_interval` automatically. You can
|
Data scrubbing is the process of background verification of copies to find
|
||||||
start/schedule scrubbing manually by updating `next_scrub` key in
|
and repair corrupted blocks. It's not run automatically by default since
|
||||||
`/pg/history/...` values in etcd if it is disabled.
|
it's a new feature. Set this parameter to true to enable automatic scrubs.
|
||||||
|
|
||||||
|
This parameter makes OSDs automatically schedule data scrubbing of clean PGs
|
||||||
|
every `scrub_interval` (see below). You can also start/schedule scrubbing
|
||||||
|
manually by setting `next_scrub` JSON key to the desired UNIX time of the
|
||||||
|
next scrub in `/pg/history/...` values in etcd.
|
||||||
|
|
||||||
|
## no_scrub
|
||||||
|
|
||||||
|
- Type: boolean
|
||||||
|
- Default: false
|
||||||
|
- Can be changed online: yes
|
||||||
|
|
||||||
|
Temporarily disable scrubbing and stop running scrubs.
|
||||||
|
|
||||||
## scrub_interval
|
## scrub_interval
|
||||||
|
|
||||||
|
|
|
@ -40,8 +40,8 @@
|
||||||
- [throttle_target_parallelism](#throttle_target_parallelism)
|
- [throttle_target_parallelism](#throttle_target_parallelism)
|
||||||
- [throttle_threshold_us](#throttle_threshold_us)
|
- [throttle_threshold_us](#throttle_threshold_us)
|
||||||
- [osd_memlock](#osd_memlock)
|
- [osd_memlock](#osd_memlock)
|
||||||
- [no_scrub](#no_scrub)
|
|
||||||
- [auto_scrub](#auto_scrub)
|
- [auto_scrub](#auto_scrub)
|
||||||
|
- [no_scrub](#no_scrub)
|
||||||
- [scrub_interval](#scrub_interval)
|
- [scrub_interval](#scrub_interval)
|
||||||
- [scrub_queue_depth](#scrub_queue_depth)
|
- [scrub_queue_depth](#scrub_queue_depth)
|
||||||
- [scrub_sleep](#scrub_sleep)
|
- [scrub_sleep](#scrub_sleep)
|
||||||
|
@ -358,24 +358,30 @@ Flusher - это микро-поток (корутина), которая коп
|
||||||
в пространство подкачки. Требует достаточного значения ulimit -l (лимита
|
в пространство подкачки. Требует достаточного значения ulimit -l (лимита
|
||||||
заблокированной памяти).
|
заблокированной памяти).
|
||||||
|
|
||||||
## no_scrub
|
|
||||||
|
|
||||||
- Тип: булево (да/нет)
|
|
||||||
- Значение по умолчанию: false
|
|
||||||
- Можно менять на лету: да
|
|
||||||
|
|
||||||
Отключить скрабы (фоновую проверку данных), даже если она запланирована.
|
|
||||||
|
|
||||||
## auto_scrub
|
## auto_scrub
|
||||||
|
|
||||||
- Тип: булево (да/нет)
|
- Тип: булево (да/нет)
|
||||||
- Значение по умолчанию: false
|
- Значение по умолчанию: false
|
||||||
- Можно менять на лету: да
|
- Можно менять на лету: да
|
||||||
|
|
||||||
Автоматически планировать фоновую проверку данных раз в `scrub_interval`. Вы
|
Скраб - процесс фоновой проверки копий данных, предназначенный, чтобы
|
||||||
можете запустить или запланировать проверку вручную, обновляя значение ключа
|
находить и исправлять повреждённые блоки. По умолчанию эти проверки ещё не
|
||||||
`next_scrub` внутри значений `/pg/history/...` в etcd, если автоматическое
|
запускаются автоматически, так как являются новой функцией. Чтобы включить
|
||||||
планирование отключено.
|
автоматическое планирование скрабов, установите данный параметр в true.
|
||||||
|
|
||||||
|
Включённый параметр заставляет OSD автоматически планировать фоновую
|
||||||
|
проверку чистых PG раз в `scrub_interval` (см. ниже). Вы также можете
|
||||||
|
запустить или запланировать проверку вручную, установив значение ключа JSON
|
||||||
|
`next_scrub` внутри ключей etcd `/pg/history/...` в UNIX-время следующей
|
||||||
|
желаемой проверки.
|
||||||
|
|
||||||
|
## no_scrub
|
||||||
|
|
||||||
|
- Тип: булево (да/нет)
|
||||||
|
- Значение по умолчанию: false
|
||||||
|
- Можно менять на лету: да
|
||||||
|
|
||||||
|
Временно отключить и остановить запущенные скрабы.
|
||||||
|
|
||||||
## scrub_interval
|
## scrub_interval
|
||||||
|
|
||||||
|
|
|
@ -382,27 +382,38 @@
|
||||||
Блокировать всю память OSD с помощью mlockall, чтобы запретить её выгрузку
|
Блокировать всю память OSD с помощью mlockall, чтобы запретить её выгрузку
|
||||||
в пространство подкачки. Требует достаточного значения ulimit -l (лимита
|
в пространство подкачки. Требует достаточного значения ulimit -l (лимита
|
||||||
заблокированной памяти).
|
заблокированной памяти).
|
||||||
- name: no_scrub
|
|
||||||
type: bool
|
|
||||||
default: false
|
|
||||||
online: true
|
|
||||||
info: |
|
|
||||||
Disable data scrubbing (background consistency check), even if it is scheduled.
|
|
||||||
info_ru: |
|
|
||||||
Отключить скрабы (фоновую проверку данных), даже если она запланирована.
|
|
||||||
- name: auto_scrub
|
- name: auto_scrub
|
||||||
type: bool
|
type: bool
|
||||||
default: false
|
default: false
|
||||||
online: true
|
online: true
|
||||||
info: |
|
info: |
|
||||||
Schedule data scrubbing to run every `scrub_interval` automatically. You can
|
Data scrubbing is the process of background verification of copies to find
|
||||||
start/schedule scrubbing manually by updating `next_scrub` key in
|
and repair corrupted blocks. It's not run automatically by default since
|
||||||
`/pg/history/...` values in etcd if it is disabled.
|
it's a new feature. Set this parameter to true to enable automatic scrubs.
|
||||||
|
|
||||||
|
This parameter makes OSDs automatically schedule data scrubbing of clean PGs
|
||||||
|
every `scrub_interval` (see below). You can also start/schedule scrubbing
|
||||||
|
manually by setting `next_scrub` JSON key to the desired UNIX time of the
|
||||||
|
next scrub in `/pg/history/...` values in etcd.
|
||||||
info_ru: |
|
info_ru: |
|
||||||
Автоматически планировать фоновую проверку данных раз в `scrub_interval`. Вы
|
Скраб - процесс фоновой проверки копий данных, предназначенный, чтобы
|
||||||
можете запустить или запланировать проверку вручную, обновляя значение ключа
|
находить и исправлять повреждённые блоки. По умолчанию эти проверки ещё не
|
||||||
`next_scrub` внутри значений `/pg/history/...` в etcd, если автоматическое
|
запускаются автоматически, так как являются новой функцией. Чтобы включить
|
||||||
планирование отключено.
|
автоматическое планирование скрабов, установите данный параметр в true.
|
||||||
|
|
||||||
|
Включённый параметр заставляет OSD автоматически планировать фоновую
|
||||||
|
проверку чистых PG раз в `scrub_interval` (см. ниже). Вы также можете
|
||||||
|
запустить или запланировать проверку вручную, установив значение ключа JSON
|
||||||
|
`next_scrub` внутри ключей etcd `/pg/history/...` в UNIX-время следующей
|
||||||
|
желаемой проверки.
|
||||||
|
- name: no_scrub
|
||||||
|
type: bool
|
||||||
|
default: false
|
||||||
|
online: true
|
||||||
|
info: |
|
||||||
|
Temporarily disable scrubbing and stop running scrubs.
|
||||||
|
info_ru: |
|
||||||
|
Временно отключить и остановить запущенные скрабы.
|
||||||
- name: scrub_interval
|
- name: scrub_interval
|
||||||
type: string
|
type: string
|
||||||
default: 30d
|
default: 30d
|
||||||
|
|
|
@ -29,7 +29,7 @@
|
||||||
- Snapshots and copy-on-write image clones
|
- Snapshots and copy-on-write image clones
|
||||||
- [Write throttling to smooth random write workloads in SSD+HDD configurations](../config/osd.en.md#throttle_small_writes)
|
- [Write throttling to smooth random write workloads in SSD+HDD configurations](../config/osd.en.md#throttle_small_writes)
|
||||||
- [RDMA/RoCEv2 support via libibverbs](../config/network.en.md#rdma_device)
|
- [RDMA/RoCEv2 support via libibverbs](../config/network.en.md#rdma_device)
|
||||||
- [Scrubbing without checksums](../config/osd.en.md#no_scrub) (verification of copies)
|
- [Scrubbing without checksums](../config/osd.en.md#auto_scrub) (verification of copies)
|
||||||
|
|
||||||
## Plugins and tools
|
## Plugins and tools
|
||||||
|
|
||||||
|
|
|
@ -31,7 +31,7 @@
|
||||||
- Снапшоты и copy-on-write клоны
|
- Снапшоты и copy-on-write клоны
|
||||||
- [Сглаживание производительности случайной записи в SSD+HDD конфигурациях](../config/osd.ru.md#throttle_small_writes)
|
- [Сглаживание производительности случайной записи в SSD+HDD конфигурациях](../config/osd.ru.md#throttle_small_writes)
|
||||||
- [Поддержка RDMA/RoCEv2 через libibverbs](../config/network.ru.md#rdma_device)
|
- [Поддержка RDMA/RoCEv2 через libibverbs](../config/network.ru.md#rdma_device)
|
||||||
- [Фоновая проверка целостности без контрольных сумм](../config/osd.ru.md#no_scrub) (сверка копий)
|
- [Фоновая проверка целостности без контрольных сумм](../config/osd.ru.md#auto_scrub) (сверка копий)
|
||||||
|
|
||||||
## Драйверы и инструменты
|
## Драйверы и инструменты
|
||||||
|
|
||||||
|
|
|
@ -111,8 +111,8 @@ const etcd_tree = {
|
||||||
print_stats_interval: 3,
|
print_stats_interval: 3,
|
||||||
slow_log_interval: 10,
|
slow_log_interval: 10,
|
||||||
inode_vanish_time: 60,
|
inode_vanish_time: 60,
|
||||||
no_scrub: false,
|
|
||||||
auto_scrub: false,
|
auto_scrub: false,
|
||||||
|
no_scrub: false,
|
||||||
scrub_interval: '30d', // 1s/1m/1h/1d
|
scrub_interval: '30d', // 1s/1m/1h/1d
|
||||||
scrub_queue_depth: 1,
|
scrub_queue_depth: 1,
|
||||||
scrub_sleep: 0, // milliseconds
|
scrub_sleep: 0, // milliseconds
|
||||||
|
|
Loading…
Reference in New Issue