netapp_eseries.santricity.netapp_e_iscsi_interface – NetApp E-Series управление конфигурацией интерфейса iSCSI
Примечание
Этот плагин входит в коллекцию netapp_eseries.santricity (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install netapp_eseries.santricity.
Для использования в книге задач укажите: netapp_eseries.santricity.netapp_e_iscsi_interface.
Новое в версии 2.7: of netapp_eseries.santricity
Обзор
- Настройка параметров интерфейса iSCSI E-Series
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address строка | IPv4-адрес, который необходимо назначить интерфейсу. Должен быть указан в формате xx.xx.xx.xx. Взаимоисключительно с config_method=dhcp
| |
| api_password строка / обязательно | Пароль для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API. | |
| api_url строка / обязательно | URL SANtricity Web Services Proxy или Embedded Web Services API. Пример: https://prod-1.wahoo.acme.com/devmgr/v2 | |
| api_username строка / обязательно | Имя пользователя для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API. | |
| config_method строка |
| Тип метода конфигурации для этого интерфейса. dhcp взаимоисключительно с address, subnet_mask и gateway. |
| controller строка / обязательно |
| Контроллер, владеющий портом, который вы хотите настроить. Имена контроллеров представлены в алфавитном порядке, первый контроллер — A, второй — B и т.д. В текущих моделях оборудования доступны 1 или 2 контроллера, но это не гарантированное ограничение и может измениться в будущем. |
| gateway строка | Адрес шлюза IPv4 для использования по интерфейсу. Должен быть указан в формате xx.xx.xx.xx. Взаимоисключительно с config_method=dhcp
| |
| log_path строка | Локальный путь к файлу для отладки логирования. | |
| mtu целое число | Значение по умолчанию: 1500 | Максимальные единицы передачи (MTU) в байтах. Это позволяет настроить большее значение MTU для включения Jumbo-кадров (любое значение > 1500). Обычно необходимо, чтобы ваш хост, коммутаторы и другие компоненты не только поддерживали Jumbo-кадры, но и были должным образом настроены. Поэтому, если вы не уверены, лучше оставить это значение по умолчанию. алиасы: max_frame_size |
| name целое число / обязательно | Канал порта, для которого необходимо изменить конфигурацию. Список вариантов не обязательно полный. Он зависит от количества портов в системе. Числовое значение представляет номер канала (обычно слева направо на HIC), начиная с 1. алиасы: channel | |
| ssid строка | Значение по умолчанию: 1 | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. |
| state строка |
| При включенном состоянии будет использоваться предоставленная конфигурация. При выключенном состоянии конфигурация IPv4 будет очищена, и IPv4-соединение отключено. |
| subnet_mask строка | Маска подсети для использования по интерфейсу. Должен быть указан в формате xx.xx.xx.xx. Взаимоисключительно с config_method=dhcp
| |
| validate_certs булево |
| Нужно ли проверять сертификаты https? |
Примечания
Примечание
- Поддерживается режим проверки.
- Настройки интерфейса применяются синхронно, но изменения самого интерфейса (получение нового IP-адреса через DHCP и т. п.) могут потребовать несколько секунд или минут, чтобы вступили в силу.
- Этот модуль не будет полезен/работать на системе E-Series без каких-либо интерфейсов iSCSI.
- Этот модуль требует версию API Web Services >= 1.3.
- Модули Ansible для E-Series требуют либо экземпляр Web Services Proxy (WSP) для управления системой хранения, либо систему хранения E-Series, поддерживающую встроенный API Web Services.
- Встроенный API Web Services в настоящее время доступен на моделях E2800, E5700, EF570 и более новых моделях оборудования.
- netapp_eseries.santricity.netapp_e_storage_system может использоваться для настройки систем, управляемых экземпляром WSP.
Примеры
- name: Configure the first port on the A controller with a static IPv4 address
netapp_e_iscsi_interface:
name: "1"
controller: "A"
config_method: static
address: "192.168.1.100"
subnet_mask: "255.255.255.0"
gateway: "192.168.1.1"
ssid: "1"
api_url: "10.1.1.1:8443"
api_username: "admin"
api_password: "myPass"
- name: Disable ipv4 connectivity for the second port on the B controller
netapp_e_iscsi_interface:
name: "2"
controller: "B"
state: disabled
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
- name: Enable jumbo frames for the first 4 ports on controller A
netapp_e_iscsi_interface:
name: "{{ item | int }}"
controller: "A"
state: enabled
mtu: 9000
config_method: dhcp
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
loop:
- 1
- 2
- 3
- 4
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| enabled булево | при успехе | Указывает, было ли включено или отключено IPv4-соединение. Это не обязательно указывает на подключение. Если dhcp был включен без DHCP-сервера, например, маловероятно, что конфигурация будет действительной. Пример: True |
| msg строка | при успехе | Сообщение об успехе Пример: Настройки интерфейса обновлены. |
Авторы
- Michael Price (@lmprice)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp_eseries/santricity/netapp_e_iscsi_interface_module.html