Skip to main content
ONTAP commands
A newer release of this product is available.

volume move show

Suggest changes
PDFs

Show status of a volume moving from one aggregate to another aggregate

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The volume move show command displays information about volume moves in the cluster. By default, with no parameters, it only shows volume moves that have failed or are currently running. The command display output depends on the parameters passed. If -vserver and -volume are specified, the following information is displayed:

  • Vserver Name: The Vserver on which the volume is located.

  • Volume Name: The volume that is part of a completed or running volume move operation.

  • Actual Completion Time: The date and time in the cluster time zone when the volume move completed.

  • Bytes Remaining: The number of bytes remaining to be sent during volume move. This is an approximate number and lags the current status by a few minutes while the volume move is in operation.

  • Destination Aggregate: The name of the aggregate to which the volume is moved.

  • Detailed Status: The detail about any warnings, errors, and state of the move operation.

  • Estimated Time of Completion: The approximate date and time in the cluster time zone when the entire volume move operation is expected to complete. Note that this time may keep increasing when the move goes into cutover-deferred mode. In those cases where the input for cutover-action is wait, during the data copy phase, the estimated time of completion will approximate the time to reach the cutover point and wait for user intervention.

  • Managing Node: The node in the cluster on which the move job is or was running. This is usually on the node hosting the volume to be moved.

  • Percentage Complete: The amount of work to move the volume completed thus far in terms of percentage.

  • Move Phase: The phase of the move operation.

  • Estimated Remaining Duration: The approximate amount of time in terms of days, hours, minutes and seconds remaining to complete the volume move.

  • Replication Throughput: The current replication throughput of the move operation in terms of Kb/s, Mb/s or Gb/s.

  • Duration of Move: The duration in days, hours and minutes for which the volume move was or is in progress.

  • Source Aggregate: The name of the aggregate where the volume being moved originally resides or resided.

  • Start Time of Move: The date and time in the cluster time zone when the volume move operation started.

  • Move State: The state of the volume move at the time of issuing the command and the system gathering up the information about the move.

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 you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name

This specifies the Vserver on which the volume is located. If this parameter and the -volume parameter are specified, the command displays detailed information about latest move performed on the specified volume. If this parameter is specified by itself, the command displays information about latest moves performed on volumes of the specified Vserver.

[-volume <volume name>] - Volume Name

This specifies the volume that is part of a completed or running volume move operation. If this parameter and the -vserver parameter are specified, the command displays detailed information about latest move performed on the specified volume. If this parameter is specified by itself, the command displays information about the latest move on all volumes matching the specified name.

[-actual-completion-time <Date>] - Actual Completion Time

If this parameter is specified, the command displays move operations that match the specified date and time in the cluster time zone when the volume move completed.

[-bytes-remaining {<integer>[KB|MB|GB|TB|PB]}] - Bytes Remaining

If this parameter is specified, the command displays move operations that match the specified number of bytes remaining to be sent during volume move.

[-cutover-action {abort_on_failure|defer_on_failure|force|wait|retry_on_failure}] - Specified Action For Cutover (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified action to be taken for cutover or during cutover failure.

[-cutover-window <integer>] - Specified Cutover Time Window (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified time window in seconds for the cutover phase of volume move.

[-destination-aggregate <aggregate name>] - Destination Aggregate

If this parameter is specified, the command displays move operations that match the specified name of the aggregate to which the volume is being moved.

[-destination-node <nodename>] - Destination Node (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified name of the node where the destination aggregate is present.

[-details <text>] - Detailed Status

If this parameter is specified, the command displays move operations that match the specified detail about any warnings, errors and state of the move operation.

[-estimated-completion-time <Date>] - Estimated Time of Completion

If this parameter is specified, the command displays move operations that match the specified date and time in the cluster time zone when the entire volume move operation is expected to complete.

[-job-id <integer>] - Job ID (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified Job-ID of the move job.

[-managing-node <nodename>] - Managing Node

If this parameter is specified, the command displays move operations that match the specified node in the cluster on which the move job is or was running.

[-percent-complete <percent>] - Percentage Complete

If this parameter is specified, the command displays move operations that match the specified amount of work to move the volume completed thus far in terms of percentage.

[-phase {queued|initializing|replicating|cutover|cutover_hard_deferred|cutover_soft_deferred|aborting|completed|cleaning_up|failed|restarting|finishing}] - Move Phase

If this parameter is specified, the command displays move operations that match the specified phase of the move operation.

[-prior-issues <text>] - Prior Issues Encountered (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified issues or transient errors encountered causing the move operation to retry the data copy phase or the cutover phase.

[-estimated-remaining-duration {<seconds>|[<d> days] <hh>:<mm>[:<ss>]}] - Estimated Remaining Duration

If this parameter is specified, the command displays move operations that match the specified time.

[-replication-throughput <text>] - Replication Throughput

If this parameter is specified, the command displays move operations that match the specified replication throughput of the move operation in terms of Kb/s, Mb/s or Gb/s.

[-actual-duration {<seconds>|[<d> days] <hh>:<mm>[:<ss>]}] - Duration of Move

If this parameter is specified, the command displays move operations that match the specified duration for which the volume move was or is in progress.

[-source-aggregate <aggregate name>] - Source Aggregate

If this parameter is specified, the command displays move operations that match the specified name of the aggregate where the volume being moved originally resides or resided.

[-source-node <nodename>] - Source Node (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified name of the node where the source aggregate is present.

[-start-time <Date>] - Start Time of Move

If this parameter is specified, the command displays move operations that match the specified date and time in the cluster time zone when the volume move operation started.

[-state {healthy|warning|alert|failed|done}] - Move State

If this parameter is specified, the command displays move operations that match the specified state of the volume move operation.

[-moved-by-autobalance {true|false}] - Move Initiated by Auto Balance Aggregate (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

[-original-job-id <integer>] - Original Job ID (privilege: advanced)

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

[-is-source-encrypted {true|false}] - Is Source Volume Encrypted

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

[-source-key-id <text>] - Encryption Key ID of Source Volume

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

[-is-destination-encrypted {true|false}] - Is Destination Volume Encrypted

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

[-destination-key-id <text>] - Encryption Key ID of Destination Volume

If this parameter is specified, the command displays move operations that match the specified value of this parameter.

Examples

The following example lists status of running and failed volume move operations in the cluster.

cluster1::> volume move show
                   Vserver   Volume     State    Move Phase Percent-Complete Time-To-Complete
                   --------- ---------- -------- ---------- ---------------- ----------------
                   vs0       s1         alert    cutover_hard_deferred
                                                             98%             -
                   vs0       vol2       failed   failed     -                -
                   2 entries were displayed.

The following example lists status of all the volume move operations in the cluster.

cluster1::> vol move show -phase *
                   (volume move show)
                   Vserver   Volume     State    Move Phase Percent-Complete Time-To-Complete
                   --------- ---------- -------- ---------- ---------------- ----------------
                   vs0       s1         alert    cutover_hard_deferred
                                                             98%             -
                   vs0       s2         done     completed  100%             -
                   vs0       vol1       failed   failed     -                -
                   3 entries were displayed.