skip book previous and next navigation links
go up to top of book: HP Volume Shadowing for OpenVMS HP Volume Shadowing for OpenVMS
go to beginning of chapter: Preparing to Use Volume Shadowing Preparing to Use Volume Shadowing
go to previous page: Licensing Volume Shadowing for OpenVMS Licensing Volume Shadowing for OpenVMS
go to next page: Write Bitmap System ParametersWrite Bitmap System Parameters
end of book navigation links

Volume Shadowing Parameters   



Volume Shadowing Parameters lists the system parameters that are required to specify the use of Volume Shadowing for OpenVMS and the system parameters you can use to tailor the shadowing software on your system. These parameters were introduced with OpenVMS Version 7.1, except for ALLOCLASS, which was introduced earlier, and SHADOW_MAX_UNIT, which was introduced in OpenVMS Version 7.3. The term dynamic in Volume Shadowing Parameters means that the active value can be changed on a running system. For more information about setting system parameters, see the HP OpenVMS System Manager's Manual.

OpenVMS Version 7.3 introduced four write bitmap system parameters (described in Write Bitmap System Parameters) and the volume shadowing system parameter SHADOW_MAX_UNIT. These system parameters support the shadowing minicopy operation, which is described in Using Minicopy for Backing Up Data (Alpha).

Table 1    Volume Shadowing Parameters
Parameter Function Range Default Dynamic
ALLOCLASS
Specifies the device allocation class for the system. When using Volume Shadowing for OpenVMS, a nonzero value is required.
0-255
0
No
SHADOWING
A value of 2 enables volume shadowing. See Write Bitmap System Parameters for a description of parameter values.
0, 21
0
No
SHADOW_MAX_COPY
Limits the number of concurrent merge or copy operations on a given node.
0--200
4
Yes
SHADOW_MAX_UNIT
Specifies the maximum number of shadow sets that can exist on a node. Dismounted shadow sets, unused shadow sets, and shadow sets with no write bitmaps allocated to them are included in this total.


10--10,000
100 on VAX; 500 on Alpha
No
SHADOW_MBR_TMO
Controls the amount of time the system tries to fail over physical members of a shadow set.
1--65,535 seconds
120
Yes
SHADOW_SITE_ID
On an Alpha system, allows a system manager to define a site value, which volume shadowing uses to determine the best device to perform reads, thereby improving performance.
1-255
No
Yes
SHADOW_SYS_DISK
Allows system disk to be a shadow set and, optionally, enables a minimerge to occur. If a minimerge is enabled, the system must also be configured for writing to a nonshadowed, nonsystem disk of your choice.
0, 1, 4097
0
Yes
SHADOW_SYS_TMO
Controls the amount of time members of a system disk shadow set have to return to the set.
1--65,535 seconds
120
Yes
SHADOW_SYS_UNIT
Contains the virtual unit number of the system disk.
0--9999
0
No
SHADOW_SYS_WAIT
This parameter applies only to shadow sets that are currently mounted in the cluster. Controls the amount of time a booting system will wait for all members of a mounted system disk shadow set to become available.
1--65,535 seconds
480
Yes

Guidelines for Using Volume Shadowing Parameters  

This section provides guidelines for using volume shadowing parameters.

ALLOCLASS

The ALLOCLASS parameter is used to specify an allocation class that forms part of a device name. The purpose of allocation classes is to provide unique and unchanging device names. When using Volume Shadowing for OpenVMS on a single system or on an OpenVMS Cluster system, a nonzero allocation class value is required for each physical device in the shadow set. For more information about using allocation classes, see the OpenVMS Cluster Systems manual.

SHADOWING

The SHADOWING parameter enables or disables volume shadowing on your system, as shown in SHADOWING Parameter Settings.

Table 2   SHADOWING Parameter Settings
Setting Effect
0
Shadowing is not enabled.

This is the default value.
2
Enables host-based shadowing.

This setting provides shadowing of all disks that are located on a standalone system or on an OpenVMS Cluster system. Set SHADOWING to 2 on every node that will mount a shadow set, including satellite nodes.

SHADOW_MAX_COPY

The SHADOW_MAX_COPY parameter controls how many parallel copy and merge operations are allowed on a given node. (Copy and merge operations are described in Ensuring Shadow Set Consistency.) This parameter provides a way to limit the number of copy and merge operations in progress at any one time.

The value of SHADOW_MAX_COPY can range from 0 to 200. The default value is specific to the OpenVMS version. You can determine the default value by looking at the parameter setting. When the value of the SHADOW_MAX_COPY parameter is 4, and you mount five multivolume shadow sets that all need a copy operation, only four copy operations can proceed. The fifth copy operation must wait until one of the first four copies completes.

Consider the following when choosing a value for the SHADOW_MAX_COPY parameter:

For example, the default value of 4 may be too high for a small node. (In particular, satellite nodes should have SHADOW_MAX_COPY set to a value of 0.) Too low a value for SHADOW_MAX_COPY unnecessarily restricts the number of operations your system can effectively handle and extends the amount of time it takes to merge all of the shadow sets.

SHADOW_MAX_COPY is a dynamic parameter. Changes to the parameter affect only future copy and merge operations; current operations (pending or already in progress) are not affected.

SHADOW_MAX_UNIT

The SHADOW_MAX_UNIT specifies the number of shadow sets that can exist on a node and determines the memory reserved for the write bitmap for each shadow set. (See Memory Requirements.) The important thing to note about this value is that any shadow set that has been created, regardless of whether it is in use, is included in this total. Because this is not a dynamic system parameter, you should be very careful when determining the value to use. If you need to change this parameter, you must reboot the system.

The default value for OpenVMS Alpha systems is 500; the default value for OpenVMS VAX systems is 100.


CautionAny MOUNT command that attempts to create more shadow sets than the maximum specified for the node will fail.

Note that this parameter does not affect the naming of shadow sets. For example, with the default value of 100, a device name such as DSA999 is still valid.

SHADOW_MBR_TMO

The SHADOW_MBR_TMO parameter controls the amount of time the system tries to fail over physical members of a shadow set before removing them from the set. SHADOW_MBR_TMO is a dynamic parameter that you can change on a running system.

With the SHADOW_MBR_TMO parameter, you specify the number of seconds, from 1 to 65,535, during which recovery of a shadow set member is attempted.


NoteThe value of SHADOW_MBR_TMO should not exceed the value of the parameter MVTIMEOUT.

If you specify zero, a default delay is used. The default delay is specific to the version of OpenVMS running on your system. For shadow sets in an OpenVMS Cluster configuration, the value of SHADOW_MBR_TMO should be set to the same value on each node.

Determining the correct value for SHADOW_MBR_TMO is a trade-off between rapid recovery and high availability. If rapid recovery is required, set SHADOW_MBR_TMO to a low value. This ensures that failing shadow set members are removed from the shadow set quickly and that user access to the shadow set continues. However, removal of shadow set members reduces data availability and, after the failed member is repaired, a full copy operation is required when it is mounted back into the shadow set.

If high availability is paramount, set SHADOW_MBR_TMO to a high value. This allows the shadowing software additional time to regain access to failed members. However, user access to the shadow set is stalled during the recovery process. If recovery is successful, access to the shadow set continues without the need for a full copy operation, and data availability is not degraded. Setting SHADOW_MBR_TMO to a high value may be appropriate when shadow set members are configured across LANs that require lengthy bridge recovery time.

Shadowing uses a timer to adhere to the number of seconds specified by the SHADOW_MBR_TMO parameter. For directly connected SCSI devices that have been powered down or do not answer to polling, the elapsed time before a device is removed from a shadow set can take several minutes.

The use of default settings for certain system parameters may lead to the occasional removal of shadow set members (systems that are using Volume Shadowing for OpenVMS) that are configured for multipath support. Therefore, when configuring multipath shadow sets using Volume Shadowing for OpenVMS, follow the recommendations shown in System Parameter Settings for Multipath Shadow Sets.

Table 3   System Parameter Settings for Multipath Shadow Sets
System Parameter Recommended Setting
MSCP_CMD_TMO
60 as a minimum.
The value of 60 is appropriate for most configurations. Some configurations may require a higher setting.
SHADOW_MBR_TMO
At least 3 x MSCP_CMD_TMO
SHADOW_SYS_TMO
At least 3 x MSCP_CMD_TMO
MVTIMEOUT
At least 4 x SHADOW_MBR_TMO


NoteThe recommended setting for MVTIMEOUT, as shown in System Parameter Settings for Multipath Shadow Sets, represents a doubling of an earlier recommendation published for OpenVMS Alpha Version 7.3.

SHADOW_SYS_DISK

A SHADOW_SYS_DISK parameter value of 1 enables shadowing of the system disk. A value of 0 disables shadowing of the system disk. A value of 4097 enables a minimerge. The default value is 0.

If you enable a minimerge of the system disk, you must also configure your system to write a dump to a nonshadowed, nonsystem disk of your choice. This is known as dump off system disk (DOSD). For more information on DOSD, see the HP OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.

In addition, you should specify a system-disk, shadow-set virtual unit number with the SHADOW_SYS_UNIT system parameter, unless the desired system disk virtual unit number is DSA0.

SHADOW_SYS_TMO

You can use the SHADOW_SYS_TMO parameter in two ways: during the booting process and during normal operations. SHADOW_SYS_TMO is a dynamic parameter that you can change on a running system.

During the booting process, you can use this parameter on the first node in the cluster to boot and to create a specific shadow set. If the proposed shadow set is not currently mounted in the cluster, use this parameter to extend the time a booting system will wait for all former members of the system disk shadow set to become available.

The second use of this parameter comes into effect once the system successfully mounts the shadow set and begins normal operations. Just as the SHADOW_MBR_TMO parameter controls the time the operating system waits for failing members of an application disk shadow set to rejoin the shadow set, the SHADOW_SYS_TMO parameter controls how long the operating system will wait for failing members of a system disk shadow set. All nodes using a particular system disk shadow set should have their SHADOW_SYS_TMO parameter equal to the same value, after normal operations begin. Therefore, after booting, this parameter applies only to members of the system disk shadow set.

The default value is OpenVMS version specific. You can set a range of up to 65,535 seconds if you want the system to wait longer than the default for all members to join the shadow set.

SHADOW_SYS_UNIT

The SHADOW_SYS_UNIT parameter, which must be used when the SHADOW_SYS_DISK parameter is set to 1, contains the virtual unit number of the system disk.

The SHADOW_SYS_UNIT parameter is an integer value that contains the virtual unit number of the system disk. The default value is 0. The maximum value allowed is 9999. This parameter is effective only when the SHADOW_SYS_DISK parameter has a value of 1. This parameter must be set to the same value on all nodes that boot off a particular system disk shadow set. SHADOW_SYS_UNIT is not a dynamic parameter.

SHADOW_SYS_WAIT

Use the SHADOW_SYS_WAIT parameter to extend the time a booting system will wait for all current members of a mounted system disk shadow set to become available to this node. SHADOW_SYS_WAIT is a dynamic parameter that you can change on a running system (for debugging purposes only). The shadow set must already be mounted by at least one other cluster node for this parameter to take effect. The default value is 256 seconds. Change this parameter to a higher value if you want the system to wait more than the 256-second default for all members to join the shadow set. This parameter has a range of 1 through 65,535 seconds.


Footnotes
1All other values are reserved for use by HP.

( Number takes you back )


go to previous page: Licensing Volume Shadowing for OpenVMS Licensing Volume Shadowing for OpenVMS
go to next page: Write Bitmap System ParametersWrite Bitmap System Parameters