Quantum DXi V-Series - Locking a VTL or NAS Share; Unlocking a VTL or NAS Share; Getting VTL or NAS Share Lock Status

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.