![background image](http://html1.mh-extra.com/html/quantum/dxi4500/dxi4500_manual_3756124044.webp)
Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-02 Rev A
July 2011
44
Replication CLI Commands
•
Getting the Status of the Active Synchronization Requests
•
Listing the File/Directory-Based Replication Status and Statistics
•
Listing the File/Directory-Based Replication Target Shares
•
Listing the Cartridge Replication Status and Statistics
•
Listing the VTL Cartridge Replication Status and Statistics
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.