volume rebalance file-move show

Contributors

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:

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