diff --git a/docs/config.en.md b/docs/config.en.md index 53ba669c..9ddc512a 100644 --- a/docs/config.en.md +++ b/docs/config.en.md @@ -21,7 +21,7 @@ Configuration parameters can be set in 3 places: mon, fio and QEMU options, OpenStack/Proxmox/etc configuration. The latter doesn't allow to set all variables directly, but it allows to override the configuration file and set everything you need inside it. -- OSD superblocks created by [vitastor-disk](../usage/disk.en.md) contain +- OSD superblocks created by [vitastor-disk](usage/disk.en.md) contain primarily disk layout parameters of specific OSDs. In fact, these parameters are automatically passed into the command line of vitastor-osd process, so they have the same "status" as command-line parameters. diff --git a/docs/config.ru.md b/docs/config.ru.md index ee0b21b7..b2e5aed5 100644 --- a/docs/config.ru.md +++ b/docs/config.ru.md @@ -23,7 +23,7 @@ монитора, опциях fio и QEMU, настроек OpenStack, Proxmox и т.п. Последние, как правило, не включают полный набор параметров напрямую, но позволяют определить путь к файлу конфигурации и задать любые параметры в нём. -- В суперблоке OSD, записываемом [vitastor-disk](../usage/disk.ru.md) - параметры, +- В суперблоке OSD, записываемом [vitastor-disk](usage/disk.ru.md) - параметры, связанные с дисковым форматом и с этим конкретным OSD. На самом деле, при запуске OSD эти параметры автоматически передаются в командную строку процесса vitastor-osd, то есть по "статусу" они эквивалентны параметрам diff --git a/docs/installation/kubernetes.ru.md b/docs/installation/kubernetes.ru.md index 51fa67fd..7795820e 100644 --- a/docs/installation/kubernetes.ru.md +++ b/docs/installation/kubernetes.ru.md @@ -8,13 +8,13 @@ У Vitastor есть CSI-плагин для Kubernetes, поддерживающий RWO, а также блочные RWX, тома. -Для установки возьмите манифесты из директории [csi/deploy/](../csi/deploy/), поместите -вашу конфигурацию подключения к Vitastor в [csi/deploy/001-csi-config-map.yaml](../csi/deploy/001-csi-config-map.yaml), -настройте StorageClass в [csi/deploy/009-storage-class.yaml](../csi/deploy/009-storage-class.yaml) +Для установки возьмите манифесты из директории [csi/deploy/](../../csi/deploy/), поместите +вашу конфигурацию подключения к Vitastor в [csi/deploy/001-csi-config-map.yaml](../../csi/deploy/001-csi-config-map.yaml), +настройте StorageClass в [csi/deploy/009-storage-class.yaml](../../csi/deploy/009-storage-class.yaml) и примените все `NNN-*.yaml` к вашей инсталляции Kubernetes. ``` for i in ./???-*.yaml; do kubectl apply -f $i; done ``` -После этого вы сможете создавать PersistentVolume. Пример смотрите в файле [csi/deploy/example-pvc.yaml](../csi/deploy/example-pvc.yaml). +После этого вы сможете создавать PersistentVolume. Пример смотрите в файле [csi/deploy/example-pvc.yaml](../../csi/deploy/example-pvc.yaml). diff --git a/docs/installation/openstack.en.md b/docs/installation/openstack.en.md index d707bf09..93408f63 100644 --- a/docs/installation/openstack.en.md +++ b/docs/installation/openstack.en.md @@ -36,5 +36,5 @@ vitastor_pool_id = 1 image_upload_use_cinder_backend = True ``` -To put Glance images in Vitastor, use [https://docs.openstack.org/cinder/pike/admin/blockstorage-volume-backed-image.html](volume-backed images), +To put Glance images in Vitastor, use [volume-backed images](https://docs.openstack.org/cinder/pike/admin/blockstorage-volume-backed-image.html), although the support has not been verified yet. diff --git a/docs/installation/openstack.ru.md b/docs/installation/openstack.ru.md index 292f2a9f..e6e7bdcd 100644 --- a/docs/installation/openstack.ru.md +++ b/docs/installation/openstack.ru.md @@ -36,5 +36,5 @@ image_upload_use_cinder_backend = True ``` Чтобы помещать в Vitastor Glance-образы, нужно использовать -[https://docs.openstack.org/cinder/pike/admin/blockstorage-volume-backed-image.html](образы на основе томов Cinder), +[образы на основе томов Cinder](https://docs.openstack.org/cinder/pike/admin/blockstorage-volume-backed-image.html), однако, поддержка этой функции ещё не проверялась. diff --git a/docs/installation/proxmox.en.md b/docs/installation/proxmox.en.md index 336de824..09bde45c 100644 --- a/docs/installation/proxmox.en.md +++ b/docs/installation/proxmox.en.md @@ -35,5 +35,5 @@ vitastor: vitastor vitastor_nbd 0 ``` -\* Note: you can also manually copy [patches/VitastorPlugin.pm](patches/VitastorPlugin.pm) to Proxmox hosts +\* Note: you can also manually copy [patches/VitastorPlugin.pm](../../patches/VitastorPlugin.pm) to Proxmox hosts as `/usr/share/perl5/PVE/Storage/Custom/VitastorPlugin.pm` instead of installing pve-storage-vitastor. diff --git a/docs/installation/proxmox.ru.md b/docs/installation/proxmox.ru.md index fd0b5c90..fa29d3c7 100644 --- a/docs/installation/proxmox.ru.md +++ b/docs/installation/proxmox.ru.md @@ -4,7 +4,7 @@ [Read in English](proxmox.en.md) -# Proxmox +# Proxmox VE Чтобы подключить Vitastor к Proxmox Virtual Environment (поддерживаются версии 6.4-7.4): @@ -35,5 +35,5 @@ vitastor: vitastor ``` \* Примечание: вместо установки пакета pve-storage-vitastor вы можете вручную скопировать файл -[patches/VitastorPlugin.pm](patches/VitastorPlugin.pm) на хосты Proxmox как +[patches/VitastorPlugin.pm](../../patches/VitastorPlugin.pm) на хосты Proxmox как `/usr/share/perl5/PVE/Storage/Custom/VitastorPlugin.pm`. diff --git a/docs/intro/architecture.en.md b/docs/intro/architecture.en.md index 147536a6..e2a4e767 100644 --- a/docs/intro/architecture.en.md +++ b/docs/intro/architecture.en.md @@ -44,7 +44,7 @@ depends linearly on drive capacity and data store block size which is 128 KB by default. With 128 KB blocks metadata takes around 512 MB per 1 TB (which is still less than Ceph wants). Journal is also kept in memory by default, but in SSD-only clusters it's only 32 MB, and in SSD+HDD - clusters, where it's beneficial to increase it, [inmemory_journal](docs/config/osd.en.md#inmemory_journal) can be disabled. + clusters, where it's beneficial to increase it, [inmemory_journal](../config/osd.en.md#inmemory_journal) can be disabled. - Vitastor storage layer doesn't have internal copy-on-write or redirect-write. I know that maybe it's possible to create a good copy-on-write storage, but it's much harder and makes performance less deterministic, so CoW isn't used in Vitastor. diff --git a/docs/intro/architecture.ru.md b/docs/intro/architecture.ru.md index 975e9f46..911c3e1d 100644 --- a/docs/intro/architecture.ru.md +++ b/docs/intro/architecture.ru.md @@ -156,7 +156,7 @@ блока хранилища (block_size, по умолчанию 128 КБ). С 128 КБ блоком потребление памяти составляет примерно 512 МБ на 1 ТБ данных. Журналы по умолчанию тоже хранятся в памяти, но в SSD-кластерах нужный размер журнала составляет всего 32 МБ, а в гибридных (SSD+HDD) - кластерах, в которых есть смысл делать журналы больше, можно отключить [inmemory_journal](../docs/config/osd.ru.md#inmemory_journal). + кластерах, в которых есть смысл делать журналы больше, можно отключить [inmemory_journal](../config/osd.ru.md#inmemory_journal). - В Vitastor нет внутреннего copy-on-write. Я считаю, что реализация CoW-хранилища гораздо сложнее, поэтому сложнее добиться устойчиво хороших результатов. Возможно, в один прекрасный день я придумаю красивый алгоритм для CoW-хранилища, но пока нет — внутреннего CoW в Vitastor не будет. diff --git a/docs/intro/features.en.md b/docs/intro/features.en.md index 50c4b9a8..24e5caed 100644 --- a/docs/intro/features.en.md +++ b/docs/intro/features.en.md @@ -35,7 +35,7 @@ - [Debian and CentOS packages](../installation/packages.en.md) - [Image management CLI (vitastor-cli)](../usage/cli.en.md) -- [Disk management CLI (vitastor-disk)](docs/usage/disk.en.md) +- [Disk management CLI (vitastor-disk)](../usage/disk.en.md) - Generic user-space client library - [Native QEMU driver](../usage/qemu.en.md) - [Loadable fio engine for benchmarks](../usage/fio.en.md) diff --git a/docs/intro/features.ru.md b/docs/intro/features.ru.md index 3296b901..f5757442 100644 --- a/docs/intro/features.ru.md +++ b/docs/intro/features.ru.md @@ -13,7 +13,7 @@ ## Серверные функции - Базовая часть - надёжное кластерное блочное хранилище без единой точки отказа -- [Производительность](../comparison1.ru.md) ;-D +- [Производительность](../performance/comparison1.ru.md) ;-D - [Несколько схем отказоустойчивости](../config/pool.ru.md#scheme): репликация, XOR n+1 (1 диск чётности), коды коррекции ошибок Рида-Соломона на основе библиотек jerasure и ISA-L с любым числом дисков данных и чётности в группе - Конфигурация через простые человекочитаемые JSON-структуры в etcd @@ -37,7 +37,7 @@ - [Пакеты для Debian и CentOS](../installation/packages.ru.md) - [Консольный интерфейс управления образами (vitastor-cli)](../usage/cli.ru.md) -- [Инструмент управления дисками (vitastor-disk)](docs/usage/disk.ru.md) +- [Инструмент управления дисками (vitastor-disk)](../usage/disk.ru.md) - Общая пользовательская клиентская библиотека для работы с кластером - [Драйвер диска для QEMU](../usage/qemu.ru.md) - [Драйвер диска для утилиты тестирования производительности fio](../usage/fio.ru.md)