Top
ETERNUS SF AdvancedCopy Manager 14.2 Operator's Guide

C.2.5 Copy destination volume locking specification file

If locking fails in copy destination volume backup pre-processing, locking is retried to prevent a temporary access conflict with other applications. If a Logical Unit (disk) is specified as the copy destination volume, locking is implemented for the volume contained in the Logical Unit (disk). If locking fails, it should be retried.

The standard retry operations are as follows:

The maximum number of retries (default value = 20 attempts) and the retry interval (default value = 1 second) can be changed by creating a configuration file called the copy destination volume locking specification file. In this configuration file, the following instructions can be specified for the copy destination volume pre-processing:

If the AdvancedCopy Manager version is 13.1 or later, the user can specify, in the destination source volume lock operation specification file, that replication pre-processing and post-processing are not to be executed.

C.2.5.1 Creating a copy destination volume locking specification file

Create this file on the server that contains the copy destination volume, naming it as follows:

File name

For a non-cluster operation

environment-setting-directory\etc\repl\data\DSTLOCK.INI

For a cluster operation

<shared-disk>:\etc\opt\swstorage\etc\repl\data\DSTLOCK.INI

Examples of settings in this file are listed below.

[g1d1p1]
LockForceMode=on
LockRetryNumber=10
LockRetryInterval=10
[ANY]
LockForceMode=off
LockRetryNumber=20
LockRetryInterval=100

An explanation of how to create this file is given below:

DSTLOCK.INI parameter settings

Key

Explanation

LockForceMode

If locking of the copy destination volume fails, locking is retried. This parameter specifies that the volume be dismounted before locking is retried.

off (default value) = no dismounting before locking is retried

on = dismounting before locking is retried

When the volume is dismounted, all handles opened for the volume become invalid.

* If the volume is set in the used state immediately after it is dismounted, then locking may be impossible.

If "on" is specified for NoPrePost, this parameter becomes invalid.

LockRetryNumber

If locking of the copy destination volume fails, locking is retried. This parameter specifies the retry count limit. A numeric value ranging from 1 to 10,000 can be specified.
The default value is 20 (attempts).
If the transaction volume cannot be locked after locking is retried for the specified retry count limit, then the processing is suspended and the command ends abnormally.
If "on" is specified for NoPrePost, this parameter becomes invalid.

LockRetryInterval

If locking of the copy destination volume fails, locking is retried. This parameter specifies the retry interval in milliseconds. A numeric value ranging from 1 to 600,000 (10 minutes) can be specified. The default value is 1,000 (1 second).
If "on" is specified for NoPrePost, this parameter becomes invalid.

NoPrePost

Specifies that replication pre-processing and post-processing are not executed.

off (default value) = The replication pre-processing and post-processing are performed.

on = The replication pre-processing and post-processing are not performed.

If "on" is specified for NoPrePost, all other parameters (LockForceMode, LockRetryNumber, LockRetryInterval) are ignored.
This parameter can be specified under AdvancedCopy Manager 13.1 and later.