Как управлять группами инициаторов и портал-группами

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

Когда нужно решить, кто и через какие адреса подключается к хранилищу ВЦОД. Две группы отвечают на два разных вопроса. Группа инициаторов — «кому разрешено»: список IQN хостов и сетей, из которых их пускают. Портал-группа — «через что слушает таргет»: набор пар «адрес + TCP-порт» на пуле.

Разница видна и в области принадлежности, и в том, где группы живут в интерфейсе. Группа инициаторов принадлежит ВЦОД — её ведёт администратор ВЦОД на вкладке Storage. Портал-группа принадлежит пулу и затрагивает все ВЦОД на нём, поэтому она лежит в кластерном разделе Unified Storage. Заводит и удаляет портал-группы только роль Cluster master. Читать состав портал-групп может и администратор ВЦОД, причём по всем пулам кластера.

Обе группы нужны до первой раздачи тома. Саму раздачу описывает «Подключение томов по iSCSI».

Предусловия

• в опциях кластера включена возможность Unified Storage;
• хранилище ВЦОД включено — группы инициаторов живут внутри хранилища;
• для создания и удаления портал-групп — роль Cluster master с привилегиями iSCSI Create Portal Group (13004) и iSCSI Delete Portal Group (13005);
• для чтения портал-групп — привилегии iSCSI View Portal Group (13006) и iSCSI List Portal Groups (13007); они выданы и администратору ВЦОД, причём по всему кластеру;
• для групп инициаторов — привилегия домена Unified Storage в области видимости своего ВЦОД;
• известны IQN хостов-инициаторов и сети, из которых они подключаются;
• версия vStack Center — 3.0.4.

Группы инициаторов

Шаг 1. Создайте группу

1. Откройте карточку ВЦОД → вкладку Storage → под-таб iSCSI.
2. Над таблицей Initiator Groups нажмите Create IG.
3. В окне Create Initiator Group заполните поля:

Поле	Что указать
Group name	1–63 символа: строчные латинские буквы, цифры, точка, дефис; уникально в ВЦОД
Allowed Initiators (IQN)	список IQN хостов; каждая строка добавляется ссылкой Add, IQN — до 223 символов
Authorized networks	список сетей в формате CIDR, из которых разрешено подключаться

4. Подтвердите создание.

Пул в форме не указывается — он берётся из хранилища ВЦОД. Промежуточного состояния «создаётся» у группы нет: она появляется в таблице только после подтверждения контроллером. Если группа есть в списке — контроллер её знает.

Шаг 2. Посмотрите группы ВЦОД

Таблица Initiator Groups на под-табе iSCSI показывает группы этого ВЦОД в свёрнутом виде: Name, Allowed Initiators, Authorized Networks, Status. В колонках состава стоят счётчики: сколько инициаторов и сколько сетей в группе.

Полный состав открывает страница группы: нажмите строку в таблице. На странице две таблицы — Allowed Initiators (IQN) и Authorized Networks, у каждой своя пагинация и кнопка Add.

Шаг 3. Измените состав группы

1. Откройте страницу группы.
2. Для инициаторов: Add добавляет строки, меню строки — Edit и Delete.
3. Для сетей: те же действия в таблице Authorized Networks.
4. Переименование — Actions → Edit Group name.

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

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

Группа инициаторов — общий ресурс. Правка состава затрагивает все тома, которые розданы этой группе, а не только тот, со страницы которого вы пришли.

Если состав не изменился, контроллер не вызывается: при заданном имени меняется одно имя. Отказ контроллера на шаге пересоздания оставляет прежний состав.

Шаг 4. Удалите группу

1. На странице группы откройте Actions → Delete.
2. Подтвердите удаление.

Группа, привязанная к таргету, не удаляется: платформа отвечает, сколько таргетов её держат. Привязка «таргет — портал-группа — группа инициаторов» возникает при первой раздаче тома и дальше живёт сама по себе. Кнопка Unmap снимает раздачу тома, но привязку не трогает, поэтому после отзыва всех раздач группа остаётся занятой. Освобождается она только при удалении ВЦОД. Если контроллер отвечает, что такой группы у него нет, удаление тоже считается успешным. Учёт чистится.

Портал-группы

Шаг 5. Создайте портал-группу

1. В дереве кластера откройте Unified Storage → таб Protocols → переключатель iSCSI.
2. В списке Portal groups нажмите Create portal group.
3. Заполните форму:

Поле	Что указать
Name	1–256 символов
Pool	пул кластера; выбранный пул определяет, какому ВЦОД группа сможет служить
Portals	повторяющийся блок, минимум одна строка: IP address (IPv4) и Port в диапазоне 1000–65535, по умолчанию 3260. Ссылка Add добавляет строку

4. Нажмите Create.

Заводить порталы заранее не нужно: портал — не самостоятельный объект, он существует только как строка состава группы. Повторяющиеся пары «адрес + порт» схлопываются в одну, а пары, уже известные кластеру, переиспользуются.

Группа неизменяема: правки состава существующей группы платформа не поддерживает. Чтобы изменить набор адресов, создайте новую группу и переведите на неё раздачу.

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

Портал-группа принадлежит пулу, а не ВЦОД. Её видят и используют все ВЦОД, чьи хранилища лежат на этом пуле, поэтому изменение набора адресов — операция уровня кластера.

Шаг 6. Посмотрите портал-группы

Список Portal groups показывает три колонки: Name, Pool и Portals — число порталов в группе. У групп, созданных до введения привязки к пулу, колонка Pool пуста: это не сбой, а унаследованные записи. В списке работают поиск, сортировка по колонкам, пагинация и выгрузка в CSV.

Нажмите имя группы — справа откроется её карточка, только для чтения: Name, Pool и таблица Portals с колонками IP address и Port. Полей ввода и кнопок правки состава в карточке нет по той же причине — состав группы неизменяем. Внизу карточки — действие Delete portal group.

Раздел виден только роли Cluster master: если привилегий на кластерный обзор нет, узла Unified Storage в дереве не будет вообще.

Шаг 7. Удалите портал-группу

Удаление вызывается из двух мест — иконкой корзины в строке списка или действием Delete portal group в карточке. Оба открывают одно подтверждение с именем группы.

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

Унаследованная группа без пула удаляется только из базы: контроллер в этом случае не вызывается, ответ приходит сразу.

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

После шагов 1–4 откройте страницу группы инициаторов. Ожидаемо: таблица Allowed Initiators (IQN) содержит ровно те IQN, которые вы задали последней правкой, а Authorized Networks — заданные сети.

После шагов 5–7 обновите список Portal groups. Ожидаемо после создания: в списке есть строка с вашим именем, заполненной колонкой Pool и ненулевым числом в колонке Portals. Ожидаемо после удаления: строки в списке нет.

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

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

Что видно	Почему	Что сделать
«Portal group not found. Refresh the list.» (-45010)	группы уже нет — список открыт устаревшим	обновите список Portal groups. При раздаче тома тот же код означает другое: группа есть, но лежит на другом пуле, а не на пуле хранилища ВЦОД
«Portal group … is in use by a target and cannot be deleted.» (-45016)	группа привязана к таргету, удаление до контроллера не доходит	отзовите раздачи, использующие этот таргет, либо оставьте группу: привязка «таргет — портал-группа» создаётся один раз и переиспользуется
«Unknown initiator group» (-45022)	группы нет либо она принадлежит другому ВЦОД	сверьте группу в таблице Initiator Groups своего ВЦОД; один ответ на два случая — чужая группа не раскрывается
«Initiator group already exists» (-45023)	имя группы занято в этом ВЦОД	задайте другое Group name — имена уникальны в пределах ВЦОД, а не кластера
«Initiator group is in use by … target(s)» (-45024)	группа привязана к таргету; в сообщении стоит число таргетов, которые её держат	кнопка Unmap снимает раздачу тома, но привязку не убирает. Группа освобождается только при удалении ВЦОД, поэтому до тех пор оставьте её на месте
«Invalid initiator group parameters» (-45025)	состав не прошёл проверку	заполните хотя бы один инициатор и одну сеть, проверьте формат IQN, формат CIDR и имя группы
«Storage is not enabled for VDC» (-45013)	группы инициаторов живут в хранилище ВЦОД, а его нет	включите хранилище на вкладке Storage
Пул не найден (-45002)	выбранный пул не существует или у него нет имени	выберите пул заново; состояние пулов — в разделе «Пулы хранения»
Форма не принимает значения (-32602)	значение не проходит разбор: пустое или слишком длинное имя, ни одной строки порталов, некорректный адрес IPv4	проверьте поля по правилам шага 5; повторяющуюся пару «адрес + порт» форма отмечает на второй такой строке
Контроллер пула не ответил или отказал (-45020, -45021)	пул недоступен либо отказал на шаге пересоздания группы; состав не изменён	проверьте доступность пула и повторите операцию
Отказ с текстом от платформы	контроллер вернул свою причину — например, что группа с таким номером у него уже есть	группа при этом не появляется в списке, расхождения между учётом и контроллером не остаётся; устраните причину и повторите
«Access denied» (-403)	создание и удаление портал-групп доступны только роли Cluster master; для групп инициаторов — нет привилегии либо ВЦОД вне области видимости	войдите под ролью уровня кластера или работайте в своём ВЦОД; чтение портал-групп этим отказом не закрыто

См. также

• Подключение томов по iSCSI — где обе группы используются вместе.
• Как настроить iSCSI-таргет и парольную защиту CHAP — точка доступа, к которой привязываются группы.
• Хранилище ВЦОД — модель и устройство — области принадлежности сущностей и инварианты.

Методы API

Операции этой страницы в API: iscsi-initiator-group-create, iscsi-initiator-group-list, iscsi-initiator-group-get, iscsi-initiator-group-set, iscsi-initiator-group-delete, iscsi-portal-group-create, iscsi-portal-group-list, iscsi-portal-group-get, iscsi-portal-group-delete — см. Справочник API.