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

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

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

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

Этот модуль позволяет выполнять операции пакетного управления группами хостов с поддержкой многопоточности и параллельной обработкой на нескольких портах.
Операции с несколькими портами выполняются одновременно с использованием пула потоков (до 10 потоков одновременно) для повышения производительности.
Поддерживаются следующие операции:
1. параллельное создание группы хостов на нескольких портах.
1. параллельное удаление группы хостов с нескольких портов.
1. добавление логического устройства в группу хостов на нескольких портах.
1. удаление логического устройства из группы хостов на нескольких портах.
1. добавление WWN хоста в группу хостов на нескольких портах.
1. удаление WWN хоста из группы хостов на нескольких портах.
1. установка режима хоста на нескольких портах.
1. добавление параметра режима хоста в группу хостов на нескольких портах.
1. удаление параметра режима хоста из группы хостов на нескольких портах.
Потокобезопасное объединение результатов обеспечивает точную отчётность об изменениях, комментариях и ошибках всех параллельных операций. https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/hostgroup_bulk.yml

Требования

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

python >= 3.9

Параметры

Параметр	Описание
connection_info словарь / обязательный	Информация, необходимая для установки соединения с системой хранения данных.
address строка / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип подключения к системе хранения данных. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
spec словарь	Спецификация операции с группой хостов.
asymmetric_access_priority строка	Уровень приоритета асимметричного доступа для группы хостов ALUA. Обязателен для задачи настройки уровня приоритета асимметричного доступа для группы хостов ALUA. Варианты: `"low"` `"high"`
host_group_number целое число	Номер группы хостов. Обязателен для задач настройки уровня приоритета асимметричного доступа для группы хостов ALUA / освобождения состояния резервирования хоста с указанием группы хостов / освобождения состояния резервирования хоста с указанием пути LU.
host_mode строка	Режим хоста для группы хостов. Необязателен для задачи создания группы хостов. Обязателен для задачи обновления режима хоста и его параметров. Варианты: `"LINUX"` `"VMWARE"` `"HP"` `"OPEN_VMS"` `"TRU64"` `"SOLARIS"` `"NETWARE"` `"WINDOWS"` `"HI_UX"` `"AIX"` `"VMWARE_EXTENSION"` `"WINDOWS_EXTENSION"` `"UVM"` `"HP_XP"` `"DYNIX"`
host_mode_options список / элементы=целое число	Список номеров параметров режима хоста для группы хостов. Необязателен для задачи создания группы хостов. Обязателен для задачи обновления режима хоста и его параметров. 0 # RESERVED 2 # VERITAS_DB_EDITION_ADV_CLUSTER 6 # TPRLO 7 # AUTO_LUN_RECOGNITION 12 # NO_DISPLAY_FOR_GHOST_LUN 13 # SIM_REPORT_AT_LINK_FAILURE 14 # HP_TRUECLUSTER_WITH_TRUECOPY 15 # RAID_HACMP 22 # VERITAS_CLUSTER_SERVER 23 # REC_COMMAND_SUPPORT 25 # SUPPORT_SPC_3_PERSISTENT_RESERVATION 33 # SET_REPORT_DEVICE_ID_ENABLE 39 # CHANGE_NEXUS_SPECIFIED_IN_SCSI_TARGET_RESET 40 # VVOL_EXPANSION 41 # PRIORITIZED_DEVICE_RECOGNITION 42 # PREVENT_OHUB_PCI_RETRY 43 # QUEUE_FULL_RESPONSE 48 # HAM_SVOL_READ 49 # BB_CREDIT_SETUP_1 50 # BB_CREDIT_SETUP_2 51 # ROUND_TRIP_SETUP 52 # HAM_AND_CLUSTER_SW_FOR_SCSI_2 54 # EXTENDED_COPY 57 # HAM_RESPONSE_CHANGE 60 # LUN0_CHANGE_GUARD 61 # EXPANDED_PERSISTENT_RESERVE_KEY 63 # VSTORAGE_APIS_ON_T10_STANDARDS 65 # ROUND_TRIP_EXTENDED_SETUP 67 # CHANGE_OF_ED_TOV_VALUE 68 # PAGE_RECLAMATION_LINUX 69 # ONLINE_LUSE_EXPANSION 71 # CHANGE_UNIT_ATTENTION_FOR_BLOCKED_POOL_VOLS 72 # AIX_GPFS 73 # WS2012 78 # NON_PREFERRED_PATH 91 # DISABLE_IO_WAIT_FOR_OPEN_STACK 95 # CHANGE_SCSI_LU_RESET_NEXUS_VSP_HUS_VM 96 # CHANGE_SCSI_LU_RESET_NEXUS 97 # PROPRIETARY_ANCHOR_COMMAND_SUPPORT 100 # HITACHI_HBA_EMULATION_CONNECTION_OPTION 102 # GAD_STANDARD_INQURY_EXPANSION_HCS 105 # TASK_SET_FULL_RESPONSE_FOR_IO_OVERLOAD 110 # ODX Support for WS2012 113 # iSCSI CHAP Authentication Log 114 # Auto Asynchronous Reclamation on ESXi 6.5+ 122 # TASK_SET_FULL_RESPONSE_AFTER_QOS_UPPER_LIMIT 124 # GUARANTEED_RESPONSE_DURING_CONTROLLER_FAILURE 131 # WCE_BIT_OFF_MODE
lun_paths список / элементы=словарь	Список записей путей LUN для изменения. Каждая запись описывает сопоставление LDEV и метаданные пути.
ldev строка / обязательный	Идентификатор логического устройства.
lun строка	Номер LUN.
name строка	Имя группы хостов. Если оно не указано, будет создано имя с префиксом «smrha-» и случайным 10-значным числом в конце, например «smrha-0806262996».
port_ids псевдонимы: ports список / элементы=строка	Список идентификаторов портов, связанных с группой хостов.
should_delete_all_volumes логическое значение	Если значение равно true, уничтожить логические устройства, которые больше не подключены ни к одной группе хостов или цели iSCSI. Варианты: `false` `true`
wwns список / элементы=словарь	Список WWN хостов для добавления или удаления. Обязателен для задач создания группы хостов / добавления WWN в группу хостов / удаления WWN из группы хостов.
nickname псевдонимы: nick_name строка	Псевдоним хоста. Необязателен для задач создания группы хостов / добавления WWN в группу хостов / удаления WWN из группы хостов. Обязателен для задачи изменения или сброса псевдонима WWN.
wwn строка / обязательный	WWN хоста. Обязателен для задач создания группы хостов / добавления WWN в группу хостов / удаления WWN из группы хостов / изменения или сброса псевдонима WWN.
state строка	Для создания и обновления группы хостов задайте состояние `present` Для удаления группы хостов задайте состояние `absent` Варианты: `"present"` ← (по умолчанию) `"absent"` `"added"` `"removed"` `"updated"`
storage_system_info словарь	Информация о системе хранения данных. Это необязательное поле.
serial строка	Серийный номер системы хранения данных.

Атрибуты

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

Примеры

- name: Create host group on multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'bulk_hg_test'
      port_ids: ['CL1-A', 'CL1-B', 'CL2-A', 'CL2-B']
      host_mode: 'VMWARE_EXTENSION'
      host_mode_options: [40, 63]
      wwns:
        - wwn: '100000109B583B2D'
          nickname: 'server1_hba1'
        - wwn: '100000109B583B2C'
          nickname: 'server1_hba2'
      lun_paths:
        - ldev: '1024'
          lun: '0'
        - ldev: '1025'
          lun: '1'

- name: Delete host group from multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: absent
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'bulk_hg_test'
      port_ids: ['CL1-A', 'CL1-B', 'CL2-A', 'CL2-B']
      should_delete_all_volumes: true

- name: Add WWNs to host groups across multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: added
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'existing_hg'
      port_ids: ['CL1-A', 'CL1-B', 'CL2-A']
      wwns:
        - wwn: '200000109B3C0FD3'
          nickname: 'new_server_hba1'
        - wwn: '200000109B3C0FD4'
          nickname: 'new_server_hba2'

- name: Remove WWNs from host groups across multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: removed
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'existing_hg'
      port_ids: ['CL1-A', 'CL1-B', 'CL2-A']
      wwns:
        - wwn: '200000109B3C0FD3'
        - wwn: '200000109B3C0FD4'

- name: Update host mode on multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: updated
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'existing_hg'
      port_ids: ['CL1-A', 'CL1-B', 'CL2-A', 'CL2-B']
      host_mode: 'LINUX'
      host_mode_options: [54, 63, 68]

- name: Add LUN paths to host groups across multiple ports in parallel
  hitachivantara.vspone_block.vsp.hv_hg_bulk:
    state: added
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'existing_hg'
      port_ids: ['CL1-A', 'CL1-B']
      lun_paths:
        - ldev: '2048'
          lun: '10'
        - ldev: '2049'
          lun: '11'

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

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

Ключ	Описание
host_groups list / elements=dictionary	Подробная информация о группе хостов в системе хранения данных. Возвращается: всегда
host_group_id integer	Идентификатор группы хостов (внутренний идентификатор, используемый системой хранения данных). Возвращается: при успехе Пример: `33`
host_group_name string	Удобочитаемое имя группы хостов. Возвращается: при успехе Пример: `"AutoAnsibleHurPri01"`
host_mode string	Настроенный режим хоста для группы хостов (тип ОС или специальный режим). Возвращается: при успехе Пример: `"LINUX"`
host_mode_options list / elements=integer	Список идентификаторов параметров режима хоста, заданных для группы хостов в данный момент. Возвращается: при успехе Пример: `[]`
lun_paths list / elements=dictionary	Список записей путей LUN, связанных с этой группой хостов. Каждая запись описывает сопоставление LDEV и метаданные пути. Возвращается: при успехе
asymmetric_access_state string	Состояние асимметричного доступа для пути (для устройств с поддержкой ALUA). Возвращается: при успехе Пример: `"Active/Optimized"`
host_group_number integer	Числовой идентификатор группы хостов, отображаемый через путь. Возвращается: при успехе Пример: `33`
host_mode string	Строка режима хоста, указанная для пути (может содержать дополнительные уточнения). Возвращается: при успехе Пример: `"LINUX/IRIX"`
host_mode_options list / elements=integer	Идентификаторы параметров режима хоста, указанные для пути. Возвращается: при успехе Пример: `[]`
is_alua_enabled boolean	Включена ли ALUA для этого пути. Возвращается: при успехе Пример: `false`
is_command_device boolean	Помечен ли LDEV как командное устройство. Возвращается: при успехе Пример: `false`
ldev_id integer	Идентификатор логического устройства (десятичное число). Возвращается: при успехе Пример: `3694`
ldev_id_hex string	Идентификатор логического устройства в шестнадцатеричном формате (разделён двоеточиями). Возвращается: при успехе Пример: `"00:0E:6E"`
lu_host_reserve dictionary	Информация о резервировании хоста для пути LU, представленная в виде логических значений для типов резервирования и ключей. Возвращается: при успехе
aca_reserve boolean	Установлено ли резервирование ACA (Auto Contingent Allegiance). Возвращается: при успехе Пример: `false`
mainframe boolean	Установлено ли резервирование в стиле мейнфрейма. Возвращается: при успехе Пример: `false`
open_system boolean	Установлено ли резервирование для открытой системы (на основе стандартного SCSI). Возвращается: при успехе Пример: `false`
persistent boolean	Активно ли постоянное резервирование. Возвращается: при успехе Пример: `false`
pgr_key boolean	Наличие ключа постоянного группового резервирования. Возвращается: при успехе Пример: `false`
lun integer	Номер LUN, назначенный этому пути. Возвращается: при успехе Пример: `17`
lun_id string	Строковый идентификатор пути LU, обычно объединяющий порт, номер группы хостов и LUN. Возвращается: при успехе Пример: `"CL4-B,33,17"`
port_id string	Идентификатор порта, связанного с этой записью пути. Возвращается: при успехе Пример: `"CL4-B"`
port_id string	Порт по умолчанию или запрошенный порт, связанный с операциями над группой хостов (например, CLx-A). Возвращается: при успехе Пример: `"CL4-B"`
resource_group_id integer	Идентификатор группы ресурсов, связанной с группой хостов (если применимо). Возвращается: при успехе Пример: `0`
wwns list / elements=dictionary	Список записей WWN (идентификаторов HBA хоста), принадлежащих группе хостов. Возвращается: при успехе Пример: `[]`
nick_name string	Устарело. Используйте `nickname`. Возвращается: при успехе Пример: `"app-server-1"`
nickname string	Необязательный удобочитаемый псевдоним, назначенный WWN. Возвращается: при успехе Пример: `"app-server-1"`
wwn string	Строка World Wide Name для HBA хоста. Возвращается: при успехе Пример: `"100000109B583B2D"`

Авторы

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