Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Рекомендации по организации хранения ISO-образов

1. Пояснение

На данный момент в zVirt есть ограничения при работе с ISO-образами:

  • После перемещения ISO-образов из одного домена хранения в другой теряется возможность загрузки с них виртуальных машин.

  • После перемещения ISO-образа в домене хранения у пользователя нет возможности произвести смену его названия.

  • Не рекомендуется выполнять параллельную загрузку двух и более ISO-образов.

  • При загрузке ISO-образов через портал администрирования возможны ошибки, связанные с настройкой службы ovirt-imageio и сертификатов, например: Не удалось подключиться к службе ovirt-imageio или Transfer was stopped by system. Reason: failure in transfer image ticket renewal.

    Способы их устранения описаны в статьях:

  • Ошибка при загрузке iso-образов (Hosted Engine),

  • Ошибка при загрузке iso-образов в режиме Standalone и

  • Ошибка при загрузке iso-образов в режиме Standalone (all-in-one).

2. Рекомендации

В связи с указанными ограничениями рекомендуется поступать следующим образом:

  • Переименовывать файл ISO до загрузки в домен хранения таким образом, чтобы по названию можно было понять его назначение.

  • Использовать отдельный домен данных для размещения ISO-образов, (например, с именем iso-images). Для этого:

    1. Авторизуйтесь в портале администратора,

    2. Перейдите в раздел Хранилище  Диски,

    3. Выберите кнопку меню Загрузить и нажмите Начать,

    4. Нажмите Тест соединения, чтобы провести тестирование корректности настройки системы до начала загрузки ISO-образа,

    5. Нажмите Выберите файл,

    6. В диалоговом окне выберите ISO-образ для загрузки,

    7. В полях Центр данных, Домен хранения, Профиль диска и Хост выберите необходимый домен хранения, а также хост, который будет использоваться в качестве прокси-сервера для загрузки ISO-образа.

      При выборе хоста рекомендуется выбирать наименее загруженный хост.

  • Для размещения ISO-образов также можно использовать API-функционал. Подробнее см. Загрузка образов дисков в хранилище с помощью утилиты "upload disk".

  • Если загрузка через портал администратора недоступна или не требуется, используйте домен ISO. Подробнее см. раздел Использование домена ISO.

3. Использование домена ISO

Домен ISO — специальный тип домена хранения для ISO-образов. В отличие от домена данных, образы в нём хранятся как обычные файлы на NFS-ресурсе, а загрузка выполняется простым копированием, без портала администратора и установки сертификатов Менеджера в доверенные. Поэтому ошибки загрузки через портал на этот способ не влияют.

Особенности домена ISO:

  • Один домен ISO можно подключить к любому количеству центров данных, при этом образы не нужно загружать в каждый центр данных отдельно.

  • Образы не перемещаются между доменами, поэтому ограничения из раздела Пояснение, связанные с перемещением, к ним не относятся.

  • Для подключения домен ISO в центре данных должен быть активный домен данных.

  • Домен ISO используется только для подключения образов как CD/DVD, использовать образ из него как диск ВМ нельзя.

3.1. Подготовка NFS-ресурса

  1. На NFS-сервере создайте каталог и назначьте владельцем пользователя vdsm и группу kvm (UID и GID 36):

    mkdir -p /exports/iso
chown 36:36 /exports/iso
chmod 0755 /exports/iso

  2. Добавьте каталог в экспорт:

    Вместо <сеть_хостов> укажите сеть хостов виртуализации.

    echo "/exports/iso <сеть_хостов>(rw,sync,no_subtree_check,all_squash,anonuid=36,anongid=36)" >> /etc/exports
exportfs -ra

Если каталог экспортируется с другого хранилища (СХД, NAS), убедитесь, что владелец каталога 36:36, а хосты имеют к нему доступ на чтение и запись.

3.2. Создание домена ISO

  1. Авторизуйтесь в портале администратора.

  2. Перейдите в раздел Хранилище  Домены и нажмите Новый домен.

  3. Заполните поля:

    • Центр данных — центр данных, в котором первоначально будет создан домен;

    • Функция домена — ISO;

    • Тип хранилища — NFS;

    • Хост — любой активный хост центра данных;

    • Имя — любое имя, например: iso;

    • Путь экспорта — <адрес_NFS-сервера>:/exports/iso.

  4. Нажмите OK и дождитесь перехода домена в статус Активный.

В версиях zVirt 5.0 и ранее будет отображено уведомление о том, что домены ISO более не поддерживаются. Проигнорируйте его.

После инициализации на NFS-ресурсе будет создана структура:

/exports/iso/
└── <STORAGE_UUID>/
    ├── dom_md/
    └── images/
        └── 11111111-1111-1111-1111-111111111111/

Где:

  • <STORAGE_UUID> — идентификатор домена, его можно посмотреть в свойствах домена на портале администрирования.

  • Каталог 11111111-1111-1111-1111-111111111111 — место хранения ISO-образов, его имя одинаково для всех доменов ISO.

3.3. Подключение к другим центрам данных

  1. Перейдите в раздел Хранилище  Домены и выберите домен ISO.

  2. На вкладке Центр данных нажмите Подключить.

  3. Выберите центр данных и нажмите OK.

Рекомендуется подключать домен к центрам данных по одному.

3.4. Загрузка ISO-образов

Скопируйте ISO-файлы в каталог <STORAGE_UUID>/images/11111111-1111-1111-1111-111111111111/ на NFS-ресурсе любым удобным способом (cp, scp, rsync).

Если копирование выполняется локально на NFS-сервере, назначьте владельца и права:

cd /exports/iso/<STORAGE_UUID>/images/11111111-1111-1111-1111-111111111111/
chown 36:36 <имя_образа>.iso
chmod 0644 <имя_образа>.iso

При копировании через NFS-клиент с опциями экспорта из подраздела Подготовка NFS-ресурса (all_squash,anonuid=36,anongid=36) владелец назначается автоматически.

Рекомендации:

  • Используйте в именах файлов латиницу, цифры, - и _, без пробелов; расширение — .iso.

  • Не переименовывайте и не удаляйте образ, пока он подключён к ВМ.

Загруженные образы отображаются в разделе Хранилище  Домены → <ISO-домен  → Образы. Список обновляется не мгновенно — если образ не появился, повторите проверку через минуту.

3.5. Подключение ISO-образа к ВМ

Образ из домена ISO подключается к виртуальной машине как CD/DVD стандартным способом через настройки ВМ в портале администрирования.

4. Имеющиеся проблемы и способы их решения

4.1. ISO-образ перестал быть загрузочным после перемещения

Если после перемещения ISO-образ перестаёт быть загрузочным, то необходимо выполнить запрос к API с указанием ID диска:

USER=admin@internal (1)
PASSWORD=1
FQDN="engine.ru"
PEM="engine.cer"
DISK_ID="b8a70a22-53b1-43af-ab04-0abbe53f359a"
curl -s \
        --cacert ${PEM} \
        --request POST \
        --header 'Version: 4' \
        --header 'Accept: application/xml' \
        --header "Content-Type: application/xml" \
        --user ${USER}':'${PASSWORD} \
        --data "<action><disk><sparse>false</sparse><format>raw</format></disk></action>" \
        https://${FQDN}/ovirt-engine/api/disks/${DISK_ID}/convert
1 В случае интеграции с Keycloak используйте учётную запись admin@zvirt@internalsso.

4.2. ISO-образ не отображается в домене ISO

Проверьте следующее:

  • файл находится в каталоге <STORAGE_UUID>/images/11111111-1111-1111-1111-111111111111/, а не в корне NFS-ресурса;

  • владелец файла — 36:36, права — не ниже 0644;

  • расширение файла — .iso;

  • домен ISO находится в статусе Активный хотя бы в одном центре данных.