Configuration Options

Configuration Options

oslo.service uses oslo.config to define and manage configuration options to allow the deployer to control how an application uses this library.

periodic_task

These options apply to services using the periodic task features of oslo.service.

DEFAULT

run_external_periodic_tasks
Type:boolean
Default:true

Some periodic tasks can be run in a separate process. Should we run them here?

service

These options apply to services using the basic service framework.

DEFAULT

backdoor_port
Type:string
Default:<None>

Enable eventlet backdoor. Acceptable values are 0, <port>, and <start>:<end>, where 0 results in listening on a random tcp port number; <port> results in listening on the specified port number (and not enabling backdoor if that port is in use); and <start>:<end> results in listening on the smallest unused port number within the specified range of port numbers. The chosen port is displayed in the service’s log file.

backdoor_socket
Type:string
Default:<None>

Enable eventlet backdoor, using the provided path as a unix socket that can receive connections. This option is mutually exclusive with ‘backdoor_port’ in that only one should be provided. If both are provided then the existence of this option overrides the usage of that option.

log_options
Type:boolean
Default:true

Enables or disables logging values of all registered options when starting a service (at DEBUG level).

graceful_shutdown_timeout
Type:integer
Default:60

Specify a timeout after which a gracefully shutdown server will exit. Zero value means endless wait.

sslutils

These options apply to services using the SSL utilities module.

ssl

ca_file
Type:string
Default:<None>

CA certificate file to use to verify connecting clients.

Deprecated Variations
Group Name
DEFAULT ssl_ca_file
cert_file
Type:string
Default:<None>

Certificate file to use when starting the server securely.

Deprecated Variations
Group Name
DEFAULT ssl_cert_file
key_file
Type:string
Default:<None>

Private key file to use when starting the server securely.

Deprecated Variations
Group Name
DEFAULT ssl_key_file
version
Type:string
Default:<None>

SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 may be available on some distributions.

ciphers
Type:string
Default:<None>

Sets the list of available ciphers. value should be a string in the OpenSSL cipher list format.

wsgi

These options apply to services using the WSGI (Web Service Gateway Interface) module.

DEFAULT

api_paste_config
Type:string
Default:api-paste.ini

File name for the paste.deploy config for api service

wsgi_log_format
Type:string
Default:%(client_ip)s "%(request_line)s" status: %(status_code)s  len: %(body_length)s time: %(wall_seconds).7f

A python format string that is used as the template to generate log lines. The following values can beformatted into it: client_ip, date_time, request_line, status_code, body_length, wall_seconds.

tcp_keepidle
Type:integer
Default:600

Sets the value of TCP_KEEPIDLE in seconds for each server socket. Not supported on OS X.

wsgi_default_pool_size
Type:integer
Default:100

Size of the pool of greenthreads used by wsgi

max_header_line
Type:integer
Default:16384

Maximum line size of message headers to be accepted. max_header_line may need to be increased when using large tokens (typically those generated when keystone is configured to use PKI tokens with big service catalogs).

wsgi_keep_alive
Type:boolean
Default:true

If False, closes the client socket connection explicitly.

client_socket_timeout
Type:integer
Default:900

Timeout for client connections’ socket operations. If an incoming connection is idle for this number of seconds it will be closed. A value of ‘0’ means wait forever.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.