# Driver `arbitrator`

**Minimal configlet:**

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

**Minimal setup command:**

	om node set --kw="uri=http://www.opensvc.com"

**Supported keywords:**

- comment
- insecure
- uri
- weight

## Keyword `comment`

	required:    false
	scopable:    false

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

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

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

**Description:**

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