libra/doc/admin_api/config.rst
Andrew Hutchings 622eda08c1 [DOCS] Add v2 Admin API docs
Change-Id: I471eb79c06b7c12645a8a133759fb3cef96740be
2014-03-14 10:48:29 +00:00

6.2 KiB

Admin API Configuration

These options are specific to the Admin API in addition to the common options </config>.

Configuration File

The [admin_api] section is specific to the libra_admin_api utility. Below is an example:

[admin_api]
db_section=mysql1
ssl_certfile=/opt/server.crt
ssl_keyfile=/opt/server.key
gearman=127.0.0.1:4730
keystone_module=keystoneclient.middleware.auth_token:AuthProtocol

[mysql1]
host=localhost
port=3306
username=root
password=
schema=lbaas
ssl_cert=/opt/mysql_cert.crt
ssl_key=/opt/mysql_key.key
ssl_ca=/opt/mysql_ca.ca

Command Line Options

libra_admin_api

--host <IP ADDRESS>

The IP address to bind the frontend to, default is 0.0.0.0

--port <PORT NUMBER>

The port number to listen on, default is 8889

--disable_keystone

Do not use keystone authentication, for testing purposes only

--db_sections <SECTIONNAME>

Config file sections that describe the MySQL servers. This option can be specified multiple times for Galera or NDB clusters.

--ssl_certfile <PATH>

The path for the SSL certificate file to be used for frontend of the API server

--ssl_keyfile <PATH>

The path for the SSL key file to be used for the frontend of the API server

--gearman_keepalive

Use TCP KEEPALIVE to the Gearman job server. Not supported on all systems.

--gearman_keepcnt <COUNT>

Maximum number of TCP KEEPALIVE probes to send before killing the connection to the Gearman job server.

--gearman_keepidle <SECONDS>

Seconds of idle time on the Gearman job server connection before sending TCP KEEPALIVE probes.

--gearman_keepintvl <SECONDS>

Seconds between TCP KEEPALIVE probes.

--gearman_ssl_ca <PATH>

The path for the Gearman SSL Certificate Authority.

--gearman_ssl_cert <PATH>

The path for the Gearman SSL certificate.

--gearman_ssl_key <PATH>

The path for the Gearman SSL key.

--gearman <HOST:PORT>

Used to specify the Gearman job server hostname and port. This option can be used multiple times to specify multiple job servers

--keystone_module <MODULE:CLASS>

A colon separated module and class to use as the keystone authentication module. The class should be compatible with keystone's AuthProtocol class.

--stats_driver <DRIVER LIST>

The drivers to be used for alerting. This option can be used multiple times to specift multiple drivers.

--stats_ping_timeout <PING_INTERVAL>

How often to run a ping check of load balancers (in seconds), default 60

--stats_poll_timer <POLL_INTERVAL>

How long to wait until we consider the initial ping check failed and send a second ping. Default is 5 seconds.

--stats_poll_timeout_retry <POLL_INTERVAL>

How long to wait until we consider the second and final ping check failed. Default is 30 seconds.

--stats_offline_ping_limit <COUNT>

How many times to ping an OFFLINE load balancer before considering it unreachable and marking it for deletion.

--stats_device_error_limit <COUNT>

Maximum number of simultaneous device failures to allow recovery on

--number_of_servers <NUMBER_OF_SERVER>

The number of Admin API servers in the system. Used to calculate which Admin API server should stats ping next

--server_id <SERVER_ID>

The server ID of this server, used to calculate which Admin API server should stats ping next (start at 0)

--datadog_api_key <KEY>

The API key to be used for the datadog driver

--datadog_app_key <KEY>

The Application key to be used for the datadog driver

--datadog_message_tail <TEXT>

Some text to add at the end of an alerting message such as a list of users to alert (using @user@email.com format), used for the datadog driver.

--datadog_tags <TAGS>

A list of tags to be used for the datadog driver

--node_pool_size <SIZE>

The number of hot spare load balancer devices to keep in the pool, default 10

--vip_pool_size <SIZE>

The number of hot spare floating IPs to keep in the pool, default 10

--expire_days <DAYS>

The number of days before DELETED load balancers are purged from the database. The purge is run every 24 hours. Purge is not run if no value is provided.

--stats_enable <BOOL>

Enable / Disable usage statistics gathering

--exists_freq <MINUTES>

Minutes between sending of billing exists messages

--usage_freq <MINUTES>

Minutes between sending of billing usage messages

--stats_freqs <MINUTES>

Minutes between collecting usage statistics

--stats_purge_enable <BOOL>

Enable / Disable purging of usage statistics

--stats_purge_days <DAYS>

Number of days to keep usage statistics

--delete_timer_seconds <SECONDS>

Which second of each minute delete timer should run

--ping_timer_seconds <SECONDS>

Which second of each minute ping timer should run

--stats_timer_seconds <SECONDS>

Which second of each minute statistics timer should run

--usage_timer_seconds <SECONDS>

Which second of each minute usage timer should run

--probe_timer_seconds <SECONDS>

Which second of each minute probe timer should run

--offline_timer_seconds <SECONDS>

Which second of each minute offline timer should run

--vips_timer_seconds <SECONDS>

Which second of each minute vips timer should run

--exists_timer_seconds <SECONDS>

Which second of each minute exists timer should run