dellemc.powerflex.sds 模块 – Dell PowerFlex 上的 SDS 管理

注意

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

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

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

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

dellemc.powerflex 1.1.0 中的新增功能

概要

  • PowerFlex 存储系统上的 SDS 管理包括创建新的 SDS、获取 SDS 的详细信息、向 SDS 添加/删除 IP、修改 SDS 的属性以及删除 SDS。

要求

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

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

  • PyPowerFlex 1.12.0。

参数

参数

注释

fault_set_id

字符串

故障集的唯一标识符。

与 *fault_set_name* 互斥。

fault_set_name

字符串

故障集的名称。

与 *fault_set_id* 互斥。

主机名

别名：gateway_host

字符串 / 必需

PowerFlex 主机的 IP 或 FQDN。

密码

字符串 / 必需

PowerFlex 主机的密码。

性能配置文件

字符串

应用于 SDS 的性能配置文件。

HighPerformance 配置文件为非常高性能的用例配置一组预定义的参数。

API 的默认值为 HighPerformance。

选项

  • "Compact"

  • "HighPerformance"

端口

整数

与 PowerFlex 主机通信的端口号。

默认值： 443

protection_domain_id

字符串

保护域的 ID。

与 *protection_domain_name* 互斥。

protection_domain_name

字符串

保护域的名称。

与 *protection_domain_id* 互斥。

rfcache_enabled

布尔值

是否启用读取闪存缓存。

选项

  • false

  • true

rmcache_enabled

布尔值

是否启用读取 RAM 缓存。

选项

  • false

  • true

rmcache_size

整数

读取 RAM 缓存大小（以 MB 为单位）。

最小大小为 128 MB。

最大大小为 3911 MB。

sds_id

字符串

SDS 的 ID。

除创建操作外，所有其他操作都可以使用 *sds_id* 执行。

与 *sds_name* 互斥。

sds_ip_list

列表 / 元素=字典

SDS 的 IP 及其角色的字典。

创建 SDS 时，至少需要一个 IP-角色。

IP-角色也可以更新。

ip

字符串 / 必需

SDS 的 IP 地址。

角色

字符串 / 必需

分配给 SDS IP 地址的角色。

选项

  • "sdsOnly"

  • "sdcOnly"

  • "all"

sds_ip_state

字符串

IP 相对于 SDS 的状态。

选项

  • "present-in-sds"

  • "absent-in-sds"

sds_name

字符串

SDS 的名称。

创建操作时必须指定。

它在 PowerFlex 阵列中是唯一的。

与 *sds_id* 互斥。

sds_new_name

字符串

SDS 新名称。

状态

字符串 / 必需

SDS 的状态。

选项

  • "present"

  • "absent"

超时

整数

连接终止后的时间。

以秒为单位。

默认值： 120

用户名

字符串 / 必需

PowerFlex 主机的用户名。

验证证书

别名：verifycert

布尔值

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

true - 表示应验证 SSL 证书。

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

选项

  • false

  • true ← (默认)

注释

注意

  • 可以与 SDS 关联的 IP 的最大限制为 8 个。

  • 需要至少一个 IP 用于 SDS 通信和一个用于 SDC 通信。

  • 如果只有一个 IP，则其角色必须为“all”；否则，一个 IP 的角色可以为“all”，其他 IP 的角色为“sdcOnly”；或者一个 IP 的角色必须为“sdsOnly”，其他 IP 的角色为“sdcOnly”。

  • 可以有多个角色为“sdcOnly”的 IP。

  • 只有一个 IP 可以具有 SDS 角色（角色为“all”或“sdsOnly”）。

  • 可以禁用 RF 缓存来创建 SDS，但是请注意，RF 缓存并不总是更新的。在这种情况下，用户应重试该操作。

  • 支持 *check_mode*。

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

示例

- name: Create SDS
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    protection_domain_name: "domain1"
    sds_ip_list:
      - ip: "198.10.xxx.xxx"
        role: "all"
    sds_ip_state: "present-in-sds"
    state: "present"

- name: Create SDS with all parameters
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node1"
    protection_domain_name: "domain1"
    fault_set_name: "faultset1"
    sds_ip_list:
      - ip: "198.10.xxx.xxx"
        role: "sdcOnly"
    sds_ip_state: "present-in-sds"
    rmcache_enabled: true
    rmcache_size: 128
    performance_profile: "HighPerformance"
    state: "present"

- name: Get SDS details using name
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    state: "present"

- name: Get SDS details using ID
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_id: "5718253c00000004"
    state: "present"

- name: Modify SDS attributes using name
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    sds_new_name: "node0_new"
    rfcache_enabled: true
    rmcache_enabled: true
    rmcache_size: 256
    performance_profile: "HighPerformance"
    state: "present"

- name: Modify SDS attributes using ID
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_id: "5718253c00000004"
    sds_new_name: "node0_new"
    rfcache_enabled: true
    rmcache_enabled: true
    rmcache_size: 256
    performance_profile: "HighPerformance"
    state: "present"

- name: Add IP and role to an SDS
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    sds_ip_list:
      - ip: "198.10.xxx.xxx"
        role: "sdcOnly"
    sds_ip_state: "present-in-sds"
    state: "present"

- name: Remove IP and role from an SDS
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    sds_ip_list:
      - ip: "198.10.xxx.xxx"
        role: "sdcOnly"
    sds_ip_state: "absent-in-sds"
    state: "present"

- name: Delete SDS using name
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_name: "node0"
    state: "absent"

- name: Delete SDS using ID
  dellemc.powerflex.sds:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    sds_id: "5718253c00000004"
    state: "absent"

返回值

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

键

描述

changed

布尔值

资源是否已更改。

返回：始终

示例： false

sds_details

字典

SDS 的详细信息。

返回：当 SDS 存在时

示例： {"authenticationError": "None", "certificateInfo": null, "configuredDrlMode": "Volatile", "drlMode": "Volatile", "faultSetId": null, "fglMetadataCacheSize": 0, "fglMetadataCacheState": "Disabled", "fglNumConcurrentWrites": 1000, "id": "8f3bb0cc00000002", "ipList": [{"ip": "10.47.xxx.xxx", "role": "all"}], "lastUpgradeTime": 0, "links": [{"href": "/api/instances/Sds::8f3bb0cc00000002", "rel": "self"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /Statistics", "rel": "/api/Sds/relationship/Statistics"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /SpSds", "rel": "/api/Sds/relationship/SpSds"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /Device", "rel": "/api/Sds/relationship/Device"}, {"href": "/api/instances/ProtectionDomain::9300c1f900000000", "rel": "/api/parent/relationship/protectionDomainId"}], "maintenanceState": "NoMaintenance", "maintenanceType": "NoMaintenance", "mdmConnectionState": "Connected", "membershipState": "Joined", "name": "node0", "numOfIoBuffers": null, "numRestarts": 2, "onVmWare": true, "perfProfile": "HighPerformance", "port": 7072, "protectionDomainId": "9300c1f900000000", "protectionDomainName": "domain1", "raidControllers": null, "rfcacheEnabled": true, "rfcacheErrorApiVersionMismatch": false, "rfcacheErrorDeviceDoesNotExist": false, "rfcacheErrorInconsistentCacheConfiguration": false, "rfcacheErrorInconsistentSourceConfiguration": false, "rfcacheErrorInvalidDriverPath": false, "rfcacheErrorLowResources": false, "rmcacheEnabled": true, "rmcacheFrozen": false, "rmcacheMemoryAllocationState": "AllocationPending", "rmcacheSizeInKb": 131072, "rmcacheSizeInMb": 128, "sdsConfigurationFailure": null, "sdsDecoupled": null, "sdsReceiveBufferAllocationFailures": null, "sdsState": "Normal", "softwareVersionInfo": "R3_6.0.0"}

authenticationError

字符串

指示身份验证错误。

返回值： 成功

certificateInfo

字符串

证书信息。

返回值： 成功

configuredDrlMode

字符串

已配置的DRL模式。

返回值： 成功

drlMode

字符串

DRL模式。

返回值： 成功

faultSetId

字符串

故障集ID。

返回值： 成功

fglMetadataCacheSize

整数

FGL元数据缓存大小。

返回值： 成功

fglMetadataCacheState

字符串

FGL元数据缓存状态。

返回值： 成功

fglNumConcurrentWrites

整数

FGL并发写入数。

返回值： 成功

id

字符串

SDS ID。

返回值： 成功

ipList

列表 / 元素=字符串

SDS IP列表。

返回值： 成功

ip

字符串

SDS中的IP地址。

返回值： 成功

角色

字符串

SDS IP的角色。

返回值： 成功

lastUpgradeTime

字符串

上次SDS升级时间。

返回值： 成功

列表 / 元素=字符串

SDS链接。

返回值： 成功

字符串

SDS实例URL。

返回值： 成功

字符串

SDS与不同实体的关系。

返回值： 成功

maintenanceState

字符串

维护状态。

返回值： 成功

maintenanceType

字符串

维护类型。

返回值： 成功

mdmConnectionState

字符串

MDM连接状态。

返回值： 成功

membershipState

字符串

成员资格状态。

返回值： 成功

name

字符串

SDS名称。

返回值： 成功

numOfIoBuffers

整数

IO缓冲区数量。

返回值： 成功

numRestarts

整数

重启次数。

返回值： 成功

onVmWare

布尔值

是否在VMware上运行。

返回值： 成功

perfProfile

字符串

性能配置。

返回值： 成功

端口

整数

SDS端口。

返回值： 成功

protectionDomainId

字符串

保护域ID。

返回值： 成功

protectionDomainName

字符串

保护域名称。

返回值： 成功

raidControllers

整数

RAID控制器数量。

返回值： 成功

rfcacheEnabled

布尔值

RF缓存是否启用。

返回值： 成功

rfcacheErrorApiVersionMismatch

布尔值

API版本不匹配导致的RF缓存错误。

返回值： 成功

rfcacheErrorDeviceDoesNotExist

布尔值

设备不存在导致的RF缓存错误。

返回值： 成功

rfcacheErrorInconsistentCacheConfiguration

布尔值

缓存配置不一致导致的RF缓存错误。

返回值： 成功

rfcacheErrorInconsistentSourceConfiguration

布尔值

源配置不一致导致的RF缓存错误。

返回值： 成功

rfcacheErrorInvalidDriverPath

布尔值

驱动程序路径无效导致的RF缓存错误。

返回值： 成功

rfcacheErrorLowResources

布尔值

资源不足导致的RF缓存错误。

返回值： 成功

rmcacheEnabled

布尔值

读取RAM缓存是否启用。

返回值： 成功

rmcacheFrozen

布尔值

RM缓存冻结。

返回值： 成功

rmcacheMemoryAllocationState

布尔值

RM缓存内存分配状态。

返回值： 成功

rmcacheSizeInKb

整数

RM缓存大小（KB）。

返回值： 成功

rmcacheSizeInMb

整数

RM缓存大小（MB）。

返回值： 成功

sdsConfigurationFailure

字符串

SDS配置失败。

返回值： 成功

sdsDecoupled

字符串

SDS解耦。

返回值： 成功

sdsReceiveBufferAllocationFailures

字符串

SDS接收缓冲区分配失败。

返回值： 成功

sdsState

字符串

SDS状态。

返回值： 成功

softwareVersionInfo

字符串

SDS软件版本信息。

返回值： 成功

作者

  • Rajshree Khare (@khareRajshree)

  • Trisha Datta (@trisha-dell)