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: 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"

Examples

The following example displays information about all file-move operations on the Vserver named "vs1":

cluster1::volume rebalance file-move*> show -vserver vs1
Vserver: vs1
Volume: fg1
Path                       Source        Destination   Status           Progress
-------------------------- ------------- ------------- --------------- ---------
/d1/d2/foo                 fg1__0002     fg1__0003     Paused                 0%
/d1/d2/bar                 fg1__0002     fg1__0004     Completed            100%

Vserver: vs1
Volume: bld_volume
Path                       Source        Destination   Status           Progress
-------------------------- ------------- ------------- --------------- ---------
/system/build/image.tgz    bld_volume__0001
                                         bld_volume__0005
                                                       Data-Transfer         50%
3 entries were displayed.

The following example displays detailed information about a specific file-move operation on Vserver vs0:

cluster1::volume rebalance file-move*> show -instance -vserver vs0 -volume fg -path /test
  (volume rebalance file-move show)
Vserver Name: vs0
                    Volume Name: fg
 Destination Constituent Volume: fg__0001
                 Operation UUID: 283a983e-c06a-42bc-8bd7-8830211cb2a9
   Destination Constituent Node: sti96-vsim-ucs539i
   Destination Constituent DSID: 1635
      Source Constituent Volume: fg__0004
          Source Operation UUID: 283a983e-c06a-42bc-8bd7-8830211cb2a9
        Source Constituent Node: sti96-vsim-ucs539j
        Source Constituent DSID: 1638
               Operation Status: Paused
    Scanner Progress Percentage: 0%
            Last Failure Reason: -
                      File Path: /test
   Destination Constituent MSID: 2154447497
             Destination Fileid: 97
         Destination Generation: 247243720
        Source Constituent MSID: 2154447500
                  Source Fileid: 504
              Source Generation: 214935427
Maximum Scanner Speed (per sec): 1MB
                 Scanner Paused: true
                 Scanner Status: Paused-Manual
               Scanner Progress: 0B
                  Scanner Total: 10MB
          Data Scanner Priority: low
                   Elapsed Time: 0h2m27s
                   Cutover Time: 0s
             Is Snapshot Fenced: false
           Is Destination Ready: true
              Last Failure Time: -