Модуль hitachivantara.vspone_block.vsp.hv_gad_bulk — управление пакетами пар GAD в блочных системах хранения данных 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_gad_bulk.

Новое в hitachivantara.vspone_block 4.7.0

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Информация, необходимая для подключения к системе хранения данных.
address string / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token string	Токен, используемый для работы с заблокированными ресурсами.
connection_type string	Тип подключения к системе хранения данных. Варианты: `"direct"` ← (по умолчанию)
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
secondary_connection_info dictionary	Информация, необходимая для подключения к вторичной системе хранения данных.
address string / обязательный	IP-адрес или имя хоста вторичной системы хранения данных.
api_token string	Значение токена блокировки для работы с заблокированными ресурсами.
password string	Пароль для аутентификации. Это поле обязательно для подключения к вторичной системе хранения данных, если не указан api_token.
username string	Имя пользователя для аутентификации. Это поле обязательно для подключения к вторичной системе хранения данных, если не указан api_token.
spec dictionary / обязательный	Спецификация задачи пакетного создания пар GAD.
allocate_new_consistency_group boolean	Выделить и назначить новый идентификатор группы согласованности. Варианты: `false` `true`
begin_primary_volume_id integer	Начальный идентификатор основного тома для пакетного создания с использованием существующих томов.
begin_secondary_volume_id string	Начальный идентификатор LDEV для диапазона вторичных томов.
capacity_saving string	Режим экономии емкости для новых томов (например, ‘compression’, ‘compression_deduplication’).
consistency_group_id integer	Идентификатор группы согласованности.
copy_group_name string	Имя группы копирования.
copy_pace integer	Скорость копирования для пары GAD. Поддерживаются значения от 1 до 15. По умолчанию: `3`
copy_pair_base_name string	Базовое имя пар копирования. К именам пар будут добавляться возрастающие номера.
do_initial_copy boolean	Следует ли выполнять начальное копирование. Варианты: `false` `true` ← (по умолчанию)
end_primary_volume_id integer	Конечный идентификатор основного тома для пакетного создания с использованием существующих томов.
end_secondary_volume_id string	Конечный идентификатор LDEV для диапазона вторичных томов.
fence_level string	Уровень fencing для пар GAD. Варианты: `"NEVER"` ← (по умолчанию) `"DATA"` `"STATUS"` `"UNKNOWN"`
is_consistency_group boolean	Укажите true для группы согласованности. Варианты: `false` `true`
is_data_reduction_force_copy boolean	Следует ли принудительно создавать пару для томов с сокращением объема данных. Варианты: `false` `true` ← (по умолчанию)
is_new_group_creation boolean	Укажите true, чтобы задать новое имя группы копирования. Варианты: `false` `true`
local_device_group_name string	Имя группы устройств в локальной системе хранения данных. Необязательный параметр для задач Split/Resync/Swap-Split/Swap-Resync.
mirror_unit_number string	Номер блока зеркалирования.
new_volume_size string	Новый размер тома для операций изменения размера или расширения.
number_of_pairs integer	Количество пар GAD для пакетного создания.
path_group_id integer	Идентификатор группы путей.
primary_hostgroups list / elements=dictionary	Список групп хостов на основном устройстве хранения данных. Обязательно для задачи создания пары GAD с конфигурацией кластера серверов.
name string / обязательный	Имя группы хостов. Обязательно для задач создания пары GAD с конфигурацией кластера серверов и создания пары GAD с конфигурацией сервера с перекрестными путями.
port_id string / обязательный	Идентификатор порта. Обязательно для задач создания пары GAD с конфигурацией кластера серверов и создания пары GAD с конфигурацией сервера с перекрестными путями.
primary_iscsi_targets list / elements=dictionary	Список целей iSCSI на основном устройстве хранения данных. Обязательно для задачи создания пары GAD-ISCSI.
name string / обязательный	Имя цели iSCSI. Обязательно для задачи создания пары GAD-ISCSI.
port_id string / обязательный	Идентификатор порта. Обязательно для задачи создания пары GAD-ISCSI.
primary_nvm_subsystem dictionary	Сведения о подсистеме NVM основного тома.
name string / обязательный	Имя подсистемы NVM в основной системе хранения данных.
paths list / elements=string	Сведения о путях NQN хоста в основной системе хранения данных.
primary_pool_id integer	Идентификатор пула для создания новых основных томов.
primary_resource_group_name string	Имя основной группы ресурсов. Обязательно для задачи создания пары GAD с конфигурацией сервера с перекрестными путями.
primary_volume_base_name string	Базовое имя основных томов при пакетном создании новых томов.
primary_volume_base_name_start_number integer	Начальный номер суффикса базового имени основного тома.
provisioned_secondary_volume_id string	Идентификатор подготовленного вторичного тома для создания пары GAD.
quorum_disk_id integer	Идентификатор диска кворума. Обязательно для задач создания.
remote_device_group_name string	Имя группы устройств в удаленной системе хранения данных. Необязательный параметр для задач Split/Resync/Swap-Split/Swap-Resync.
secondary_hostgroups list / elements=dictionary	Список групп хостов на вторичном устройстве хранения данных. Обязательно для задач создания.
name string / обязательный	Имя группы хостов. Обязательно для задач создания.
port_id string / обязательный	Идентификатор порта. Обязательно для задач создания.
secondary_iscsi_targets list / elements=dictionary	Список целей iSCSI на вторичном устройстве хранения данных. Обязательно для задачи создания пары GAD-ISCSI.
name string / обязательный	Имя цели iSCSI. Обязательно для задачи создания пары GAD-ISCSI.
port_id string / обязательный	Идентификатор порта. Обязательно для задачи создания пары GAD-ISCSI.
secondary_nvm_subsystem dictionary	Сведения о подсистеме NVM вторичного тома.
name string / обязательный	Имя подсистемы NVM во вторичной системе хранения данных.
paths list / elements=string	Сведения о путях NQN хоста во вторичной системе хранения данных.
secondary_pool_id integer	Идентификатор пула вторичной системы хранения данных для создания вторичных томов.
secondary_resource_group_name string	Имя вторичной группы ресурсов.
set_alua_mode boolean	Для конфигурации сервера с перекрестными путями установите для режима ALUA значение True. Варианты: `false` `true`
should_match_volume_ids boolean	Указывает, должны ли идентификаторы основного и вторичного томов совпадать в парах GAD. Значение по умолчанию — false. Варианты: `false` `true`

virtual_storage_serial_number string	Серийный номер виртуальной системы хранения для создания пары GAD.
volume_size string	Размер создаваемых томов (например, ‘10GB’, ‘1TB’).
storage_system_info dictionary	Информация о системе хранения. Это необязательное поле.
serial string	Серийный номер системы хранения.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Определяет, следует ли запускать модуль в режиме проверки.

Примеры

- name: Batch create GAD pairs with host groups
  hitachivantara.vspone_block.vsp.hv_gad_bulk:
    connection_info:
      address: storage1.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      number_of_pairs: 5
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "10GB"
      capacity_saving: "compression"
      primary_volume_base_name: "gad_vol"
      primary_volume_base_name_start_number: 1
      copy_group_name: "batch_gad_cg"
      copy_pair_base_name: "batch_pair"
      quorum_disk_id: 0
      is_new_group_creation: true
      primary_hostgroups:
        - name: "primary_hg_1"
          port_id: "CL1-A"
          enable_preferred_path: true
      secondary_hostgroups:
        - name: "secondary_hg_1"
          port_id: "CL2-A"
          enable_preferred_path: false

- name: Batch create GAD pairs with host groups
  hitachivantara.vspone_block.vsp.hv_gad_bulk:
    connection_info:
      address: storage1.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      number_of_pairs: 5
      should_match_volume_ids: true
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "10GB"
      capacity_saving: "compression"
      primary_volume_base_name: "gad_vol"
      primary_volume_base_name_start_number: 1
      copy_group_name: "batch_gad_cg"
      copy_pair_base_name: "batch_pair"
      quorum_disk_id: 0
      is_new_group_creation: true
      primary_hostgroups:
        - name: "primary_hg_1"
          port_id: "CL1-A"
          enable_preferred_path: true
      secondary_hostgroups:
        - name: "secondary_hg_1"
          port_id: "CL2-A"
          enable_preferred_path: false

- name: Batch create GAD pairs with NVMe subsystems
  hitachivantara.vspone_block.vsp.hv_gad_bulk:
    connection_info:
      address: storage1.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      number_of_pairs: 3
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "20GB"
      copy_group_name: "nvme_gad_cg"
      copy_pair_base_name: "nvme_pair"
      quorum_disk_id: 0
      is_new_group_creation: true
      primary_nvm_subsystem:
        name: "primary-nvme-subsystem"
        paths:
          - "nqn.2014-08.com.example:nvme:primary-host"
      secondary_nvm_subsystem:
        name: "secondary-nvme-subsystem"
        paths:
          - "nqn.2014-08.com.example:nvme:secondary-host"

- name: Batch create GAD pairs with iSCSI targets
  hitachivantara.vspone_block.vsp.hv_gad_bulk:
    connection_info:
      address: storage1.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      number_of_pairs: 4
      primary_pool_id: 0
      secondary_pool_id: 0
      volume_size: "50GB"
      copy_group_name: "iscsi_gad_cg"
      copy_pair_base_name: "iscsi_pair"
      quorum_disk_id: 0
      is_new_group_creation: true
      primary_iscsi_targets:
        - name: "iscsi_hg_primary"
          port_id: "CL3-A"
      secondary_iscsi_targets:
        - name: "iscsi_target_secondary"
          port_id: "CL4-A"
          enable_preferred_path: false

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

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

Ключ	Описание
comments list / elements=string	Список комментариев или предупреждений, полученных в ходе пакетной операции. Возвращается: успех Пример: `[]`
gad_pairs list / elements=dictionary	Список объектов пар GAD, созданных в ходе пакетной операции. Возвращается: успех
consistency_group_id integer	Идентификатор группы согласованности. Возвращается: успех Пример: `-1`
copy_group_name string	Имя группы копирования. Возвращается: успех Пример: `"cp_group_840"`
copy_pace_track_size integer	Устарело. Размер дорожки для скорости копирования. Возвращается: успех Пример: `""`
copy_pair_name string	Имя пары. Возвращается: успех Пример: `"gad_pair_840"`
copy_rate string	Устарело. Скорость копирования. Возвращается: успех Пример: `""`
fence_level string	Уровень ограждения. Возвращается: успех Пример: `"NEVER"`
is_alua_enabled boolean	Указывает, включен ли ALUA. Возвращается: успех Пример: `false`
local_device_group_name string	Имя локальной группы устройств. Возвращается: успех Пример: `"cp_group_840S_"`
mirror_unit_id integer	Устарело. Используйте вместо этого mirror_unit_number. Возвращается: успех Пример: `0`
mirror_unit_number integer	Номер блока зеркалирования. Возвращается: успех Пример: `0`
primary_virtual_serial_number integer	Основной виртуальный серийный номер. Возвращается: успех Пример: `-1`
primary_virtual_volume_id integer	Идентификатор основного виртуального тома. Возвращается: успех Пример: `-1`
primary_volume_id integer	Идентификатор основного тома. Возвращается: успех Пример: `840`
primary_volume_id_hex string	Идентификатор основного тома в шестнадцатеричном формате. Возвращается: успех Пример: `"00:03:48"`
primary_volume_status string	Статус пары GAD. Возвращается: успех Пример: `"PSUE"`
primary_volume_storage_id string	Устарело. Используйте вместо этого primary_volume_storage_serial_number. Возвращается: успех Пример: `"810050"`
primary_volume_storage_serial_number string	Серийный номер системы хранения основного тома. Возвращается: успех Пример: `"810050"`
primary_vsm_resource_group_name string	Имя основной группы ресурсов VSM. Возвращается: успех Пример: `""`
quorum_disk_id integer	Идентификатор диска кворума. Возвращается: успех Пример: `21`
remote_device_group_name string	Имя удаленной группы устройств. Возвращается: успех Пример: `"cp_group_840P_"`
remote_mirror_copy_pair_id string	Устарело. Идентификатор пары копирования удаленного зеркала. Возвращается: успех Пример: `"A34000810050,cp_group_840,cp_group_840S_,cp_group_840P_,gad_pair_840"`
secondary_virtual_serial_number integer	Серийный номер вторичной виртуальной системы хранения. Возвращается: успех Пример: `-1`
secondary_virtual_volume_id integer	Идентификатор вторичного виртуального тома. Возвращается: успех Пример: `-1`
secondary_volume_id integer	Идентификатор вторичного тома. Возвращается: успех Пример: `831`
secondary_volume_id_hex string	Идентификатор вторичного тома в шестнадцатеричном формате. Возвращается: успех Пример: `"00:03:3F"`
secondary_volume_status string	Статус пары GAD. Возвращается: успех Пример: `"PSUE"`
secondary_volume_storage_id string	Устарело. Используйте вместо этого secondary_volume_storage_serial_number. Возвращается: успех Пример: `"810045"`
secondary_volume_storage_serial_number string	Серийный номер системы хранения вторичного тома. Возвращается: успех Пример: `"810045"`
secondary_vsm_resource_group_name string	Имя вторичной группы ресурсов VSM. Возвращается: успех Пример: `""`

Авторы

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_gad_bulk_module.html