Как создавать, читать и удалять тома ВЦОД

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

Когда ВЦОД нужен блочный том: под данные приложения, под общий диск для хоста вне кластера, под будущую раздачу по iSCSI. Том создаётся внутри уже включённого хранилища ВЦОД, занимает его квоту и до раздачи никому не виден.

Инструкция закрывает жизненный цикл тома целиком: создание, чтение параметров и занятого места, удаление. Раздача тома инициатору — отдельный шаг, он описан в «Подключение томов по iSCSI». Если хранилище у ВЦОД ещё не включено, начните с создания ВЦОД с Unified Storage.

Предусловия

• в опциях кластера включена возможность Unified Storage;
• хранилище ВЦОД включено — вкладка Storage карточки ВЦОД показывает его сводку, а не приглашение включить;
• привилегия Create vDC Volume для создания и Delete vDC Volume для удаления — обе доступны роли Cluster master и администратору ВЦОД в рамках своего ВЦОД;
• версия vStack Center — 3.0.4.

Шаг 1. Проверьте свободную квоту

Ёмкость хранилища равна квоте пространства ВЦОД, отдельного лимита у хранилища нет. Перед созданием крупного тома посмотрите, сколько квоты уже занято.

1. Откройте Virtual Data Centers.
2. Смотрите колонку Storage: в ней занятое место и действующая квота, рядом мини-индикатор. Если квота не задана, вторым числом стоит «∞».
3. Фильтр рядом с поиском отбирает ВЦОД по состоянию хранилища: All storage states, Storage enabled, Storage disabled.

Квота считается по всему занятому пространству ВЦОД, а не только по томам хранилища: диски виртуальных машин суммируются с томами. Лимит правится в настройках ВЦОД полем Storage (GB).

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

1. Откройте карточку ВЦОД → вкладку Storage → под-таб Volumes.
2. Нажмите Create volume.
3. Заполните форму:

Поле	Что указать
Volume name	1–63 символа: строчные латинские буквы, цифры, точка, дефис; первый и последний символ — буква или цифра; имя уникально в хранилище этого ВЦОД
Size	размер тома, минимум 1 ГБ; единица выбирается рядом с числом
Protocol	iSCSI, если том раздаётся сразу, или Choose later
LUN ID	номер, под которым том виден на таргете; поле преднастроено свободным номером
Initiator Group	существующая группа, новая группа или Assign later

4. Нажмите Create.

Пул в форме не выбирается — он берётся из хранилища ВЦОД. Размер блока форма тоже не спрашивает: платформа подставляет значение по умолчанию 32768 байт, и оно видно в колонке Block size списка томов.

Ёмкость резервируется в квоте до обращения к контроллеру пула. Если контроллер отказал, резерв снимается и тома не остаётся ни на пуле, ни в списке.

Шаг 3. Посмотрите список томов ВЦОД

Под-таб Volumes показывает тома этого ВЦОД плоской таблицей.

Колонка	Что показывает
ID	идентификатор тома; ссылка на страницу тома
Name	имя тома в хранилище; тоже ссылка
Size	размер тома
Block size	размер блока, подставленный при создании
Protocol	протокол раздачи или None, если том не роздан
Access	группа инициаторов, которой том экспортирован
Status	Mapped или Unmapped

В таблице работают поиск, сортировка по колонкам и пагинация. Пустое хранилище показывает сообщение «No volumes yet».

Тома видны и до настройки iSCSI: создание тома и его раздача — независимые шаги. Тома всех ВЦОД сводит отдельный экран «Все тома»: одна таблица с постраничным выводом и фильтрами по ВЦОД, пулу, признаку раздачи и протоколу. В каждой строке стоят ВЦОД, пул и размер тома. Экран открыт только роли Cluster master. Пустой результат под фильтром и кластер без томов на нём различимы.

Шаг 4. Откройте карточку тома

Нажмите имя или идентификатор тома в списке.

В шапке страницы — имя тома и его состояние: Mapped или Unmapped. Дальше две карточки и секция раздачи.

Блок	Что в нём
Properties	Name, Pool, Size, Path — полное имя тома на пуле. У розданного тома добавляются Protocol, LUN ID и Target со ссылкой на страницу таргета
Capacity	занятое и доступное место, коэффициенты сжатия и дедупликации. Доступное — остаток самого тома, а не свободная ёмкость пула
Initiator Group Mapping	имя группы инициаторов со ссылкой на её страницу, под-карточки Initiators и Authorized networks

Читайте страницу так. Properties и состояние раздачи vStack Center отдаёт из своего учёта, а показатели Capacity запрашивает у контроллера пула в момент открытия. Недоступность контроллера страницу не роняет: значения в Capacity приходят пустыми, остальное отображается.

У не розданного тома секция Initiator Group Mapping показывает «Volume is not mapped» и кнопку Map volume, а Protocol в Properties равен None.

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

Шаг 5. Удалите том

Удаление вызывается действием Delete volume. Если том роздан, vStack Center сначала снимает раздачу, затем удаляет том.

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

Если раздачу удалось снять, но контроллер затем отказал в уничтожении тома (например, из-за снимков или клонов), том останется в списке без раздачи. Устраните зависимость и повторите удаление; чтобы вернуть доступ к тому, раздайте его заново.

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

Вернитесь на под-таб Volumes.

Ожидаемо после шага 2: в таблице есть строка с вашим именем, в колонке Size — заданный размер, в колонке Status — Unmapped. Ожидаемо после шага 5: строки с этим томом в таблице нет, а занятое место в колонке Storage на экране Virtual Data Centers уменьшилось на размер тома.

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

Что видно	Почему	Что сделать
«Storage is not enabled for VDC» (-45013)	хранилище у ВЦОД не включено, создавать тома негде	включите хранилище на вкладке Storage — шаги в создании ВЦОД с Unified Storage
«Quota exceeded» (-45017)	запрошенный размер больше свободной квоты ВЦОД; в сообщении видны запрошенный и доступный объём	уменьшите Size или увеличьте квоту Storage (GB) в настройках ВЦОД
«Volume already exists» (-45018)	имя занято другим томом того же хранилища	задайте другое Volume name; занявший имя том ищите в списке Volumes — имена уникальны внутри хранилища ВЦОД, а не кластера
«Invalid volume parameters» (-45019)	значения не прошли проверку: размер, размер блока или формат имени	проверьте Volume name по правилам шага 2 и Size не меньше 1 ГБ
«Unknown volume» (-45026)	тома нет, он принадлежит другому ВЦОД или ещё не подтверждён контроллером	обновите список Volumes и откройте том заново; один ответ на три случая — принадлежность чужого тома не раскрывается
«Unified Storage feature is disabled» (-45001)	возможность Unified Storage выключена в опциях кластера	включение — на стороне администратора кластера; пока возможность выключена, операции хранилища отклоняются, роль Cluster master исключения не даёт
Пул хранилища не найден (-45002)	учёт и состояние пула расходятся	проверьте состояние пула в разделе «Пулы хранения»
Контроллер пула не ответил или отказал (-45020, -45021)	пул недоступен либо отказал на одном из шагов удаления	проверьте доступность пула, обновите карточку тома и проверьте состояние раздачи перед повтором
Отказ на удалении с текстом от платформы	том держат его снимки или клоны — платформа передаёт причину как есть	снимите зависимости на стороне пула и повторите удаление
«Access denied» (-403)	не хватает привилегии либо открыт ВЦОД вне области видимости	работайте в своём ВЦОД; кросс-ВЦОД чтение доступно только роли Cluster master

См. также

• Хранилище ВЦОД — модель и устройство — инварианты модели и разделение доступа.
• Подключение томов по iSCSI — как отдать том инициатору и отозвать раздачу.
• Как посмотреть и изменить свойства датасета — свойства ZFS на уровне датасета.

Методы API

Операции этой страницы в API: vdc-create-volume, vdc-list-volumes, vdc-volume-get, vdc-volume-delete, vdc-storage-list, cluster-list-volumes — см. Справочник API.