Veritas Cluster Server Bundled Agents Reference Guide

Veritas™ Cluster Server Bundled Agents Reference Guide - Symantec Veritas™ Cluster Server Bundled Agents Reference Guide - Symantec

d1mj3xqaoh14j0.cloudfront.net
from d1mj3xqaoh14j0.cloudfront.net More from this publisher
17.08.2015 Views

138 VCS infrastructure and support agents Registry Replication (RegRep) agent Table 7-4 RegRep agent optional attributes (continued) Optional Attributes ExcludeKeys Description A list of the subkeys to be excluded from replication. For more information on how the agent excludes keys, see Excluding keys. When defining the keys, you must use the abbreviations listed in Configuring registry keys. Note: This attribute can take localized values. Type and Dimension: string-vector ForceRestore Defines the agent behavior when the registry update fails on a node where the resource is being brought online. A registry update may fail if any of the keys being updated are open. If set to 1 and the registry update fails, the agent tries to forcibly restore the keys by: ■ ■ ■ backing up the configured registry keys of the node being brought online. deleting the configured registry keys from the node being brought online. updating the configured registry keys with the changed values. If the update fails again, the agent reapplies the original values of the registry keys from the backup. If set to 0, the agent does not try to forcibly update the registry when an update fails. Default is 0. Type and Dimension: boolean-scalar ListOpenKeys Defines whether the agent lists a set of registry keys, including keys having open handles, when a registry update fails. The list is logged to the agent log. The value 1 indicates the agent lists the registry key set. The value 0 indicates the agent does not. Default is 1. Type and Dimension: boolean-scalar RestoreLocally Defines whether the agent restores the keys on the node if it was taken offline from the same node. For example, if the agent was taken offline from SystemA and brought online again on SystemA, this attribute determines whether the registry keys would be restored on SystemA. The value 1 indicates the agent restores the keys on the system.The value 0 indicates it does not. Default is 0. Type and Dimension: boolean-scalar

VCS infrastructure and support agents Registry Replication (RegRep) agent 139 Excluding keys This section describes the algorithm the Registry Replication agent uses while excluding keys. For example, assume a registry key KEY_X has a subkey of KEY_Y, which has a subkey KEY_Z. This key would appear as KEY_X\KEY_Y\KEY_Z in the Registry Editor. Table 7-5 describes various scenarios of keys marked for replication and for exclusion. The Result column describes the agent behavior in these scenarios. Table 7-5 RegRep agent exclude keys and behavior Keys for Replication KEY_X KEY_X KEY_X KEY_X\KEY_Y Exclude Keys KEY_Y\KEY_Z KEY_Y KEY_X KEY_X Result KEY_Y is excluded. So is KEY_Z. KEY_Y is excluded. So is KEY_Z. KEY_X is not excluded and an error message is logged. KEY_X is not excluded and an error message is logged. Configuring registry keys To configure a registry key to be replicated or excluded, use the abbreviation corresponding to the registry hive, as listed in Table 7-6. Table 7-6 RegRep agent registry hive Registry Hive HKEY_LOCAL_MACHINE HKEY_USERS HKEY_CURRENT_CONFIG HKEY_CLASSES_ROOT Abbreviation HKLM HKU HKCC HKCR Ignoring subkeys Use the IgnoreSubKeys option for the Keys attribute to prevent the RegistryReplication agent from replicating the subkeys. Table 7-7 describes possible combination of values for the Keys attribute. The Result column describes the agent behavior in these scenarios:

VCS infrastructure and support agents<br />

Registry Replication (RegRep) agent<br />

139<br />

Excluding keys<br />

This section describes the algorithm the Registry Replication agent uses while<br />

excluding keys. For example, assume a registry key KEY_X has a subkey of KEY_Y,<br />

which has a subkey KEY_Z. This key would appear as KEY_X\KEY_Y\KEY_Z in the<br />

Registry Editor.<br />

Table 7-5 describes various scenarios of keys marked for replication and for<br />

exclusion. The Result column describes the agent behavior in these scenarios.<br />

Table 7-5<br />

RegRep agent exclude keys and behavior<br />

Keys for<br />

Replication<br />

KEY_X<br />

KEY_X<br />

KEY_X<br />

KEY_X\KEY_Y<br />

Exclude Keys<br />

KEY_Y\KEY_Z<br />

KEY_Y<br />

KEY_X<br />

KEY_X<br />

Result<br />

KEY_Y is excluded. So is KEY_Z.<br />

KEY_Y is excluded. So is KEY_Z.<br />

KEY_X is not excluded and an error<br />

message is logged.<br />

KEY_X is not excluded and an error<br />

message is logged.<br />

Configuring registry keys<br />

To configure a registry key to be replicated or excluded, use the abbreviation<br />

corresponding to the registry hive, as listed in Table 7-6.<br />

Table 7-6<br />

RegRep agent registry hive<br />

Registry Hive<br />

HKEY_LOCAL_MACHINE<br />

HKEY_USERS<br />

HKEY_CURRENT_CONFIG<br />

HKEY_CLASSES_ROOT<br />

Abbreviation<br />

HKLM<br />

HKU<br />

HKCC<br />

HKCR<br />

Ignoring subkeys<br />

Use the IgnoreSubKeys option for the Keys attribute to prevent the<br />

RegistryReplication agent from replicating the subkeys.<br />

Table 7-7 describes possible combination of values for the Keys attribute. The<br />

Result column describes the agent behavior in these scenarios:

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!