diff options
author | Maxim Gorbunov <m.v.gorbunov@gmail.com> | 2022-05-13 23:00:52 +0300 |
---|---|---|
committer | Maxim Gorbunov <m.v.gorbunov@gmail.com> | 2022-05-13 23:00:52 +0300 |
commit | eb47b892f5a0ab71163d79bcb112de71e75ebc88 (patch) | |
tree | 9048a3a7d6cf182a204d05d246272ca381fe12ef | |
parent | fa1b35aac71328a6bdd2f6e79da9a3b2de6aa107 (diff) | |
download | ydb-eb47b892f5a0ab71163d79bcb112de71e75ebc88.tar.gz |
Improve manual cluster configuration docs
ref:e4826336d0f4cc58779ee78f4bc0969fc73dd01d
6 files changed, 25 insertions, 24 deletions
diff --git a/ydb/docs/en/core/deploy/configuration/config.md b/ydb/docs/en/core/deploy/configuration/config.md index e15733e534..6e0f566244 100644 --- a/ydb/docs/en/core/deploy/configuration/config.md +++ b/ydb/docs/en/core/deploy/configuration/config.md @@ -26,17 +26,17 @@ This configuration can be specified as follows: ```bash host_configs: - drive: - - path: /dev/disk/by-partlabel/ydb_ssd_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_02 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 type: SSD host_config_id: 1 - drive: - - path: /dev/disk/by-partlabel/ydb_ssd_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_02 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_03 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_03 type: SSD host_config_id: 2 ``` @@ -197,7 +197,7 @@ blob_storage_config: - fail_domains: - vdisk_locations: - node_id: 1 - path: /dev/disk/by-partlabel/ydb_ssd_02 + path: /dev/disk/by-partlabel/ydb_disk_ssd_02 pdisk_category: SSD .... ``` diff --git a/ydb/docs/en/core/deploy/manual/_includes/prepare-configs.md b/ydb/docs/en/core/deploy/manual/_includes/prepare-configs.md index e907b0c060..29af8022ec 100644 --- a/ydb/docs/en/core/deploy/manual/_includes/prepare-configs.md +++ b/ydb/docs/en/core/deploy/manual/_includes/prepare-configs.md @@ -11,7 +11,7 @@ Download a sample config for the appropriate failure model of your cluster: ```text host_configs: - drive: - - path: /dev/disk/by-partlabel/ydb_disk_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD host_config_id: 1 ``` @@ -42,4 +42,4 @@ hosts: data_center: 'zone-c' rack: '1' ``` - +Full cluster coniguration options are given in [Cluster configuration](../../configuration/config.md) article.
\ No newline at end of file diff --git a/ydb/docs/en/core/deploy/manual/deploy-ydb-on-premises.md b/ydb/docs/en/core/deploy/manual/deploy-ydb-on-premises.md index e077473066..27ab393b67 100644 --- a/ydb/docs/en/core/deploy/manual/deploy-ydb-on-premises.md +++ b/ydb/docs/en/core/deploy/manual/deploy-ydb-on-premises.md @@ -57,13 +57,13 @@ Make sure that you specified the disks that have no other data! ```bash sudo parted /dev/nvme0n1 mklabel gpt -s sudo parted -a optimal /dev/nvme0n1 mkpart primary 0% 100% -sudo parted /dev/nvme0n1 name 1 ydb_disk_01 +sudo parted /dev/nvme0n1 name 1 ydb_disk_ssd_01 sudo partx --u /dev/nvme0n1 ``` -As a result, a disk labeled as `/dev/disk/by-partlabel/ydb_disk_01` will appear in the system. +As a result, a disk labeled as `/dev/disk/by-partlabel/ydb_disk_ssd_01` will appear in the system. -If you plan to use more than one disk on each server, specify a label that is unique for each of them instead of `ydb_disk_01`. You'll need to use these disks later in the configuration files. +If you plan to use more than one disk on each server, specify a label that is unique for each of them instead of `ydb_disk_ssd_01`. You'll need to use these disks later in the configuration files. Download an archive with the `ydbd` executable file and the libraries necessary for working with YDB: @@ -92,7 +92,7 @@ sudo cp -i ydbd-main-linux-amd64/lib/libidn.so /opt/ydb/lib/ 3. Format the disk with the built-in command ```bash -sudo LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ydb/lib /opt/ydb/bin/ydbd admin bs disk obliterate /dev/disk/by-partlabel/ydb_disk_01 +sudo LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ydb/lib /opt/ydb/bin/ydbd admin bs disk obliterate /dev/disk/by-partlabel/ydb_disk_ssd_01 ``` Perform this operation for each disk that will be used for data storage. diff --git a/ydb/docs/ru/core/deploy/configuration/config.md b/ydb/docs/ru/core/deploy/configuration/config.md index c4019863f6..12946af75f 100644 --- a/ydb/docs/ru/core/deploy/configuration/config.md +++ b/ydb/docs/ru/core/deploy/configuration/config.md @@ -26,17 +26,17 @@ host_configs: ```bash host_configs: - drive: - - path: /dev/disk/by-partlabel/ydb_ssd_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_02 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 type: SSD host_config_id: 1 - drive: - - path: /dev/disk/by-partlabel/ydb_ssd_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_02 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 type: SSD - - path: /dev/disk/by-partlabel/ydb_ssd_03 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_03 type: SSD host_config_id: 2 ``` @@ -198,7 +198,7 @@ blob_storage_config: - fail_domains: - vdisk_locations: - node_id: 1 - path: /dev/disk/by-partlabel/ydb_ssd_02 + path: /dev/disk/by-partlabel/ydb_disk_ssd_02 pdisk_category: SSD .... ``` diff --git a/ydb/docs/ru/core/deploy/manual/_includes/prepare-configs.md b/ydb/docs/ru/core/deploy/manual/_includes/prepare-configs.md index ce03cbef55..1da2a20ee7 100644 --- a/ydb/docs/ru/core/deploy/manual/_includes/prepare-configs.md +++ b/ydb/docs/ru/core/deploy/manual/_includes/prepare-configs.md @@ -8,7 +8,7 @@ ```text host_configs: - drive: - - path: /dev/disk/by-partlabel/ydb_disk_01 + - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD host_config_id: 1 ``` @@ -36,4 +36,5 @@ hosts: body: 3 data_center: 'zone-c' rack: '1' -```
\ No newline at end of file +``` +Более подробная информация по созданию конфигурации приведена в статье [Конфигурация кластера](../../configuration/config.md)
\ No newline at end of file diff --git a/ydb/docs/ru/core/deploy/manual/deploy-ydb-on-premises.md b/ydb/docs/ru/core/deploy/manual/deploy-ydb-on-premises.md index 4d210ecc2c..306711e0c1 100644 --- a/ydb/docs/ru/core/deploy/manual/deploy-ydb-on-premises.md +++ b/ydb/docs/ru/core/deploy/manual/deploy-ydb-on-premises.md @@ -49,13 +49,13 @@ sudo usermod -aG disk ydb ```bash sudo parted /dev/nvme0n1 mklabel gpt -s sudo parted -a optimal /dev/nvme0n1 mkpart primary 0% 100% -sudo parted /dev/nvme0n1 name 1 ydb_disk_01 +sudo parted /dev/nvme0n1 name 1 ydb_disk_ssd_01 sudo partx --u /dev/nvme0n1 ``` -После выполнения в системе появится диск с лейблом `/dev/disk/by-partlabel/ydb_disk_01` +После выполнения в системе появится диск с лейблом `/dev/disk/by-partlabel/ydb_disk_ssd_01` -Если вы планируете использовать более одного диска на каждом сервере - укажите для каждого свой уникальный лейбл вместо `ydb_disk_01`. Эти диски необходимо будет использовать в конфигурационных файлах далее. +Если вы планируете использовать более одного диска на каждом сервере - укажите для каждого свой уникальный лейбл вместо `ydb_disk_ssd_01`. Эти диски необходимо будет использовать в конфигурационных файлах далее. Скачайте архив с исполняемым файлом `ydbd` и необходимыми для работы YDB библиотеками: ```bash @@ -78,7 +78,7 @@ sudo cp -i ydbd-main-linux-amd64/lib/libidn.so /opt/ydb/lib/ ``` 3. Отформатируйте диск встроенной командой ```bash -sudo LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ydb/lib /opt/ydb/bin/ydbd admin bs disk obliterate /dev/disk/by-partlabel/ydb_disk_01 +sudo LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ydb/lib /opt/ydb/bin/ydbd admin bs disk obliterate /dev/disk/by-partlabel/ydb_disk_ssd_01 ``` Проделайте данную операцию для каждого диска, который будет использоваться для хранения данных. |