Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-05 Rev B
April 2012
38
Replication CLI Commands
•
Deleting an OST Target Mapping
•
Initiating a Cartridge
Based, File/Directory
Based, or Namespace
Replication
syscli --replicate vtl --name <VTL_name> --barcode <barcode> |
--namespace [--disbleok]
This CLI command allows the admin user to initiate a replication the for a
specified VTL. If the
--barcode
option is specified, only the cartridge with
specified barcode on the specified VTL will have replication initiated. The VTL
must have cartridge base replication enabled in order to replicate a cartridge. If
the
--namespace
option is specified, namespace replication is initiated for the
whole specified VTL. If the
--disableok
option is specified, no error will be
returned if the cartridge base replication is not enabled.
syscli --replicate nas --name <NAS_share_name> [ --path
<directory_path_or_filename_to_the_share> | --namespace ] [--disableok]
This CLI command allows the admin user to initiate a replication for NAS share
or an individual directory or file on the specified NAS share. The share must have
the file/directory based replication enabled in order to replicate a directory or a
file. If the
--namespace
options is specified, namespace replication is initiated
on the whole NAS share. If the
--disableok
option is specified, no error will be
returned if the file/directory base replication is not enabled.
Locking a VTL or NAS
Share
syscli --lock vtl --name <VTL_name> [--wait]
syscli --lock nas --name <NAS_share_name> [--wait]
This CLI command allows the admin user to lock or unlock the specified VTL or
share on a replication target so that cartridge or file/directory based replication
recovery requests are queued. No recovery will occur until the VTL or share is
unlocked.
If the
--wait
option is not specified when locking, the CLI will not wait and will
return right away if the VTL or share is already locked. If the
--wait
option is
specified, this CLI command will wait if there is a lock in place and will return
when the lock is obtained.
Unlocking a VTL or NAS
Share
syscli --unlock vtl --name <VTL_name> [--force]
syscli --unlock nas --name <NAS_share_name> [--force]
This CLI command allows the admin user to unlock the specified VTL or share on
a replication target that was locked from the previous lock CLI command.
If the
--force
option is specified, the lock will be forced to be unlocked on the
VTL or share.
Getting VTL or NAS
Share Lock Status
syscli --getstatus vtllock --name <VTL_name>
This CLI command allows the CLI admin to retrieve the status of the lock for the
specified VTL.
