netapp_eseries.santricity.na_santricity_iscsi_interface 模块 – NetApp E-Series 管理 iSCSI 接口配置

注意

此模块是 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_iscsi_interface

概要

  • 配置 E-Series iSCSI 接口的设置

参数

参数

注释

address

字符串

要分配给接口的 IPv4 地址。

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

config_method=dhcp 互斥

api_password

字符串 / 必需

用于使用 SANtricity Web 服务代理或嵌入式 Web 服务 API 进行身份验证的密码。

api_url

字符串 / 必需

指向 SANtricity Web 服务代理或嵌入式 Web 服务 API 的 URL。

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

api_username

字符串 / 必需

用于使用 SANtricity Web 服务代理或嵌入式 Web 服务 API 进行身份验证的用户名。

config_method

字符串

此接口要使用的配置方法类型。

dhcp 与 addresssubnet_maskgateway 互斥。

选项

  • "dhcp" ←(默认)

  • "static"

controller

字符串 / 必需

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

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

当前硬件型号有 1 或 2 个可用控制器,但这并不是一个保证的硬性限制,将来可能会发生变化。

选项

  • "A"

  • "B"

gateway

字符串

用于接口的 IPv4 网关地址。

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

config_method=dhcp 互斥

mtu

别名:max_frame_size

整数

最大传输单元 (MTU),以字节为单位。

这允许您配置更大的 MTU 值,以便启用巨型帧(任何值 > 1500)。

通常,您的主机、交换机和其他组件不仅需要支持巨型帧,还需要正确配置它。因此,除非您知道自己在做什么,否则最好将其保留为默认值。

默认: 1500

port

整数 / 必需

要修改的控制器 iSCSI 基板或 HIC 端口。

通过从左到右计数控制器的 iSCSI 端口来确定端口。计数基板和 HIC 端口。

speed

字符串

此选项将更改接口端口速度。

只会接受支持的速度,并且必须采用 [0-9]+[gm] 的形式(即 25g)

关闭的接口将报告为未知速度,直到它们设置为接受的网络速度。

当端口的速度自动配置时,请勿使用此选项,因为它会失败。有关端口的功能,请参见系统管理器。

ssid

字符串

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

默认: "1"

state

字符串

启用后,将使用提供的配置。

禁用后,将清除 IPv4 配置并禁用 IPv4 连接。

选项

  • "enabled" ←(默认)

  • "disabled"

subnet_mask

字符串

用于接口的子网掩码。

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

config_method=dhcp 互斥

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ←(默认)

注释

注意

  • 支持检查模式。

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

  • 此模块在没有任何 iSCSI 接口的 E-Series 系统上将不起作用/不可用。

  • 此模块需要 Web 服务 API 版本 >= 1.3。

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

  • 嵌入式 Web 服务目前在 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_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

字符串

成功消息

返回:成功时

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

作者

  • Michael Price (@lmprice)

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)