Add system requirements tail

Add system requirements

Author: bazeltsev

ydb/docs/en/core/cluster/system-requirements.md

@@ -0,0 +1,45 @@
+# System requirements and recommendations
+
+This section provides recommendations for deploying {{ ydb-short-name }}.
+
+## Hardware configuration {#hardware}
+
+* **CPU**
+
+  {{ ydb-short-name }} server can be run only on x86-64 CPU with AVX2 instructions support (Intel Haswell (4th generation) and later, AMD EPYC and later).
+
+  ARM processors are not supported now.
+
+* **Memory**
+
+  It is recommended to use error-correcting code (ECC) memory for data consistency.
+
+* **Storage**
+
+  {{ ydb-short-name }} server can be run on servers with any storage types (HDD/SSD/NVMe/RAM). It is recommended to use SSD/NVMe drives for better performance.
+
+  Minimal disk capacity must be at least 80GB. It is recommended to use such disks only for testing, proper functioning is not guaranteed. It is recommended to use disks as block devices with more than 800GB capacity for efficiency.
+
+  {{ ydb-short-name }} does not use any filesystems to store data and works  directly with disk. Don't create or mount filesystems on disks which are used in {{ ydb-short-name }} . Also it is not recommended to share block devices with other processes as this can lead to a significant performance degradation.
+
+## Software configuration {#software}
+
+{{ ydb-short-name }} server can be run on OS Linux with kernel 4.4 or later. MacOS and Windows are not supported now.
+
+## Topology {#topology}
+
+When planning a deployment, it's important to choose the right [Blob Storage configuration](./configuration/config.md#domains-blob) based on the required fault tolerance:
+
+ * Mode None - This mode requires 1 server without fault tolerance. It is recommended only for functional testing.
+
+ * block-4-2: This mode requires at least 8 servers in one datacenter. To ensure maximum fault tolerance, servers must be located in 8 independent racks. In this mode cluster remains operational if 1 rack fails completely and 1 node in another rack fails.
+
+ * Mode mirror-3dc - This mode requires at least 9 servers. To ensure maximum fault tolerance, servers must be located in three independent data centers and different server racks in each of them. In this mode cluster remains operational if 1 datacenter fails completely and 1 node fails in another datacenter.
+
+  * Mode mirror-3dc - This mode requires at least 9 servers. To ensure maximum fault tolerance, servers must be located in three independent data centers and different server racks in each of them. In this mode cluster remains operational if 1 datacenter fails completely and 1 node fails in another datacenter.
+
+  * Mode mirror-3dc-3-nodes - The simple variant of mirror-3dc mode. This mode requires at least 3 servers with 3 disks in each. To ensure maximum fault tolerance, each server must be located in an independent datacenter. In this mode cluster keeps running if no more than 1 node fails. It is recommended only for testing.
+
+The failure of the node means that the server is out of service completely or one of the disks in it fails.
+
+Read more about storage groups in [Terms and definitions](../concepts/databases.md#storage-groups).

ydb/docs/en/core/deploy/production_checklist.md

@@ -0,0 +1,45 @@
+# System requirements and recommendations
+
+This section provides recommendations for deploying {{ ydb-short-name }}.
+
+## Hardware configuration {#hardware}
+
+* **CPU**
+
+  {{ ydb-short-name }} server can be run only on x86-64 CPU with AVX2 instructions support (Intel Haswell (4th generation) and later, AMD EPYC and later). 
+  ARM processors are not supported now.
+
+* **Memory**
+
+  It is recommended to use error-correcting code (ECC) memory for data consistency.
+
+* **Storage**
+
+  {{ ydb-short-name }} server can be run on servers with any storage types (HDD/SSD/NVMe/RAM). It is recommended to use SSD/NVMe drives for better performance.
+
+  Minimal disk capacity must be at least 80GB. It is recommended to use such disks only for testing, proper functioning is not guaranteed. It is recommended to use disks as block devices with more than 800GB capacity for efficiency.
+
+  {{ ydb-short-name }} does not use any filesystems to store data and works  directly with disk. Don't create or mount filesystems on disks which are used in {{ ydb-short-name }} . Also it is not recommended to share block devices with other processes as this can lead to a significant performance degradation. 
+
+
+## Software configuration {#software}
+
+{{ ydb-short-name }} server can be run on OS Linux with kernel 4.4 or later. MacOS and Windows are not supported now.
+
+## Topology {#topology}
+
+When planning a deployment, it's important to choose the right [Blob Storage configuration](./configuration/config.md#domains-blob) based on the required fault tolerance:
+
+ * Mode None - This mode requires 1 server without fault tolerance. It is recommended only for functional testing.
+
+ * block-4-2: This mode requires at least 8 servers in one datacenter. To ensure maximum fault tolerance, servers must be located in 8 independent racks. In this mode cluster remains operational if 1 rack fails completely and 1 node in another rack fails.
+
+ * Mode mirror-3dc - This mode requires at least 9 servers. To ensure maximum fault tolerance, servers must be located in three independent data centers and different server racks in each of them. In this mode cluster remains operational if 1 datacenter fails completely and 1 node fails in another datacenter.
+
+  * Mode mirror-3dc - This mode requires at least 9 servers. To ensure maximum fault tolerance, servers must be located in three independent data centers and different server racks in each of them. In this mode cluster remains operational if 1 datacenter fails completely and 1 node fails in another datacenter.
+
+  * Mode mirror-3dc-3-nodes - The simple variant of mirror-3dc mode. This mode requires at least 3 servers with 3 disks in each. To ensure maximum fault tolerance, each server must be located in an independent datacenter. In this mode cluster keeps running if no more than 1 node fails. It is recommended only for testing.
+
+The failure of the node means that the server is out of service completely or one of the disks in it fails.
+
+Read more about storage groups in [Terms and definitions](../concepts/databases.md#storage-groups).

ydb/docs/en/core/deploy/system-requirements.md

@@ -1,9 +1,9 @@
 items:
+# - name: Requirements and recommendations
+#   href: ../deploy/system-requirements.md
 - name: Kubernetes
   include: { mode: link, path: orchestrated/toc_p.yaml }
 - name: VM / Baremetal
   href: manual/deploy-ydb-on-premises.md
 - name: Configuration
   href: configuration/config.md
-  # - name: Production checklist
-  #  href: ../deploy/production_checklist.md

ydb/docs/en/core/deploy/toc_i.yaml

@@ -0,0 +1,31 @@
+# Системные требования и рекомендации
+
+В данном разделе приводятся рекомендации для развертывания {{ ydb-short-name }}.
+
+## Аппаратная конфигурация {#hardware}
+
+Необходимое количество серверов и дисков определяется требованиями к отказоустойчивости. Подробнее читайте в разделе [{#T}](topology.md).
+
+* **Процессор**
+
+  {{ ydb-short-name }} сервер может быть запущен только на процессорах с архитектурой x86-64 с поддержкой AVX2 инструкций (Intel Haswell (4 поколение) и более поздние, AMD EPYC и более поздние).
+
+  ARM архитектура в настоящее время не поддерживается.
+
+* **Оперативная память**
+
+  Рекомендуется использовать оперативную память с поддержкой коррекции ошибок (ECC) для защиты от аппаратных сбоев.
+
+* **Дисковая подсистема**
+
+  {{ ydb-short-name }} сервер может быть запущен на серверах с дисками любого типа (HDD/SSD/NVMe). Однако мы рекомендуем использовать диски SSD/NVMe для большей производительности.
+
+  Минимальный размер диска должен быть не менее 80 ГБ, при меньшем размере, узел не сможет использовать устройство. Корректная и бесперебойная работа с дисками минимального размера не гарантируется. Использовать такие диски рекомендуется исключительно в тестовых целях. Для эффективной работы YDB рекомендуется использовать диски размером более 800 ГБ как блочные устройства.
+
+  {{ ydb-short-name }} не использует файловую систему для хранения данных и работает с диском напрямую. Поэтому не следует монтировать файловую систему или выполнять другие операции с разделом, который использует {{ ydb-short-name }}. Так же не рекомендуется делить блочное устройство с другими процессами - это может приводить к существенному ухудшению производительности.
+
+## Программная конфигурация {#software}
+
+{{ ydb-short-name }} сервер может быть запущен на серверах с операционной системой Linux с ядром 4.4 и выше.
+
+Операционные системы macOS и Windows в данный момент не поддерживаются.

ydb/docs/ru/core/cluster/system-requirements.md

@@ -0,0 +1,20 @@
+# Топология
+
+Топология кластера определяется требованиями к отказоустойчивости. Доступны следующие режимы работы:
+
+Режим | Множитель<br>объема хранения | Минимальное<br>количество<br>узлов | Описание
+--- | --- | --- | ---
+`none` | 1 | 1 | Избыточность отсутствует.<br>Любой сбой оборудования приводит к недоступности пула хранения.<br>Режим рекомендуется использовать только для функционального тестирования.
+`block-4-2` | 1,5 | 8 | Применяется [Erasure coding](https://ru.wikipedia.org/wiki/Стирающий_код) с двумя блоками избыточности, добавляемыми к четырем блокам исходных данных. Узлы хранилища размещаются в не менее чем 8 доменах отказа (обычно стойках).<br>Пул хранения доступен при потере любых двух доменов, продолжая запись всех 6 частей данных в оставшихся доменах.<br>Режим рекомендуется для пулов хранения в пределах одной зоны доступности (обычно центра обработки данных).
+`mirror-3-dc` | 3 | 9 | Данные реплицируются в 3 зоны доступности, использующие 3 домена отказа (обычно стойки) внутри каждой зоны.<br>Пул хранения доступен при сбое одной зоны доступности и одного домена отказа в оставшихся зонах.<br>Режим рекомендуется для мультидатацентровых инсталляций.
+`mirror-3dc-3-nodes` | 3 | 3 | Является упрощенным вариантом `mirror-3dc`. Для данного режима необходимо минимум 3 сервера по 3 диска в каждом. Для обеспечения наибольшей отказоустойчивости каждый сервер должен находиться в независимом датацентре.<br>Работоспособность в данном режиме сохраняется при выходе из строя не более 1 узла.<br>Режим рекомендуется использовать только для функционального тестирования.
+
+{% note info %}
+
+Под выходом из строя узла подразумевается как полная так и частичная его недоступность, например выход из строя одного диска на узле.
+
+Приведенный выше множитель объема хранения относится только к фактору обеспечения отказоустойчивости. Для планирования размера хранилища необходимо учитывать другие влияющие факторы (например, фрагментацию и гранулярность слотов).
+
+{% endnote %}
+
+О том, как задать топологию кластера {{ ydb-short-name }} читайте в разделе [{#T}](../deploy/configuration/config.md#domains-blob).

ydb/docs/ru/core/cluster/topology.md

@@ -2,8 +2,10 @@
 
 В данном разделе представлена информация по развертыванию и конфигурации многоузловых кластеров YDB, обслуживающих множество баз данных.
 
-- [Развертывание в Kubernetes](../orchestrated/concepts.md)
-- [Развертывание на виртуальных и железных серверах](../manual/deploy-ydb-on-premises.md)
-- [Конфигурирование](../configuration/config.md)
+* [{#T}](../../cluster/system-requirements.md).
+* [{#T}](../../cluster/topology.md).
+* [Развертывание в Kubernetes](../orchestrated/concepts.md).
+* [Развертывание на виртуальных и железных серверах](../manual/deploy-ydb-on-premises.md).
+* [Конфигурирование](../configuration/config.md).
 
 Пошаговые сценарии быстрого развертывания локального одноузлового кластера для целей разработки и тестирования функциональности приведены в разделе [Начало работы](../../getting_started/self_hosted/index.md).

ydb/docs/ru/core/deploy/_includes/index.md

@@ -145,15 +145,14 @@ domains_config:
 - Шифрование данных (вкл/выкл)
 - Режим отказоустойчивости
 
-В настоящее время поддерживаются три режима отказоустойчивости:
-
-|Название режима|Множитель<br>объема хранения|Минимальное<br>количество<br>узлов|Описание|
-|---------|-|-----------|-|
-| none | 1 | 1 | Избыточность отсутствует, любой сбой оборудования приводит к недоступности пула хранения. Этот режим может быть полезен для функционального тестирования. |
-| block-4-2 | 1.5 | 8 | Применяется [Erasure coding](https://ru.wikipedia.org/wiki/Стирающий_код) с двумя блоками избыточности, добавляемыми к четырем блокам исходных данных. Узлы хранилища размещаются в не менее чем 8 доменах отказа (обычно стойках). Пул хранения доступен при потере любых двух доменов, продолжая запись всех 6 частей данных в оставшихся доменах. Этот режим применим для пулов хранения в пределах одной зоны доступности (обычно центра обработки данных). |
-| mirror-3-dc | 3 | 9 | Данные реплицируются в 3 зоны доступности, использующие 3 домена отказа (ообычно стойки) внутри каждой зоны. Пул хранения доступен при сбое одной зоны доступности и одного домена отказа в оставшихся зонах. |
-
-Приведенный выше множитель объема хранения относится только к фактору обеспечения отказоустойчивости. Для планирования размера хранилища необходимо учитывать другие значительные факторы, в частности фрагментацию и гранулярность слотов.
+Доступны следующие [режимы отказоустойчивости](../../cluster/topology.md):
+
+Режим | Описание
+--- | ---
+`none` | Избыточность отсутствует. Применяется для тестирования.
+`block-4-2` | Избыточность с коэффициентом 1,5, применяется для однодатацентровых кластеров.
+`mirror-3-dc` | Избыточность с коэффициентом 3, применяется для мультидатацентровых кластеров.
+`mirror-3dc-3-nodes` | Избыточность с коэффициентом 3. Применяется для тестирования.
 
 **Синтаксис**