dellemc.unity.consistencygroup 模块 – 在 Unity 存储系统上管理一致性组
注意
此模块是 dellemc.unity 集合（版本 2.0.0）的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install dellemc.unity。您需要进一步的要求才能使用此模块，请参阅 要求 以了解详细信息。
要在 playbook 中使用它，请指定： dellemc.unity.consistencygroup。
dellemc.unity 1.1.0 中的新增功能
概要
在 Unity 存储系统上管理一致性组包括创建新的一致性组、向一致性组添加卷、从一致性组删除卷、将主机映射到一致性组、从一致性组取消映射主机、重命名一致性组、修改一致性组的属性、启用一致性组中的复制、禁用一致性组中的复制以及删除一致性组。
要求
执行此模块的主机需要以下要求。
Dell Unity 存储设备版本 5.1 或更高版本。
Ansible-core 2.14 或更高版本。
Python 3.9、3.10 或 3.11。
Storops Python SDK 1.2.11。
参数
参数 |
注释 |
|---|---|
一致性组的 ID。 它只能用于获取、修改、添加/删除卷或删除操作。 |
|
一致性组的名称。 对于创建操作是强制性的。 对于任何操作，请指定 cg_name 或 cg_id（但不能同时指定两者）。 |
|
一致性组的描述。 |
|
这是一个主机列表。 必须提供主机 ID 或名称，才能为一致性组映射/取消映射主机。 如果提供了 hosts，则还应指定 mapping_state。 如果一致性组没有卷，则无法将主机映射到一致性组。 当一致性组映射到主机时，用户不应使用卷模块将一致性组中的卷映射到主机。 |
|
主机的 ID。 |
|
主机的名称。 |
|
字符串变量，描述一致性组内主机的状态。 如果提供了 hosts，则还应指定 mapping_state。 选项
|
|
一致性组的新名称，用于重命名操作。 |
|
Unity 管理服务器的密码。 |
|
与 Unity 管理服务器通信的端口号。 默认值： |
|
启用复制所需的设置。 |
|
目标一致性组的名称。 默认值将是源一致性组名称，前缀为“DR_”。 |
|
分配目标 LUN 的池的 ID。 与 destination_pool_name 互斥。 |
|
分配目标 LUN 的池的名称。 与 destination_pool_id 互斥。 |
|
要配置复制的远程系统的详细信息。 如果 replication_type 为 |
|
远程 Unity Unisphere 主机的 IP 或 FQDN。 |
|
远程 Unity Unisphere 主机的密码。 |
|
托管远程 Unity Unisphere 的端口。 默认值： |
|
远程 Unity Unisphere 主机的用户名。 |
|
布尔变量，用于指定是否验证远程 Unity Unisphere 主机的 SSL 证书。
选项
|
|
复制模式。 选项
|
|
复制类型。 选项
|
|
系统同步源 LUN 和目标 LUN 之前要等待的最长时间。 如果 replication_mode 为 该值应在 |
|
复制状态。 选项
|
|
分配给一致性组的快照计划。 指定空字符串 “” 会从一致性组中删除现有的快照计划。 |
|
定义一致性组是否应存在。 选项
|
|
分层策略选项，用于确定如何在池中可用的层之间分配存储资源数据。 选项
|
|
Unity 管理服务器的 IP 地址或 FQDN。 |
|
Unity 管理服务器的用户名。 |
|
布尔变量，用于指定是否验证 SSL 证书。
选项
|
|
字符串变量，描述一致性组内卷的状态。 如果提供了volumes，则还应指定vol_state。 选项
|
|
这是一个卷列表。 必须提供卷 ID 或名称，才能从一致性组添加/删除现有卷。 如果提供了volumes，则还应指定vol_state。 如果一致性组或卷有快照，则无法从一致性组添加/删除卷。 |
|
卷的 ID。 |
|
卷的名称。 |
注释
注意
不支持 check_mode。
此集合中名为 ‘dellemc.unity’ 的模块旨在支持 Dell Unity 存储平台。
示例
- name: Create consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
validate_certs: "{{validate_certs}}"
username: "{{username}}"
password: "{{password}}"
cg_name: "{{cg_name}}"
description: "{{description}}"
snap_schedule: "{{snap_schedule1}}"
state: "present"
- name: Get details of consistency group using id
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_id: "{{cg_id}}"
state: "present"
- name: Add volumes to consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_id: "{{cg_id}}"
volumes:
- vol_name: "Ansible_Test-3"
- vol_id: "sv_1744"
vol_state: "{{vol_state_present}}"
state: "present"
- name: Rename consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_name: "{{cg_name}}"
new_cg_name: "{{new_cg_name}}"
state: "present"
- name: Modify consistency group details
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_name: "{{new_cg_name}}"
snap_schedule: "{{snap_schedule2}}"
tiering_policy: "{{tiering_policy1}}"
state: "present"
- name: Map hosts to a consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_id: "{{cg_id}}"
hosts:
- host_name: "10.226.198.248"
- host_id: "Host_511"
mapping_state: "mapped"
state: "present"
- name: Unmap hosts from a consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_id: "{{cg_id}}"
hosts:
- host_id: "Host_511"
- host_name: "10.226.198.248"
mapping_state: "unmapped"
state: "present"
- name: Remove volumes from consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_name: "{{new_cg_name}}"
volumes:
- vol_name: "Ansible_Test-3"
- vol_id: "sv_1744"
vol_state: "{{vol_state_absent}}"
state: "present"
- name: Delete consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_name: "{{new_cg_name}}"
state: "absent"
- name: Enable replication for consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_id: "cg_id_1"
replication_params:
destination_cg_name: "destination_cg_1"
replication_mode: "asynchronous"
rpo: 60
replication_type: "remote"
remote_system:
remote_system_host: '10.1.2.3'
remote_system_verifycert: false
remote_system_username: 'username'
remote_system_password: 'password'
destination_pool_name: "pool_test_1"
replication_state: "enable"
state: "present"
- name: Disable replication for consistency group
dellemc.unity.consistencygroup:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
cg_name: "dis_repl_ans_source"
replication_state: "disable"
state: "present"
返回值
通用返回值记录在此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
资源是否已更改。 返回：始终 示例： |
|
一致性组的详细信息。 返回：当一致性组存在时 示例： |
|
映射到一致性组的主机的详细信息。 返回：成功 |
|
映射到一致性组的主机列表。 返回：成功 |
|
主机的详细信息。 返回：成功 |
|
主机的 ID。 返回：成功 |
|
主机的名称。 返回：成功 |
|
是否启用复制。 返回：成功 |
|
系统为一致性组提供的 ID。 返回：成功 |
|
属于一致性组的卷的详细信息。 返回：成功 |
|
属于一致性组的卷列表。 返回：成功 |
|
卷的详细信息。 返回：成功 |
|
系统为卷提供的 ID。 返回：成功 |
|
卷的名称。 返回：成功 |
|
一致性组的 FAST VP 分层策略。 返回：成功 |
|
应用于一致性组的快照计划。 返回：成功 |
|
应用于一致性组的快照计划。 返回：成功 |
|
系统为快照计划提供的 ID。 返回：成功 |
|
快照计划的名称。 返回：成功 |
|
一致性组的快照列表。 返回：成功 |
|
拍摄快照的日期和时间。 返回：成功 |
|
快照过期的日期和时间。 返回：成功 |
|
快照的名称。 返回：成功 |
|
为其拍摄快照的存储资源。 返回：成功 |
|
存储资源的详细信息。 返回：成功 |
|
存储资源的 ID。 返回：成功 |