volume rebalance file-move show

Display a list of files being moved

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

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:

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

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"
    

Examples

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
    

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"
    

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