Как раздать том по iSCSI и отозвать раздачу

Когда использовать

Когда том создан, а хост его ещё не видит. Раздача — последний шаг цепочки: она добавляет том на таргет ВЦОД под выбранным номером LUN и ограничивает его видимость одной группой инициаторов. До этого шага том существует, занимает квоту, но недоступен никому.

Обратная операция — отзыв раздачи. Она снимает LUN с таргета, а том оставляет на месте: данные не удаляются. Отзыв нужен, когда том требуется сохранить, но доступ к нему надо закрыть или изменить. При удалении розданного тома vStack Center снимает раздачу сам.

Предусловия

• в опциях кластера включена возможность Unified Storage;
• у ВЦОД настроен iSCSI-таргет — см. «Как настроить iSCSI-таргет и парольную защиту CHAP»;
• есть портал-группа на пуле хранилища ВЦОД — см. «Группы инициаторов и порталов»;
• том создан и ещё не роздан: в списке Volumes его Status — Unmapped (см. «Тома ВЦОД»);
• привилегия Map vDC Volume для раздачи и Unmap vDC Volume для отзыва — обе доступны роли Cluster master и администратору ВЦОД в рамках своего ВЦОД;
• версия vStack Center — 3.0.4.

Шаг 1. Выберите номер LUN и группу инициаторов

Номер LUN уникален в пределах таргета и лежит в диапазоне 0..255. Форма раздачи подставляет свободный номер сама; занятые номера видны в Properties на страницах уже розданных томов этого ВЦОД, поле LUN ID.

Группу инициаторов берут существующую или создают вместе с раздачей — в форме это одна и та же строка выбора.

Что нужно	Что выбрать в форме	Когда удобнее
Отдать том хостам, которые уже описаны группой	существующую группу в списке Initiator Group	группа переиспользуется; состав правится отдельно на её странице
Завести группу под этот том сразу	Create и заполнить состав на месте	первая раздача в ВЦОД; экономит переход на другой экран

Шаг 2. Раздайте том

1. Откройте карточку ВЦОД → вкладку Storage → под-таб Volumes и нажмите имя тома.
2. В секции Initiator Group Mapping нажмите Map volume.
3. Заполните форму:

Поле	Что указать
Protocol	iSCSI; вариант NVMe в этой версии недоступен и помечен Coming soon
LUN ID	свободный номер 0..255; поле уже заполнено предложенным значением
Initiator Group	существующая группа или Create — тогда заполните Group name, Allowed Initiators (IQN) и Authorized networks

4. Подтвердите раздачу.

Портал-группу в форме не выбирают: используется группа, привязанная к пулу хранилища ВЦОД.

Форма ждёт завершения всей операции, а не только её приёма. Под этим ожиданием стоит цепочка шагов на контроллере пула, и порядок в ней не случайный:

1. создаётся группа инициаторов, если её просили создать;
2. создаётся привязка «таргет — портал-группа — группа инициаторов», если её ещё нет;
3. том добавляется на таргет как LUN;
4. видимость LUN ограничивается этой группой инициаторов.

Маскирование идёт последним, потому что маска накладывается на уже добавленный LUN. Том считается розданным только после успеха всех шагов: пока цепочка не дошла до конца, его Status остаётся Unmapped. Если маска не легла, добавленный LUN снимается компенсирующим шагом — полураздач не остаётся.

Шаг 3. Проверьте изоляцию

Маска ограничивает видимость LUN одной группой инициаторов: другие группы того же таргета этот том не видят. Один том экспортируется ровно одной группе — раздать его второй группе нельзя.

Отсюда рабочий приём: чтобы расширить круг хостов, не отзывайте раздачу, а допишите IQN в состав уже привязанной группы. На странице тома это делает кнопка Edit group members в секции Initiator Group Mapping. Изменения действуют на том сразу.

предупреждение

Группа инициаторов — общий ресурс: правка состава через Edit group members затрагивает все тома, которые розданы этой группе.

Сменить группу у розданного тома одной операцией нельзя. Смена группы — это Unmap, а затем Map volume с другой группой.

Шаг 4. Отзовите раздачу

1. Откройте страницу тома.
2. В секции Initiator Group Mapping нажмите Unmap.
3. Подтвердите отзыв в диалоге.

Цепочка отзыва симметрична раздаче и состоит из двух шагов: сначала снимается маска LUN, затем сам LUN. Порядок обязателен — маска не уходит автоматически вместе с LUN, и обратный порядок оставил бы висящую привязку. Если контроллер отвечает, что LUN или маски у него нет, это считается успехом: учёт чистится, а расхождение гасится.

Что переживает отзыв: группа инициаторов, таргет и привязка «таргет — портал-группа — группа инициаторов». Привязка переиспользуется следующей раздачей, поэтому повторное подключение того же тома дешевле первого.

Проверка результата

Останьтесь на странице тома.

Ожидаемо после шага 2: в шапке — Mapped, в Properties появились Protocol, LUN ID с заданным номером и Target со ссылкой на страницу таргета. Секция Initiator Group Mapping показывает имя группы и под-карточки Initiators и Authorized networks.

Ожидаемо после шага 4: в шапке — Unmapped, секция раздачи показывает «Volume is not mapped» и кнопку Map volume, а Protocol в Properties равен None.

Признак у инициатора в под-карточке Initiators — это сверка состава группы с контроллером: Disconnected означает, что запись есть в учёте vStack Center, а на контроллере её нет.

Если не получилось

Что видно	Почему	Что сделать
«iSCSI is not configured for VDC» (-45032)	у ВЦОД нет таргета, добавлять LUN некуда	настройте iSCSI на под-табе Overview вкладки Storage
«Unknown portal group» (-45010)	портал-группа не найдена или лежит не на пуле хранилища этого ВЦОД	проверьте пул группы в кластерном разделе Unified Storage → Protocols → iSCSI, колонка Pool
«LUN ID … is already in use on target …» (-45029)	номер занят другим томом того же таргета; в сообщении видны таргет и номер	задайте свободный номер из диапазона 0..255 — занятые видны в Properties розданных томов
«Volume is already mapped» (-45027)	том уже роздан, а один том экспортируется ровно одной группе	расширьте состав привязанной группы через Edit group members вместо второй раздачи
«Volume is not mapped» (-45028)	отзывать нечего: том не роздан	проверьте Status тома в списке Volumes — вероятно, отзыв уже прошёл
«Unknown volume» (-45026)	тома нет, он принадлежит другому ВЦОД либо ещё не подтверждён контроллером	обновите список Volumes; один ответ на три случая — чужой том не раскрывается
«Unknown initiator group» (-45022)	выбранной группы нет либо она принадлежит другому ВЦОД	выберите группу из таблицы Initiator Groups своего ВЦОД
«Initiator group already exists» (-45023)	имя новой группы занято в этом ВЦОД	задайте другое Group name либо выберите существующую группу
«Invalid initiator group parameters» (-45025)	состав новой группы не прошёл проверку	проверьте имя, формат IQN и формат CIDR
«Invalid volume map parameters» (-45031)	набор параметров не сходится с протоколом	проверьте LUN ID в диапазоне 0..255 и то, что выбрана ровно одна группа — существующая либо новая, с непустым списком инициаторов
«Volume map protocol is out of scope: nvme» (-45030)	протокол NVMe в этой версии не поддерживается	раздача идёт только по iSCSI; обхода нет
«Storage is not enabled for VDC» (-45013)	хранилище у ВЦОД не включено	включите хранилище на вкладке Storage
Контроллер пула не ответил или отказал (-45020, -45021)	пул недоступен либо отказал на шаге цепочки	при раздаче том остаётся не розданным, при отзыве запись о раздаче сохраняется; проверьте доступность пула и повторите
Отказ при отзыве с текстом от платформы	контроллер отказал на снятии маски или LUN и передал причину как есть	запись о раздаче сохраняется, том остаётся розданным — разбирайте причину на стороне пула
«Unified Storage feature is disabled» (-45001)	возможность Unified Storage выключена в опциях кластера	включение — на стороне администратора кластера; пока возможность выключена, операции хранилища отклоняются
«Access denied» (-403)	не хватает привилегии Map vDC Volume или Unmap vDC Volume либо открыт чужой ВЦОД	работайте в своём ВЦОД; существование чужого ВЦОД в ответе не раскрывается

См. также

• Тома ВЦОД — создание тома, карточка и удаление.
• Группы инициаторов и порталов — правила доступа, на которые опирается раздача.
• Хранилище ВЦОД — модель и устройство — инварианты раздачи и разделение доступа.

Методы API

Операции этой страницы в API: vdc-volume-map, vdc-volume-unmap, vdc-list-volumes, vdc-volume-get, iscsi-initiator-group-set — см. Справочник API.