Search <book_title>...

InfoScale™ Cluster Server 9.0 Bundled Agents Reference Guide - Linux

Last Published: 2025-04-14

Product(s): InfoScale & Storage Foundation (9.0)

Platform: Linux

Attributes

Table: Required attributes

Attribute	Description
RvgResourceName	The name of the RVGShared resource type that this agent will promote, that is, the name RVG resource type which has been configured using the RVGShared agent. Type and dimension: string-scalar
AutoTakeover	A flag to indicate whether the agent should perform a takeover on online if the original Primary is down. Type and dimension: integer-scalar Default: 1
AutoResync	A flag to indicate whether the agent should attempt to automatically perform a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns. Type and dimension: integer-scalar Default: 0
VCSResLock	This attribute is reserved for internal use by VCS. Type and dimension: string-scalar
BunkerSyncTimeOut	Determines whether or not the bunker performs a replay of the replicator log to the Secondary. Set this value in seconds to specify the time allocated for the log replay. You can use the following values: 0: Disables bunker replay. The RVGSharedPri agent immediately performs a takeover on the Secondary, without sending pending writes from the bunker to the Secondary. Custom value (in seconds): The RVGSharedPri agent sends writes to the Secondary for the specified duration. After the time limit is reached, the agent performs the takeover on the Secondary. The bunker replay time equals the specified value and can be set dynamically. Null (default value): If you do not specify a value for this attribute (the default null value), the RVGSharedPri agent considers it as an infinite timeout value. The RVGSharedPri agent replays all the writes in the bunker replicator log to the Secondary. Cluster Server (VCS) performs the takeover on the Secondary only after the agent sends all the writes to the Secondary. The OnlineTimeout and OnlineRetryLimit attributes of the RVGSharedPri agent determine how long an RVGPrimary resource has to complete its online operation. Use the following formula to calculate the Time Available for Online to Complete (TAOC): TAOC = OnlineTimeout + ( OnlineRetryLimit × OnlineTimeout ) When you set the BunkerSyncTimeOut value in seconds, the value of TAOC for the RVGPrimary agent should be greater than the desired BunkerSyncTimeOut value. Using a TAOC value that is greater than BunkerSyncTimeOut value ensures that the bunker replay and the RVG takeover can complete in the allotted time for that particular online operation. If the TAOC is smaller than BunkerSyncTimeOut value and the bunker replay does not complete within the allotted time for the online process, the resource faults. If the resource faults, clear the fault. Try the online operation again if the resource has not failed over to other cluster node in the configuration. If you increase the value of the BunkerSyncTimeOut attribute, you need to increase the value of the OnlineTimeout or OnlineRetryLimit attribute so that TAOC remains greater than the changed value. This is to ensure that the bunker replay completes within allotted time for online. Type and dimension: string-scalar Default: ""
BunkerSyncElapsedTime	The time, in seconds, that the Secondary RVG has waited for the synchronization from the bunker host to complete. This attribute is reserved for internal use only. Do not modify this attribute value. Type and dimension: integer-scalar
EnableSingleWriter	This attribute is used to enable or disable the Single Writer feature for applications that are configured in failover service groups on single node VCS clusters. You can use the following values: 1: Enables the Single Writer feature in the next online operation of the agent. The agent activates the `single_writer` flag using the required VVR commands to transfer the VVR Logowner role to the node where the RVGSharedPri resource is online. This is on the same node where the application failover service group is online. 0: Disables the Single Writer feature using the agent's online entry point. The agent deactivates the `single_writer` flag using the required VVR commands to restore the agent behavior to the default settings. -1 (default value): The Single Writer feature remains inactive and there is no change in the default agent behavior. Refer to the InfoScale Replication Administrator's Guide for more information about the Single Writer feature. Type and dimension: string-scalar Default: -1 Note: If the EnableSingleWriter attribute is modified after the application service group is already online, then those changes take effect during the next online operation of the RVGSharedPri resource.

Table: Optional attributes

Attribute	Description
NumThreads	Number of threads used within the agent process for managing resources. This number does not include threads used for other internal purposes. Do not modify this attribute for this agent. Setting this attribute to a higher value may result in agent function timeouts due to serialization of underlying commands. Default: 1
ResyncType	Allows you to choose between automatic synchronization and difference-based synchronization. By default, difference-based synchronization is enabled for resynchronization. To enable automatic synchronization, enter: # haconf -makerw *# hares -modify RVGSharedPri_resource_name* ResyncType 1 # haconf -dump -makero # hares -value RVGSharedPri_resource_name ResyncType** To track automatic synchronization progress, enter: # vxrlink -g dg_name -i time_interval status rlk_name # vradmin -g dg_name repstatus rvg_name Type and dimension: integer-scalar Default: 0

Attribute

Description

NumThreads

Number of threads used within the agent process for managing resources. This number does not include threads used for other internal purposes.

Do not modify this attribute for this agent.

Setting this attribute to a higher value may result in agent function timeouts due to serialization of underlying commands.

Default: 1

ResyncType

Allows you to choose between automatic synchronization and difference-based synchronization.

By default, difference-based synchronization is enabled for resynchronization.

To enable automatic synchronization, enter:

# haconf -makerw

# hares -modify RVGSharedPri_resource_name ResyncType 1

# haconf -dump -makero

# hares -value RVGSharedPri_resource_name ResyncType

To track automatic synchronization progress, enter:

# vxrlink -g dg_name -i time_interval status rlk_name

# vradmin -g dg_name repstatus rvg_name

Type and dimension: integer-scalar

Default: 0

Note:

Default settings of AutoTakeover=1 and AutoResync=0 cause the first failover to succeed when the original Primary goes down, and upon the original Primary's return, the RDS has a Primary-Primary configuration error. Set the default value of the AutoResync attribute of the RVGPrimary and RVGSharedPri agents to 1 if you want the agent to automatically attempt a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns. This prevents the Primary-Primary configuration error.

Note:

Configurations having multiple RVGs in the same disk group (DG) is currently not supported through the RVGSharedPri agent.