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

Parameter Name Meaning Setting Value Default Value When to Apply Notes
QUORUM_MODE Specifies the quorum mode. majority

storage

none or off
off As required (takes effect immediately) Refer to “LifeKeeper Quorum” in the SIOS Technical Documentation.
WITNESS_MODE Specifies the witness mode. remote_verify

storage

none or off
remote_verify As required (takes effect immediately) Refer to “LifeKeeper Quorum” in SIOS Technical Documentation.
QUORUM_LOSS_ACTION Specifies the action when quorum is lost. osu osu As required (takes effect immediately) Refer to “LifeKeeper Quorum” in SIOS Technical Documentation.
QUORUM_QUARANTINE_SECS Specifies the number of seconds that the LifeKeeper service will wait before restarting, after it loses quorum. 300 As required (takes effect immediately)

Parameters valid only when QUORUM_MODE and WITNESS_MODE are set to storage. Run qwk_storage_init to apply these parameters.

Parameter Name Meaning Setting Value Default Value When to Apply Notes
QWK_STORAGE_TYPE
Specifies the type of shared storage.

Must be specified when QUORUM_MODE is storage.
file

aws_s3
(not set) When executing qwk_storage_init
This parameter is applied only when storage is specified for QUORUM_MODE and WITNESS_MODE.
For details, see “Storage Mode” in the Technical Documentation.
QWK_STORAGE_HBEATTIME Specifies the interval in seconds between reading and writing QWK objects. This setting must be greater than or equal to the LCMHBEATTIME setting.

If QWK_STORAGE_TYPE=aws_s3, we recommend setting this value to 7 or higher.
An integer between 5 and 10 6 When executing qwk_storage_init This parameter is applied only when storage is specified for QUORUM_MODE and WITNESS_MODE.
For details, see “Storage Mode” in the Technical Documentation.
QWK_STORAGE_NUMHBEATS Specifies the value for determining that a failure has occurred on the target node in the witness check. When loading a QWK object, if the update has stopped for more than the number of times specified in this parameter, it is determined that a failure has occurred on the target node. This setting must be greater than or equal to the value of LCMNUMHBEATS. An integer of 3 or more 4 When executing qwk_storage_init This parameter is applied only when storage is specified for QUORUM_MODE and WITNESS_MODE.
For details, see “Storage Mode” in the Technical Documentation.

QWK_STORAGE_OBJECT_<Host name>

Note: If the host name contains a “-” replace them with an underscore “_” (e.g. LKSIOS-1 → LKSIOS_1).

Note: Host names should contain all upper case characters.

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 file]

Specify the path to the files on the file server.

(Example)

QWK_STORAGE_OBJECT_NODEA=//file_server/sharename/NODEA
QWK_STORAGE_OBJECT_NODEB=//file_server/sharename/NODEB

Note: Use forward slashes to specify the SMB path to be used, not backslashes.

[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_, specify the S3 endpoint with a + character after s3uri, and the region with a + character. 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) When executing qwk_storage_init

Note: NODEA and NODEB must be regular files and not directories.
This parameter is applied only when storage is specified for QUORUM_MODE and WITNESS_MODE.
For details, see “Storage Mode” in the Technical Documentation.
HTTP_PROXY
HTTPS_PROXY
NO_PROXY
Set this when performing AWS CLI via a proxy. The value set here will be passed to the AWS CLI as is. Please see the AWS documentation for more information.

This parameter is common with Recovery Kit for EC2 and Recovery Kit for Route53.
String (not set) When executing qwk_storage_init This is a common parameter for “EC2” and “Route53”.

Parameters valid only when QWK_STORAGE_TYPE is set to aws_s3

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

If all attempts to access Amazon S3 QWK objects fail and the number of failures exceeds the value specified by this parameter, Amazon S3 is considered inaccessible.

If log number 18227 is recorded frequently, adjust this parameter.
An integer of 1 or more 7
QWK_CURL_CONNECT_TIMEOUT Specify the connection timeout in seconds for each access to Amazon S3 QWK objects.

Even if a timeout occurs, access is retried until the number of retries specified by QWK_CURL_RETRY is reached or the time specified by QWK_CURL_RETRY_TIMEOUT has elapsed.

If log number 18225 is recorded frequently, adjust this parameter.
An integer between 2 and 10 The value set in QWK_STORAGE_HBEATTIME
QWK_CURL_RETRY_TIMEOUT Specifies the timeout in seconds before Amazon S3 QWK objects are considered inaccessible.

If all attempts to access Amazon S3 QWK objects fail and the time specified by this parameter has elapsed, Amazon S3 is considered inaccessible.

If log number 18228 is recorded frequently, adjust this parameter.
An integer of 30 or more 60
QWK_STORAGE_S3_CREDENTIALS_INTERVAL LifeKeeper for Windows issues a signed URL internally when accessing an Amazon S3 QWK object.
You can specify its expiration time 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