Перейти к содержанию

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

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

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

Libvirt

Тома Libvirt автоматически создаются в пуле, закрепленном за текущим ВЦОД.

Проверьте доступные ресурсы командой 

storage libvirt volume resources show
Действия, доступные с томами Libvirt:

  1. Просмотреть список всех томов ВЦОД 

    storage libvirt volume list

  2. Просмотреть подробную информацию о конкретном томе 

    storage libvirt volume show [--name <NAME>] 
                            [--uuid <UUID>] 
                            [--get_volume_full_info <yes|no>]
    где

    • name — имя тома;
    • uuid — идентификатор тома;
    • get_volume_full_info — полное имя тома. Значение по умолчанию — no. Возможные значения: yes, no.

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

    storage libvirt volume update --uuid <UUID> 
                              [--capacity <CAPACITY>] 
                              [--type <cdrom|system|datablock>] 
                              [--persistent <yes|no>] 
                              [--descr <DESCR>]
    где

    • uuid — идентификатор тома;
    • capacity — объем тома в мегабайтах или гигабайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 100MB, 200Mb, 300Gb, 400gb;
    • type — тип тома. Возможные значения: cdrom, system, datablock;
    • persistent — возможность изменения тома. Возможные значения: yes, no;
    • descr — описание тома.

  4. Просмотреть права доступа к тому 

    storage libvirt volume rights [--name <NAME>]
                              [--uuid <UUID>]
    где

    • name — имя тома;
    • uuid — идентификатор тома.

  5. Удалить том 

    storage libvirt volume del [--name <NAME>] 
                           [--uuid <UUID>] 
                           [--get_volume_full_info <yes|no>]
    где

    • name — имя тома;
    • uuid — идентификатор тома;
    • get_volume_full_info — предоставление полной информации о томе. Значение по умолчанию — no. Возможные значения: yes, no.

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

    Внимание

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

    В таких случаях удалите его из базы данных командой 

    storage libvirt volume clear [--name <NAME>] 
                             [--uuid <UUID>] 
                             [--get_volume_full_info <yes|no>]
    где

    • name — имя тома;
    • uuid — идентификатор тома;
    • get_volume_full_info — предоставление полной информации о томе. Значение по умолчанию — no. Возможные значения: yes, no.

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

Примечание

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

РСХД

В выводе информации о томе после выполнения команд storage sp volume list и storage sp volume show добавлено поле template_type, в котором указано к какому разделу относится данный том.

Возможные значения:

  • img – том находится в разделе шаблона РСХД img, в котором хранятся все образы после создания или загрузки. Если образ персистентный, то он подключается к ВМ напрямую из этого раздела;
  • sys – том находится в разделе шаблона РСХД sys, в котором хранятся base on образы ВМ, созданные на основе неперсистентных образов из раздела img

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

  1. Просмотреть список всех томов в рамках указанного шаблона 

    storage sp volume list [--all <yes|no>] 
                       [--template <TEMPLATE>]

    где

    • all — список всех томов.

      Возможные значения:

      • по умолчанию — yes, список всех томов;
      • no — список томов, принадлежащих определенному шаблону template;

    • template — имя шаблона при флаге all no.

  2. Просмотр подробной информации о конкретном томе 

    storage sp volume show --uuid <UUID>

    где uuid — идентификатор тома.

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

    storage sp volume update --uuid <UUID> 
                        [--name <NAME>] 
                        [--descr <DESCR>] 
                        [--bw <BW>] 
                        [--iops <IOPS>] 
                        [--reuse_server <REUSE_SERVER>] 
                        [--size <SIZE>] 
                        [--type <cdrom|system|datablock>] 
                        [--persistent <yes|no>] 
                        [--bus <virtio|sata|ide|scsi>]

    где

    • uuid — идентификатор тома;
    • name — имя тома;
    • descr — описание тома;
    • bw — ограничение пропускной способности в килобайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 1000KB, 2000Kb, 3000kb;
    • iops — ограничение операций ввода-вывода;
    • reuse_server — разрешение на размещение реплик на одном сервере;
    • size — размер тома в мегабайтах или гигабайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 100MB, 200Mb, 300Gb, 400gb;
    • type — тип тома. Возможные значения: cdrom, system, datablock;
    • persistent — возможность изменения тома. Возможные значения: yes, no;
    • bus — шина для подключения тома к ВМ. Возможные значения: virtio, sata, ide, scsi.

    Примечание

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

  4. Просмотреть, сколько пространства занимает том РСХД, подключенный к ВМ 

    storage sp volume status --uuid <UUID>

    где uuid — идентификатор тома.

  5. Конвертировать том в снимок.

    Важно

    Том после команды удаляется

    storage sp volume freeze --uuid <UUID>

    где uuid — идентификатор тома.

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

    Внимание

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

    В таких случаях удалите его из базы данных командой 

    storage sp volume clear --uuid <UUID>

    где uuid — идентификатор тома.

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

  7. Удалить том 

    storage sp volume del --uuid <UUID>

    где uuid — идентификатор тома.

Примечание

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

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

Важно

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

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

  1. Просмотрите список всех томов 

    storage sp volume list --all yes

  2. Выберите из списка base_on том, размер которого нужно увеличить. Запишите его идентификатор.

  3. Введите команду 

    storage sp volume update --uuid <UUID> 
                         --size <SIZE>

    где

    • uuid — идентификатор base_on тома;
    • size — новый размер тома в мегабайтах или гигабайтах. Число и единицы измерения указываются слитно в любом регистре. Например: 100MB, 200Mb, 300Gb, 400gb. Может быть только больше предыдущего размера.

  4. Если виртуальная машина, к которой подключен увеличенный том, была включена, выключите ВМ командой 

    scheduler request state --name <NAME> 
                        --vcluster <VCLUSTER> 
                        --state stop
                       [--force <yes|no>]

    где

    • name — имя пользовательского ресурса, содержащего ВМ;
    • vcluster — имя виртуального кластера;

    • state — статус ВМ. Возможные значения:

      • START — запуск ВМ;
      • STOP — остановка ВМ;
      • REBOOT — перезагрузка ВМ;
      • SUSPEND — приостановка работы ВМ;
      • RESUME — возобновление работы ВМ;

    • force — опция, разрешающая принудительную небезопасную перезагрузку или остановку виртуальной машины. Значение по умолчанию — no. Возможные значения:

      • yes — принудительная перезагрузка или остановка ВМ разрешена. При этом несохраненные данные могут быть потеряны;
      • no — выполняется только штатная перезагрузка или остановка.

    Внимание

    Опция force действует исключительно для состояний STOP и REBOOT

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

    scheduler request state --name <NAME> 
                        --vcluster <VCLUSTER> 
                        --state start
    где

    • name — имя ВМ;
    • vcluster — имя виртуального кластера;

    • state — статус ВМ. Возможные значения:

      • START — запуск ВМ;
      • STOP — остановка ВМ;
      • REBOOT — перезагрузка ВМ;
      • SUSPEND — приостановка работы ВМ;
      • RESUME — возобновление работы ВМ.

NFS

Примечание

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

  1. Просмотреть информацию о томе 

    storage nfs volume show --uuid <UUID> 
                        [--name <NAME>] 
                        [--mount_uuid <MOUNT_UUID>] 
                        [--get_full_name <yes|no>]

    где

    • uuid — идентификатор тома;
    • name — имя тома;
    • mount_uuid — идентификатор подключения;
    • get_full_name — полное имя тома. Значение по умолчанию — no. Возможные значения: yes, no;

  2. Просмотреть все существующие тома 

    storage nfs volume list [--mount_uuid <MOUNT_UUID>] 
                        [--get_full_name <yes|no>] 
                        [--all <yes|no>]

    где

    • mount_uuid — идентификатор подключения;
    • get_full_name — полное имя тома. Значение по умолчанию — no. Возможные значения: yes, no;
    • all — показать base_on том. Значение по умолчанию — no. Возможные значения: yes, no.

  3. Удалить том 

    storage nfs volume del [--name <NAME>] 
                       [--uuid <UUID>] 
                       [--mount_uuid <MOUNT_UUID>]
                       [--get_full_name <yes|no>]
    где

    • name — имя тома;
    • mount_uuid — идентификатор подключения;
    • get_full_name — полное имя тома. Значение по умолчанию — no. Возможные значения: yes, no.

  4. Том может зависнуть в статусе Pending (Ожидание). В таких случаях удалите его из базы данных командой 

    storage nfs volume clear --uuid <UUID>

    где uuid — идентификатор тома.

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

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