NAME
accopy query - Display copy session information
SYNOPSIS
To display copy session information by device unit
accopy query -a diskArrayName -type {local | remote | odx | vvol | all} [-tfoinfo] [-xml]
To display REC session information
accopy query -a diskArrayName -sa srcDiskArrayName -ta dstDiskArrayName [-xml]
DESCRIPTION
This command displays the status of the copy sessions being performed in the specified ETERNUS Disk storage system.
This command also targets the copy sessions that are started by software other than AdvancedCopy Manager.
OPTIONS
This option specifies the name of ETERNUS Disk storage system for which the execution status of copy sessions is displayed.
This option specifies the type of copy sessions to display.
local: Displays only OPC, QuickOPC, EC, SnapOPC, SnapOPC+, monitor sessions, and Extended Copy.
remote: Displays only REC sessions.
odx: Displays ODX.
vvol: Displays VVOL sessions.
all: Displays all sessions.
This option is specified when displaying information about the Storage Cluster Continuous Copy function.
Refer to the EXAMPLES table for items displayed when this option is specified.
This option specifies the display of information for all REC sessions set up from the device specified with the -sa option towards the device specified with the -ta option.
Either srcDiskArrayName or dstDiskArrayName must match with the ETERNUS name specified to the -a option.
If specifying a device other than a management device for AdvancedCopy Manager CCM or Express, specify the Box ID (40 characters) instead of the ETERNUS name of AdvancedCopy Manager CCM or Express.
This option specifies when displaying by the XML format.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Displaying the information of copy sessions in storage device units
> accopy query -a ET001 Disk Array Name : ET001 BOX-ID : 00ETERNUSDXM##ET44S20A####HK000104###### Source <=> Target SID(RSID) Copy Type Copy Status Copy Phase Progress Copied Block Total Block Operation Date ------------------------------------ --- --------------------- ---------- --------- ----------- ---------- -------- ------------ ----------- --------------------- ET001/0x1 ==> ET001/0x3 0x19(----) OPC "Executing" Copying N/A 471859 N/A "2010/10/20 09:02:03" ET001/0x2[addr=0x800,size=0xC800000] ==> ET001/0x4[addr=0x800] 0x22(----) EC "Executing" Copying 68% 142606336 209715200 "2010/10/20 10:23:30" ET001/0x5 ==> ET001/0x6 0x24(----) SnapOPCP "Executing" Copying N/A 524288 N/A "2010/10/20 11:45:34" ET001/0x7[addr=0x3F,size=0x1400000] ==> ET001/0x8[addr=0x7F] 0x35(----) SnapOPCP "Executing" Copying N/A 20971520 20971520 "2010/10/19 12:00:45" ET002/0x9 ==> ET001/0x9 0x48(0x42) REC "Executing" Paired N/A 4294967295 N/A "2010/10/20 03:35:03" ET001/0xA[addr=0x3F,size=0x7FFFFFC0] ==> ---- 0x88(----) Estimate "Executing" Copying N/A 3456777 2147483584 "2010/10/20 10:30:03" ET001/0xB ==> ET001/0xC 0x92(----) QuickOPC "Executing" Readying N/A 0 N/A "----/--/-- --:--:--" ET001/0xD[addr=0x3F,size=0x1400000] ==> ET001/0xE[addr=0x7F] 0x19(----) Xcopy "Executing" Copying N/A 512 N/A "2010/10/20 10:02:03"
Displaying the information of REC copy sessions
> accopy query -a ET001 -sa ET002 -ta ET001 Disk Array Name : ET001 BOX-ID : 00ETERNUSDXM##ET44S20A####HK000104###### Source <=> Target SID(RSID) Copy Type Copy Status Copy Phase Progress Copied Block Total Block Operation Date --------- --- --------- ---------- --------- ----------- ---------- -------- ------------ ----------- --------------------- ET002/0x9 ==> ET001/0x9 0x48(0x42) REC "Executing" Paired N/A 4294967295 N/A "2010/10/20 03:35:03"
Displaying the copy session information in device units specified with the -tfoinfo option
> accopy query -a ET001 -type all -tfoinfo Disk Array Name : ET001 BOX-ID : 00ETERNUSDXM##ET44S20A####HK000104###### Source <=> Target SID(RSID) Copy Type Copy Status Copy Phase Progress Copied Block Total Block Operation Date Active/Standby TFO Info ---------- --- ---------- ---------- --------- ----------- ---------- -------- ------------ ----------- --------------------- -------------- -------- ET001/0x1 ==> ET001/0x6 0x11(----) QuickOPC "Executing" Copying N/A 471859 N/A "2014/07/24 18:31:12" Active normal ET001/0x2 ==> ET001/0x7 0x21(----) EC "Executing" Copying 68% 209715200 N/A "2014/07/24 18:31:22" Active normal ET001/0x3 ==> ET001/0x8 0x31(----) OPC "Executing" Copying N/A 142606336 N/A "2014/07/24 18:31:32" ---- ---- ET001/0x11 ==> ET001/0x16 0x12(----) QuickOPC "Executing" Copying N/A 3456777 N/A "2014/07/24 18:31:12" Standby unpaired ET001/0x14 ==> ET001/0x19 0x42(----) QuickOPC "Executing" Copying N/A 142606336 N/A "2014/07/24 18:31:12" Standby unpaired
The following table shows the meanings of the information displayed.
Title | Explanation |
---|---|
Source | Displays the logical volume for the copy source.
The logical volume number, copy start location and copy size are displayed in hexadecimal. |
<=> | Displays the copy direction.
|
Target | Displays the logical volume for the copy destination.
The logical volume number, copy start location and copy size are displayed in hexadecimal. When Copy Type column is "Estimate", "----" is displayed. |
SID(RSID) | Displays the session ID, REC session ID, and VVOL session ID in "x(y)" format.
|
Copy Type | Displays the copy type.
|
Copy Status | Displays the copy execution status.
"EC Hardware suspend (Use REC DISK)" and "EC Hardware suspend (Use REC BUFFER)" is displayed in the following circumstance.
|
Copy Phase | Displays the current phase.
|
Progress | Displays the progress of copy processes as a percentage. The "N/A" is displayed in the following case.
|
Copied Block | Displays the number of blocks that have been copied. |
Total Block | Displays the number of total blocks. |
Operation Date | If a copy session exists, it displays the date for when the EC session state transitions indicated below last occurred (last execution date) in a "yyyy/mm/dd hh:mm:ss" format.
If any of the following conditions apply, the date is displayed as "----/--/-- --:--:--."
|
Active/Standby | This is displayed when the -tfoinfo option is specified.
|
TFO Info | This is displayed when the -tfoinfo option is specified.
|
NOTES
If the information acquisition operation has failed, this command outputs the following message and then terminates with an error.
ccm5004 Operation failed. function=stxccopy.QUERY, message=message
It is possible that the access volume is incorrect. Therefore, check it using the acarray detail command and check that the CCM Server can access to the access volume.
If inaccessible, set up a volume for which access is possible by using the acarray change command.
For the Source and Target, either of the following information is displayed.
ETERNUS name
If using a device registered to AdvancedCopy Manager CCM or Express
Box ID
If using a device not registered to AdvancedCopy Manager CCM or Express.
There are cases of [***Other-Storage***] being displayed for the Source or Target column. If, after specifying the device which is correctly displayed and executing the acarray remove command, one then re-executes the acarray add command, both ETERNUS names are correctly displayed.
In the following VVOL sessions, the progress of copy processes may not reach 100 % depending on the data update status.
VVOL-Snapshot
VVOL-Fastclone