netapp.ontap.na_ontap_igroup – Настройка группы iSCSI или FC igroup NetApp ONTAP
Примечание
Этот плагин входит в коллекцию netapp.ontap (версия 21.1.1).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_igroup.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создание/удаление/переименование групп igroup и изменение инициаторов, принадлежащих группе igroup
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Ansible 2.9
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, поскольку он обеспечивает более подробные сообщения об ошибках при проблемах с подключением.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Для включения http в кластере необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| bind_portset string | Имя текущего набора портов для привязки к новосозданной группе igroup. | |
| cert_filepath string добавлен в 20.6.0 of netapp.ontap | Путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| feature_flags dictionary добавлен в 20.5.0 of netapp.ontap | Включение или отключение новой функции. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| force_remove_initiator boolean |
| Принудительное удаление инициатора, даже если к этой группе инициаторов уже назначены LUN. |
| from_name string добавлен в 2.7.0 of netapp.ontap | Имя группы igroup, которую нужно переименовать в name. | |
| hostname string / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port integer | Переопределяет порт по умолчанию (80 или 443) на указанный порт. | |
| https boolean |
| Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требует SSL. |
| initiator_group_type string |
| Тип группы инициаторов. Обязательно, если state=present. |
| initiators list / elements=string | Список инициаторов, которые нужно сопоставить с группой igroup. WWPN, псевдоним WWPN или имя iSCSI инициатора для добавления или удаления. При модификации этот список заменяет существующие инициаторы. Этот модуль не добавляет или не удаляет конкретных инициаторов в группе igroup. псевдонимы: инициатор | |
| key_filepath string добавлен в 20.6.0 of netapp.ontap | Путь к файлу SSL-ключа клиента. | |
| name string / обязательно | Имя группы igroup, которую нужно обработать. | |
| ontapi integer | Версия API ontap для использования | |
| os_type string | Тип ОС инициаторов в группе. псевдонимы: ostype | |
| password string | Пароль для указанного пользователя. псевдонимы: pass | |
| state string |
| Указывает, должно ли существовать указанная группа Igroup или нет. |
| use_rest string | По умолчанию: "auto" | API REST, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае вернется к ZAPI. всегда -- всегда будет использовать API REST никогда -- всегда будет использовать ZAPI авто -- попробует использовать API REST |
| username string | Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется API на уровне кластера или на уровне SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. основная аутентификация, используя имя пользователя и пароль, 2. аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs boolean |
| Если установлено значение no, SSL-сертификаты не будут проверены.Это следует устанавливать только в False на сайтах, контролируемых лично, использующих самозаверяющие сертификаты. |
| vserver string / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create iSCSI Igroup
na_ontap_igroup:
state: present
name: ansibleIgroup3
initiator_group_type: iscsi
os_type: linux
initiators: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com,abc.com:redhat.com
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create FC Igroup
na_ontap_igroup:
state: present
name: ansibleIgroup4
initiator_group_type: fcp
os_type: linux
initiators: 20:00:00:50:56:9f:19:82
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: rename Igroup
na_ontap_igroup:
state: present
from_name: ansibleIgroup3
name: testexamplenewname
initiator_group_type: iscsi
os_type: linux
initiators: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify Igroup Initiators (replaces exisiting initiators)
na_ontap_igroup:
state: present
name: ansibleIgroup3
initiator_group_type: iscsi
os_type: linux
initiator: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete Igroup
na_ontap_igroup:
state: absent
name: ansibleIgroup3
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_igroup_module.html