NFS. Настроить хранилище

Просмотреть NFS-подключения

Просмотреть список всех подключений
```
storage nfs mount list
```
Просмотреть подробную информацию об определенном подключении
```
storage nfs mount show --uuid <UUID>
```
где uuid — идентификатор NFS-подключения.

Правила управления NFS-подключением

Команда создания NFS-подключения производит только запись о подключении в БД. Монтирования при ее выполнении не происходит.
Изменить параметры можно только для несмонтированного NFS-подключения, поэтому рекомендуется делать это до монтирования.
Команда монтирования NFS-подключения производит монтирование NFS-подключения сразу на все узлы, указанные при его создании.
Тестировать можно только смонтированное NFS-подключение.
Добавить узлы можно для смонтированного и несмонтированного NFS-подключения. При добавлении новых узлов для смонтированного NFS-подключения монтирование NFS-директории на новых узлах производится автоматически.
Удалить узлы можно только у несмонтированного NFS-подключения, поэтому рекомендуется делать это до монтирования.
Добавить ВЦОД можно для смонтированного и несмонтированного NFS-подключения.
Удалить ВЦОД можно только для несмонтированного NFS-подключения, поэтому рекомендуется делать это до монтирования.
Размонтировать NFS-подключение вручную нельзя, размонтирование производится автоматически при удалении из кластера всех ВЦОД, привязанных к нему. Удаление некоторых ВЦОД, привязанных к NFS-подключению, не приводит к его размонтированию.
Удалить можно только несмонтированное NFS-подключение.

Создать NFS-подключение

storage nfs mount add --name <NAME>
                      --nfs_server <NFS_SERVER>
                      --shared_folder_path <SHARED_FOLDER_PATH>
                      --ns <NS ...>
                      --capacity <CAPACITY>
                     [--mount_point <MOUNT_POINT>]
                     [--params <PARAMS>]
                     [--nodes <NODES ...>]
                     [--autocheck <yes|no>]
                     [--check_timeout <CHECK_TIMEOUT>]
                     [--descr <DESCR>]

где

name — название подключения;

Внимание

Имя не должно содержать кириллицу, пробелы, точки, запятые и специальные символы.
Допускаются латинские буквы, цифры, дефис - и нижнее подчеркивание _
nfs_server — IP-адрес сервера NFS;
shared_folder_path — директория на сервере, которая будет смонтирована;
ns — список ВЦОД, которые должны иметь доступ к этому подключению. Значение по умолчанию — *, все ВЦОД;
capacity — ограничение объема подключения в мегабайтах или гигабайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 100MB, 200Mb, 300Gb, 400gb;
mount_point — точка монтирования на одном или нескольких узлах. Если не указана, то формируется автоматически как /nfs_shares/<cluster>/<ns>/<name>, если в параметре ns указан определенный ВЦОД, и /nfs_shares/<cluster>/<name>, если в параметре ns указаны все ВЦОД;
params — параметры, которые должны быть записаны в файл /etc/fstab. Если не указаны, то автоматически используется строка defaults;
nodes — список узлов, на которые нужно будет монтировать директорию. Значение по умолчанию — *, все узлы;
autocheck — нужно ли будет проводить автоматическую проверку доступности для этого подключения после монтирования. Возможные значения: yes, no. Значение по умолчанию — yes;
check_timeout — период автоматической проверки в секундах. Возможные значения: от 60 до 300. Значение по умолчанию — 300;
descr — описание подключения.

Изменить параметры NFS-подключения

Чтобы обновить настройки подключения, введите

storage nfs mount update --uuid <UUID>
                        [--name <NAME>]
                        [--nfs_server <NFS_SERVER>]
                        [--shared_folder_path <SHARED_FOLDER_PATH>]
                        [--mount_point <MOUNT_POINT>]
                        [--params <PARAMS>]
                        [--autocheck <yes|no>]
                        [--check_timeout <CHECK_TIMEOUT>]
                        [--descr <DESCR>]
                        [--capacity <CAPACITY>]

где

uuid — идентификатор подключения из БД;
name — название подключения;

Внимание

Имя не должно содержать кириллицу, пробелы, точки, запятые и специальные символы.
Допускаются латинские буквы, цифры, дефис - и нижнее подчеркивание _
nfs_server — IP-адрес сервера NFS;
shared_folder_path — директория на сервере, которая будет смонтирована;
mount_point — точка монтирования на одном или нескольких узлах;
params — параметры, которые должны быть записаны в файл /etc/fstab;
autocheck — нужно ли будет проводить автоматическую проверку доступности для этого подключения после монтирования. Возможные значения: yes, no. Значение по умолчанию — yes;
check_timeout — период автоматической проверки в секундах. Возможные значения: от 60 до 300. Значение по умолчанию — 300;
descr — описание подключения;
capacity — ограничение объема подключения в мегабайтах или гигабайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 100MB, 200Mb, 300Gb, 400gb.

Монтировать NFS-подключение

Выполните монтирование директории на узлы

storage nfs mount connect --uuid <UUID>

где uuid — идентификатор подключения из БД.

На каждом узле в файл /etc/fstab записывается информация о подключении и выполняется команда mount <mount_point>.

Тестировать доступность подключения

Протестировать смонтированное NFS-подключение

storage nfs mount test --uuid <UUID>
                      [--nodes <NODES>]

где

uuid — идентификатор подключения из БД;
nodes — список узлов, на которых нужно провести проверку. Значение по умолчанию — *, все узлы;

Тест подключения на каждом узле состоит из двух этапов: выполнения команды findmnt <mount_point> и теста на запись в точке монтирования timeout 10 dd if=/dev/zero bs=4096 count=20 > <mount_point>/test-<node_uuid>.
Статус подключения и ошибки выполнения теста сохраняются в БД.
Если при добавлении подключения был указан параметр autocheck, то тест подключения будет выполняться автоматически с указанной периодичностью в check_timeout.

Добавить узлы

Добавить новые узлы к NFS-подключению

storage nfs mount nodes add --uuid <UUID>
                           [--nodes <NODES>]

где

uuid — идентификатор подключения из БД;
nodes — список узлов, которые нужно добавить. Значение по умолчанию — *, все узлы.

Удалить узлы

Удалить узлы из несмонтированного NFS-подключения

storage nfs mount nodes del --uuid <UUID>
                           [--nodes <NODES>]

где

uuid — идентификатор подключения из БД;
nodes — список узлов, которые нужно удалить. Значение по умолчанию — *, все узлы.

Добавить ВЦОД

Добавить новые ВЦОД к NFS-подключению

storage nfs mount ns add --uuid <UUID>
                         --ns <NS>

где

uuid — идентификатор подключения из БД;
ns — список ВЦОД, которые нужно добавить.

Удалить ВЦОД

Удалить ВЦОД из несмонтированного NFS-подключения

storage nfs mount ns del --uuid <UUID>
                         --ns <NS>

где

uuid — идентификатор подключения из БД;
ns — список ВЦОД, которые нужно удалить.

Удалить NFS-подключение

Удалить несмонтированное NFS-подключение

storage nfs mount del --uuid <UUID>

где uuid — идентификатор подключения из БД.

Примечание

Управление NFS-томами описано в статьях Руководства пользователя Создание и управление томом и Работа с томом

Термины и определения содержатся в статьях: