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 与 addresssubnet_maskgateway 互斥。

选项

  • "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_addressdns_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_addressntp_address_backup 互斥。

dhcp 与 ntp_addressntp_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 Services 嵌入式 REST API URL 的列表

返回:成功时

msg

字符串

成功消息

返回:成功时

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

作者

  • Michael Price (@lmprice)

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)