Quorum/Witness Common Parameters

The table below lists the Quorum parameters. These values are tuned by editing the /etc/default/LifeKeeper configuration file.

These parameters take effect immediately after they are set.

Parameter Name Meaning Setting Value Default Value
QUORUM_MODE Specifies the quorum mode. majority
tcp_remote
storage
none or off
majority
WITNESS_MODE Specifies the witness mode. remote_verify
storage
none or off
remote_verify
QUORUM_LOSS_ACTION Specifies the action when quorum is lost. fastkill
fastboot
osu
fastkill
ALLOW_EXTEND_WITH_QUORUM_ERROR If an error or quorum failure occurs in the quorum system, the user has the option to continue the resource extension or stop the operation to address the quorum issue before the resource extension. true
false
false

Parameters applied only when tcp_remote is specified for QUORUM_MODE

These parameters take effect immediately after they are set.

Parameter Name Meaning Setting Value Default Value
QUORUM_HOSTS Specifies a host and port name combination to be used for determining quorum. The format for entries is “host:port”. When specifying more than one host:port combination, the entries must be comma separated (do not include a space).

(Example)

QUORUM_HOSTS=myhost:80,router1:443,router2:22
String (not set)
QUORUM_TIMEOUT_SECS The time allowed for tcp/ip witness connections to complete. Connections that don’t complete within this time are treated as failed/unavailable. This only applies when the QUORUM_MODE is tcp_remote. Integers 20

Parameters applied only when storage is specified for QUORUM_MODE and WITNESS_MODE

Execute qwk_storage_init to take effect these parameters.

Parameter Name Meaning Setting Value Default Value
QWK_STORAGE_TYPE Specifies the type of shared storage.
Must be specified when QUORUM_MODE is storage.
block
file
aws_s3
(not set)
QWK_STORAGE_HBEATTIME Specifies the interval in seconds between reading and writing the QWK objects.
This value must be greater than or equal to the LCMHBEATTIME setting value.
An integer between 5 and 10 6
QWK_STORAGE_NUMHBEATS Specifies the number of consecutive heartbeat checks that when reached indicates the target node has failed. A missed heartbeat occurs when the QWK object has not been updated since the last check. An integer of 3 or more 4
QWK_STORAGE_OBJECT_<hostname>
Note: If the host name contains a “-” or “.”, replace them with an underscore “_” (e.g. lksios-1 → lksios_1).
Note: The host name used by LifeKeeper can be checked via the lcduname command.
Specifies the path to the QWK objects. You must specify paths for all nodes in the cluster.

[When QWK_STORAGE_TYPE is block]
Specify the device file path.
Note: Use WWID (/dev/disk/by-id/) to specify a permanent path.
(Example)
QWK_STORAGE_OBJECT_nodeA=/dev/disk/by-id/xxxxx
QWK_STORAGE_OBJECT_nodeB=/dev/disk/by-id/yyyyy

[When QWK_STORAGE_TYPE is file]
Specify the regular file path.
(Example)
QWK_STORAGE_OBJECT_nodeA=/quorum/nodeA
QWK_STORAGE_OBJECT_nodeB=/quorum/nodeB

[When QWK_STORAGE_TYPE is aws_s3]
Specify the S3uri for the Amazon S3 object. Use an S3 object from a different region than the one where LifeKeeper is running. One region is enough, but when specifying 2 regions, make sure to separate them with commas(do not include spaces).
(Example 1)
QWK_STORAGE_OBJECT_nodeA=s3://bucket1/nodeA,s3://bucket2/nodeA
QWK_STORAGE_OBJECT_nodeB=s3://bucket1/nodeB,s3://bucket2/nodeB
(Example 2)
QWK_STORAGE_OBJECT_nodeA=s3://bucket/quorum/nodeA
QWK_STORAGE_OBJECT_nodeB=s3://bucket/quorum/nodeB

To access Amazon S3 in another region from an environment without Internet access, or to access Amazon S3-compatible object storage, you need to specify an endpoint and region. In
QWK_STORAGE_OBJECT_<hostname>, specify the S3 endpoint after s3uri with +, and then specify the region with +. For example:

QWK_STORAGE_OBJECT_nodeA=s3://bucket/quorum/nodeA+https://bucket.vpce-XXXX.vpce.amazonaws.com/+us-east-1

QWK_STORAGE_OBJECT_nodeB=s3://bucket/quorum/nodeB+https://bucket.vpce-XXXX.vpce.amazonaws.com/+us-east-1

Note: NodeA and nodeB must be regular files and not directories.
String (Maximum length is 256 characters) (not set)
HTTP_PROXY
HTTPS_PROXY
NO_PROXY
Set this parameter when accessing AWS CLI via proxy. The value set here will be passed to AWS CLI. See AWS documentation for details.

This is a common parameter for Recovery Kit for EC2 and Recovery Kit for Route53.
String (not set)

Feedback

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment