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

Добавьте информацию о новом подключении

Примечание

Команда производит только запись о подключении в БД. Монтирования при ее выполнении не происходит
```
storage nfs mount add --name <NAME>
                      --nfs_server <NFS_SERVER>
                      --shared_folder_path <SHARED_FOLDER_PATH>
                      [--mount_point <MOUNT_POINT>]
                      [--params <PARAMS>]
                      --nodes <NODES>
                      --ns <NS>
                      [--autocheck <AUTOCHECK>]
                      [--check_timeout <CHECK_TIMEOUT>]
                      [--descr <DESCR>]
```
где
- name — название подключения;
- nfs_server — IP-адрес сервера NFS;
- shared_folder_path — директория на сервере, которая будет смонтирована;
- mount_point — точка монтирования на одном или нескольких узлах. Если не указана, то формируется автоматически как /nfs_shares/<cluster>/<ns>/<name>, если в параметре ns указан определенный ВЦОД, и /nfs_shares/<cluster>/<name>, если в параметре ns указаны все ВЦОД;
- params — параметры, которые должны быть записаны в файл /etc/fstab. Если не указаны, то автоматически используется строка defaults;
- ns — список ВЦОД, которые должны иметь доступ к этому подключению. Можно указать конкретные ВЦОД или все сразу;
- nodes — список узлов, на которые нужно будет монтировать директорию;
- autocheck — нужно ли будет проводить автоматическую проверку доступности для этого подключения после монтирования;
- check_timeout — с какой периодичностью нужно проводить автоматическую проверку. Можно указать любое значение между 60 и 300 секундами. Значение по умолчанию — 300;
- descr — описание подключения.
Просмотрите список всех подключений
```
storage nfs mount list
```
Чтобы просмотреть подробную информацию об определенном подключении, введите
```
storage nfs mount show --uuid <UUID>
```
где uuid — идентификатор подключения из БД.
Выполните монтирование директории на узлы
```
storage nfs mount connect --uuid <UUID>
```
где uuid — идентификатор подключения из БД.

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

Внимание

Команду обновления можно выполнять только для размонтированного подключения
```
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 <AUTOCHECK>]
                        [--check_timeout <CHECK_TIMEOUT>]
                        [--descr <DESCR>]
```
где
- uuid — идентификатор подключения из БД;
- name — название подключения;
- nfs_server — IP-адрес сервера NFS;
- shared_folder_path — директория на сервере, которая будет смонтирована;
- mount_point — точка монтирования на одном или нескольких узлах;
- params — параметры, которые должны быть записаны в файл /etc/fstab;
- autocheck — нужно ли будет проводить автоматическую проверку доступности для этого подключения после монтирования;
- check_timeout — с какой периодичностью нужно проводить автоматическую проверку. Можно указать любое значение между 60 и 300 секундами. Значение по умолчанию — 300;
- descr — описание подключения.
Добавить новые узлы к уже смонтированному подключению
```
storage nfs mount nodes add --nodes <NODES> 
                            --uuid <UUID>
```
где
- nodes — список узлов, которые нужно добавить;
- uuid — идентификатор подключения из БД.
При выполнении команды монтирование директории на новых узлах выполнится автоматически.
Удаление узлов из подключения

Внимание

Команду можно выполнить только для несмонтированного подключения
```
storage nfs mount nodes del --nodes <NODES>
                            --uuid <UUID>
```
где
- nodes — список узлов, которые нужно удалить;
- uuid — идентификатор подключения из БД.
Тестировать доступность подключения
```
storage nfs mount test --uuid <UUID>
                       [--node <NODES>]
```
где
- uuid — идентификатор подключения из БД;
- node — узел, на котором нужно провести проверку. Если узел не указан, тест выполнится на всех подключенных узлах.
Тест подключения на каждом узле состоит из двух этапов: выполнения команды findmnt <mount_point> и теста на запись в точке монтирования timeout 10 dd if=/dev/zero bs=4096 count=20 > <mount_point>/test-<node_uuid>.
Статус подключения и ошибки выполнения теста сохраняются в БД.
Если при добавлении подключения был указан параметр autocheck, то тест подключения будет выполняться автоматически с указанной периодичностью в check_timeout.
Размонтировать подключение

Внимание

Подключение можно размонтировать только после удаления всех ВЦОД из него
```
storage nfs mount disconnect --uuid <UUID>
```
где uuid — идентификатор подключения из БД.

Размонтирование происходит на всех подключенных узлах сразу. На каждом узле из файла /etc/fstab удаляется запись о подключении и выполняется команда umount <mount_point>.
Удалить подключение из БД

Внимание

Подключение можно удалить только после размонтирования
```
storage nfs mount del --uuid <UUID>
```
где uuid — идентификатор подключения из БД.
Добавить новые ВЦОД к подключению
```
storage nfs mount ns add --ns <NS> 
                         --uuid <UUID>
```
где
- uuid — идентификатор подключения из БД;
- ns — список ВЦОД, которые нужно добавить.
Удалить ВЦОД из подключения

Внимание

Команду можно выполнить только для несмонтированного подключения
```
storage nfs mount ns del --ns <NS> 
                         --uuid <UUID>
```
где
- uuid — идентификатор подключения из БД;
- ns — список ВЦОД, которые нужно удалить.

Примечание

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

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