Skip to content

Delegate host configuration variables

The tables in this section provide an overview of the serviced configuration variables that apply to Control Center delegate hosts. Set these variables as required for your environment or applications.

Delegate variables

The following miscellaneous variables apply only to delegate hosts.

Variable Description
SERVICED_ZK The list of hosts in the ZooKeeper
SERVICED_STATS_PERIOD The frequency at which delegates gather metrics to send to the master host.
SERVICED_IPTABLES_MAX_CONNECTIONS The maximum number of open connections to allow on a delegate. The number increases when the master is unavailable and decreases when the master returns to service.

Internal services endpoint variables

The variables in the following table must be set identically on all Control Center delegate hosts.

The SERVICED_AUTH_TOKEN_EXPIRATION variable affects RPC, mux, and internal services endpoint traffic.

Variable Endpoint Description
SERVICED_DOCKER_REGISTRY (varies) The local Docker registry for Control Center internal services images and application images.
SERVICED_ENDPOINT Master-Host:4979 The serviced RPC server. The endpoint port number must match the value of SERVICED_RPC_PORT.
SERVICED_LOG_ADDRESS Master-Host:5042 The logstash service.
SERVICED_LOGSTASH_ES Master-Host:9100 The Elasticsearch service for logstash.
SERVICED_STATS_PORT Master-Host:8443 The serviced metrics consumer service.
SERVICED_AUTH_TOKEN_EXPIRATION (none) The length of time a delegate authentication token is valid.

RPC service variables

The variables in the following table must be set identically on all Control Center hosts, except:

  • SERVICED_RPC_PORT, set only on the master
  • SERVICED_MAX_RPC_CLIENTS, set only on delegates

By default, serviced uses TLS to encrypt all RPC traffic. The SERVICED_KEY_FILE and SERVICED_CERT_FILE variables identify the digital certificate used for RPC, mux, and HTTP traffic.

The SERVICED_AUTH_TOKEN_EXPIRATION variable affects RPC, mux, and internal services endpoint traffic.

Variable Where to set
SERVICED_ENDPOINT Master, delegates
SERVICED_MAX_RPC_CLIENTS Delegates
SERVICED_RPC_PORT Master
SERVICED_RPC_CERT_VERIFY Master, delegates
SERVICED_RPC_DISABLE_TLS Master, delegates
SERVICED_RPC_TLS_MIN_VERSION Master, delegates
SERVICED_RPC_TLS_CIPHERS Master, delegates
SERVICED_KEY_FILE Master
SERVICED_CERT_FILE Master
SERVICED_RPC_DIAL_TIMEOUT Master, delegates
SERVICED_AUTH_TOKEN_EXPIRATION Master

Multiplexer variables

The variables in the following table must be set identically on all Control Center hosts.

By default, serviced uses TLS to encrypt all mux traffic. The SERVICED_KEY_FILE and SERVICED_CERT_FILE variables identify the digital certificate used for RPC, mux, and HTTP traffic.

The SERVICED_AUTH_TOKEN_EXPIRATION variable affects RPC, mux, and internal services endpoint traffic.

Variable Where to set
SERVICED_MUX_PORT Master, delegates
SERVICED_MUX_DISABLE_TLS Master, delegates
SERVICED_MUX_TLS_MIN_VERSION Master, delegates
SERVICED_MUX_TLS_CIPHERS Master, delegates
SERVICED_KEY_FILE Master
SERVICED_CERT_FILE Master
SERVICED_AUTH_TOKEN_EXPIRATION Master