6.26 List Move

list move <<move_name>|<pool_name>>

Print detailed information about a specified NSS pool move. It lists the devices you are moving from and the devices you are moving to, such as

from=sdc,sdd,sde to=sdg

If a pool is cluster-enabled, the pool move is enabled and active only on the node where the pool cluster resource is currently online. On other nodes in the cluster, the pool move is not enabled.

nlvm [nlvm_options] list move <<move_name>|<pool_name>>

The move occurs as a low-level block mirror between the original location and the new location. The entire pool area is mirrored. The response reports the number of mirror regions to be moved for the pool relative to the maximum original pool size, which is unrelated to the NSS blocks in use. The region count for the old pool location does not change during the move. The complete parameter indicates the number of regions that have been moved so far and the percentage that it represents of the total number of regions to be moved.

The size of a mirror region is determined internally based on the total size of the mirror. One sector is used to track the number of mirror regions that are currently synchronized. A bit represents a mirror region, and there are 4096 bits total (512 * 8) to track. A shift technique is used so that the mirror region size is always a power of 2 (128, 256, 512, and so on) and the total number of regions to move is less than or equal to 4096. Except for very small mirrors, the number of mirror regions is usually between 2048 and 4096. The minimum mirror region size used is 64 sectors (32 KB). There is no maximum. For an 8 TB pool the mirror region size is 2 GB. When a complete region is mirrored, the bit is set. If a region is partially mirrored during a system failure or cluster resource migration, the entire region is remirrored when mirroring resumes.

The response lists the set of devices that are being used for the original location (from) and the new location (to).

Command Option

move_name or pool_name

Mandatory. Specify the name of the move, such as POOLNAME_move. You can alternatively specify the pool name.

Example

MYPOOL_move

Command Example

nlvm list move MYPOOL_move

Print detailed information about the MYPOOL_move move.

Response Parameters

The command returns the following information about the specified pool move:

• Name of the move. Typically, <pool_name>_move.
• Major:minor of the move object
• Name of the pool being moved
• From set of devices for the pool being moved
• To set of devices for the pool in its new location
• Size of the pool being moved
• Total number of mirror regions to be moved
• Number of mirror regions that are complete along with associated percent complete
• Status of the “from” group (Active, ReadError, WriteError, Missing, NotEnabled)
• Status of the “to” group (Active, ReadError, WriteError, Missing, NotEnabled)

Sample Command Responses

Sample 1: Cluster Node where the Pool Cluster Resource Is Active

nlvm list move DFS01_TEST

  Move=DFS01_TEST_move (253:200) pool=DFS01_TEST 
  from=raid5_1,sde,sdd,sdg to=sdc,sdd 
  oldsize=7.19GB(15087616) regions=3684 complete=1245(33%) 
  fromstat=Active tostat=Active

Sample 2: Any Cluster Node where the Pool Cluster Resource Is Not Active

nlvm list move DFS01_TEST

  Move=DFS01_TEST_move (253:200) pool=DFS01_TEST
  from=raid5_1,sde,sdd,sdg to=sdc,sdd 
  Move is not enabled on this node.