netapp_e_iscsi_interface – Модуль управления настройками интерфейса iSCSI NetApp E-Series
Новый в версии 2.7.
Обзор
- Настройка параметров интерфейса iSCSI E-Series
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address - | IPv4-адрес, который необходимо назначить интерфейсу. Должен быть указан в формате xx.xx.xx.xx. Взаимоисключительно с config_method=dhcp
| |
| api_password строка / обязательно | Пароль для аутентификации с прокси-сервером SANtricity Web Services или встроенным API веб-служб. | |
| api_url строка / обязательно | URL-адрес прокси-сервера SANtricity Web Services или встроенного API веб-служб. Пример: https://prod-1.wahoo.acme.com/devmgr/v2 | |
| api_username строка / обязательно | Имя пользователя для аутентификации с прокси-сервером SANtricity 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, чтобы включить гигантские кадры (любое значение > 1500). Как правило, необходимо, чтобы ваш хост, коммутаторы и другие компоненты не только поддерживали гигантские кадры, но и правильно их настраивали. Поэтому, если вы не знаете, что делаете, лучше оставить это значение по умолчанию. псевдонимы: 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 веб-служб ≥ 1.3.
- Модули Ansible для E-Series требуют либо наличие прокси-сервера Web Services Proxy (WSP) для управления системой хранения, либо E-Series систему хранения, которая поддерживает встроенный API веб-служб.
- Встроенные веб-службы в настоящее время доступны на оборудовании E2800, E5700, EF570 и более новых моделях.
- 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 строка | при успехе | Сообщение об успехе Пример: Настройки интерфейса были обновлены. |
Статус
- Не гарантируется обратная совместимость интерфейса этого модуля. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Майкл Прайс (@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.9/modules/netapp_e_iscsi_interface_module.html