aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorkruall <kruall@yandex-team.ru>2022-02-22 21:48:25 +0300
committerkruall <kruall@yandex-team.ru>2022-02-22 21:48:25 +0300
commit1c884c0275210056299158a263d422d1981b1fda (patch)
treeb0fd3facebee65ff38596f508bb3bc066d8338e0
parent31430783bc860af117f3416f7948a21a6535c7a0 (diff)
downloadydb-1c884c0275210056299158a263d422d1981b1fda.tar.gz
Fix some parts of mainteance/manual docs, KIKIMR-13082
ref:59f4033c489c866fa0cb9a72107896e2968d9f0b
-rw-r--r--ydb/docs/ru/core/maintenance/manual/change_actorsystem_configs.md1
-rw-r--r--ydb/docs/ru/core/maintenance/manual/cluster_expansion.md14
-rw-r--r--ydb/docs/ru/core/maintenance/manual/cms.md6
-rw-r--r--ydb/docs/ru/core/maintenance/manual/failure_model.md4
-rw-r--r--ydb/docs/ru/core/maintenance/manual/index.md15
-rw-r--r--ydb/docs/ru/core/maintenance/manual/moving_vdisks.md4
-rw-r--r--ydb/docs/ru/core/maintenance/manual/scrubbing.md8
7 files changed, 19 insertions, 33 deletions
diff --git a/ydb/docs/ru/core/maintenance/manual/change_actorsystem_configs.md b/ydb/docs/ru/core/maintenance/manual/change_actorsystem_configs.md
index f211e790385..d74e4a6cc06 100644
--- a/ydb/docs/ru/core/maintenance/manual/change_actorsystem_configs.md
+++ b/ydb/docs/ru/core/maintenance/manual/change_actorsystem_configs.md
@@ -1,5 +1,4 @@
-
# Изменение конфигурации акторсистемы
## На статических нода
diff --git a/ydb/docs/ru/core/maintenance/manual/cluster_expansion.md b/ydb/docs/ru/core/maintenance/manual/cluster_expansion.md
index 67aa10ec280..032c060a11f 100644
--- a/ydb/docs/ru/core/maintenance/manual/cluster_expansion.md
+++ b/ydb/docs/ru/core/maintenance/manual/cluster_expansion.md
@@ -5,9 +5,9 @@
```
Node {
NodeId: 1
- Port: <ик-порт>
- Host: "<старый-хост>"
- InterconnectHost: "<старый-хост>"
+ Port: <ic-port>
+ Host: "<существующий-хост>"
+ InterconnectHost: "<существующий-хост>"
Location {
DataCenter: "DC1"
Module: "M1"
@@ -17,7 +17,7 @@
}
Node {
NodeId: 2
- Port: <ик-порт>
+ Port: <ic-port>
Host: "<новый-хост>"
InterconnectHost: "<новый-хост>"
Location {
@@ -55,15 +55,15 @@
BoxId: 1
Host {
Key {
- Fqdn: "<старый-хост>"
- IcPort: <ик-порт>
+ Fqdn: "<существующий-хост>"
+ IcPort: <ic-port>
}
HostConfigId: 1
}
Host {
Key {
Fqdn: "<новый-хост>"
- IcPort: <ик-порт>
+ IcPort: <ic-port>
}
HostConfigId: 1
}
diff --git a/ydb/docs/ru/core/maintenance/manual/cms.md b/ydb/docs/ru/core/maintenance/manual/cms.md
index d6a869e275b..3436c462447 100644
--- a/ydb/docs/ru/core/maintenance/manual/cms.md
+++ b/ydb/docs/ru/core/maintenance/manual/cms.md
@@ -1,6 +1,6 @@
-## Изменение конфигураций через CMS
+# Изменение конфигураций через CMS
-### Получить текущие настройки
+## Получить текущие настройки
Следующая команда позволит получить текущие настройки по кластеру или по тенанту.
@@ -12,7 +12,7 @@
./kikimr -s <ендпоинт> admin console configs load --out-dir <папка-для-конфигов> --tenant <имя-тенанта>
```
-### Обновить настройки
+## Обновить настройки
Сначала надо выкачать нужный конфиг как указано выше, после чего требуется подготовить protobuf файл с запросом на изменение.
diff --git a/ydb/docs/ru/core/maintenance/manual/failure_model.md b/ydb/docs/ru/core/maintenance/manual/failure_model.md
index be79347530b..74b4396055c 100644
--- a/ydb/docs/ru/core/maintenance/manual/failure_model.md
+++ b/ydb/docs/ru/core/maintenance/manual/failure_model.md
@@ -1,7 +1,5 @@
# Способы предотвращения выхода за модель отказа
-**Ссылка на статью в концептах о модели отказа скоро будет**
-
## Отказал один VDisk в группе хранения {#storage_group_lost_one_disk}
При включенном SelfHeal данная ситуация счиается штатной. SelfHeal перевезет VDisk за указанное в настройках время, после чего начнется процесс репликации данных на другом PDisk'е.
@@ -15,8 +13,6 @@
При отказе более одного VDisk'а в группе SelfHeal перестает перевозить VDisk'и. В случае если количество отказавших VDisk'ов находится на грани модели отказа, то рекомендуеся восстановить работоспособность хотя бы одного из VDisk'ов, прежде чем начинать [перевоз VDisk'ов](moving_vdisks.md#removal_from_a_broken_device). Так же возможно потребуется более осторожно [перевозить VDisk'и по одному](moving_vdisks.md#moving_vdisk).
-При одновременной недоступности 2 VDisk'ов по возможности рекомендуется восстановить работоспособность хотя бы одного из них, либо заменить один VDisk для начала процесса репликации. Это сохранит пространство для маневра в случае отказа третьего VDisk'а до завершения репликации.
-
## Количество отказавших VDisk'ов превысело модель отказа {#exceeded_the_failure_modele}
Доступность и работоспособность системы может быть нарушена. Необходимо восстановить работоспособность хотя бы одного из VDisk'ов без потери хранившихся на нем данных.
diff --git a/ydb/docs/ru/core/maintenance/manual/index.md b/ydb/docs/ru/core/maintenance/manual/index.md
index f0124b0b861..33c065ab7b4 100644
--- a/ydb/docs/ru/core/maintenance/manual/index.md
+++ b/ydb/docs/ru/core/maintenance/manual/index.md
@@ -6,7 +6,7 @@
* Возможен [выход за модель отказа](failure_model.md) из-за которого чтение и запись в группу хранения полностью останавливавется.
-* Так же не сбалансированная нагрузка на диски может сильно повлиять на летенси обработки запросов. Способы балансироваки написаны в следующей [статье](balancing_load.md).
+* Несбалансированная нагрузка на диски может сильно повлиять на летенси обработки запросов. Способы балансировки написаны в следующей [статье](balancing_load.md).
* Окончание свободного места на нескольких физических дисках тоже может остановить запись, которое можно решить [освобождением места](disk_end_space.md) либо [расширением кластера](cluster_expansion.md) блочными устройствами.
@@ -16,12 +16,9 @@
## Изменение конфигурации кластера
-Кластер YDB позволяет проводить [расширение](cluster_expansion.md) устройств и узлов.
-
-[Конфигурировать](change_actorsystem_configs.md) акторсистему на нодах.
-
-Изменять конфиги через [CMS](cms.md).
-
-[Добавлять](adding_storage_groups.md) новые группы хранения.
-
+Кластер YDB позволяет:
+* проводить [расширение](cluster_expansion.md) устройств и узлов.
+* [Конфигурировать](change_actorsystem_configs.md) акторсистему на нодах.
+* Изменять конфиги через [CMS](cms.md).
+* [Добавлять](adding_storage_groups.md) новые группы хранения.
diff --git a/ydb/docs/ru/core/maintenance/manual/moving_vdisks.md b/ydb/docs/ru/core/maintenance/manual/moving_vdisks.md
index ca2daac7e5b..8554f205d6d 100644
--- a/ydb/docs/ru/core/maintenance/manual/moving_vdisks.md
+++ b/ydb/docs/ru/core/maintenance/manual/moving_vdisks.md
@@ -23,7 +23,7 @@ kikimr admin bs config invoke --proto 'Command { ReassignGroupDisk { GroupId: <I
3. Выполнить перевоз VDisk'а
```bash
- kikimr admin bs config invoke --proto 'Command { UpdateDriveStatus { HostKey: { Fqdn: "<Xост>" IcPort: <ic-port>} Path: "<Путь до партлейбла устройства>" PDiskId: <PDiskID> Status: BROKEN } }'
+ kikimr admin bs config invoke --proto 'Command { UpdateDriveStatus { HostKey: { Fqdn: "<host>" IcPort: <ic-port>} Path: "<Путь до партлейбла устройства>" PDiskId: <pdisk-id> Status: BROKEN } }'
```
## Вернуть PDisk после развоза {#return_a_device_to_work}
@@ -37,5 +37,5 @@ kikimr admin bs config invoke --proto 'Command { ReassignGroupDisk { GroupId: <I
3. Вернуть PDisk
```bash
- kikimr admin bs config invoke --proto 'Command { UpdateDriveStatus { HostKey: { Fqdn: "<Xост>" IcPort: <IC Порт>} Path: "<Путь до партлейбла устройства>" PDiskId: <ID ПДиска> Status: ACTIVE } }'
+ kikimr admin bs config invoke --proto 'Command { UpdateDriveStatus { HostKey: { Fqdn: "<host>" IcPort: <ic-pord>} Path: "<Путь до партлейбла устройства>" PDiskId: <pdisk-id> Status: ACTIVE } }'
```
diff --git a/ydb/docs/ru/core/maintenance/manual/scrubbing.md b/ydb/docs/ru/core/maintenance/manual/scrubbing.md
index d433c09bda3..00b1172344f 100644
--- a/ydb/docs/ru/core/maintenance/manual/scrubbing.md
+++ b/ydb/docs/ru/core/maintenance/manual/scrubbing.md
@@ -1,12 +1,6 @@
# Включение/выключение Scrubbing
-## Включение/Отключение
-
-**WILL BE SOON**
-
-## Настройки Scrubbing
-
Настройки Scrub позволяют регулировать интервал времени, который проходит от начала предыдущего цикла скраббинга диска до начала следующего, а также максимальное число дисков, которые могут скрабиться одновременно. Значение по умолчанию — 1 месяц.
`$ kikimr admin bs config invoke --proto 'Command { UpdateSettings { ScrubPeriodicitySeconds: 86400 MaxScrubbedDisksAtOnce: 1 } }'`
-**WILL BE SOON**
+В случае, если ScrubPeriodicitySeconds равен 0, то Scrubbing выключен.