diff options
author | kruall <kruall@yandex-team.ru> | 2022-02-22 21:48:25 +0300 |
---|---|---|
committer | kruall <kruall@yandex-team.ru> | 2022-02-22 21:48:25 +0300 |
commit | 1c884c0275210056299158a263d422d1981b1fda (patch) | |
tree | b0fd3facebee65ff38596f508bb3bc066d8338e0 | |
parent | 31430783bc860af117f3416f7948a21a6535c7a0 (diff) | |
download | ydb-1c884c0275210056299158a263d422d1981b1fda.tar.gz |
Fix some parts of mainteance/manual docs, KIKIMR-13082
ref:59f4033c489c866fa0cb9a72107896e2968d9f0b
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 выключен. |