volume rebalance file-move show

Description​

The volume rebalance file-move show command displays a list of files being moved between the FlexGroup Constituents.

The volume rebalance file-move show command is only supported on FlexGroup volumes. The command displays information about each ongoing file-move operation, as well as any file-move operations that have completed, failed or have been cancelled within the last two minutes. For all file-move operations matching the specified parameters, the command displays the following information:

• Vserver name
• Volume name
• File Path
• Source Constituent Volume
• Destination Constituent Volume
• Current status of the file-move operation ("Preparing", "Data-Transfer", "Paused", "Complete", "Failed" or "Terminated-Manual")
• Percentage of total data bytes transferred to the destination

To display detailed information about each file-move operation, run the command with the -instance parameter. The detailed view provides the following information:

• Vserver Name
• Volume Name
• Destination Constituent Volume
• Source Constituent Volume
• Destination Constituent Node
• Source Constituent Node
• Operation Status: Current status of the file-move operation ("Preparing", "Data-Transfer", "Paused", "Complete", "Failed" or "Terminated-Manual")
• Scanner Progress Percentage
• Operation UUID: UUID of the overall file-move operation
• Source Operation UUID: UUID used to identify the file-move operation on the source constituent
• File Path: Path of the file being moved
• Source Constituent Master Data Set ID
• Source Constituent Data Set ID
• Source File ID: ID of the inode on the source constituent
• Source Generation: Generation number of the inode on the source constituent
• Destination File ID: ID of the inode on the destination constituent
• Destination Data Set ID
• Destination Master Data Set ID
• Destination Generation: Generation number of the inode on the destination constituent
• Maximum Scanner Speed (per sec): Maximum throughput of the data scanner
• Scanner Paused: Displays information if the underlying data transfer scanner is paused
• Scanner Status: The current stage of the underlying data transfer scanner ("Preparing", "Allocation-Map", "Data", "Destroying", "Paused-Manual", "Paused-Error", "Complete", "Terminated-Manual" or "Destroyed")
• Scanner Progress: Number of bytes transferred
• Scanner Total: Total number of bytes to be transferred
• Data Scanner Priority: Priority of the data scanner assigned to the file-move operation (high or low)
• Elapsed Time
• Cutover Time: Time elapsed during the cutover stage of the file-move operation, in seconds
• Is Snapshot Fenced: Whether snapshots are fenced for the file-move operation
• Is Destination Ready: Whether the destination volume is ready for the file-move operation
• Last Failure Time
• Last Failure Reason

You can specify parameters from the above list to display information. For example, to display information only about paused operations, run the command with the -status Paused parameter.

Parameters​

{ [-fields <fieldname>, ...]

If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ]}

If this parameter is specified, the command displays the additional detailed information described above.

[-vserver <vserver name>] - Vserver Name

If this parameter and the -volume parameter are specified, the command displays the file-move operations on the specified volume. If this parameter is specified by itself, the command displays the file-move operations on all volumes on the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter and the -vserver parameter are specified, the command displays the file-move operations on the specified volume. If this parameter is specified by itself, the command displays the file-move operations on all volumes matching the specified name.

[-destination-constituent <volume name>] - Destination Constituent Volume

If this parameter is specified, the command displays only the file-move operations with the specified destination FlexGroup constituent name.

[-operation-uuid <UUID>] - Operation UUID

If this parameter is specified, the command displays only the file-move operation with the specified operation UUID.

[-destination-node <nodename>] - Destination Constituent Node

If this parameter is specified, the command displays only file-move operations for files being moved to the specified destination node.

[-destination-dsid <integer>] - Destination Constituent DSID

If this parameter is specified, the command displays only file-move operations with the specified destination volume data set ID.

[-source-constituent <volume name>] - Source Constituent Volume

If this parameter is specified, the command displays only file-move operations with the specified source FlexGroup constituent name.

[-source-operation-uuid <UUID>] - Source Operation UUID

If this parameter is specified, the command displays only the file-move operation with the specified internal source job operation UUID.

[-source-node <nodename>] - Source Constituent Node

If this parameter is specified, the command displays only file-move operations for files being moved from the specified source node.

[-source-dsid <integer>] - Source Constituent DSID

If this parameter is specified, the command displays only file-move operations with the specified source volume data set ID.

[-status {Preparing|Data-Transfer|Paused|Complete|Failed|Manually-Terminated}] - Operation Status

If this parameter is specified, the command displays only file-move operations with the specified status ("Preparing", "Data-Transfer", "Paused", "Complete", "Failed" or "Terminated-Manual").

[-scanner-percent <percent>] - Scanner Progress Percentage

If this parameter is specified, the command displays only file-move operations that have transferred the specified percentage of total bytes.

[-last-failure-reason <text>] - Last Failure Reason

If this parameter is specified, the command displays only file-move operations whose last failure reason matches the specified string.

[-path <text>] - File Path

If this parameter is specified, the command displays only file-move operations for files that match the specified path.

[-destination-msid <integer>] - Destination Constituent MSID

If this parameter is specified, the command displays only file-move operations with the specified destination volume master data set ID.

[-destination-fileid <integer>] - Destination Fileid

If this parameter is specified, the command displays only file-move operations pertaining to files with the specified file ID on the destination constituent.

[-destination-generation <integer>] - Destination Generation

If this parameter is specified, the command displays only file-move operations pertaining to files with the specified generation number on the destination constituent.

[-source-msid <integer>] - Source Constituent MSID

If this parameter is specified, the command displays only file-move operations with the specified source volume master data set ID.

[-source-fileid <integer>] - Source Fileid

If this parameter is specified, the command displays only file-move operations pertaining to files with the specified file ID on the source constituent.

[-source-generation <integer>] - Source Generation

If this parameter is specified, the command displays only file-move operations pertaining to files with the specified generation number on the source constituent.

[-max-throughput {<integer>[KB|MB|GB|TB|PB]}] - Maximum Scanner Speed (per sec)

If this parameter is specified, the command displays only file-move operations that use the specified value as the maximum scanner speed (in MB/s). This value does not represent a throughput the system will guarantee, but a limit that cannot be exceeded.

[-scanner-paused {true|false}] - Scanner Paused

If this parameter is specified, the command displays only file-move operations that are paused (true) or unpaused (false).

[-scanner-status {Preparing|Allocation-Map|Data|Destroying|Paused-Manual|Paused-Error|Complete|Destroyed|Terminated-Manual}] - Scanner Status

If this parameter is specified, the command displays only file-move operations in the specified scanner stage ("Preparing", "Allocation-Map", "Data", "Destroying", "Paused-Manual", "Paused-Error", "Complete", "Terminated-Manual" or "Destroyed")

[-scanner-progress {<integer>[KB|MB|GB|TB|PB]}] - Scanner Progress

If this parameter is specified, the command displays only file-move operations that have transferred the specified number of bytes.

[-scanner-total {<integer>[KB|MB|GB|TB|PB]}] - Scanner Total

If this parameter is specified, the command displays only file-move operations with the specified total transfer size in bytes.

[-data-scanner-priority {high|low}] - Data Scanner Priority

If this parameter is specified, the command displays only the file-move operations that give the data scanner high priority (high) or low priority (low).

[-elapsed-time <time_interval>] - Elapsed Time

If this parameter is specified, the command displays only file-move operations that have a matching elapsed-time interval. Specify an elapsed-time range by using the ".." operator between two values. For example, the following command displays file-move operations with elapsed-time between 2 hours and 3 hours 30 minutes:

        volume rebalance file-move show -elapsed-time 2h..3h30m
    

Specify a comparative elapsed-time value using the ">" and "<" operators. For example, the following command displays the file-move operations with an elapsed-time greater than 5 hours and 30 minutes:

        volume rebalance file-move show -elapsed-time >5h30m
    

[-cutover-time <[<integer>h][<integer>m][<integer>s]>] - Cutover Time

If this parameter is specified, the command displays only the file-move operations with the specified cutover time.

[-is-snapshot-fenced {true|false}] - Is Snapshot Fenced

If this parameter is specified, the command displays only the file-move operations with snapshots fenced (true) or unfenced (false).

[-is-destination-ready {true|false}] - Is Destination Ready

If this parameter is specified, the command displays only the file-move operations for which the destination volume is ready (true) or not ready (false).

[-last-failure-time <MM/DD/YYYY HH:MM:SS>] - Last Failure Time

If this parameter is specified, the command displays file-move operations that have a matching last-failure-time value. Use the format: "MM/DD/YYYY HH:MM:SS". Specify a time range by using the ".." operator between two time statements. For example, the following command displays file-move operations with a last-failure-time value between "08/13/2014 05:55:00" and "08/13/2014 06:10:00":

        volume rebalance file-move show -last-failure-time "08/13/2021 05:55:00".."08/13/2021 06:10:00"
    

Specify a comparative last-failure-time value using the ">" and "<" operators. For example, the following command displays file-move operations with a last-failure-time value after "8/27/2021 14:58:00":

        volume rebalance file-move show -last-failure-time >"8/27/2021 14:58:00"