Работа с томом

Примечание

Действия выполняются пользователем с ролью Администратор ВЦОД или Разработчик ВМ

В статье описана работа с томами Libvirt, РСХД и NFS.

Создание томов описано в статье Создать том.

Libvirt. Работа с томами

Просмотреть список всех томов ВЦОД в рамках указанного пула
```
storage libvirt volume list --pool <pool_name>
```
В качестве дополнительного параметра можно указать sc_node, чтобы отобразить список томов на конкретном узле.
Просмотр подробной информации о конкретном томе
```
storage libvirt volume show --name <volume_name> --pool <pool_name>
```
Введите параметр sc_node, если запрос производится не с того узла, на котором находится запрашиваемый том.

Обновить параметры тома

storage libvirt volume update --capacity <new_capacity> --name <volume_name>  --pool <pool_name> --sc_node <node_uuid_where_volume_place>

Удалить том

storage libvirt volume del --name <volume_name> --pool <pool_name> --sc_node <node_uuid_where_volume_place>

Том может зависнуть в статусе Pending (Ожидание).

Внимание

Данная команда доступна только Администратору ВЦОД

В таких случаях удалите его из базы данных командой
```
storage libvirt volume clear --name <volume_name> --pool <pool_name> --sc_node <node_uuid_where_volume_place> 
```
После этого создайте том заново, указав корректные параметры.

Примечание

Команда clear используется для удаления из списка объектов, зависших в процессе создания и фактически несозданных.
Команда del применяется для удаления уже созданных объектов

РСХД

Работа с томами

Просмотреть список всех томов в рамках указанного шаблона
```
storage sp volume list  [--all {yes,no}] [--template <template_name>]
```
где
- all — список всех томов.
  
  Возможные значения:
  - по умолчанию — yes, список всех томов,
  - no — список томов, принадлежащих определенному шаблону template;
- template — имя шаблона при флаге all no.
Просмотр подробной информации о конкретном томе
```
storage sp volume show --uuid <volume_uuid>
```
где uuid — идентификатор тома.
Обновить параметры тома
```
storage sp volume update [--bw <BW>] [--descr <DESCR>] [--iops <IOPS>] --uuid <volume_uuid> [--persistent <yes_or_no>] [--reuse_server <REUSE_SERVER>] [--size <volume_size>] [--type <cdrom,system,datablock>]
```
где
- bw — ограничение пропускной способности в Кбайт;
- descr — описание тома;
- iops — ограничение операций ввода-вывода;
- uuid — идентификатор тома;
- persistent — возможность изменения тома;
- reuse_server — разрешение на размещение реплик на одном сервере;
- size — размер тома;
- type — тип тома. Возможные значения: cdrom, system, datablock.
Примечание

Чтобы увеличить размер тома, подключенного к ВМ, выполните действия подраздела Увеличить размер тома, подключенного к виртуальной машине
Конвертировать том в снимок.

Важно

Том после команды удаляется
```
storage sp volume freeze --uuid <volume_uuid>
```
где uuid — идентификатор тома.
Том может зависнуть в статусе Pending (Ожидание).

Внимание

Данная команда доступна только Администратору ВЦОД

В таких случаях удалите его из базы данных командой
```
storage sp clear --sc_uuid <node_uuid> --volume_uuid <volume_uuid>
```
После этого создайте том заново, указав корректные параметры.

Удалить том

storage sp volume del --uuid <volume_uuid>

Примечание

Команда clear используется для удаления из списка объектов, зависших в процессе создания и фактически несозданных.
Команда del применяется для удаления уже созданных объектов

Увеличить размер тома, подключенного к виртуальной машине

Важно

Возможно только увеличить размера тома, подключенного к ВМ

Чтобы увеличить размер тома, подключенного к виртуальной машине:

Просмотрите список всех томов
```
storage sp volume list --all yes
```
Выберите из списка base_on том, размер которого нужно увеличить. Запишите его идентификатор.
Введите команду
```
storage sp volume update --uuid <base_on_volume_uuid> --size <new_size>
```
где
- uuid — идентификатор base_on тома;
- size — новый размер тома. Может быть только больше предыдущего размера.
Если виртуальная машина, к которой подключен увеличенный диск, была включена, выключите ВМ командой
```
scheduler request state --name <vm_name> --vcluster <vcluster_name> --state stop
```
где
- name — имя ВМ;
- vcluster — имя виртуального кластера.

Включите виртуальную машину

scheduler request state --name <vm_name> --vcluster <vcluster_name> --state start

NFS. Работа с томами

Примечание

Ограничения работы с NFS-томами описаны в статье NFS. Создать том

Просмотреть информацию о томе
```
storage nfs volume show --uuid <UUID>
```
где uuid — идентификатор тома.
Просмотреть все существующие тома
```
storage nfs volume list [--mount_uuid <MOUNT_UUID>]
```
где mount_uuid — идентификатор подключения.
Удалить том
```
storage nfs volume del --uuid <UUID>
```
где uuid — идентификатор тома.
Том может зависнуть в статусе Pending (Ожидание). В таких случаях удалите его из базы данных командой
```
storage nfs volume clear --uuid <UUID>
```
где uuid — идентификатор тома.

После этого создайте том заново, указав корректные параметры.

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