dellemc.powerflex.mdm_cluster 模块 – 管理 Dell PowerFlex 上的 MDM 集群

注意

此模块是 dellemc.powerflex 集合（版本 2.5.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install dellemc.powerflex。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定：dellemc.powerflex.mdm_cluster。

dellemc.powerflex 1.3.0 中的新增功能

概要

  • 在 PowerFlex 存储系统上管理 MDM 集群和 MDM 包括添加/删除备用 MDM，修改 MDM 名称和虚拟接口。

  • 它还包括获取 MDM 集群的详细信息，修改 MDM 集群所有权、集群模式和性能配置文件。

要求

执行此模块的主机需要以下要求。

  • Dell PowerFlex 存储系统版本 3.6 或更高版本。

  • PyPowerFlex 1.12.0。

参数

参数

注释

clear_interfaces

布尔值

清除所有虚拟 IP 接口。

clear_interfaces 与 virtual_ip_interfaces 互斥。

选择

  • false

  • true

cluster_mode

字符串

集群的模式。

选择

  • "OneNode"

  • "ThreeNodes"

  • "FiveNodes"

hostname

别名：gateway_host

字符串 / 必需

PowerFlex 主机的 IP 或 FQDN。

is_primary

布尔值

将 is_primary 设置为 true 以将 MDM 集群所有权从当前主 MDM 更改为不同的 MDM。

将 is_primary 设置为 false 将返回 MDM 集群详细信息。

新的所有者 MDM 必须是具有管理器角色的 MDM。

选择

  • false

  • true

mdm

列表 / elements=dictionary

指定将 MDM 添加到 MDM 集群或从 MDM 集群删除 MDM 的参数。

mdm_id

字符串

将要添加到集群或从集群删除的 MDM 的 ID。

mdm_name

字符串

将要添加到集群或从集群删除的 MDM 的名称。

mdm_type

字符串 / 必需

MDM 的类型。

必须传递 mdm_id 或 mdm_name 以及 mdm_type。

选择

  • "Secondary"

  • "TieBreaker"

mdm_id

字符串

MDM 的 ID。

与 mdm_name 互斥。

mdm_name

字符串

MDM 的名称。它在 PowerFlex 阵列中是唯一的。

与 mdm_id 互斥。

如果在添加备用操作中传递了 mdm_name，则将相同的名称分配给新的备用 mdm。

mdm_new_name

字符串

重命名 MDM。

mdm_state

字符串

MDM 的映射状态。

选择

  • "present-in-cluster"

  • "absent-in-cluster"

password

字符串 / 必需

PowerFlex 主机的密码。

performance_profile

字符串

将性能配置文件应用于集群 MDM。

选择

  • "Compact"

  • "HighPerformance"

port

整数

与 PowerFlex 主机通信的端口号。

默认： 443

standby_mdm

字典

指定添加备用 MDM 参数。

allow_multiple_ips

布尔值

允许添加的节点与主节点具有不同数量的 IP。

选择

  • false

  • true

management_ips

列表 / elements=string

用于管理 MDM 的管理 IP 列表。它可以包含 IPv4 地址。

mdm_ips

列表 / elements=string / 必需

将分配给新 MDM 的 MDM IP 列表。它可以包含 IPv4 地址。

port

整数

指定新 MDM 的端口。

role

字符串 / 必需

新 MDM 的角色。

选择

  • "Manager"

  • "TieBreaker"

virtual_interfaces

列表 / elements=string

将用于虚拟 IP 地址的 NIC 接口列表。

state

字符串 / 必需

MDM 集群的状态。

选择

  • "present"

  • "absent"

timeout

整数

连接将在超时后终止。

以秒为单位提及。

默认： 120

username

字符串 / 必需

PowerFlex 主机的用户名。

validate_certs

别名：verifycert

布尔值

布尔变量，用于指定是否验证 SSL 证书。

true - 表示应验证 SSL 证书。

false - 表示不应验证 SSL 证书。

选择

  • false

  • true ← (默认)

virtual_ip_interfaces

列表 / elements=string

将用于虚拟 IP 的接口列表。

接口的顺序必须与分配给集群的虚拟 IP 相匹配。

允许修改主类型和辅助类型 MDM 的接口。

virtual_ip_interfaces 与 clear_interfaces 互斥。

注意

注意

  • 重命名和修改虚拟 IP 接口时，参数 mdm_name 或 mdm_id 是必需的。

  • 修改性能配置文件时，不需要参数 mdm_name 或 mdm_id。

  • 对于更改 MDM 集群所有权的操作，只会返回 changed 为 true 的情况；对于幂等性情况，将返回 MDM 集群的详细信息。

  • 将所有权更改为新添加的 MDM 后，重新安装所有 SDC。

  • 要添加管理器备用 MDM，必须安装具有管理器角色的 MDM 包。

  • 支持 check_mode。

  • 名为“dellemc.powerflex”的集合中存在的模块旨在支持 Dell PowerFlex 存储平台。

示例

- name: Add a standby MDM
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_1"
    standby_mdm:
      mdm_ips:
        - "10.x.x.x"
      role: "TieBreaker"
      management_ips:
        - "10.x.y.z"
    state: "present"

- name: Remove a standby MDM
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_1"
    state: "absent"

- name: Switch cluster mode from 3 node to 5 node MDM cluster
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    cluster_mode: "FiveNodes"
    mdm:
      - mdm_id: "5f091a8a013f1100"
        mdm_type: "Secondary"
      - mdm_name: "mdm_1"
        mdm_type: "TieBreaker"
    sdc_state: "present-in-cluster"
    state: "present"

- name: Switch cluster mode from 5 node to 3 node MDM cluster
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    cluster_mode: "ThreeNodes"
    mdm:
      - mdm_id: "5f091a8a013f1100"
        mdm_type: "Secondary"
      - mdm_name: "mdm_1"
        mdm_type: "TieBreaker"
    sdc_state: "absent-in-cluster"
    state: "present"

- name: Get the details of the MDM cluster
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    state: "present"

- name: Change ownership of MDM cluster
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_2"
    is_primary: true
    state: "present"

- name: Modify performance profile
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    performance_profile: "HighPerformance"
    state: "present"

- name: Rename the MDM
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_1"
    mdm_new_name: "new_mdm_1"
    state: "present"

- name: Modify virtual IP interface of the MDM
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_1"
    virtual_ip_interface:
      - "ens224"
    state: "present"

- name: Clear virtual IP interface of the MDM
  dellemc.powerflex.mdm_cluster:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    mdm_name: "mdm_1"
    clear_interfaces: true
    state: "present"

返回值

通用返回值记录在这里，以下是此模块特有的字段

键

描述

changed

布尔值

资源是否已更改。

返回： 总是

示例： false

mdm_cluster_details

字典

MDM 集群的详细信息。

返回： 当 MDM 集群存在时

示例： {"clusterMode": "ThreeNodes", "clusterState": "ClusteredNormal", "goodNodesNum": 3, "goodReplicasNum": 2, "id": "cdd883cf00000002", "master": {"id": "5908d328581d1400", "ips": ["10.x.y.z"], "managementIPs": ["10.x.y.z"], "name": "sample_mdm", "opensslVersion": "OpenSSL 1.0.2k-fips  26 Jan 2017", "port": 9011, "role": "Manager", "status": "Normal", "versionInfo": "R3_6.0.0", "virtualInterfaces": ["ens1"]}, "perfProfile": "HighPerformance", "slaves": [{"id": "5908d328581d1401", "ips": ["10.x.x.z"], "managementIPs": ["10.x.x.z"], "name": "sample_mdm1", "opensslVersion": "OpenSSL 1.0.2k-fips  26 Jan 2017", "port": 9011, "role": "Manager", "status": "Normal", "versionInfo": "R3_6.0.0", "virtualInterfaces": ["ens1"]}], "standbyMDMs": [{"id": "5908d328581d1403", "ips": ["10.x.z.z"], "managementIPs": ["10.x.z.z"], "opensslVersion": "N/A", "port": 9011, "role": "TieBreaker", "status": "Normal", "versionInfo": "R3_6.0.0", "virtualInterfaces": []}], "tieBreakers": [{"id": "5908d328581d1402", "ips": ["10.x.y.y"], "managementIPs": [], "opensslVersion": "N/A", "port": 9011, "role": "TieBreaker", "status": "Normal", "versionInfo": "R3_6.0.0", "virtualInterfaces": []}]}

clusterMode

字符串

MDM 集群的模式。

返回： 成功

clusterState

字符串

MDM 集群的状态。

返回： 成功

goodNodesNum

整数

MDM 集群中的节点数。

返回： 成功

goodReplicasNum

整数

用于复制的节点数。

返回： 成功

id

字符串

MDM 集群的 ID。

返回： 成功

master

字典

主 MDM 的详细信息。

返回： 成功

id

字符串

MDM 的 ID。

返回： 成功

ips

列表 / elements=string

主 MDM 的 IP 列表。

返回： 成功

managementIPs

列表 / elements=string

主 MDM 的管理 IP 列表。

返回： 成功

name

字符串

MDM 的名称。

返回： 成功

opensslVersion

字符串

OpenSSL 版本。

返回： 成功

port

字符串

MDM 的端口。

返回： 成功

role

字符串

MDM 的角色。

返回： 成功

status

字符串

MDM 的状态。

返回： 成功

versionInfo

字符串

MDM 的版本。

返回： 成功

virtualInterfaces

列表 / elements=string

虚拟接口列表

返回： 成功

name

字符串

MDM 集群的名称。

返回： 成功

slaves

列表 / elements=dictionary

辅助 MDM 的列表。

返回： 成功

id

字符串

MDM 的 ID。

返回： 成功

ips

列表 / elements=string

辅助 MDM 的 IP 列表。

返回： 成功

managementIPs

列表 / elements=string

辅助 MDM 的管理 IP 列表。

返回： 成功

name

字符串

MDM 的名称。

返回： 成功

opensslVersion

字符串

OpenSSL 版本。

返回： 成功

port

字符串

MDM 的端口。

返回： 成功

role

字符串

MDM 的角色。

返回： 成功

status

字符串

MDM 的状态。

返回： 成功

versionInfo

字符串

MDM 的版本。

返回： 成功

virtualInterfaces

列表 / elements=string

虚拟接口列表

返回： 成功

standbyMDMs

列表 / elements=dictionary

备用 MDM 的列表。

返回： 成功

id

字符串

MDM 的 ID。

返回： 成功

ips

列表 / elements=string

MDM 的 IP 列表。

返回： 成功

managementIPs

列表 / elements=string

MDM 的管理 IP 列表。

返回： 成功

name

字符串

MDM 的名称。

返回： 成功

opensslVersion

字符串

OpenSSL 版本。

返回： 成功

port

字符串

MDM 的端口。

返回： 成功

role

字符串

MDM 的角色。

返回： 成功

status

字符串

MDM 的状态。

返回： 成功

versionInfo

字符串

MDM 的版本。

返回： 成功

virtualInterfaces

列表 / elements=string

虚拟接口列表。

返回： 成功

tieBreakers

列表 / elements=dictionary

决胜 MDM 的列表。

返回： 成功

id

字符串

MDM 的 ID。

返回： 成功

ips

列表 / elements=string

决胜 MDM 的 IP 列表。

返回： 成功

managementIPs

列表 / elements=string

决胜 MDM 的管理 IP 列表。

返回： 成功

name

字符串

MDM 的名称。

返回： 成功

opensslVersion

字符串

OpenSSL 版本。

返回： 成功

port

字符串

MDM 的端口。

返回： 成功

role

字符串

MDM 的角色。

返回： 成功

status

字符串

MDM 的状态。

返回： 成功

versionInfo

字符串

MDM 的版本。

返回： 成功

virtualIps

列表 / elements=string

虚拟 IP 列表。

返回： 成功

作者

  • Bhavneet Sharma (@sharmb5)