Spec-Zone.ru › Ansible

Модуль hitachivantara.vspone_block.vsp.hv_hur_bulk — управление пакетами пар HUR в блочных системах хранения данных VSP.

Примечание

Этот модуль входит в коллекцию hitachivantara.vspone_block (версия 4.8.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install hitachivantara.vspone_block. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hitachivantara.vspone_block.vsp.hv_hur_bulk.

Добавлено в hitachivantara.vspone_block 3.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль позволяет создавать пакеты пар HUR в блочных системах хранения данных VSP. — Обеспечивает эффективное создание нескольких пар HUR за одну операцию.
  • Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/hur_bulk.yml

Требования

На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

dictionary / required

Сведения, необходимые для подключения к системе хранения данных.

address

string / required

IP-адрес или имя хоста системы хранения данных.

api_token

string

Токен для работы с заблокированными ресурсами.

connection_type

string

Тип подключения к системе хранения данных.

Варианты:

  • "direct" ← (по умолчанию)

password

string

Пароль для аутентификации. Это обязательное поле.

username

string

Имя пользователя для аутентификации. Это обязательное поле.

secondary_connection_info

dictionary

Сведения, необходимые для подключения к вторичной системе хранения данных.

address

string / required

IP-адрес или имя хоста вторичной системы хранения данных.

api_token

string

Значение токена блокировки для работы с заблокированными ресурсами.

password

string

Пароль для аутентификации во вторичной системе хранения данных, если api_token не указан.

username

string

Имя пользователя для аутентификации во вторичной системе хранения данных, если api_token не указан.

spec

dictionary / required

Спецификация задачи пакетного создания пар HUR.

allocate_new_consistency_group

boolean

Укажите, нужно ли выделить новую группу согласованности.

Варианты:

  • false ← (по умолчанию)
  • true

begin_primary_volume_id

string

Начальный идентификатор основного тома для пакетного создания с использованием существующих томов.

begin_secondary_volume_id

string

Начальный идентификатор LDEV для диапазона вторичных томов.

capacity_saving

string

Режим экономии емкости для новых томов (например, ‘compression’, ‘deduplication_compression’).

consistency_group_id

integer

Идентификатор группы согласованности от 0 до 255. Это необязательное поле.

copy_group_name

string / required

Имя группы копирования.

copy_pair_base_name

string / required

Префикс имен пар копирования. Фактические имена пар копирования будут иметь вид <copy_pair_base_name>_<primary_volume_id>_<secondary_volume_id>

data_reduction_share

boolean

Укажите, нужно ли создать общий том с сокращением объема данных. Для Thin Image Advance этому параметру присваивается значение true.

Варианты:

  • false
  • true

do_initial_copy

boolean

Выполнить первоначальное копирование. Это необязательное поле при выполнении операции создания.

Варианты:

  • false
  • true ← (по умолчанию)

enable_delta_resync

boolean

Укажите, нужно ли включить дельта-синхронизацию.

Варианты:

  • false ← (по умолчанию)
  • true

end_primary_volume_id

string

Конечный идентификатор основного тома для пакетного создания с использованием существующих томов.

end_secondary_volume_id

string

Конечный идентификатор LDEV для диапазона вторичных томов.

fence_level

string

Задает уровень ограждения основного тома и определяет, будет ли узлу запрещен доступ к основному тому или он сможет продолжать обращаться к нему, когда пара приостановлена из-за ошибки. Это необязательное поле.

Варианты:

  • "ASYNC" ← (по умолчанию)

is_consistency_group

boolean

Укажите, нужно ли включить группу согласованности.

Варианты:

  • false ← (по умолчанию)
  • true

is_data_reduction_force_copy

boolean

Принудительное копирование для сокращения объема данных. Необязательный параметр для задачи Create HUR pair in new copy group.

Варианты:

  • false
  • true ← (по умолчанию)

is_new_group_creation

boolean

Укажите, нужно ли включить создание новой группы.

Варианты:

  • false
  • true

local_device_group_name

string

Имя локальной группы устройств.

mirror_unit_number

integer

Номер зеркального блока.

Варианты:

  • 0
  • 1
  • 2
  • 3

number_of_pairs

integer / required

Количество пар GAD для пакетного создания.

path_group_id

integer

Необязательный параметр для задач Create HUR pair in new copy group /Create HUR-NVMe pair /Create HUR-ISCSI pair. Укажите идентификатор группы путей в диапазоне от 0 до 255. Если вы не уверены, не используйте этот параметр. Если опустить это значение или указать 0, будет использоваться наименьший идентификатор группы путей в указанной группе путей.

primary_hostgroups

list / elements=dictionary

Список объектов групп узлов для основных томов.

lun_id

integer

Идентификатор LUN группы узлов во вторичной системе хранения данных. Для операции создания не требуется.

name

string / required

Имя группы узлов во вторичной системе хранения данных. Для операции создания обязательно.

port_id

string / required

Порт группы узлов во вторичной системе хранения данных. Для операции создания обязательно.

primary_iscsi_targets

list / elements=dictionary

Список целей iSCSI на основном устройстве хранения данных.

lun_id

integer

Идентификатор LUN.

name

string / required

Имя цели iSCSI.

port_id

string / required

Идентификатор порта.

primary_journal_id

integer

Идентификатор журнала основного тома. Это необязательное поле.

primary_nvm_subsystem

dictionary

Сведения о подсистеме NVM основного тома..

name

string / required

Имя подсистемы NVM в основной системе хранения данных.

paths

list / elements=string

Сведения о путях Host NQN в основной системе хранения данных.

primary_pool_id

integer / required

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

primary_volume_base_name

string

Префикс имен основных томов при пакетном создании новых томов.

primary_volume_base_name_number_of_digits

integer

Количество цифр в суффиксе имен основных томов при пакетном создании.

Варианты:

  • 1
  • 2
  • 3
  • 4
  • 5

primary_volume_base_name_start_number

integer

Начальный номер, который будет добавлен к primary_volume_base_name для формирования имени первого тома при пакетном создании.

remote_device_group_name

string

Имя удаленной группы устройств.

secondary_hostgroups

list / elements=dictionary

Список объектов групп узлов для вторичных томов.

lun_id

integer

Идентификатор LUN группы узлов во вторичной системе хранения данных. Для операции создания не требуется.

name

string / required

Имя группы узлов во вторичной системе хранения данных. Для операции создания обязательно.

port_id

string / required

Порт группы узлов во вторичной системе хранения данных. Для операции создания обязательно.

secondary_iscsi_targets

list / elements=dictionary

Список целей iSCSI на вторичном устройстве хранения данных.

lun_id

integer

Идентификатор LUN.

name

string / required

Имя цели iSCSI для вторичной системы хранения данных.

port_id

string / required

Идентификатор порта.

secondary_journal_id

integer

Идентификатор журнала вторичного тома. Это необязательное поле.

secondary_nvm_subsystem

dictionary

Сведения о подсистеме NVM вторичного тома.

name

string / обязательный

Имя подсистемы NVM на вторичной системе хранения данных.

paths

list / elements=string

Информация о путях Host NQN на вторичной системе хранения данных.

secondary_pool_id

integer / обязательный

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

should_match_volume_ids

boolean

Укажите, должны ли совпадать идентификаторы первичного и вторичного томов в парах HUR. Значение по умолчанию — false.

Варианты:

  • false
  • true

volume_size

string / обязательный

Размер создаваемого тома (например, «10GB», «1TB») для пар HUR.

state

string

Для массового создания пар HUR задайте состояние present.

Варианты:

  • "present" ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

Определяет, следует ли запускать модуль в режиме проверки.

Примеры

- name: Create a HUR pairs in bulk mode
  hitachivantara.vspone_block.vsp.hv_hur_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      number_of_pairs: 2
      copy_group_name: "rd_hur_cg_123"
      copy_pair_base_name: "rd_hur_cp_123_"
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "1GB"
      primary_hostgroups:
        - name: "snewar-common-hg-01"
          port_id: "CL2-A"
        - name: "snewar-common-hg-01"
          port_id: "CL2-B"
      secondary_hostgroups:
        - name: "snewar-common-hg-01"
          port_id: "CL2-A"
        - name: "snewar-common-hg-01"
          port_id: "CL2-B"

- name: Create a HUR pairs in bulk mode with matching primary and secondary volume IDs
  hitachivantara.vspone_block.vsp.hv_hur_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      should_match_volume_ids: true
      number_of_pairs: 2
      copy_group_name: "rd_hur_cg_123"
      copy_pair_base_name: "rd_hur_cp_123_"
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "1GB"
      primary_hostgroups:
        - name: "snewar-common-hg-01"
          port_id: "CL2-A"
        - name: "snewar-common-hg-01"
          port_id: "CL2-B"
      secondary_hostgroups:
        - name: "snewar-common-hg-01"
          port_id: "CL2-A"
        - name: "snewar-common-hg-01"
          port_id: "CL2-B"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

hur_info

dictionary

Объект только что созданной пары HUR.

Возвращается: при успешном выполнении

consistency_group_id

integer

Идентификатор группы согласованности.

Возвращается: при успешном выполнении

Пример: 51

copy_group_name

string

Имя группы копирования.

Возвращается: при успешном выполнении

Пример: "snewar_hur_copy_group_12"

copy_pair_name

string

Имя пары копирования.

Возвращается: при успешном выполнении

Пример: "snewar_hur_copy_pair_12"

copy_rate

integer

Устарело. Скорость копирования.

Возвращается: при успешном выполнении

Пример: -1

fence_level

string

Настройка уровня fencing.

Возвращается: при успешном выполнении

Пример: "ASYNC"

local_device_group_name

string

Имя локальной группы устройств, для которой нужно получить информацию о паре TrueCopy.

Возвращается: при успешном выполнении

Пример: "hur_bulk_cg_1P_"

mirror_unit_id

integer

Устарело. Используйте вместо этого mirror_unit_number.

Возвращается: при успешном выполнении

Пример: 1

mirror_unit_number

integer

Номер зеркального устройства.

Возвращается: при успешном выполнении

Пример: 1

primary_journal_id

integer

Идентификатор первичного журнала.

Возвращается: при успешном выполнении

Пример: 25

primary_journal_pool

integer

Устарело. Используйте вместо этого primary_journal_id.

Возвращается: при успешном выполнении

Пример: 25

primary_volume_id

integer

Идентификатор первичного тома.

Возвращается: при успешном выполнении

Пример: 6442

primary_volume_id_hex

string

Шестнадцатеричное представление идентификатора первичного тома.

Возвращается: при успешном выполнении

Пример: "00:19:2A"

primary_volume_status

string

Состояние первичного тома.

Возвращается: при успешном выполнении

Пример: "PAIR"

primary_volume_storage_id

string

Устарело. Используйте вместо этого primary_volume_storage_serial_number.

Возвращается: при успешном выполнении

Пример: "810050"

primary_volume_storage_serial_number

string

Серийный номер системы хранения данных для первичного тома.

Возвращается: при успешном выполнении

Пример: "810050"

pvol_status

string

Устарело. Используйте вместо этого primary_volume_status.

Возвращается: при успешном выполнении

Пример: "PAIR"

pvol_storage_device_id

string

Устарело. Идентификатор устройства хранения PVOL.

Возвращается: при успешном выполнении

Пример: "A34000810050"

remote_device_group_name

string

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

Возвращается: при успешном выполнении

Пример: "hur_bulk_cg_1S_"

remote_mirror_copy_pair_id

string

Устарело. Идентификатор пары удалённого зеркального копирования.

Возвращается: при успешном выполнении

Пример: "A34000810050,spcA34000810045A34000810050,spcA34000810045A34000810050,spcA34000810050A34000810045,spc-7331-6442"

secondary_journal_id

integer

Идентификатор вторичного журнала.

Возвращается: при успешном выполнении

Пример: 25

secondary_journal_pool

integer

Устарело. Используйте вместо этого secondary_journal_id.

Возвращается: при успешном выполнении

Пример: 25

secondary_volume_id

integer

Идентификатор вторичного тома.

Возвращается: при успешном выполнении

Пример: 7331

secondary_volume_id_hex

string

Шестнадцатеричное представление идентификатора вторичного тома.

Возвращается: при успешном выполнении

Пример: "00:1C:A3"

secondary_volume_storage_id

string

Устарело. Используйте вместо этого secondary_volume_storage_serial_number.

Возвращается: при успешном выполнении

Пример: "810045"

secondary_volume_storage_serial_number

string

Серийный номер системы хранения данных для вторичного тома.

Возвращается: при успешном выполнении

Пример: "810045"

svol_status

string

Состояние SVOL.

Возвращается: при успешном выполнении

Пример: "PAIR"

svol_storage_device_id

string

Устарело. Идентификатор устройства хранения SVOL.

Возвращается: при успешном выполнении

Пример: "A34000810045"

Авторы

  • Hitachi Vantara LTD (@hitachi-vantara)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hitachivantara/vspone_block/vsp.hv_hur_bulk_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API