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 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 boolean |
| Необходимо ли проверять сертификаты https? |
Примечания
Примечание
- Поддерживается режим проверки.
- Параметры интерфейса применяются синхронно, но изменения самого интерфейса (получение нового IP-адреса через dhcp и т. п.) могут занять несколько секунд или минут, прежде чем вступят в силу.
- Этот модуль не будет полезен/используем на системе E-Series без каких-либо интерфейсов iSCSI.
- Этот модуль требует версию Web Services API >= 1.3.
- Модули Ansible для E-Series требуют либо экземпляр Web Services Proxy (WSP), доступный для управления хранилищем, либо систему хранения E-Series, поддерживающую Embedded Web Services API.
- Embedded Web Services в настоящее время доступен на моделях оборудования 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 boolean | при успехе | Указывает, включено или выключено IPv4-соединение. Это не обязательно указывает на подключение. Если dhcp был включен без dhcp-сервера, например, маловероятно, что конфигурация будет фактически действительной. Пример: True |
| msg string | при успехе | Сообщение об успехе Пример: Настройки интерфейса были обновлены. |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/netapp_e_iscsi_interface_module.html
