Driver arbitrator

Minimal configlet:

[arbitrator]
uri = http://www.opensvc.com

Minimal setup command:

om test/ccfg/foo set --kw="uri=http://www.opensvc.com"

Supported keywords:

• comment
• insecure
• uri
• weight

Keyword comment

required:    false
scopable:    false
rbac:        This driver group requires the root grant.

Description:

A free form text describing the role of the object, of the node, or of the section it is set in.

The keyword is accepted in any section, so the DEFAULT section can document a configuration as a whole, and a resource, pool, heartbeat, array or network section can document itself.

The agent does not interpret the value.

Keyword insecure

required:    false
scopable:    false
default:     false
convert:     bool
rbac:        This driver group requires the root grant.

Description:

Set to true to disable the arbitrator SSL certificate verification on the https uri.

This should only be enabled for testing.

Keyword uri

required:    true
scopable:    false
aliases:     name
rbac:        This driver group requires the root grant.

Example:

uri=http://www.opensvc.com

Description:

The arbitrator uri used by cluster node to ask for a vote when the cluster is split.

When the uri scheme is http or https, the vote checker is based on a GET request, else it is based on a TCP connect.

When the port is not specified in a TCP connect uri, the port of the cluster listener is implied: listener.port, 1215 by default. An arbitrator still listening on the 1214 port of a v2 agent must name it in the uri.

Arbitrators are tried in sequence, each reachable arbitrator gives a vote.

In case of a real split, all arbitrators are expected to be unreachable from the lost segment. At least one of them is expected to be reachable from the surviving segment.

Arbitrators of a cluster must thus be located close enough to each other, so a subset of arbitrators can’t be reachable from a split cluster segment, while another subset of arbitrators is reachable from the other split cluster segment.

But not close enough so they can all fail together. Usually, this can be interpreted as: same site, not same rack and power lines.

Arbitrators are verified every 60s to alert admins of the arbitrator failures.

Keyword weight

required:    false
scopable:    false
default:     1
convert:     int
rbac:        This driver group requires the root grant.

Description:

During a quorum vote, this reachable arbitrator contributes <n> votes.