gabconfig (1M)

NAME

gabconfig - Group Membership and Atomic Broadcast (GAB) configuration utility

SYNOPSIS

sbin/gabconfig [-abBcejJklRsuUvWx] [-f iofence] [-n count ] [-t stable ] [-V version] [-S param:value]

DESCRIPTION

The gabconfig utility sets up and maintains the configuration of the GAB driver. The GAB driver is dependent on the Low Latency Transport (LLT) protocol, which must be configured prior to running gabconfig.

OPTIONS

-a Display GAB driver port memberships.

-b Enable system halt when the process fails to heartbeat. By default, if a process fails to heartbeat in a given interval, GAB makes five attempts to kill the process. With this option set, GAB panics the system without making any attempts to kill the process. This option can be turned off using the -B option.

-B Disable system halt when the process fails to heartbeat. This option will turn off the functionality enabled by the -b option.

-e Print out kernel tunables set for GAB. If the value of the tunables is changed, the changed value will get into effect on module reload.

-c Configure the driver for use. Configuring the GAB driver enables client registrations and the joining of an already seeded group.

-j Enable halt on rejoin. A network failure may cause systems to form independant clusters, or partitions. When the connections are restored, systems will attempt to rejoin into one cluster. By default, GAB kills processes associated with ports on rejoining systems. This option directs GAB to halt the system.

-J Disable halt on rejoin. This option will turn off the functionality enabled by the -j option.

-k Repeat attempts to kill a process that does not die. By default, after five attempts to kill a process, GAB halts the system. This option directs GAB to close the client port and repeatedly and silently attempt to kill a process without halting the system.

-l Display the GAB driver configuration.

-s Single network. This flag disables network partition arbitration and should be used only to test configurations. It is required for operating GAB over one network connection.

-S param:value
Change the value of the gab tunables. Valid param fields are:
isolate_time: Specify a timeout (in milliseconds) for clients to respond to SIGKILL signal. When gab clients receive SIGKILL signal they must unregister from the GAB driver within isolate_time milliseconds to avoid halting the system. The default value is 120000 ms or 120 seconds.
kill_ntries: Specify the maximum no of SIGABRT signals sent to the client when client stops sending heartbeats to GAB driver. The default value is 5.

-u Unconfigure the GAB driver. Close the seed control port (port a) if all client ports are closed.

-U Unconfigure the GAB driver and reinitialize all configuration states.

-v Display GAB version information like the product version, build time stamp, interface version, minimum, maximum, and on-the-wire protocol versions.

-W Display the supported range of the GAB protocol versions and the current version.

-x Seed control port. This option affords protection from pre-existing network partitions. The control port (port a) propagates the seed to all configured systems. GAB must be seeded to enable the delivery of membership on client ports.

-R Start the rolling upgrade process. If cluster is running at the GAB protocol version lower than the version which all the cluster nodes can understand, this option will start the rolling upgrade process. Once rolling upgrade process is finished, GAB on all the nodes will start talking in the maximum supported version. The rolling upgrade process may fail if cluster membership changes during the process of rolling upgrade. This option must be used only on the lowest nodeid in the cluster.

-V protocol_version
Specify the GAB protocol version. GAB can be configured to operate at any version within the version range returned by the -v option.

-f iofence_timeout
Specify a timeout (in milliseconds) for clients to respond to an IOFENCE message before the system halts. When clients receive an IOFENCE message, they must unregister from the GAB driver within iofence_timeout milliseconds to avoid halting the system. The default is 15000ms or 15 seconds.

-n system_count
Count of systems in the cluster. A non-zero system count auto-seeds the cluster when all systems are present. The default is zero, for no auto-seeding.

-t stable_timeout
Specifies the time GAB waits to reconfigure membership after the last report from LLT of a change in the state of local node connections for a given port. Any change in the state of connections will restart GAB waiting period. stable_timeout applies during membership transitions. The default value for stable_timeout is five seconds. Note that message latency for connection state messages, typically less than one second, should be taken into consideration when calculating stable_timeout value.

DISCLAIMER

When LLT and GAB are running under a cluster manager other than VCS, configure LLT and GAB as per the cluster manager’s supplementary documentation on LLT and GAB. -k, -b, -B, -f, -j, -J options are applicable only in VCS environment.

VCS 5.1 SP1

gabconfig (1M)

-a	Display GAB driver port memberships.
-b	Enable system halt when the process fails to heartbeat. By default, if a process fails to heartbeat in a given interval, GAB makes five attempts to kill the process. With this option set, GAB panics the system without making any attempts to kill the process. This option can be turned off using the -B option.
-B	Disable system halt when the process fails to heartbeat. This option will turn off the functionality enabled by the -b option.
-e	Print out kernel tunables set for GAB. If the value of the tunables is changed, the changed value will get into effect on module reload.
-c	Configure the driver for use. Configuring the GAB driver enables client registrations and the joining of an already seeded group.
-j	Enable halt on rejoin. A network failure may cause systems to form independant clusters, or partitions. When the connections are restored, systems will attempt to rejoin into one cluster. By default, GAB kills processes associated with ports on rejoining systems. This option directs GAB to halt the system.
-J	Disable halt on rejoin. This option will turn off the functionality enabled by the -j option.
-k	Repeat attempts to kill a process that does not die. By default, after five attempts to kill a process, GAB halts the system. This option directs GAB to close the client port and repeatedly and silently attempt to kill a process without halting the system.
-l	Display the GAB driver configuration.
-s	Single network. This flag disables network partition arbitration and should be used only to test configurations. It is required for operating GAB over one network connection.
-S param:value
	Change the value of the gab tunables. Valid param fields are: isolate_time: Specify a timeout (in milliseconds) for clients to respond to SIGKILL signal. When gab clients receive SIGKILL signal they must unregister from the GAB driver within isolate_time milliseconds to avoid halting the system. The default value is 120000 ms or 120 seconds. kill_ntries: Specify the maximum no of SIGABRT signals sent to the client when client stops sending heartbeats to GAB driver. The default value is 5.
-u	Unconfigure the GAB driver. Close the seed control port (port a) if all client ports are closed.
-U	Unconfigure the GAB driver and reinitialize all configuration states.
-v	Display GAB version information like the product version, build time stamp, interface version, minimum, maximum, and on-the-wire protocol versions.
-W	Display the supported range of the GAB protocol versions and the current version.
-x	Seed control port. This option affords protection from pre-existing network partitions. The control port (port a) propagates the seed to all configured systems. GAB must be seeded to enable the delivery of membership on client ports.
-R	Start the rolling upgrade process. If cluster is running at the GAB protocol version lower than the version which all the cluster nodes can understand, this option will start the rolling upgrade process. Once rolling upgrade process is finished, GAB on all the nodes will start talking in the maximum supported version. The rolling upgrade process may fail if cluster membership changes during the process of rolling upgrade. This option must be used only on the lowest nodeid in the cluster.
-V protocol_version
	Specify the GAB protocol version. GAB can be configured to operate at any version within the version range returned by the -v option.
-f iofence_timeout
	Specify a timeout (in milliseconds) for clients to respond to an IOFENCE message before the system halts. When clients receive an IOFENCE message, they must unregister from the GAB driver within iofence_timeout milliseconds to avoid halting the system. The default is 15000ms or 15 seconds.
-n system_count
	Count of systems in the cluster. A non-zero system count auto-seeds the cluster when all systems are present. The default is zero, for no auto-seeding.
-t stable_timeout
	Specifies the time GAB waits to reconfigure membership after the last report from LLT of a change in the state of local node connections for a given port. Any change in the state of connections will restart GAB waiting period. stable_timeout applies during membership transitions. The default value for stable_timeout is five seconds. Note that message latency for connection state messages, typically less than one second, should be taken into consideration when calculating stable_timeout value.