![background image](http://html1.mh-extra.com/html/quantum/dxi-v-series/dxi-v-series_manual_3715194050.webp)
Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-09 Rev B
February 2014
40
Replication CLI Commands
CLI command options:
•
--replicate
: Initiates replication for a specified NAS share.
•
--name
: Must be a valid NAS share name for the system.
•
--target
: Target host name or IP of the replication job. If the system or the
share/partition has two targets configured, you must use the
--target
option and you must specify a target IP or hostname. If the system or the
share/partition has no target configured, invoking the commands will result
in error.
•
--path
: Directory or filename used for directory/file based replication.
•
--namespace
: If specified, namespace replication is initiated on the whole
NAS share. If not specified, directory/file base replication is performed.
•
--disableok
: if specified, no error will be returned if directory/file based
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.
syscli --getstatus naslock --name <NAS_share_name>
This CLI command allows the user to retrieve the status of the lock for the
specified NAS share.