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 или встроенным API веб-служб. | |
| api_url - / обязательно | URL SANtricity Web Services Proxy или встроенного API веб-служб. | |
| api_username - / обязательно | Имя пользователя для аутентификации с SANtricity Web Services Proxy или встроенным 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 - / обязательно | Идентификатор массива, который требуется управлять. Это значение должно быть уникальным для каждого массива. | |
| state - |
| При включенном состоянии будет использоваться предоставленная конфигурация. При отключенном состоянии конфигурация IPv4 будет очищена, и IPv4-соединение будет отключено. |
| subnet_mask - | Маска подсети для использования с интерфейсом. Должен быть указан в формате xx.xx.xx.xx. Взаимоисключающий с config_method=dhcp
| |
| validate_certs boolean |
| Подтверждать сертификаты 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 boolean | при успехе | Указывает, включено или отключено IPv4-соединение. Это не обязательно означает наличие соединения. Например, если dhcp был включен без сервера dhcp, то конфигурация вряд ли будет действительной. Пример: True |
| msg строка | при успехе | Сообщение об успехе Пример: Настройки интерфейса обновлены. |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.7/modules/netapp_e_iscsi_interface_module.html