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

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

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

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

Этот модуль предоставляет следующие операции управления группами хостов
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.yml

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для установления соединения с системой хранения данных.
address string / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token string	Токен для выполнения операций с заблокированными ресурсами.
connection_type string	Тип соединения с системой хранения данных. Варианты: `"direct"` ← (по умолчанию)
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary	Спецификация операции с группой хостов.
asymmetric_access_priority string	Уровень приоритета асимметричного доступа для группы хостов ALUA. Обязателен для задачи настройки уровня приоритета асимметричного доступа для группы хостов ALUA. Варианты: `"low"` `"high"`
host_group_number integer	Номер группы хостов. Обязателен для задач настройки уровня приоритета асимметричного доступа для группы хостов ALUA, освобождения состояния резервации хоста с указанием группы хостов и освобождения состояния резервации хоста с указанием пути LU.
host_mode string	Режим хоста для группы хостов. Необязателен для задачи создания группы хостов. Обязателен для задачи обновления режима хоста и параметров режима хоста. Варианты: `"LINUX"` `"VMWARE"` `"HP"` `"OPEN_VMS"` `"TRU64"` `"SOLARIS"` `"NETWARE"` `"WINDOWS"` `"HI_UX"` `"AIX"` `"VMWARE_EXTENSION"` `"WINDOWS_EXTENSION"` `"UVM"` `"HP_XP"` `"DYNIX"`
host_mode_options list / элементы=integer	Список номеров параметров режима хоста для группы хостов. Необязателен для задачи создания группы хостов. Обязателен для задачи обновления режима хоста и параметров режима хоста. 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
ldevs list / элементы=string	LDEV, которые необходимо сопоставить с группой хостов или удалить из сопоставления. Поддерживаются десятичный и шестнадцатеричный форматы. Необязателен для задачи создания группы хостов. Обязателен для задач представления/отмены представления LDEV.
lun integer	Идентификатор LUN для освобождения состояния резервации хоста логического устройства, сопоставленного с указанным путем LU. Обязателен для задачи освобождения состояния резервации хоста с указанием пути LU.
lun_paths list / элементы=dictionary	Список записей путей LUN для изменения. Каждая запись описывает сопоставление LDEV и метаданные пути.
ldev string / обязательный	Идентификатор логического устройства.
lun string	Номер LUN.
name string	Имя группы хостов. Если оно не указано, будет создано имя с префиксом «smrha-» и добавленным в конце случайным 10-значным числом, например «smrha-0806262996». Необязательно для задачи создания группы хостов. Обязательно для задач обновления режима хоста и параметров режима хоста, добавления WWN в группу хостов, удаления WWN из группы хостов, представления/отмены представления LDEV, удаления и изменения или сброса псевдонима WWN.
port_id псевдонимы: port string	Идентификатор FC-порта. Обязателен для задач создания группы хостов, обновления режима хоста и параметров режима хоста, добавления WWN в группу хостов, удаления WWN из группы хостов, представления/отмены представления LDEV, удаления, изменения или сброса псевдонима WWN, настройки уровня приоритета асимметричного доступа для группы хостов ALUA, освобождения состояния резервации хоста с указанием группы хостов и освобождения состояния резервации хоста с указанием пути LU.
port_ids псевдонимы: ports list / элементы=string	Список идентификаторов портов, связанных с группой хостов.
should_delete_all_volumes псевдонимы: should_delete_all_ldevs boolean	Если значение равно true, при удалении группы хостов будут удалены все сопоставленные с ней тома. Необязателен для задачи удаления группы хостов. Значение по умолчанию — false. Варианты: `false` `true`
should_release_host_reserve boolean	Если значение равно true, освободить резерв хоста. Обязателен для задач освобождения состояния резервации хоста с указанием группы хостов и освобождения состояния резервации хоста с указанием пути LU. Варианты: `false` `true`
state string	Операция подзадачи. Варианты: `"present_ldev"` `"unpresent_ldev"` `"add_wwn"` `"remove_wwn"` `"set_host_mode_and_hmo"` `"present"` ← (по умолчанию)
wwns list / элементы=dictionary	Список WWN хостов для добавления или удаления. Обязателен для задач создания группы хостов, добавления WWN в группу хостов и удаления WWN из группы хостов.
nickname псевдонимы: nick_name string	Псевдоним хоста. Необязателен для задач создания группы хостов, добавления WWN в группу хостов и удаления WWN из группы хостов. Обязателен для задачи изменения или сброса псевдонима WWN.
wwn string / обязательный	WWN хоста. Обязателен для задач создания группы хостов, добавления WWN в группу хостов, удаления WWN из группы хостов и изменения или сброса псевдонима WWN.
state string	Для создания и обновления группы хостов задайте значение `present` Для удаления группы хостов задайте значение `absent` Варианты: `"present"` ← (по умолчанию) `"absent"`
storage_system_info dictionary	Сведения о системе хранения данных. Это необязательное поле.
serial string	Серийный номер системы хранения данных.

Атрибуты

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

Примечания

Примечание

Выходные параметры entitlement_status, subscriber_id и partner_id удалены в версии 3.4.0. Они также объявлены устаревшими из-за упрощения внутреннего API и больше не поддерживаются.
Тип соединения gateway удален начиная с версии 3.4.0. Если вам требуется этот тип соединения, используйте более раннюю версию.

Примеры

- name: Create host group with LDEVs and WWNs
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'testhg26dec'
      port_id: 'CL1-A'
      host_mode: 'VMWARE_EXTENSION'
      host_mode_options: [40]
      wwns:
        - wwn: '100000109B583B2D'
          nickname: 'test1'
        - wwn: '100000109B583B2C'
          nickname: 'test2'
      ldevs: [393, 851]

- name: Delete host group
  hitachivantara.vspone_block.vsp.hv_hg:
    state: absent
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      name: 'testhg26dec'
      port_id: 'CL1-A'

- name: Present LDEVs to hostgroup
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      state: present_ldev
      name: 'testhg26dec'
      port_id: 'CL1-A'
      ldevs: [300, 400]

- name: Unpresent LDEVs from hostgroup
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      state: unpresent_ldev
      name: 'testhg26dec'
      port_id: 'CL1-A'
      ldevs: [800, 801]

- name: Add WWNs to hostgroup
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      state: add_wwn
      name: 'testhg26dec'
      port_id: 'CL1-A'
      wwns:
        - wwn: '200000109B3C0FD3'
          nickname: 'test1'
        - wwn: '200000109B3C0FD4'
        - wwn: '200000109B3C0FD5'

- name: Remove WWNs from hostgroup
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      state: remove_wwn
      name: 'testhg26dec'
      port_id: 'CL1-A'
      wwns:
        - wwn: '200000109B3C0FD3'

- name: Update host group
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      state: set_host_mode_and_hmo
      name: 'testhg26dec'
      port_id: 'CL1-A'
      host_mode: 'VMWARE_EXTENSION'
      host_mode_options: [54, 63]

- name: Asymmetric access priority level for ALUA host group.
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      host_group_number: 208
      port_id: 'CL1-A'
      asymmetric_access_priority: 'high'

- name: Release the host reservation status by specifying the LU path.
  hitachivantara.vspone_block.vsp.hv_hg:
    state: present
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      host_group_number: 150
      port_id: 'CL1-A'
      should_release_host_reserve: true
      lun: 0

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

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

Ключ	Описание
host_group 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_module.html