Clusters Options

Agency endpoint

List of agency endpoints:—cluster.agency-endpoint endpoint

An agency endpoint the server can connect to. The option can be specifiedmultiple times, so the server can use a cluster of agency servers.Endpoints have the following pattern:

  • tcp://ipv4-address:port - TCP/IP endpoint, using IPv4
  • tcp://[ipv6-address]:port - TCP/IP endpoint, using IPv6
  • ssl://ipv4-address:port - TCP/IP endpoint, using IPv4, SSL encryption
  • ssl://[ipv6-address]:port - TCP/IP endpoint, using IPv6, SSL encryptionAt least one endpoint must be specified or ArangoDB will refuse to start.It is recommended to specify at least two endpoints so ArangoDB has analternative endpoint if one of them becomes unavailable.

Examples

  1. --cluster.agency-endpoint tcp://192.168.1.1:4001 --cluster.agency-endpoint tcp://192.168.1.2:4002 ...

My address

This server’s address / endpoint:—cluster.my-address endpoint

The server’s endpoint for cluster-internal communication. If specified, itmust have the following pattern:

  • tcp://ipv4-address:port - TCP/IP endpoint, using IPv4
  • tcp://[ipv6-address]:port - TCP/IP endpoint, using IPv6
  • ssl://ipv4-address:port - TCP/IP endpoint, using IPv4, SSL encryption
  • ssl://[ipv6-address]:port - TCP/IP endpoint, using IPv6, SSL encryptionIf no endpoint is specified, the server will look up its internalendpoint address in the agency. If no endpoint can be found in the agencyfor the server’s id, ArangoDB will refuse to start.

Examples

Listen only on interface with address 192.168.1.1

  1. --cluster.my-address tcp://192.168.1.1:8530

Listen on all ipv4 and ipv6 addresses, which are configured on port 8530

  1. --cluster.my-address ssl://[::]:8530

My role

This server’s role:—cluster.my-role [dbserver|coordinator]

The server’s role. Is this instance a db server (backend data server)or a coordinator (frontend server for external and application access)

Node ID (deprecated)

This server’s id: —cluster.my-local-info info

Some local information about the server in the cluster, this can forexample be an IP address with a process ID or any string unique tothe server. Specifying info is mandatory on startup if the serverid (see below) is not specified. Each server of the cluster musthave a unique local info. This is ignored if my-id below is specified.

This option is deprecated and will be removed in a future release. Thecluster node ids have been dropped in favour of once generated UUIDs.

More advanced options

These options should generally remain untouched.

Synchroneous replication timing: —cluster.synchronous-replication-timeout-factor double

Strech or clinch timeouts for internal synchroneous replicationmechanism between db servers. All such timeouts are affected by thischange. Please change only with intent and great care. Default at 1.0.

System replication factor: —cluster.system-replication-factorinteger

Change default replication factor for system collections. Default at 2.