dellemc.unity.replication_session 模块 – 管理 Unity 存储系统上的复制会话

注意

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

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

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

要在 playbook 中使用它，请指定：dellemc.unity.replication_session。

dellemc.unity 1.7.0 中的新增功能

概要

  • 管理 Unity 存储系统上的复制会话包括获取详细信息、暂停、恢复、同步、故障转移、故障恢复和删除复制会话。

需求

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

  • Dell Unity 存储设备版本 5.1 或更高版本。

  • Ansible-core 2.14 或更高版本。

  • Python 3.9、3.10 或 3.11。

  • Storops Python SDK 1.2.11。

参数

参数

注释

failback

布尔值

执行复制会话的故障恢复。

选项

  • false

  • true

failover_with_sync

布尔值

如果 true，则在异步复制会话故障转移之前同步源和目标资源，或者在同步复制会话故障转移后保持它们同步。

如果 false，则执行复制会话的故障转移。

选项

  • false

  • true

force

布尔值

在从源 NAS 服务器发出复制故障转移时，跳过对 NAS 服务器的文件系统复制会话的预检查。

选项

  • false

  • true

force_full_copy

布尔值

指示在故障恢复会话期间是否要将所有数据从目标 SP 同步回源 SP。当由于故障导致复制会话不同步时，在恢复操作期间需要此参数。

选项

  • false

  • true

password

字符串 / 必需

Unity 管理服务器的密码。

pause

布尔值

暂停或恢复复制会话。

选项

  • false

  • true

port

整数

与 Unity 管理服务器通信的端口号。

默认值： 443

session_id

字符串

复制会话的 ID。

session_name

字符串

复制会话的名称。

state

字符串

状态变量，用于确定复制会话是否存在。

选项

  • "absent"

  • "present" ← (默认)

sync

布尔值

同步复制会话。

选项

  • false

  • true

unispherehost

字符串 / 必需

Unity 管理服务器的 IP 地址或 FQDN。

username

字符串 / 必需

Unity 管理服务器的用户名。

validate_certs

别名：verifycert

布尔值

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

true - 指示应验证 SSL 证书。

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

选项

  • false

  • true ← (默认)

备注

注意

  • 支持 _check_mode_。

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

示例

- name: Get replication session details
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"

- name: Get replication session details based on session_id
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_id: "103079215114_APM00213404195_0000_103079215274_APM00213404194_0000"

- name: Pause a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    pause: true

- name: Resume a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    pause: false
    force_full_copy: true

- name: Sync a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    sync: true

- name: Failover with sync a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failover_with_sync: true
    force: true

- name: Failover a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failover_with_sync: false

- name: Failback a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failback: true
    force_full_copy: true

- name: Delete a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    state: "absent"

返回值

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

键

描述

changed

布尔值

资源是否已更改。

返回： 始终

示例： true

replication_session_details

字典

复制会话的详细信息。

返回： 复制会话存在时。

示例： {"current_transfer_est_remain_time": 0, "daily_snap_replication_policy": null, "dst_resource_id": "nas_8", "dst_spa_interface": {"UnityRemoteInterface": {"hash": 8771253398547, "id": "APM00213404195:if_181"}}, "dst_spb_interface": {"UnityRemoteInterface": {"hash": 8771253424144, "id": "APM00213404195:if_180"}}, "dst_status": "ReplicationSessionStatusEnum.OK", "existed": true, "hash": 8771259012271, "health": {"UnityHealth": {"hash": 8771253424168}}, "hourly_snap_replication_policy": null, "id": "103079215114_APM00213404195_0000_103079215274_APM00213404194_0000", "last_sync_time": "2023-04-18 10:35:25+00:00", "local_role": "ReplicationSessionReplicationRoleEnum.DESTINATION", "max_time_out_of_sync": 0, "members": null, "name": "rep_sess_nas", "network_status": "ReplicationSessionNetworkStatusEnum.OK", "remote_system": {"UnityRemoteSystem": {"hash": 8771253380142}}, "replication_resource_type": "ReplicationEndpointResourceTypeEnum.NASSERVER", "src_resource_id": "nas_213", "src_spa_interface": {"UnityRemoteInterface": {"hash": 8771253475010, "id": "APM00213404194:if_195"}}, "src_spb_interface": {"UnityRemoteInterface": {"hash": 8771253374169, "id": "APM00213404194:if_194"}}, "src_status": "ReplicationSessionStatusEnum.OK", "status": "ReplicationOpStatusEnum.ACTIVE", "sync_progress": 0, "sync_state": "ReplicationSessionSyncStateEnum.IN_SYNC"}

currentTransferEstRemainTime

整数

复制同步完成的预计剩余时间。

返回：成功

dstResourceId

字符串

目标资源的标识符。

返回：成功

dstStatus

字符串

复制会话目标端的狀態。

返回：成功

id

字符串

replicationSession 实例的唯一标识符。

返回：成功

lastSyncTime

字符串

上次复制同步的日期和时间。

返回：成功

maxTimeOutOfSync

整数

系统同步源资源和目标资源之前等待的最长时间。

返回：成功

name

字符串

用户指定的复制会话名称。

返回：成功

networkStatus

字符串

复制会话使用的网络连接状态。

返回：成功

remoteSystem

字典

指定用作复制会话目标的远程系统。

返回：成功

UnityRemoteSystem

字典

远程存储系统信息。

返回：成功

id

字符串

远程系统实例的唯一标识符。

返回：成功

serialNumber

字符串

远程系统的序列号。

返回：成功

replicationResourceType

字符串

复制会话端点的复制资源类型。

返回：成功

srcStatus

字符串

会话源端的狀態。

返回：成功

status

字符串

复制会话的复制状态。

返回：成功

syncProgress

整数

复制会话的源资源和目标资源之间的同步完成百分比。

返回：成功

syncState

字符串

复制会话的源资源和目标资源之间的同步状态。

返回：成功

作者

  • Jennifer John (@Jennifer-John)