7
Configuration of Services
8
=========================
10
Configuration File Format
11
-------------------------
12
Libra uses the `Oslo configuration library <https://wiki.openstack.org/wiki/Oslo/Config>`_
13
so its format is similar to other OpenStack programs.
18
The ``[DEFAULT]`` section contains generic options common to the various
19
Libra utilities (worker, mgm, etc).
29
billing_enable = false
30
notification_driver = []
31
default_notification_level = INFO
32
default_publisher_id = None
38
rabbit_use_ssl = false
40
rabbit_password = guest
41
rabbit_host = localhost
44
rabbit_virtual_host = /
45
rabbit_retry_interval = 1
46
rabbit_retry_backoff = 2
47
rabbit_max_retries = 0
48
rabbit_ha_queues = false
49
control_exchange = openstack
50
amqp_durable_queues = false
52
Options supported in this section:
56
Run as a daemon. Default is 'true'.
60
Specifies the user for the process when in daemon mode. Default is the
65
Specifies the group for the process when run in daemon mode.
69
Prints more verbose output. Sets logging level to INFO from WARNING
73
Prints debug output. Sets logging level to DEBUG from WARNING
75
.. option:: billing_enable
77
Enables the sending of billing information to a rabbitMQ host. It sends
78
create and delete loadbalancer messages as well as exists and usage
79
messages on a periodic, configurable basis. See admin_api config.
81
.. option:: notification_driver
83
Driver or drivers to handle sending notifications for metering / billing.
84
For instance, the openstack rpc driver is
85
openstack.common.notifier.rpc_notifier.
87
.. option:: default_notification_level
89
Default notification level for outgoing notifications
91
.. option:: default_publisher_id
93
Default publisher_id for outgoing notifications
97
Default host name to use in notifications. Will use default_publisher_id
98
or gethostname() if not set.
102
Default host name to use in notifications. Will use default_publisher_id
103
or gethostname() if not set.
105
.. option:: kombu_ssl_version
107
SSL version to use (valid only if SSL enabled). valid values are TLSv1,
108
SSLv23 and SSLv3. SSLv2 may be available on some distributions
110
.. option:: kombu_ssl_keyfile
112
SSL key file (valid only if SSL enabled)
114
.. option:: kombu_ssl_certfile
116
SSL cert file (valid only if SSL enabled)
118
.. option:: kombu_ssl_ca_certs
120
SSL certification authority file (valid only if SSL enabled)
122
.. option:: rabbit_use_ssl
124
Connect over SSL for RabbitMQ
126
.. option:: rabbit_userid
130
.. option:: rabbit_password
132
The RabbitMQ password
134
.. option:: rabbit_host
136
The RabbitMQ broker address where a single node is used
138
.. option:: rabbit_port
140
The RabbitMQ broker port where a single node is used
142
.. option:: rabbit_hosts
144
RabbitMQ HA cluster host:port pairs
146
.. option:: rabbit_virtual_host
148
The RabbitMQ virtual host
150
.. option:: rabbit_retry_interval
152
How frequently to retry connecting with RabbitMQ
154
.. option:: rabbit_retry_backoff
156
How long to backoff for between retries when connecting to RabbitMQ
158
.. option:: rabbit_max_retries
160
Maximum retries with trying to connect to RabbitMQ (the default of 0
161
implies an infinite retry count)
163
.. option:: rabbit_ha_queues
165
Use H/A queues in RabbitMQ (x-ha-policy: all). You need to wipe RabbitMQ
166
database when changing this option.
168
.. option:: control_exchange
170
AMQP exchange to connect to if using RabbitMQ or Qpid
172
.. option:: amqp_durable_queues
174
Use durable queues in amqp.
179
The ``[gearman]`` section contains options specific to connecting to
180
a Gearman job server. All of the Libra utilities will read this section
181
since each connects to Gearman.
183
In order to support SSL connections, it is required that all three SSL
184
related options be supplied. Also, the user owning the process must be
185
able to read all SSL files.
190
servers = 10.0.0.1:4730, 10.0.0.2:4730
192
ssl_ca = /etc/ssl/gearman.ca
193
ssl_cert = /etc/ssl/gearman.cert
194
ssl_key = /etc/ssl/gearman.key
196
Options supported in this section:
198
.. option:: keepalive
200
Enable TCP KEEPALIVE pings. Default is 'false'.
204
Max KEEPALIVE probes to send before killing connection.
208
Seconds of idle time before sending KEEPALIVE probes.
210
.. option:: keepintvl
212
Seconds between TCP KEEPALIVE probes.
216
Gearman worker polling timeout. Default is 1.
218
.. option:: reconnect_sleep
220
Seconds to sleep between job server reconnects. Default is 60.
224
Comma-separated list of Gearman job servers and port in HOST:PORT format.
228
Gearman SSL certificate authority.
232
Gearman SSL certificate.