Configuring Control Center

Control Center (serviced) is a single binary that behaves differently based on the variables defined in its startup script, /etc/init/serviced.conf, and in its defaults file, /etc/default/serviced. The values in the defaults file take precedence over the values defined in the startup script.

The following list describes the contents of /etc/default/serviced and their affects on the serviced daemon.

HOME
Default: /root
The path serviced uses to locate the .dockercfg file.

This variable is included in the startup script, /etc/init/serviced.conf.

GOMAXPROCS
Default: 2
The maximum number of CPU cores serviced uses.

This variable is included in the startup script, /etc/init/serviced.conf.

SERVICED_AGENT
Default: 1 (true)
One of two variables that determine whether serviced assumes the role of agent or master. The other variable is SERVICED_MASTER.
  • To configure serviced as an agent:
    SERVICED_AGENT=1
    SERVICED_MASTER=0
  • To configure serviced as the master:
    SERVICED_AGENT=1
    SERVICED_MASTER=1

This variable is included in the startup script, /etc/init/serviced.conf.

SERVICED_MASTER
Default: 1 (true)
One of two variables that determine whether serviced assumes the role of agent or master. The other variable is SERVICED_AGENT.

This variable is included in the startup script, /etc/init/serviced.conf.

SERVICED_MASTER_POOLID
Default: default
The name of the resource pool in which the serviced instance configured as master is located.
SERVICED_MASTER_IP
Default: 172.17.42.1
The IP address of the serviced instance configured as master. This variable simplifies the configuration of multi-host deployments.
SERVICED_ZK
Default: $SERVICED_MASTER_IP:2181
The list of endpoints in serviced's ZooKeeper ensemble, separated by the comma character (,). Currently, the serviced instance configured as master is the only host in the ZooKeeper ensemble.
SERVICED_REGISTRY
Default: 1 (true)
Determines whether serviced uses a local registry to store images.
SERVICED_DOCKER_REGISTRY
Default: $SERVICED_MASTER_IP:5000
The IP address and port number of the serviced registry host.
SERVICED_STATIC_IPS
Default: 10.0.0.30,10.0.0.31
The list of static IP addresses reserved for serviced to use when it advertises external IP addresses on behalf of services it manages, separated by the comma character (,).
SERVICED_ENDPOINT
Default: $SERVICED_MASTER_IP:4979
The IP address and port number of the default serviced RPC endpoint.
SERVICED_RPC_PORT
Default: 4979
The port on which serviced listens for RPC requests.
SERVICED_UI_PORT
Default: 443
The port on which serviced listens for HTTPS requests. (The web interface port.)
SERVICED_MUX_PORT
Default: 22250
The port serviced uses for multiplexing on its private subnet.
SERVICED_VARPATH
Default: /opt/serviced/var
The path of the local directory in which serviced stores its data files, including the distributed file system files.
SERVICED_KEY_FILE
Default: /etc/....
The path of a TLS key file. By default, no key file is installed.
SERVICED_CERT_FILE
Default: /etc/....
The path of a TLS certificate file. By default, no certificate file is installed.
SERVICED_VFS
Default: rsync
The driver for virtual file system volumes. The supported drivers are rsync and btrfs.
SERVICED_VHOST_ALIASES
Default: foobar.com,example.com
The list of virtual host aliases to use in virtual host multiplexing, separated by the comma character (,).
SERVICED_MAX_CONTAINER_AGE
Default: 86400 (1 day)
The maximum number of seconds serviced waits before removing a stopped container.
SERVICED_VIRTUAL_ADDRESS_SUBNET
Default: 10.3
The 16-bit private subnet to use for serviced's virtual IPv4 addresses.
Note: This value affects the values of SERVICED_STATIC_IPS.
SERVICED_LOG_LEVEL
Default: 0
The relative amount of debug information to write to the /var/log/upstart/serviced.log file. The range is 0 (minimum) to 5 (maximum).
SERVICED_LOG_ADDRESS
Default: $SERVICED_MASTER_IP:5042
The endpoint of the logstash service.
SERVICED_STATS_PORT
Default: $SERVICED_MASTER_IP:8443
The endpoint of the OpenTSDB reader daemon, for serviced statistics.
SERVICED_STATS_PERIOD
Default: 10
The number of seconds to wait between polls (health checks) of hosts in resource pools.
SERVICED_OPTS
Default: (empty)
Arbitrary options for the serviced startup command.

The Control Center project is provided under the Apache 2.0 license. © 2015 Zenoss Control Center ·2015-05-22 14:29:19 +0000