Octavia Configuration Options

bind_host
Type:unknown type
Default:127.0.0.1

The host IP to bind to

bind_port
Type:unknown type
Default:9876
Minimum Value:0
Maximum Value:65535

The port to bind to

api_handler
Type:string
Default:queue_producer

The handler that the API communicates with

api_paste_config
Type:string
Default:api-paste.ini

The API paste config file to use

api_extensions_path
Type:string
Default:

The path for API extensions

auth_strategy
Type:string
Default:keystone

The type of authentication to use

allow_bulk
Type:boolean
Default:true

Allow the usage of the bulk API

allow_pagination
Type:boolean
Default:false

Allow the usage of the pagination

allow_sorting
Type:boolean
Default:false

Allow the usage of the sorting

pagination_max_limit
Type:string
Default:-1

The maximum number of items returned in a single response. The string ‘infinite’ or a negative integer value means ‘no limit’

host
Type:string
Default:ubuntu-xenial-citycloud-sto2-10786898

The hostname Octavia is running on

octavia_plugins
Type:string
Default:hot_plug_plugin

Name of the controller plugin to use

agent_server_ca
Type:string
Default:/etc/octavia/certs/client_ca.pem

The ca which signed the client certificates

agent_server_cert
Type:string
Default:/etc/octavia/certs/server.pem

The server certificate for the agent.py server to use

agent_server_network_dir
Type:string
Default:/etc/netns/amphora-haproxy/network/interfaces.d/

The directory where new network interfaces are located

agent_server_network_file
Type:string
Default:<None>

The file where the network interfaces are located. Specifying this will override any value set for agent_server_network_dir.

amphora_id
Type:string
Default:<None>

The amphora ID.

cert_manager
Type:string
Default:barbican_cert_manager

Name of the cert manager to use

cert_generator
Type:string
Default:local_cert_generator

Name of the cert generator to use

barbican_auth
Type:string
Default:barbican_acl_auth

Name of the Barbican authentication method to use

region_name
Type:string
Default:<None>

Region in Identity service catalog to use for communication with the barbican service.

endpoint_type
Type:string
Default:publicURL

The endpoint_type to be used for barbican service.

amp_active_retries
Type:integer
Default:10

Retry attempts to wait for Amphora to become active

amp_active_wait_sec
Type:integer
Default:10

Seconds to wait between checks on whether an Amphora has become active

amp_flavor_id
Type:string
Default:

Nova instance flavor id for the Amphora

amp_image_tag
Type:string
Default:

Glance image tag for the Amphora image to boot. Use this option to be able to update the image without reconfiguring Octavia. Ignored if amp_image_id is defined.

amp_image_id
Type:string
Default:

Glance image id for the Amphora image to boot

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:Superseded by amp_image_tag option.
amp_image_owner_id
Type:string
Default:

Restrict glance image selection to a specific owner ID. This is a recommended security setting.

amp_ssh_key_name
Type:string
Default:

SSH key name used to boot the Amphora

amp_ssh_access_allowed
Type:boolean
Default:true

Determines whether or not to allow access to the Amphorae

amp_boot_network_list
Type:list
Default:

List of networks to attach to the Amphorae. All networks defined in the list will be attached to each amphora.

amp_network
Type:string
Default:

Network to attach to the Amphorae.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:Replaced by amp_boot_network_list.
amp_secgroup_list
Type:list
Default:

List of security groups to attach to the Amphora.

client_ca
Type:string
Default:/etc/octavia/certs/ca_01.pem

Client CA for the amphora agent to use

amphora_driver
Type:string
Default:amphora_noop_driver

Name of the amphora driver to use

compute_driver
Type:string
Default:compute_noop_driver

Name of the compute driver to use

network_driver
Type:string
Default:network_noop_driver

Name of the network driver to use

cert_generator
Type:string
Default:local_cert_generator

Name of the cert generator to use

loadbalancer_topology
Type:string
Default:SINGLE
Valid Values:ACTIVE_STANDBY, SINGLE

Load balancer topology configuration. SINGLE - One amphora per load balancer. ACTIVE_STANDBY - Two amphora per load balancer.

user_data_config_drive
Type:boolean
Default:false

If True, build cloud-init user-data that is passed to the config drive on Amphora boot instead of personality files. If False, utilize personality files.

base_path
Type:string
Default:/var/lib/octavia

Base directory for amphora files.

base_cert_dir
Type:string
Default:/var/lib/octavia/certs

Base directory for cert storage.

haproxy_template
Type:string
Default:<None>

Custom haproxy template.

connection_max_retries
Type:integer
Default:300

Retry threshold for connecting to amphorae.

connection_retry_interval
Type:integer
Default:5

Retry timeout between connection attempts in seconds.

haproxy_stick_size
Type:string
Default:10k

Size of the HAProxy stick table. Accepts k, m, g suffixes. Example: 10k

bind_host
Type:unknown type
Default:0.0.0.0

The host IP to bind to

bind_port
Type:unknown type
Default:9443
Minimum Value:0
Maximum Value:65535

The port to bind to

haproxy_cmd
Type:string
Default:/usr/sbin/haproxy

The full path to haproxy

respawn_count
Type:integer
Default:2

The respawn count for haproxy’s upstart script

respawn_interval
Type:integer
Default:2

The respawn interval for haproxy’s upstart script

rest_request_conn_timeout
Type:floating point
Default:10

The time in seconds to wait for a REST API to connect.

rest_request_read_timeout
Type:floating point
Default:60

The time in seconds to wait for a REST API response.

client_cert
Type:string
Default:/etc/octavia/certs/client.pem

The client certificate to talk to the agent

server_ca
Type:string
Default:/etc/octavia/certs/server_ca.pem

The ca which signed the server certificates

use_upstart
Type:boolean
Default:true

If False, use sysvinit.

bind_ip
Type:unknown type
Default:127.0.0.1

IP address the controller will listen on for heart beats

bind_port
Type:unknown type
Default:5555
Minimum Value:0
Maximum Value:65535

Port number the controller will listen onfor heart beats

failover_threads
Type:integer
Default:10

Number of threads performing amphora failovers.

status_update_threads
Type:integer
Default:50

Number of threads performing amphora status update.

heartbeat_key
Type:string
Default:<None>

key used to validate amphora sendingthe message

heartbeat_timeout
Type:integer
Default:60

Interval, in seconds, to wait before failing over an amphora.

health_check_interval
Type:integer
Default:3

Sleep time between health checks in seconds.

sock_rlimit
Type:

integer

Default:

0

sets the value of the heartbeat recv buffer

controller_ip_port_list
Type:list
Default:

List of controller ip and port pairs for the heartbeat receivers. Example 127.0.0.1:5555, 192.168.0.1:5555

heartbeat_interval
Type:integer
Default:10

Sleep time between sending heartbeats.

event_streamer_driver
Type:string
Default:noop_event_streamer

Specifies which driver to use for the event_streamer for syncing the octavia and neutron_lbaas dbs. If you don’t need to sync the database or are running octavia in stand alone mode use the noop_event_streamer

spare_check_interval
Type:integer
Default:30

Spare check interval in seconds

spare_amphora_pool_size
Type:integer
Default:0

Number of spare amphorae

cleanup_interval
Type:integer
Default:30

DB cleanup interval in seconds

amphora_expiry_age
Type:integer
Default:604800

Amphora expiry age in seconds

load_balancer_expiry_age
Type:integer
Default:604800

Load balancer expiry age in seconds

cert_interval
Type:integer
Default:3600

Certificate check interval in seconds

cert_expiry_buffer
Type:integer
Default:1209600

Seconds until certificate expiration

cert_rotate_threads
Type:integer
Default:10

Number of threads performing amphora certificate rotation

vrrp_advert_int
Type:integer
Default:1

Amphora role and priority advertisement interval in seconds.

vrrp_check_interval
Type:integer
Default:5

VRRP health check script run interval in seconds.

vrrp_fail_count
Type:integer
Default:2

Number of successive failures before transition to a fail state.

vrrp_success_count
Type:integer
Default:2

Number of consecutive successes before transition to a success state.

vrrp_garp_refresh_interval
Type:integer
Default:5

Time in seconds between gratuitous ARP announcements from the MASTER.

vrrp_garp_refresh_count
Type:integer
Default:2

Number of gratuitous ARP announcements to make on each refresh interval.

admin_user_domain
Type:string
Default:default

Admin user keystone authentication domain

admin_project_domain
Type:string
Default:default

Admin project keystone authentication domain

lb_network_name
Type:string
Default:<None>

Name of amphora internal network

max_retries
Type:integer
Default:15

The maximum attempts to retry an action with the networking service.

retry_interval
Type:integer
Default:1

Seconds to wait before retrying an action with the networking service.

port_detach_timeout
Type:integer
Default:300

Seconds to wait for a port to detach from an amphora.

topic
Type:string
Default:<None>
event_stream_topic
Type:string
Default:neutron_lbaas_event

topic name for communicating events through a queue

engine
Type:string
Default:serial

TaskFlow engine to use

max_workers
Type:integer
Default:5

The maximum number of workers