4.6.2 acopc query (OPC/QuickOPC Copy Status Display Command)

NAME

acopc query - Display the copy status of OPC or QuickOPC

SYNOPSIS

acopc query -g copyGroup [-p copyPair] [-r] [-progress] [-date] [-xml]
acopc query -g copyGroup [-p copyPair] [-r] -all [-xml]

DESCRIPTION

This command displays the copy status of the OPC or QuickOPC for the specified copy group or copy pair.
When the Storage Cluster Continuous Copy function is used, this command displays the copy status of both the Primary Storage and Secondary Storage.

OPTIONS

-g copyGroup: This option specifies the copy group name.

-p copyPair

This option specifies a copy pair.
When the Storage Cluster Continuous Copy function is used, specify either the Primary Storage or Secondary Storage copy pair. The ETERNUS Disk storage system that is the Storage Cluster pair is automatically retrieved from the specified copy pair and the copy status of both the Primary Storage and Secondary Storage is displayed.

When specifying with the LU to Partition format or the Partition to LU format, you must enclose the entire argument for this option within double quotations (") depending on the shell being used.

-r: This option displays the status of a copy in the reverse direction to the direction that has been specified.

-progress: This option displays the progress of copy processes.

-date: This option displays the last execution date of OPC or QuickOPC for the copy pair.

-all: This option specifies the displaying by the extended format.
Refer to the table of EXAMPLES for the displayed items.

-xml: This option specifies when displaying by the XML format.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

For OPC (When the Storage Cluster Continuous Copy function is not used)

When the -progress and -date options are not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"             0
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying"       1048576

When the -progress option is specified:

> acopc query -g Group01 -progress

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    Progress Copied Block Total Block
--------- --- --------- -------- ------------ -----------
ET001/0x1 ==> ET001/0x3       0%            0     1048576
ET001/0x2 ==> ET001/0x4      45%      1048576     2330168

When the -date option is specified:

> acopc query -g Group01 -date

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block Operation Date
--------- --- --------- ---- --------------- ---------- ------------ ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"             0 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying"       1048576 "2010/10/20 09:00:00"

When the -progress and -date options are specified, or the -all option is specified:

> acopc query -g Group01 -progress -date

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Progress Copied Block Total Block Operation Date
--------- --- --------- ---- --------------- ---------- -------- ------------ ----------- ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"        0%            0     1048576 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying"       45%      1048576     2330168 "2010/10/20 09:00:00"

For QuickOPC (When the Storage Cluster Continuous Copy function is not used)

When the -progress and -date options are not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Tracking"      1048576
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Tracking"      1048576

When the -progress option is specified:

> acopc query -g Group01 -progress

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    Progress Copied Block Total Block
--------- --- --------- -------- ------------ -----------
ET001/0x1 ==> ET001/0x3       0%            0     1048576
ET001/0x2 ==> ET001/0x4      45%       471859     1048576

When the -date option is specified:

> acopc query -g Group01 -date

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase         Copied Block Operation Date
--------- --- --------- ---- --------------- ------------------ ------------ ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying/Tracking"            0 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying/Tracking"      1048576 "2010/10/20 09:00:00"

When the -progress and -date options are specified, or the -all option is specified:

> acopc query -g Group01 -progress -date

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase         Progress Copied Block Total Block Operation Date
--------- --- --------- ---- --------------- ------------------ -------- ------------ ----------- ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying/Tracking"       0%            0     1048576 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying/Tracking"      45%      1048576     2330168 "2010/10/20 09:00:00"

For OPC using the Storage Cluster Continuous Copy function

When the -progress and -date options are not specified:

> acopc query -g Group01
Copy Group Name     : Group01
Copy Group Type     : OPC
Disk Array Name     : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)
TFO Disk Array Name : ET002 (00ETERNUSDXH##ET87S20A####NC4110699004##)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block Standby-Source Standby-Target Standby-Session
--------- --- --------- ---- --------------- ---------- ------------ -------------- -------------- ---------------
ET001/0x1 ==> ET001/0x6 0x21 "OPC Executing" "Copying"             0 ET002/0x1      ET002/0x11     "Exist"
ET001/0x2 ==> ET001/0x7 0x22 "OPC Executing" "Copying"       1048576 ET002/0x2      ET002/0x12     "Not-Exist"

The following table shows the meanings of the information displayed.

Table 4.1 When -progress and -date Options Are Not Specified
Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -a option for the acgroup create command.
TFO Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -tfoa option for the acgroup create command.
Source	Displays the logical volume for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Active" is displayed.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target. <==: Copying from the target to the source.
Target	Displays the logical volume for the copy destination. If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Active" is displayed.
SID	Displays the session ID for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source session ID of the storage device where the TFO status is "Active" is displayed.
OPC Status	Displays the execution status of the OPC. If the Storage Cluster Continuous Copy function is used, the OPC execution status of the storage device where the TFO status is "Active" is displayed. OPC Starting: The OPC is starting up. OPC Executing: The OPC is executing. OPC action not startup: The specified session does not exist. OPC Error Suspend: An error has occurred, preventing the copy process from continuing.
Copy Phase	Displays the current phase. If the Storage Cluster Continuous Copy function is used, the phase of the storage device where the TFO status is "Active" is displayed. Readying: Concurrent OPC is defined. Copying: Copy processing is executing. Tracking: Copy processing has completed, and tracking is in progress. Copying/Tracking: Both copy processing and tracking are in progress. Not set: Copy processing has not been performed.
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. If the Storage Cluster Continuous Copy function is used, the number of blocks of the storage device where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Standby-Source	If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Target	If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Session	If the Storage Cluster Continuous Copy function is used, the Standby-Side Continuous Copy Session status is displayed. Exist: A Standby-Side Continuous Copy Session exists. Not-Exist: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session exists) ----: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session also does not exist) ???: The Standby-Side Continuous Copy Session status is unknown.

Table 4.2 When -progress Option Is Specified
Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -a option for the acgroup create command.
TFO Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -tfoa option for the acgroup create command.
Source	Displays the logical volume for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Active" is displayed.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target <==: Copying from the target to the source
Target	Displays the logical volume for the copy destination. If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Active" is displayed.
Progress	Displays the progress of copy processes as a percentage. If the Storage Cluster Continuous Copy function is used, the replication progress rate of the ETERNUS Disk storage system where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the progress of copy processes is unknown, it is displayed "???".
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. If the Storage Cluster Continuous Copy function is used, the number of blocks of the storage device where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Total Block	Displays the number of total blocks. If the Storage Cluster Continuous Copy function is used, the number of total blocks of the storage device where the TFO status is "Active" is displayed. If the number of total blocks is unknown, it is displayed "???".
Standby-Source	If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Target	If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Session	If the Storage Cluster Continuous Copy function is used, the Standby-Side Continuous Copy Session status is displayed. Exist: A Standby-Side Continuous Copy Session exists. Not-Exist: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session exists) ----: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session also does not exist) ???: The Standby-Side Continuous Copy Session status is unknown.

Table 4.3 When -date Option Is Specified
Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -a option for the acgroup create command.
TFO Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -tfoa option for the acgroup create command.
Source	Displays the logical volume for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Active" is displayed.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target <==: Copying from the target to the source
Target	Displays the logical volume for the copy destination. If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Active" is displayed.
SID	Displays the session ID for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source session ID of the storage device where the TFO status is "Active" is displayed.
OPC Status	Displays the execution status of the OPC. If the Storage Cluster Continuous Copy function is used, the OPC execution status of the storage device where the TFO status is "Active" is displayed. OPC Starting: The OPC is starting up. OPC Executing: The OPC is executing. OPC action not startup: The specified session does not exist. OPC Error Suspend: An error has occurred, preventing the copy process from continuing.
Copy Phase	Displays the current phase. If the Storage Cluster Continuous Copy function is used, the phase of the storage device where the TFO status is "Active" is displayed. Readying: Concurrent OPC is defined. Copying: Copy processing is executing. Tracking: Copy processing has completed, and tracking is in progress. Copying/Tracking: Both copy processing and tracking are in progress. Not set: Copy processing has not been performed.
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. If the Storage Cluster Continuous Copy function is used, the number of blocks of the storage device where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Operation Date	If an OPC session exists, it displays the date for when the OPC session state transitions indicated below last occurred (last execution date) in a "yyyy/mm/dd hh:mm:ss" format. The displaying of the date is performed on the basis of the target device's time zone. If the Storage Cluster Continuous Copy function is used, the date and time of storage device where the TFO status is "Active" is displayed. Starting logical copy (execution of acopc start or acopc start -diff) State transitions to error suspend (OPC Status column displays "OPC Error Suspend") If any of the following conditions apply, the date is displayed as "----/--/-- --:--:--." If an OPC session does not exist (OPC Status column displays "OPC action not startup") If the OPC session's copy status could not be acquired from the device (OPC Status column displays "???") If using a device for which the last execution date recording function is not supported (ETERNUS DX60 S2)
Standby-Source	If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Target	If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Session	If the Storage Cluster Continuous Copy function is used, the Standby-Side Continuous Copy Session status is displayed. Exist: A Standby-Side Continuous Copy Session exists. Not-Exist: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session exists) ----: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session also does not exist) ???: The Standby-Side Continuous Copy Session status is unknown.

Table 4.4 When -progress and -date Options Are Specified, or -all Option Is Specified
Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -a option for the acgroup create command.
TFO Disk Array Name	Displays the Box ID and the ETERNUS name that was specified with the -tfoa option for the acgroup create command.
Source	Displays the logical volume for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Active" is displayed.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target <==: Copying from the target to the source
Target	Displays the logical volume for the copy destination. If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Active" is displayed.
SID	Displays the session ID for the copy source. If the Storage Cluster Continuous Copy function is used, the copy source session ID of the storage device where the TFO status is "Active" is displayed.
OPC Status	Displays the execution status of the OPC. If the Storage Cluster Continuous Copy function is used, the OPC execution status of the storage device where the TFO status is "Active" is displayed. OPC Starting: The OPC is starting up. OPC Executing: The OPC is executing. OPC action not startup: The specified session does not exist. OPC Error Suspend: An error has occurred, preventing the copy process from continuing.
Copy Phase	Displays the current phase. If the Storage Cluster Continuous Copy function is used, the phase of the storage device where the TFO status is "Active" is displayed. Readying: Concurrent OPC is defined. Copying: Copy processing is executing. Tracking: Copy processing has completed, and tracking is in progress. Copying/Tracking: Both copy processing and tracking are in progress. Not set: Copy processing has not been performed.
Progress	Displays the progress of copy processes as a percentage. If the Storage Cluster Continuous Copy function is used, the replication progress rate of the ETERNUS Disk storage system where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the progress of copy processes is unknown, it is displayed "???".
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. If the Storage Cluster Continuous Copy function is used, the number of blocks of the storage device where the TFO status is "Active" is displayed. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Total Block	Displays the number of total blocks. If the Storage Cluster Continuous Copy function is used, the number of total blocks of the storage device where the TFO status is "Active" is displayed. If the number of total blocks is unknown, it is displayed "???".
Operation Date	If an OPC session exists, it displays the date for when the OPC session state transitions indicated below last occurred (last execution date) in a "yyyy/mm/dd hh:mm:ss" format. The displaying of the date is performed on the basis of the target device's time zone. If the Storage Cluster Continuous Copy function is used, the date and time of storage device where the TFO status is "Active" is displayed. Starting logical copy (execution of acopc start or acopc start -diff) State transitions to error suspend (OPC Status column displays "OPC Error Suspend") If any of the following conditions apply, the date is displayed as "----/--/-- --:--:--." If an OPC session does not exist (OPC Status column displays "OPC action not startup") If the OPC session's copy status could not be acquired from the device (OPC Status column displays "???") If using a device for which the last execution date recording function is not supported (ETERNUS DX60 S2)
Standby-Source	If the Storage Cluster Continuous Copy function is used, the copy source logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Target	If the Storage Cluster Continuous Copy function is used, the copy destination logical volume of the storage device where the TFO status is "Standby" is displayed.
Standby-Session	If the Storage Cluster Continuous Copy function is used, the Standby-Side Continuous Copy Session status is displayed, Exist: A Standby-Side Continuous Copy Session exists. Not-Exist: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session exists) ----: A Standby-Side Continuous Copy Session does not exist. (An Active-Side Continuous Copy Session also does not exist) ???: The Standby-Side Continuous Copy Session status is unknown.

NOTES

When the copy type of copy group is EC, REC or SnapOPCP, this command cannot be executed.
Information such as Copy direction data and SID data may display as "???". Refer to "5.3 Resolving for Displaying "???" in Advanced Copy Status" and take action.
The copying progress for OPC and QuickOPC may not reach 100% due to such things as data updates to the copy source.
If Copy Phase column is either of the following, the copying is complete.
- Not Set (when the copy type is OPC)
- Tracking (when the copy type is QuickOPC)
When the Storage Cluster Continuous Copy function is used, it may be necessary to take measures, depending on the content displayed in the Standby-Session column.
- For "Not-Exist":
  Refer to "3.12.11 When Recovering Storage Cluster Continuous Copy Function".
- Other than those above:
  No action is required.