Skip to content
Raphaël De Giusti edited this page Sep 3, 2012 · 1 revision

This is configuration file documentation for the latest synapse version from the master branch.

Post section of kickstart for ComodIT

Copy this to the %post section in your kickstart file.

# Configure Synapse
cat << EOF > /etc/synapse/synapsed.conf
[bootstrap]
register = True
host = my.comodit.com
username = ${_org.access_key}
password = ${_org.secret_key}
uuid = ${_host.uuid}
EOF

# Synapse for one time install
/usr/bin/synapse --uri ${_setup_url}

Minimal configuration file for autodiscover on my.comodit.com

Modify the <ORG_ACCESS_KEY> and <ORG_SECRET_KEY> according to your ComodIT organization informations.

  • /etc/synapse/synapsed.conf
[bootstrap]
register = True
host = my.comodit.com
username = <ORG_ACCESS_KEY>
password = <ORG_SECRET_KEY>

Full configuration file

  • /etc/synapse/synapsed.conf
###############################################################################
# BOOTSTRAP SECTION
# Use this section to autodiscover your host
# If the register option is set to True some of the rabbitmq settings will be
# overriden, such as the username, uuid, host, vhost
###############################################################################
[bootstrap]
#------------------------------------------------------------------------------
# The rabbitmq server hostname
#------------------------------------------------------------------------------
host = my.comodit.com

#------------------------------------------------------------------------------
# These are identifiers for connecting to your organization
#------------------------------------------------------------------------------
username = org.ORGANIZATION_ACCESS_KEY
password = ORGANIZATION_SECRET_KEY

#------------------------------------------------------------------------------
# This is the default rabbitmq port (not ssl)
#------------------------------------------------------------------------------
port = 5672

#------------------------------------------------------------------------------
# Synapse certificate requests will be published in this queue
#------------------------------------------------------------------------------
queue = register

#------------------------------------------------------------------------------
# If set to True, Synapse will generate a key pair and a CSR, publish it in the
# register queue and wait for the server's response which will contain the
# certificates
#------------------------------------------------------------------------------
register = False

#------------------------------------------------------------------------------
# Synapse will initiate the AMQP connection to this vhost.
#------------------------------------------------------------------------------
vhost = /

#------------------------------------------------------------------------------
# Synapse will ask the bootstrapping server to create a queue with this uuid
# value. Synapse will bind to this queue after the bootstrapping.
#------------------------------------------------------------------------------
uuid =

###############################################################################
# RABBITMQ SECTION
# This section contains specific options for rabbitmq.
# WARNING: Some of these options can be overriden if the bootstrap section is
# used.
###############################################################################
[rabbitmq]
#------------------------------------------------------------------------------
# These options set the paths in which pem files will be stored
#------------------------------------------------------------------------------
cacertfile = /etc/synapse/ssl/certs/cacert.pem
certfile = /etc/synapse/ssl/certs/cert.pem
csrfile = /etc/synapse/ssl/csr/csr.pem
keyfile = /etc/synapse/ssl/private/key.pem

#------------------------------------------------------------------------------
# Check whether or not the server asks for a certificate from the client.
#------------------------------------------------------------------------------
fail_if_no_peer_cert = True

#------------------------------------------------------------------------------
# Rabbitmq will kill the TCP socket if there's no trafic during this number of
# seconds. This prevent fantom connections to remain active.
#------------------------------------------------------------------------------
heartbeat = 30

#------------------------------------------------------------------------------
# The rabbitmq hostname
# The host is overridden by the host of the bootstrap section if 
# bootstrapping was successful.
#------------------------------------------------------------------------------
host = localhost

#------------------------------------------------------------------------------
# Username / password to connect to the specified vhost
# The username is overridden by the username of the bootstrap section if 
# bootstrapping was successful.
#------------------------------------------------------------------------------
username = guest
password = guest

#------------------------------------------------------------------------------
# Connection port (by default, 5671 is for SSL)
#------------------------------------------------------------------------------
port = 5671

#------------------------------------------------------------------------------
# Use SSL encryption ?
# use_ssl will be set to True if bootstrapping was successful
#------------------------------------------------------------------------------
use_ssl = True

#------------------------------------------------------------------------------
# Use SSL authentication ? This requires the server to have the
# ssl_auth_mechanism_plugin enabled.
# ssl_auth will be set to True if bootstrapping was successful
#------------------------------------------------------------------------------
ssl_auth = True

#------------------------------------------------------------------------------
# Synapse will publish its message into this queue if no reply_to header is set
# to an RPC request.
#------------------------------------------------------------------------------
status_queue = inbox

#------------------------------------------------------------------------------
# Synapse will try to bind to this queue
# The uuid is overridden by the uuid of the bootstrap section if bootstrapping 
# was successful.
#------------------------------------------------------------------------------
uuid = 

#------------------------------------------------------------------------------
# Synapse will initiate the AMQP connection to this vhost.
# The vhost is overridden by the vhost of the bootstrap section if 
# bootstrapping was successful.
#------------------------------------------------------------------------------
vhost = /

###############################################################################
# RESOURCEFILE SECTION
# This is the setup.json "one time" synapse run options section
###############################################################################
[resourcefile]
#------------------------------------------------------------------------------
# The path to the setup.json file on the system
#------------------------------------------------------------------------------
path = /tmp/setup.json

#------------------------------------------------------------------------------
# The url to the setup.json file on the system
#------------------------------------------------------------------------------
url = http://localhost/setup.json
#
#------------------------------------------------------------------------------
# Synapse will try to reach the url for this number of seconds
#------------------------------------------------------------------------------
timeout = 10


###############################################################################
# CONTROLLER SECTION
# This section contains options for managing resources-plugins
###############################################################################
[controller]
#------------------------------------------------------------------------------
# This very config file path
#------------------------------------------------------------------------------
config_file = /etc/synapse/synapsed.conf

#------------------------------------------------------------------------------
# Path to custom plugins
#------------------------------------------------------------------------------
custom_plugins = /var/lib/synapse/custom_plugins

#------------------------------------------------------------------------------
# Override these to force the instantiation of plugins for a specific OS
# These settings are auto-discovered and set when synapse will start if empty.
#------------------------------------------------------------------------------
distribution_name =
distribution_version =

#------------------------------------------------------------------------------
# Synapse automatically loads every plugin it finds. There are some built-in
# plugins in synapse source folder, the rest in is the custom_plugins path. Just
# specify a list of comma separated plugin names not to load them at synapse
# startup. Example: services-plugin,hosts-plugin
#------------------------------------------------------------------------------
ignored_resources =

#------------------------------------------------------------------------------
# Resources states will be stored in this path
#------------------------------------------------------------------------------
persistence_path = /var/lib/synapse/persistence

###############################################################################
# LOGGING SECTION
# This section sets logging options
###############################################################################
[logconf]
#------------------------------------------------------------------------------
# Loglevel
#------------------------------------------------------------------------------
level = INFO

#------------------------------------------------------------------------------
# Path to log files
#------------------------------------------------------------------------------
path = /var/log/synapse/

###############################################################################
# MONITORING SECTION
# This section sets monitoring options
###############################################################################
[monitor]
#------------------------------------------------------------------------------
# By default, every resource state will be checked by this number of seconds
#------------------------------------------------------------------------------
default_interval = 30

#------------------------------------------------------------------------------
# Once a compliance message is sent, it won't be sent again before this
# interval (in seconds)
#------------------------------------------------------------------------------
alert_interval = 3600

#------------------------------------------------------------------------------
# You can add custom interval for any resource managed by synapse simply by
# specifying its name and the number of seconds. The following example will
# check packages states every 20 seconds and send host status every 10 seconds
# (this was formerly the ping_cortex options)
#------------------------------------------------------------------------------
#packages = 20
#hosts = 10