модуль netapp_eseries.santricity.na_santricity_iscsi_interface — управление конфигурацией интерфейса iSCSI NetApp E-Series
Примечание
Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install netapp_eseries.santricity.
Чтобы использовать её в плейбуке, укажите: netapp_eseries.santricity.na_santricity_iscsi_interface.
Краткое описание
- Настройка параметров интерфейса iSCSI E-Series
Параметры
Параметр | Комментарии |
|---|---|
address string | IPv4-адрес, который будет назначен интерфейсу. Следует указывать в формате xx.xx.xx.xx. Несовместим с config_method=dhcp |
api_password string / обязательный | Пароль для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API. |
api_url string / обязательный | URL-адрес SANtricity Web Services Proxy или Embedded Web Services API. |
api_username string / обязательный | Имя пользователя для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API. |
config_method string | Тип метода настройки, используемый для этого интерфейса. dhcp несовместим с address, subnet_mask и gateway. Варианты:
|
controller string / обязательный | Контроллер, которому принадлежит настраиваемый порт. Имена контроллеров отображаются в алфавитном порядке: первый контроллер — A, второй — B и так далее. В текущих моделях оборудования доступен один или два контроллера, однако это не является неизменным ограничением и может измениться в будущем. Варианты:
|
gateway string | IPv4-адрес шлюза, используемого интерфейсом. Следует указывать в формате xx.xx.xx.xx. Несовместим с config_method=dhcp |
mtu псевдонимы: max_frame_size integer | Максимальная единица передачи (MTU) в байтах. Это позволяет задать для MTU большее значение, чтобы включить jumbo-кадры (любое значение > 1500). Как правило, для этого необходимо, чтобы хост, коммутаторы и другие компоненты не только поддерживали jumbo-кадры, но и были правильно настроены. Поэтому, если вы не уверены в своих действиях, лучше оставить значение по умолчанию. По умолчанию: |
port integer / обязательный | Порт iSCSI базовой платы контроллера или HIC, который нужно изменить. Чтобы определить номер порта, считайте порты iSCSI контроллера слева направо, начиная с единицы. Сначала считайте порты базовой платы, затем порты HIC. |
speed string | Параметр изменяет скорость порта интерфейса. Допускаются только поддерживаемые значения скорости в формате [0-9]+[gm] (например, 25g). Для отключённых интерфейсов скорость будет отображаться как «Неизвестно», пока для них не будет задана допустимая скорость сети. Не используйте этот параметр, если скорость порта настраивается автоматически, иначе операция завершится ошибкой. Сведения о возможностях порта см. в System Manager. |
ssid string | Идентификатор управляемого массива. Это значение должно быть уникальным для каждого массива. По умолчанию: |
state string | Если параметр включён, будет использоваться указанная конфигурация. Если параметр отключён, конфигурация IPv4 будет удалена, а подключение IPv4 — отключено. Варианты:
|
subnet_mask string | Маска подсети, используемая интерфейсом. Следует указывать в формате 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 и более новых моделях оборудования.
- Для настройки систем, управляемых экземпляром WSP, можно использовать netapp_eseries.santricity.netapp_e_storage_system.
Примеры
- name: Configure the first port on the A controller with a static IPv4 address
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "1"
controller: "A"
config_method: static
address: "192.168.1.100"
subnet_mask: "255.255.255.0"
gateway: "192.168.1.1"
speed: "25g"
- name: Disable ipv4 connectivity for the second port on the B controller
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "2"
controller: "B"
state: disabled
- name: Enable jumbo frames for the first 4 ports on controller A
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "{{ item }}"
controller: "A"
state: enabled
mtu: 9000
config_method: dhcp
loop:
- 1
- 2
- 3
- 4
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
msg string | Сообщение об успешном выполнении Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp_eseries/santricity/na_santricity_iscsi_interface_module.html
