API Doc
Search Docs...
⌘ K
OverviewDeploymentManagementOperationReferenceGlossary

Viewing CDP tasks

Viewing the CDP task list

Viewing all CDP tasks

Procedure

Run the following command on any node in the cluster:

zbs-cdp job list [options]

Parameter description

ParameterDescription
--group <GROUP>Optional. Specifies a group name for filtering.
-v / --version <VER>Optional. Specifies the CDP protocol version (v1 or v2).

Output example

zbs-cdp job list
Version    ID                                    Group                                            Stage    Compress    No Full Copy      CID  Local volume                          Remote volume                         Remote Addr               CDPJobOption    ERROR
---------  ------------------------------------  -----------------------------------------------  -------  ----------  --------------  -----  ------------------------------------  ------------------------------------  ------------------------  --------------  -------
v2         c791e4e2-e4d4-4e97-8636-bcc84cc76c85  example                                          MIRROR   False       False               1  2ea55379-34dc-4b36-a4bd-6027b5d1f8b2  e9fbfd57-8ac2-4908-b44d-e8f0bfe2b89b  10.10.130.31:10201:10206                  None
v2         322ee53b-ab96-4367-873c-f8b0fbd296f1  example                                          MIRROR   False       False               1  3af41af7-db61-425a-91ed-1e366f7404b9  da2f5f67-a3a1-4b24-bc5d-132e337dc1c8  10.10.130.31:10201:10206                  None
v2         e5fc0fbe-bdae-4f4d-a943-b465b928c91d  cmjjmxbzp15w701udccy464wr-6c9dc8b557-78f766f5c4  MIRROR   False       True                4  d971646c-d470-46cb-9dff-32cd0cfff5d2  77215d42-d068-4582-9e82-0b6c0c192ba9  10.10.130.31:10201:10206                  None
v2         e4c47df1-012d-4a72-a424-1a34818fd905  cmjjmxbzp15w701udccy464wr-6c9dc8b557-78f766f5c4  MIRROR   False       True                4  46b9fea1-3aee-4121-8fbc-270ae577f7f8  b7aaa2e8-0d52-4a11-a97a-d5ac420e025a  10.10.130.31:10201:10206                  None

Output note

After successful execution, all qualified CDP tasks will be listed. For field descriptions, refer to the output note in Creating a single CDP task.

Viewing local CDP tasks

Procedure

Run the following command on any node in the cluster:

zbs-cdp job list_local [options]

Parameter description

ParameterDescription
--group <GROUP>Optional. Specifies a group name for filtering.
--chunk_ip <IP>Optional. Specifies the IP address of the chunk node.
--chunk_port <PORT>Optional. Specifies the port of the chunk node.
-v / --version <VER>Optional. Specifies the CDP protocol version (v1 or v2).

Output example

zbs-cdp job list_local
Version    ID                                    Group    Stage    Compress    No Full Copy      CID  Local volume                          Remote volume                         Remote Addr               CDPJobOption    ERROR
---------  ------------------------------------  -------  -------  ----------  --------------  -----  ------------------------------------  ------------------------------------  ------------------------  --------------  -------
v2         322ee53b-ab96-4367-873c-f8b0fbd296f1  example  MIRROR   False       False               0  3af41af7-db61-425a-91ed-1e366f7404b9  da2f5f67-a3a1-4b24-bc5d-132e337dc1c8  10.10.130.31:10201:10206                  None

Output note

After successful execution, all CDP tasks running on the local nodes will be listed. For field descriptions, refer to the output note in Creating a single CDP task.

Viewing the details of a CDP task

Viewing task details

Procedure

Run the following command on any node in the cluster:

  • View by the task ID:

    zbs-cdp job show <id> [options]
  • View by the local volume ID:

    zbs-cdp job show_by_volume <volume_id> [options]

Parameter description

ParameterDescription
idThe task ID.
volume_idThe local volume ID.
--show_sync_point_tasksOptional. Specifies whether to display the synchronization point task details of the task.
-v / --version <VER>Optional. Specifies the CDP protocol version (v1 or v2).

Output example

-------------  ------------------------------------
Version        v2
ID             c7312eda-e462-41bf-860f-ebc61571ae2e
Group          example
Stage          MIRROR
Compress       False
No Full Copy   False
CID            1
Local volume   be09dd2c-325d-406c-b772-bcb36d3991fd
Remote volume  6c786d90-1857-4423-a655-0f268622aea0
Remote Addr    10.10.130.31:10201:10206
CDPJobOption
ERROR          None
-------------  ------------------------------------

========== CURRENT SYNC POINT TASK ==========
ID: bd9268c3-512d-4191-99fa-6b3a46543029 -> 3515af1e-56b8-46e0-bb95-eebc2148dc0c
Name: test_sp_20251226_141434_r1_1 -> test_sp_20251226_141434_r1_1
Secondary ID:  ->

========== SYNC POINT TASKS ==========
Stage    Src Snapshot                  Src ID                                Src Secondary ID    Remote Snapshot               Remote ID                             Remote Secondary ID    ERROR
-------  ----------------------------  ------------------------------------  ------------------  ----------------------------  ------------------------------------  ---------------------  -------
DONE     test_sp_20251226_141434_r1_1  bd9268c3-512d-4191-99fa-6b3a46543029  None                test_sp_20251226_141434_r1_1  3515af1e-56b8-46e0-bb95-eebc2148dc0c  None                   None

Output note

After successful execution, the task details will be displayed. For basic field descriptions, refer to the output note in Creating a single CDP task.

If --show_sync_point_tasks is specified, the synchronization point task information is also displayed:

  • CURRENT SYNC POINT TASK field description

    FieldDescription
    IDMapping from the local snapshot ID to the remote snapshot ID.
    NameMapping from the local snapshot name to the remote snapshot name.
    Secondary IDMapping from the local secondary snapshot ID to the remote secondary snapshot ID.
  • SYNC POINT TASKS list field description

    FieldDescription
    StageThe stage of the synchronization point task (e.g., DONE, ERROR, etc.).
    Src SnapshotThe local snapshot name.
    Src IDThe local snapshot ID.
    Src Secondary IDThe local secondary snapshot ID.
    Remote SnapshotThe remote snapshot name.
    Remote IDThe remote snapshot ID.
    Remote Secondary IDThe remote secondary snapshot ID.
    ERRORThe error message.

Viewing local task details

Procedure

Run the following command on any node in the cluster:

zbs-cdp job show_local <id> [options]

Parameter description

ParameterDescription
idThe task ID.
--chunk_ip <IP>Optional. Specifies the IP address of the chunk node.
--chunk_port <PORT>Optional. Specifies the port of the chunk node.
--show_sync_point_tasksOptional. Specifies whether to display the synchronization point task details of the task.
-v / --version <VER>Optional. Specifies the CDP protocol version (v1 or v2).

Output example

zbs-cdp job show_local c0bb7d91-e74b-434c-98e2-00c57e8bb93f
-------------  ------------------------------------
Version        v2
ID             c0bb7d91-e74b-434c-98e2-00c57e8bb93f
Group          cdp-test
Stage          MIRROR
Compress       False
No Full Copy   False
CID            1
Local volume   babbe516-4b44-4651-a0a5-eeb36a6a6e0d
Remote volume  0b5cb6fc-11cf-4770-8109-28d3435c03b5
Remote Addr    10.88.67.95:10201:10206
ERROR          None
-------------  ------------------------------------

------------------  ----------
Total Read          10.00 GB
Total Write         8.50 GB
Total Read Latency  150.00 ms
Total Write Latency 120.00 ms
Total Read Times    1024
Total Write Times   800
Avg Read Latency    0.15 ms
Avg Write Latency   0.15 ms
Read Throughput     100.00 MB/s
Write Throughput    85.00 MB/s
------------------  ----------

Output note

After successful execution, the local task details and performance statistics will be displayed.

For basic field descriptions, refer to the output note in Creating a single CDP task.

Performance statistics fields are explained as follows:

FieldDescription
Total ReadThe total amount of data read.
Total WriteThe total amount of data written.
Total Read LatencyThe total read latency.
Total Write LatencyThe total write latency.
Total Read TimesThe total number of read operations.
Total Write TimesThe total number of write operations.
Avg Read LatencyThe average read latency.
Avg Write LatencyThe average write latency.
Read ThroughputThe read throughput.
Write ThroughputThe write throughput.