Manage VTL Replication

Initiate Replication for a VTL or VTL Cartridge

Initiate replication for a specified VTL.

Command

syscli ‑‑replicate vtl ‑‑name <VTL_name> [‑‑target <host_name_or_ip>] ‑‑barcode <barcode> | ‑‑namespace

Command Attributes

Review the following attribute descriptions.

`‑‑replicate vtl`	Initiates replication for the specified VTL.
`‑‑name <VTL_name>`	Enter the name of the VTL for which to initiate replication.
`‑‑target <host_name_or_ip>`	Enter the replication's target host name or IP address. If the system or the share/partition has two targets configured, you must use this option to specify a target IP or hostname. If the system or the share/partition does not have a target configured, invoking this command results in error.
`‑‑barcode <barcode>`	Enter the barcode of the VTL's cartridge on which to initiate replication. Note: To replicate a VTL cartridge, the VTL must have cartridge base replication enabled.
`‑‑namespace`	Enter to indicate namespace replication of the entire VTL. If you do not use this option, cartridge based replication is performed.

Lock a VTL

Lock the specified VTL on a replication target so that cartridge based replication recovery requests are queued. Recovery does not occur until the VTL is unlocked.

Command

syscli ‑‑lock vtl ‑‑name <VTL_name> [‑‑wait]

Unlock a VTL

Unlock the specified VTL on a replication target. If you specify the ‑‑force option, the lock is forced to unlock.

Command

syscli ‑‑unlock vtl ‑‑name <VTL_name> [‑‑force]

Get VTL Lock Status

Retrieve the status of the lock for the specified VTL.

Command

syscli ‑‑getstatus vtllock ‑‑name <VTL_name>

Initiate Source to Target Cartridge Synchronization

Initiate source to target cartridge synchronization for a specified VTL with cartridge based replication enabled.

Command

syscli ‑‑sync vtl ‑‑name <VTL_name> [‑‑target <host_name_or_ip>]

Command Attributes

Review the following attribute descriptions.

‑‑sync vtl

Initiates source to target synchronization for the specified VTL.

‑‑name <VTL_name>

Enter the name of the VTL for which to initiate synchronization.

‑‑target <host_name_or_ip>

Enter the replication's target host name or IP address.

If the system or the share/partition has two targets configured, you must use this option to specify a target IP or hostname. If the system or the share/partition does not have a target configured, invoking this command results in error.

Add a VTL Replication Target

Add a target to which a VTL can replicate data.

Command

syscli ‑‑add vtltarget ‑‑name <vtl_name> ‑‑target <host_name_or_ip>

Delete a VTL Replication Target

Remove a target to which a VTL can replicate data.

Command

syscli ‑‑del vtltarget ‑‑name <vtl_name> ‑‑target <host_name_or_ip>

List VTL Replication Targets

List the replication targets for the specified VTL.

Command

syscli ‑‑list vtltarget ‑‑name <vtl_name>

Enable VTL Replication

Enable replication of the specified VTL.

Note: This command enables replication to all targets configured for the VTL. You cannot enable replication for a single target using this command. Instead, run the following command to allow or disallow replication to a particular target: syscli ‑‑add/del <vtltarget> ‑‑name <vtl_name> ‑‑target <host_name_or_ip>.

Note: You must configure the target system's corresponding partition with a Sync ID prior to configuring the source system's partition.

Command

syscli ‑‑enablerep vtl ‑‑name <vtl_name> [‑‑cartbase] [‑‑syncid <sync_id>]

Command Attributes

Review the following attribute descriptions.

`‑‑enablerep vtl`	Enable replication of the specified VTL.
`‑‑name <vtl_name>`	Enter the name of the VTL partition on which to enable replication.
`‑‑cartbase`	Enable cartridge based replication. If you do not specify this option, replication is enabled for the entire VTL partition. Note: Before editing replication settings, disable cartridge based replication using `‑‑disable cartrep`, and then add and remove targets using `‑‑add vtltarget` or `‑‑del vtltarget`.
`‑‑syncid <sync_id>`	Enter the Sync ID of the VTL partition for which you are enabling replication. If you do not specify this option when cartridge based replication is enabled, the CLI uses the VTL name for the Sync ID.

Disable VTL Replication

Disable replication for the specified VTL.

Note: This command disables replication for all targets configured for the VTL. You cannot disable replication for a single target. Instead, run the following command to allow or disallow replication to a particular target: syscli ‑‑add/del <vtltarget> ‑‑name <vtl_name> ‑‑target <host_name_or_ip>

Command

syscli ‑‑disablerep vtl ‑‑name <VTL_name> [‑‑nocartbase]

Check Status on a VTL

Check and verify the status of a VTL prior to replicating its data.

DEPRECATED Command

syscli ‑‑checkrepready vtl ‑‑name <vtl_name>

Abort VTL Replication

Abort the current replication of a VTL.

Command

syscli ‑‑abortrep vtl ‑‑name <VTL_name> [‑‑target <host_name_or_ip>]

Abort VTL Synchronization

Abort the current synchronization of a VTL.

Command

syscli ‑‑abortsync vtl ‑‑name <VTL_name> [‑‑target <host_name_or_ip>]

List Deduplicated VTLs

List all VTLs that have data deduplication enabled. Replication and synchronization information is also listed if it applies.

Command

syscli ‑‑list dedupvtl

Example Output

Total count = 1

[dedupvtl = 1]

VTL name = test1

replication state = Enabled

replication sync id =

last replication start = Thu Mar 5 11:02:03 2009

last replication completion = Thu Mar 5 11:02:07 2009

last replication status = Success

last synchronization start =

last synchronization completion =

last synchronization status =

List All Replicated VTLs

List all VTLs that have been replicated to the target, along with the status of each replication task.

Command

syscli ‑‑list repvtl

Example Output

List of all replicated VTL on the target.

Total count = 1

[replicated vtl = 1]

ID = 1

VTL Name = test1

Source Host = Galaxy3.node-1

Replication Started = Thu Mar 5 13:08:59 2009

Replication Finished = Thu Mar 5 13:08:59 2009

Replication Status = Success

Recover a VTL Cartridge

Recover and recreate a VTL cartridge from the target system.

When recovering and recreating a VTL cartridge, you must add tape drives to the devices, roboot the devices, and map the devices before the VTL is accessible. If the partition contains media, you can select only the highest capacity tape drive for that media type. The original cartridge type is not retained during replication.

Example

If the partition contains SDLT600 tape cartridges, you will only be able to select DLT-S4 tape drives when mapping devices to the recovered partition.

Command

syscli ‑‑recover vtl ‑‑repname <replicated_VTL_name> ‑‑srchost <source_hostname_or_IP address> ‑‑id <ID_of_the_replicated_VTL> [‑‑recname <recovered_VTL_name >] [‑‑submit]

Command Attributes

Review the following attribute descriptions.

`‑‑recover vtl`	Recovers and recreates the specified VTL cartridge from the target system.
`‑‑repname <replicated_VTL_name>`	Enter the name of the replicated VTL on which the cartridge exists. You can retrieve replicated VTL names using the `syscli ‑‑list repvtl` command.
`‑‑srchost <source_hostname_or_IP address>`	Enter the source system's IP address or hostname. You can retrieve the source system's IP address or hostname using the `syscli ‑‑list repvtl` command.
`‑‑id <ID_of_the_replicated_VTL>`	Enter the ID of the replicated VTL on which the cartridge exists. You can retrieve replicated VTL IDs using the `syscli ‑‑list repvtl` command.
`‑‑recname <recovered_VTL_name >`	Enter a name for the recovered VTL. Otherwise the VTL is assigned its replicated name.
`‑‑submit`	If specified, the CLI does not wait for the recover operation to complete.

Failback a Replicated VTL

Failback a replicated VTL to a specified system.

Before using this command:

From the system on which the replicated VTL data exists, run the ‑‑recover vtl command specifying the VTL to failback.
Configure the target role IP address on the system to which to failback the VTL.

Command

syscli ‑‑failback repvtl ‑‑repname <vtl_name> ‑‑srchost <source_host> ‑‑id <id> ‑‑tgthost <target_host> [‑‑encrypt {‑‑encrypttype 128|256|tls}]

Command Attributes

Review the following attribute descriptions.

`‑‑failback repvtl`	Failback a replicated VTL to the specified source system.
`‑‑repname <vtl_name>`	Enter the name of the replicated VTL to failback. You can retrieve replicated VTL names using the `syscli ‑‑list repvtl` command.
`‑‑srchost <source_host>`	Enter the hostname or IP address of the system to which to failback the VTL. You can retrieve the original source system's IP address or hostname using the `syscli ‑‑list repvtl` command.
`‑‑id <id>`	Enter the ID of the replicated VTL to failback. You can retrieve replicated VTL IDs using the `syscli ‑‑list repvtl` command.
`‑‑tgthost <target_host>`	Enter the hostname or IP address of the system on which the replicated VTL data exists. The receiving system must have this system defined as an allowed replication source.
`‑‑encrypt`	Specify to encrypt the failback data. Note: To enable encryption, the Data-In-Flight license must be installed. Encryption is not available in all regions. See Manage Encryption.
`‑‑encrypttype 128\|256\|tls`	If you enabled encryption, specify the encryption type, either 128 bit, 256 bit, or TLS 256 bit encryption.

Delete a Replicated VTL from the Target

Delete a replicated VTL from the target system.

Command

syscli ‑‑del repvtl ‑‑repname <replicated_VTL_name> ‑‑srchost <source_host> ‑‑id <ID>

Command Attributes

Review the following attribute descriptions.

`‑‑del repvtl`	Deletes the specified VTL from the target system.
`‑‑repname <replicated_VTL_name>`	Enter the name of the replicated VTL to delete from the target system. You can retrieve replicated VTL names using the `syscli ‑‑list repvtl` command.
`‑‑srchost <source_host>`	Enter the source system's IP address or hostname. You can retrieve the source system's IP address or hostname using the `syscli ‑‑list repvtl` command.
`‑‑id <ID>`	Enter the ID of the replicated VTL to delete from the target system. You can retrieve replicated VTL IDs using the `syscli ‑‑list repvtl` command.

List Replicated VTL Recovery Jobs

List replicated VTL recovery jobs on the target system, along with recovery status.

Command

syscli ‑‑list vtlrecjob

Example Output

List of all replicated VTL recovery jobs:

Total count = 1sysc

[recovery job = 1]

ID = 1

Original VTL Name = VTL1

New VTL Name = VTL1_REC

Source Host = galaxy.node-1

Recovery Job Started = Mon Jun 1 11:22:17 2009

Recovery Job Finished = Mon Jun 1 11:22:43 2009

Recovery Job Status = Success

Delete Replicated VTL Recovery Jobs

Delete a replicated VTL recovery job from the target system.

Command

syscli ‑‑del vtlrecjob -repname <VTL_name> ‑‑srchost <source_hostname> ‑‑id <ID_of_the_recovery_job>

Command Attributes

Review the following attribute descriptions.

`‑‑del vtlrecjob`	Deletes the specified replicated VTL recovery from the target system.
`‑‑repname <VTL_name>`	Enter the name of the replicated VTL to delete from the target system. You can retrieve replicated VTL names using the `syscli ‑‑list vtlrecjob` command.
`‑‑srchost <source_hostname>`	Enter the source system's IP address or hostname. You can retrieve the source system's IP address or hostname using the `syscli ‑‑list vtlrecjob` command.
`‑‑id <ID_of_the_recovery_job>`	Enter the ID of the recovery job to delete from the target system. You can retrieve recovery IDs using the `syscli ‑‑list vtlrecjob` command.

List Replicated VTL Failback Jobs

List replicated VTL failback jobs on the target system, along with the job's status.

Command

syscli ‑‑list vtlfailbackjob

Example Output

List of all replicated VTL failback jobs:

Total count = 1

[failback job = 1]

ID = 1

VTL Name = part4

Target Host = 10.40.164.70

Failback Job Started = Wed Jun 3 16:45:53 2009

Failback Job Finished = Wed Jun 3 16:46:01 2009

Failback Job Status = Success

Delete Replicated VTL Failback Jobs

Delete a replicated VTL failback job from the target system.

Command

syscli ‑‑del vtlfailbackjob ‑‑repname <VTL_name> ‑‑tgthost <target_hostname> ‑‑id <ID_of_the_failback_job>

Command Attributes

Review the following attribute descriptions.

`‑‑del vtlfailbackjob`	Deletes the specified replicated VTL failback from the target system.
`‑‑repname <VTL_name>`	Enter the name of the replicated VTL to delete from the target system. You can retrieve replicated VTL names using the `syscli ‑‑list vtlfailbackjob` command.
`‑‑tgthost <target_hostname>`	Enter the target system's IP address or hostname. You can retrieve the target system's IP address or hostname using the `syscli ‑‑list vtlfailbackjob` command.
`‑‑id <ID_of_the_failback_job>`	Enter the ID of the failback job to delete from the target system. You can retrieve recovery IDs using the `syscli ‑‑list vtlfailbackjob` command.

Abort Replicated VTL Failback Jobs

Abort an active replicated VTL failback job on the target system.

Command

syscli ‑‑abort vtlfailbackjob ‑‑repname <VTL_name> ‑‑tgthost <target_hostname> ‑‑id <ID_of_the_failback_job>

Command Attributes

Review the following attribute descriptions.

`‑‑abort vtlfailbackjob`	Aborts the specified replicated VTL failback job on the target system.
`‑‑repname <VTL_name>`	Enter the name of the replicated VTL for which the failback job is running. You can retrieve replicated VTL names using the `syscli ‑‑list vtlfailbackjob` command.
`‑‑tgthost <target_hostname>`	Enter the target system's IP address or hostname. You can retrieve the target system's IP address or hostname using the `syscli ‑‑list vtlfailbackjob` command.
`‑‑id <ID_of_the_failback_job>`	Enter the ID of the failback job to abort. You can retrieve recovery IDs using the `syscli ‑‑list vtlfailbackjob` command.

Enable VTL Cartridge Based Replication

Enable VTL cartridge based replication for a target system.

Command

syscli ‑‑enable cartrep ‑‑name <VTL_name> [‑‑syncid <sync_id>] [‑‑locked]

Command Attributes

Review the following attribute descriptions.

`‑‑enable cartrep`	Enable cartridge based replication for the specified VTL.
`‑‑name <VTL_name>`	The name of the VTL for which to enable cartridge based replication.
`‑‑syncid <sync_id>`	Enter the Sync ID of the VTL for which you are enabling replication. If you do not specify this option when cartridge based replication is enabled, the CLI uses the VTL name for the Sync ID.
`‑‑locked`	If specified, locks the VTL partition. Replication requests are queued, but they will not occur until the partition is unlocked.

Disable VTL Cartridge Based Replication

Disable cartridge based replication for the specified VTL.

Note: Before editing replication settings using ‑‑enablerep vtl, ‑‑disablerep vtl, or --disable cartrep, make sure to finish adding and removing targets.

Command

syscli ‑‑disable cartrep ‑‑name <VTL_name>

List Cartridge Based Replication Status and Statistics

List the status and statistics of data sent from a VTL cartridge based replication.

Command

syscli ‑‑list cartrepstats ‑‑name <VTL_name>

List VTL Paritions Eligible to Receive Cartridge Based Replication Data

List deduplication-enabled VTL partitions that are eligible to receive cartridge based replication data.

Note: When the output of the partition's state is Enabled, the partition is eligible to receive cartridge based data.

Command

syscli ‑‑list carttarget [‑‑name <VTL_name>]

`‑‑abortrep vtl`	Abort the current replication of the specified VTL.
`‑‑name <VTL_name>`	Enter the name of the VTL for which to abort replication.
`‑‑target <host_name_or_ip>`	If the system or VTL partition has more than one target configured, you must specify the target to which replicated data is being sent.

`‑‑abortsync vtl`	Abort the current synchronization of the specified VTL.
`‑‑name <VTL_name>`	Enter the name of the VTL for which to abort synchronization.
`‑‑target <host_name_or_ip>`	If the system orVTL partition has more than one target configured, you must specify the target with which the partition is being synchronized.

`‑‑list cartrepstats`	List the replication status and additional statistics of data sent from the specified VTL partition.
`‑‑name <VTL_name>`	Enter the name of the VTL partition for which the cartridge based replication is occurring.

`‑‑add vtltarget`	Add a target to which a VTL can replicate data.
`‑‑name <vtl_name>`	Enter the name of the VTL partition to which to add a replication target.
`‑‑target <host_name_or_ip>`	Enter the target's IP address or hostname.

`‑‑del vtltarget`	Remove a target from which a VTL can replicate data.
`‑‑name <vtl_name>`	Enter the name of the VTL partition from which to remove a replication target.
`‑‑target <host_name_or_ip>`	Enter the target's IP address or hostname.