ETERNUS SF Express V14.1 User's Guide

C.1.25 acec query (Status display command for Clone(EC) type or Remote Advanced Copy)

NAME

acec query - Displays the status of Clone(EC) type Advanced Copy or Remote Advanced Copy.

SYNOPSIS

acec query -g COPY-GROUP [-p PAIR] [-progress] [-r] [-xml]

DESCRIPTION

This command displays the status of the Clone(EC) type Advanced Copy or Remote Advanced Copy for the specified copy group or copy pair.
Please make sure to specify the "query" subcommand.

OPTIONS

-g COPY-GROUP

This option specifies the copy group name.

-p PAIR

This option specifies a copy pair.

-progress

Displays the progress of copy processes.

-r

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

-xml

This option specifies when displaying by the XML format.

EXIT STATUS

=0: Completed successfully

>0: Terminated abnormally

EXAMPLES

• For EC

  • When the -progress option is not specified:

    C:\>acec query -g ECGroup
    
    Copy Group Name : ECGroup
    Copy Group Type : EC
    Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)
    
    Source   <=> Target   SID  EC Status               Copy Phase Copied Block
    -------- --- -------- ---- ----------------------- ---------- ------------
    DX80/0x1 N/A DX80/0x3 N/A  "EC action not startup" "Not set"             0
    DX80/0x2 ==> DX80/0x4 0x41 "EC Executing"          "Copying"       1048576
    

    The following table shows the meanings of the information displayed.

    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 ETERNUS name that was specified the "-a" option of the acgroup create (Copy group creation command).
    Source	Displays the logical volume for the copy source.
    <=>	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.
    SID	Displays the session ID.
    EC Status	Displays the execution status of the EC. EC Starting: The EC is starting up. EC Executing: The EC is executing. EC Suspend: The EC is suspended. EC action not startup: The specified session does not exist. EC Error Suspend: An error has occurred, preventing the copy process from continuing.
    Copy Phase	Displays the current phase. Copying: Copy processing is executing. Paired: The copy is in an equivalency maintenance state. Not set: Either the specified session does not exist, or the copy process is not running.
    Copied Block	Displays the number of blocks that have been copied.

  • When the -progress option is specified:

    C:\>acec query -g ECGroup -progress
    
    Copy Group Name : ECGroup
    Copy Group Type : EC
    Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)
    
    Source   <=> Target   Progress Copied Block Total Block
    -------- --- -------- -------- ------------ -----------
    DX80/0x1 N/A DX80/0x3      N/A          N/A         N/A
    DX80/0x2 ==> DX80/0x4      45%       471859     1048576
    

    The following table shows the meanings of the information displayed.

    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 ETERNUS name that was specified the "-a" option of the acgroup create (Copy group creation command).
    Source	Displays the logical volume for the copy source.
    <=>	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.
    Progress	Displays the progress of copy processes as a percentage. The "N/A" is displayed when the copy process is not executed.
    Copied Block	Displays the number of blocks that have been copied. The "N/A" is displayed when the copy process is not executed.
    Total Block	Displays the number of total blocks.

• For REC

  • When the -progress option is not specified:

    C:\>acec query -g RECGroup
    
    Copy Group Name        : RECGroup
    Copy Group Type        : REC
    Disk Array Name        : DX90P (00ETERNUSDXL##ET09E24AG###NP4310901018##)
    Remote Disk Array Name : DX90S (00ETERNUSDXL##ET09E24AG###NP4310901019##)
    
    Source    <=> Target    SID(RSID)  EC Status               Copy Phase Copied Block Rcv  Split Xfer
    --------- --- --------- ---------- ----------------------- ---------- ------------ ---- ----- -------
    DX90P/0x1 N/A DX90S/0x6 N/A        "EC action not startup" "Not set"             0 ---- ----  ----
    DX90P/0x2 ==> DX90S/0x7 0x4A(0x11) "EC Executing"          "Copying"             0 auto ----  through
    DX90P/0x3 ==> DX90S/0x8 0x4C(0x13) "EC Suspend"            "Paired"        1048576 auto ----  through
    

    The following table shows the meanings of the information displayed.

    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 ETERNUS name that was specified with the "-a" option of the acgroup create (Copy group creation command).
    Remote Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-remote" option of the acgroup create (Copy group creation command).
    Source	Displays the logical volume for the copy source.
    <=>	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.
    SID(RSID)	Displays the Session ID of the ETERNUS Disk storage system (i.e. the Disk Array Name) and the Session ID of the Remote ETERNUS Disk storage system (i.e. the Remote Disk Array Name).
    EC Status	Displays the execution status of the EC. EC Starting: The EC is starting up. EC Executing: The EC is executing. EC Suspend: The EC is suspended EC action not startup: The specified session does not exist. EC Error Suspend: An error has occurred, preventing the copy process from continuing. EC Hardware Suspend: The EC has paused because of a hardware error, such as a problem with the path between hardware devices.
    Copy Phase	Displays the current phase. Copying: Copy processing is executing. Paired: The copy is in an equivalency maintenance state. Not set: Either the specified session does not exist, or the copy process is not running.
    Copied Block	Displays the number of blocks that have been copied.
    Rcv	Displays the recovery mode for REC copies. auto: Indicates that the recovery mode is "Automatic". manual: Indicates that the recovery mode is "Manual". ----: Indicates that a REC copy is not being performed.
    Split	Displays the split mode for REC copies. auto: Indicates that the split mode is "Automatic". manual: Indicates that the split mode is "Manual". ----: Indicates that either a REC copy is not being performed or that the mode is not synchronous mode.
    Xfer	Displays the transfer mode for REC copies. sync: Indicates that the transfer mode is "synchronous". through: Indicates that the transfer mode is "through". consist: Indicates that the transfer mode is "consistency". stack: Indicates that the transfer mode is "stack". ----: a REC copy is not being performed.

  • When the -progress option is specified:

    C:\>acec query -g RECGroup -progress
    
    Copy Group Name        : RECGroup
    Copy Group Type        : REC
    Disk Array Name        : DX90P (00ETERNUSDXL##ET09E24AG###NP4310901018##)
    Remote Disk Array Name : DX90S (00ETERNUSDXL##ET09E24AG###NP4310901019##)
    
    Source    <=> Target    Progress Copied Block Total Block
    --------- --- --------- -------- ------------ -----------
    DX90P/0x1 N/A DX90S/0x6      N/A          N/A         N/A
    DX90P/0x2 ==> DX90S/0x7      45%       471859     1048576
    DX90P/0x3 ==> DX90S/0x8     100%      1048576     1048576
    

    The following table shows the meanings of the information displayed.

    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 ETERNUS name that was specified with the "-a" option of the acgroup create (Copy group creation command).
    Remote Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-remote" option of the acgroup create (Copy group creation command).
    Source	Displays the logical volume for the copy source.
    <=>	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.
    Progress	Displays the progress of copy processes as a percentage. The "N/A" is displayed when the copy process is not executed.
    Copied Block	Displays the number of blocks that have been copied. The "N/A" is displayed when the copy process is not executed.
    Total Block	Displays the number of total blocks.

NOTES

• Information such as Copy direction data and SID data may display as "???".

  It is possible that the access path is incorrect. Therefore, check it using the acarray detail (Command for displaying detailed information about ETERNUS Disk storage systems).

  For details on how to correctly set the access path, refer to "6.4.1.2 Access Path Settings".

• If the copy type of a copy group is OPC, QuickOPC or SnapOPCP, the command ends abnormally.