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
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 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)

Parameters applied only when aws_s3 is specified for QWK_STORAGE_TYPE

Parameter Name Meaning Setting Value Default Value
QWK_CURL_RETRY Specifies the number of attempts to access the Amazon S3 QWK object.

If all attempts to access the Amazon S3 QWK object fail, it determines that Amazon S3 is inaccessible after the number of failed attempts exceeds the value specified in this parameter.

Adjust this parameter if log number 135930 is frequently recorded.
An integer of 1 or more 7
QWK_CURL_CONNECT_TIMEOUT Specifies the timeout period in seconds for each connection to the Amazon S3 QWK object.

Even if the connection times out, access will be retried until the number of failures specified in QWK_CURL_RETRY is reached or the time specified in QWK_CURL_RETRY_TIMEOUT has elapsed.

Adjust this parameter if log number 135931 is frequently recorded.
An integer between 2 and 10 QWK_STORAGE_HBEATTIME
The value set in QWK_STORAGE_HBEATTIME
QWK_CURL_RETRY_TIMEOUT Specifies the timeout period in seconds before determining that the Amazon S3 QWK object is inaccessible.

When all attempts to access the Amazon S3 QWK object fail, it determines that Amazon S3 is inaccessible after the time specified by this parameter has elapsed.

Adjust this parameter if log number 135931 is frequently recorded.
An integer of 30 or more 60
QWK_STORAGE_S3_CREDENTIALS_INTERVAL LifeKeeper for Linux issues a signed URL internally when accessing the Amazon S3 QWK object.

The expiration time of the signed URL can be set in seconds.
An integer between 5400 and 14400 14400

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