Spec-Zone.ru › Ansible

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

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

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

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

  • Модуль hv_iscsi_target предоставляет следующие операции по управлению целями iSCSI
    1. Создание цели iSCSI
    1. Обновление режима хоста и параметров режима хоста
    1. Добавление инициатора IQN в цель iSCSI
    1. Добавление LDEV в цель iSCSI
    1. Удаление инициатора IQN из цели iSCSI
    1. Удаление LDEV из цели iSCSI
    1. Удаление цели iSCSI
    1. Добавление пользователя CHAP в цель iSCSI
    1. Удаление пользователя CHAP из цели iSCSI
  • Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/iscsi_target_bulk.yml

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

dictionary / обязательно

Информация, необходимая для установления соединения с системой хранения данных.

address

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

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

api_token

string

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

connection_type

string

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

Варианты:

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

password

string

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

username

string

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

spec

dictionary / обязательно

Спецификация операции с целью iSCSI.

chap_users

list / elements=dictionary

Список пользователей CHAP, которых нужно добавить или удалить.

host_mode

string

Режим хоста группы хостов. Обязателен для задачи обновления режима хоста и параметров режима хоста цели iSCSI.

Варианты:

  • "LINUX"
  • "VMWARE"
  • "HP"
  • "OPEN_VMS"
  • "TRU64"
  • "SOLARIS"
  • "NETWARE"
  • "WINDOWS"
  • "HI_UX"
  • "AIX"
  • "VMWARE_EXTENSION"
  • "WINDOWS_EXTENSION"
  • "UVM"
  • "HP_XP"
  • "DYNIX"

host_mode_options

list / elements=integer

Список номеров параметров режима хоста группы хостов.

Обязателен для задачи обновления режима хоста и параметров режима хоста цели iSCSI.

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

id

integer

Идентификатор цели iSCSI. Если он не указан, для идентификации цели iSCSI необходимо указать имя.

iqn_initiators

list / elements=dictionary

Список инициаторов IQN, которых нужно добавить или удалить.

iqn

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

IQN инициатора.

nickname

string

Псевдоним инициатора.

lun_paths

list / elements=dictionary

Список путей LUN, которые нужно добавить или удалить. Каждый путь LUN содержит номер LUN и идентификатор LDEV.

ldev

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

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

lun

integer

Номер LUN.

name

string

Имя цели iSCSI. Если оно не указано, для идентификации цели iSCSI необходимо указать идентификатор.

port_ids

list / elements=string / обязательно

Идентификаторы портов целей iSCSI.

should_delete_all_volumes

псевдонимы: should_delete_all_ldevs

boolean

Если значение равно true, уничтожает логические устройства, которые больше не подключены ни к одной цели iSCSI.

Варианты:

  • false
  • true

should_release_host_reserve

boolean

Если значение равно true, освобождает резерв хоста.

Варианты:

  • false
  • true

state

string

Для создания и обновления цели iSCSI задайте значение state present.

Для удаления цели iSCSI задайте значение state absent.

Варианты:

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

storage_system_info

dictionary

Информация о системе хранения данных. Это поле является необязательным.

serial

string

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

Примеры

- name: Create multiple iSCSI targets
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: present
    spec:
      name: 'rd-server-1234'
      port_ids: ['CL1-C', 'CL2-C']
      host_mode: "LINUX"
      host_mode_options: [54, 63]
      iqn_initiators:
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254a
          nickname: "nickname_1"
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254b
          nickname: "nickname_2"
      lun_paths:
            - lun: 5
              ldev: 5150
            - lun: 6
              ldev: 5153
      chap_users:
        - chap_user_name: user1
          chap_secret: Secret123456

- name: Update iscsi target host mode and options
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: updated
    spec:
      name: 'iscsi-target-server-1'
      port_ids: ['CL1-C', 'CL2-C']
      host_mode: "LINUX"
      host_mode_options: [54, 63, 94]
      should_release_host_reserve: true

- name: Add iqn initiators, LUN paths and CHAP users to multiple iscsi targets
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: added
    spec:
      name: 'rd-server-0324'
      port_ids: ['CL1-C', 'CL2-C']
      iqn_initiators:
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254a
          nickname: "nickname_1"
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254b
          nickname: "nickname_2"
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254c
          nickname: "nickname_3"
      lun_paths:
            - lun: 5
              ldev: 5150
            - lun: 6
              ldev: 5153
            - lun: 7
              ldev: 5154
      chap_users:
        - chap_user_name: user1
          chap_secret: Secret123456
        - chap_user_name: user2
          chap_secret: Secret123456
        - chap_user_name: user3
          chap_secret: Secret123456
  register: result

- name: Remove chap user from iscsi target
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: present
    spec:
      state: remove_chap_user
      name: 'iscsi-target-server-1'
      port: 'CL4-C'
      chap_users:
        - chap_user_name: user2
          chap_secret: Secret2

- name: Add iqn initiators to iscsi target
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: present
    spec:
      state: add_iscsi_initiator
      name: 'iscsi-target-server-1'
      port: 'CL4-C'
      iqn_initiators:
        - iqn: iqn.1993-08.org.debian.iscsi:01:107dc7e4254b

- name: Release host reserve status of a iscsi target using lun
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: present
    spec:
      id: 20
      should_release_host_reserve: true
      port: 'CL4-C'
      lun: 100

- name: Release host reserve status of a iscsi targets
  hitachivantara.vspone_block.vsp.hv_iscsi_target_bulk:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: present
    spec:
      iscsi_id: 20
      port: 'CL4-C'
      should_release_host_reserve: true

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

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

Ключ

Описание

iscsi_target

dictionary

Сведения о цели iSCSI.

Возвращается: всегда

auth_param

dictionary

Параметры аутентификации.

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

authentication_mode

string

Режим аутентификации.

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

Пример: "BOTH"

is_chap_enabled

boolean

Указывает, включен ли CHAP.

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

Пример: true

is_chap_required

boolean

Указывает, требуется ли CHAP.

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

Пример: false

is_mutual_auth

boolean

Указывает, включена ли взаимная аутентификация.

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

Пример: false

chap_users

list / elements=string

Список пользователей CHAP.

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

Пример: []

host_mode

dictionary

Сведения о режиме хоста.

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

host_mode

string

Режим хоста.

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

Пример: "LINUX"

host_mode_options

list / elements=dictionary

Список параметров режима хоста.

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

Пример: []

iqn

string

IQN цели iSCSI.

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

Пример: "iqn.1994-04.jp.co.hitachi:rsd.has.t.10050.4c0ee"

iqn_initiators

list / elements=dictionary

Список инициаторов IQN.

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

iqn

string

IQN инициатора.

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

Пример: "iqn.1993-08.org.debian.iscsi:01:107dc7e4254a"

nick_name

string

Псевдоним инициатора.

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

Пример: "iscsi-target-1"

iscsi_id

integer

Идентификатор цели iSCSI.

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

Пример: 238

iscsi_name

string

Имя цели iSCSI.

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

Пример: "isserver21"

logical_units

list / elements=dictionary

Список логических устройств.

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

Пример: []

port_id

string

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

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

Пример: "CL4-C"

resource_group_id

integer

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

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

Пример: 0

Авторы

  • 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_iscsi_target_bulk_module.html

Spec-Zone.ru

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