netapp_eseries.santricity.na_santricity_mgmt_interface 模块 – NetApp E 系列存储系统管理接口配置

注意

此模块是 netapp_eseries.santricity 集合 (版本 1.4.1) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用: ansible-galaxy collection install netapp_eseries.santricity

要在 playbook 中使用它,请指定: netapp_eseries.santricity.na_santricity_mgmt_interface

概要

  • 配置 E 系列存储系统的管理接口

参数

参数

注释

address

字符串

分配给接口的 IPv4 地址。

应以 xx.xx.xx.xx 的形式指定。

与 `config_method=dhcp` 互斥

api_password

字符串 / 必填

用于验证 SANtricity Web Services Proxy 或嵌入式 Web Services API 的密码。

api_url

字符串 / 必填

SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。

示例 https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

字符串 / 必填

用于验证 SANtricity Web Services Proxy 或嵌入式 Web Services API 的用户名。

config_method

字符串

用于网络接口端口的配置方法类型。

dhcp 与 `address`、`subnet_mask` 和 `gateway` 互斥。

选项

  • "dhcp"

  • "static"

controller

字符串 / 必填

拥有要配置的端口的控制器。

控制器名称按字母顺序排列,第一个控制器为 A,第二个为 B,依此类推。

当前的硬件型号具有 1 个或 2 个可用的控制器,但这并非硬性限制,将来可能会更改。

选项

  • "A"

  • "B"

dns_address

字符串

主 IPv4 或 IPv6 DNS 服务器地址

dns_address_backup

字符串

辅助 IPv4 或 IPv6 DNS 服务器地址

dns_config_method

字符串

用于 DNS 服务的配置方法类型。

dhcp 与 `dns_address` 和 `dns_address_backup` 互斥。

选项

  • "dhcp"

  • "static"

gateway

字符串

接口使用的 IPv4 网关地址。

应以 xx.xx.xx.xx 的形式指定。

与 `config_method=dhcp` 互斥

ntp_address

字符串

主 IPv4、IPv6 或 FQDN NTP 服务器地址

ntp_address_backup

字符串

辅助 IPv4、IPv6 或 FQDN NTP 服务器地址

ntp_config_method

字符串

用于 NTP 服务的配置方法类型。

disable 与 `ntp_address` 和 `ntp_address_backup` 互斥。

dhcp 与 `ntp_address` 和 `ntp_address_backup` 互斥。

选项

  • "disabled"

  • "dhcp"

  • "static"

port

整数

要修改的以太网端口配置。

通道代表控制器上从左到右的端口号,从 1 开始。

当指定 `config_method` 时,这是必需的。

ssh

布尔值

启用对控制器的 ssh 访问以进行调试。

这是一个控制器级别的设置。

对于不支持 ssh 的旧设备,将启用 rlogin/telnet。

选项

  • false

  • true

ssid

字符串

要管理的阵列的 ID。此值对于每个阵列必须唯一。

默认值: "1"

state

字符串

启用或禁用 IPv4 网络接口配置。

必须启用 IPv4 或 IPv6,否则会发生错误。

除非定义,否则当指定 `config_method` 时,假定为 `state==enabled`。

选项

  • "enabled"

  • "disabled"

subnet_mask

字符串

接口使用的子网掩码。

应以 xx.xx.xx.xx 的形式指定。

与 `config_method=dhcp` 互斥

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

备注

注意

  • 支持检查模式。

  • 强烈建议每个控制器至少有一个可用的管理端口。

  • 使用 SANtricity Web Services Proxy 时,请使用 netapp_eseries.santricity.na_santricity_storage_system 更新管理路径。这是因为已知问题,将在代理版本 4.1 中解决。解决后,管理端口应自动更新。

  • 接口设置是同步应用的,但接口本身的更改(通过 dhcp 接收新的 IP 地址等)可能需要几秒钟或几分钟才能生效。

  • E 系列 Ansible 模块需要 Web Services Proxy (WSP) 实例才能管理存储系统,或者需要支持嵌入式 Web Services API 的 E 系列存储系统。

  • 嵌入式 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
  na_santricity_mgmt_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"

- name: Disable ipv4 connectivity for the second port on the B controller
  na_santricity_mgmt_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"
    enable_interface: no

- name: Enable ssh access for ports one and two on controller A
  na_santricity_mgmt_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"
    ssh: yes

- name: Configure static DNS settings for the first port on controller A
  na_santricity_mgmt_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"
    dns_config_method: static
    dns_address: "192.168.1.100"
    dns_address_backup: "192.168.1.1"

返回值

常见的返回值已在 此处 记录,以下是此模块特有的字段:

描述

available_embedded_api_urls

列表 / 元素=字符串

包含可用 Web 服务嵌入式 REST API URL 的列表

返回: 成功时

msg

字符串

成功消息

返回: 成功时

示例: "接口设置已更新."

作者

  • Michael Price (@lmprice)

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)