CLI Guide

Table Of Contents

Syntax

batch-migrate clean

[-f|--file] pathname

[-e|--rename-targets]

Arguments

Required arguments

[-f|--file] pathname *Directory and filename of migration plan file. relative paths can be used. If no directory is

specified, the default directory is /var/log/VPlex/cli on the management server.

Optional arguments

[-e|--rename-

targets]

rename the target devices and virtual volumes to the source device names.

* argument is positional.

Description

Dismantles the source device down to its storage volumes and unclaims the storage volumes.

● For device migrations, cleaning dismantles the source device down to its storage volumes. The storage volumes no longer in

use are unclaimed.

For device migrations only, use the optional --rename-targets argument to rename the target device after the source

device. If the target device is renamed, the virtual volume on top of it is also renamed if the virtual volume has a system-

assigned default name.

Without renaming, the target devices retain their target names, which can make the relationship between volumes and

devices less evident.

● For extent migrations, cleaning destroys the source extent and unclaims the underlying storage-volume if there are no

extents on it.

CAUTION:

This command must be run before the batch-migration has been removed. The command will not

clean migrations that have no record in the CLI context tree.

Example

In the following example, source devices are torn down to their storage volumes and the target devices and volumes are

renamed after the source device names:

VPlexcli:/> batch-migrate clean --rename-targets --file migrate.txt

Using migration plan file /temp/migration_plans/migrate.txt for cleanup phase.

0: Deleted source extent /clusters/cluster-1/devices/R20061115_Symm2264_010, unclaimed

its disks Symm2264_010

1: Deleted source extent /clusters/cluster-1/extents/R20061115_Symm2264_011, unclaimed

its disks Symm2264_011