Configuration Options

Senlin uses oslo.config to define and manage configuration options to allow the deployer to control many aspects of the service API and the service engine.

DEFAULT

host
Type:

host address

Default:

np0036938050

Name of the engine node. This can be an opaque identifier. It is not necessarily a hostname, FQDN or IP address.

default_region_name
Type:

string

Default:

<None>

Default region name used to get services endpoints.

max_response_size
Type:

integer

Default:

524288

Maximum raw byte size of data from web response.

notification_topics
Type:

list

Default:

['versioned_notifications']

Default notification topic.

periodic_interval
Type:

integer

Default:

60

Seconds between running periodic tasks.

check_interval_max
Type:

integer

Default:

3600

Maximum seconds between cluster check to be called.

health_check_interval_min
Type:

integer

Default:

60

Minimum seconds between health check to be called.

environment_dir
Type:

string

Default:

/etc/senlin/environments

The directory to search for environment files.

max_nodes_per_cluster
Type:

integer

Default:

1000

Maximum nodes allowed per top-level cluster.

max_clusters_per_project
Type:

integer

Default:

100

Maximum number of clusters any one project may have active at one time.

default_action_timeout
Type:

integer

Default:

3600

Timeout in seconds for actions.

default_nova_timeout
Type:

integer

Default:

600

Timeout in seconds for nova API calls.

max_actions_per_batch
Type:

integer

Default:

0

Maximum number of node actions that each engine worker can schedule consecutively per batch. 0 means no limit.

batch_interval
Type:

integer

Default:

3

Seconds to pause between scheduling two consecutive batches of node actions.

lock_retry_times
Type:

integer

Default:

3

Number of times trying to grab a lock.

lock_retry_interval
Type:

integer

Default:

10

Number of seconds between lock retries.

database_retry_limit
Type:

integer

Default:

10

Number of times retrying a failed operation on the database.

database_retry_interval
Type:

integer

Default:

0.3

Initial number of seconds between database retries.

database_max_retry_interval
Type:

integer

Default:

2

Maximum number of seconds between database retries.

engine_life_check_timeout
Type:

integer

Default:

2

RPC timeout for the engine liveness check that is used for cluster locking.

name_unique
Type:

boolean

Default:

False

Flag to indicate whether to enforce unique names for Senlin objects belonging to the same project.

service_down_time
Type:

integer

Default:

60

Maximum time since last check-in for a service to be considered up.

trust_roles
Type:

list

Default:

[]

The roles which are delegated to the trustee by the trustor when a cluster is created.

cloud_backend
Type:

string

Default:

openstack

Valid Values:

openstack, openstack_test

Default cloud backend to use.

event_dispatchers
Type:

multi-valued

Default:

database

Event dispatchers to enable.

authentication

auth_url
Type:

string

Default:

''

Complete identity V3 API endpoint.

service_username
Type:

string

Default:

senlin

Senlin service user name.

service_password
Type:

string

Default:

''

Password specified for the Senlin service user.

service_project_name
Type:

string

Default:

service

Name of the service project.

service_user_domain
Type:

string

Default:

Default

Name of the domain for the service user.

service_project_domain
Type:

string

Default:

Default

Name of the domain for the service project.

verify_ssl
Type:

boolean

Default:

True

Verify HTTPS connections.

interface
Type:

string

Default:

public

Interface to use for the API endpoints.

conductor

workers
Type:

integer

Default:

1

Number of senlin-conductor processes.

threads
Type:

integer

Default:

1000

Number of senlin-conductor threads.

dispatchers

priority
Type:

string

Default:

info

Valid Values:

critical, error, warning, info, debug

Lowest event priorities to be dispatched.

exclude_derived_actions
Type:

boolean

Default:

True

Exclude derived actions from events dumping.

engine

workers
Type:

integer

Default:

1

Number of senlin-engine processes.

Deprecated Variations

Group

Name

DEFAULT

num_engine_workers

threads
Type:

integer

Default:

1000

Number of senlin-engine threads.

Deprecated Variations

Group

Name

DEFAULT

scheduler_thread_pool_size

health_manager

nova_control_exchange
Type:

string

Default:

nova

Exchange name for nova notifications.

nova_notification_topic
Type:

string

Default:

versioned_notifications

Topic name for nova notifications.

heat_control_exchange
Type:

string

Default:

heat

Exchange name for heat notifications.

heat_notification_topic
Type:

string

Default:

notifications

Topic name for heat notifications.

enabled_endpoints
Type:

multi-valued

Default:

nova

Default:

heat

Notification endpoints to enable.

workers
Type:

integer

Default:

1

Number of senlin-health-manager processes.

threads
Type:

integer

Default:

1000

Number of senlin-health-manager threads.

Deprecated Variations

Group

Name

DEFAULT

health_manager_thread_pool_size

cleanup_interval
Type:

integer

Default:

900

Seconds between running periodic cleanup tasks.

notification

max_message_size
Type:

integer

Default:

65535

The max size(bytes) of message can be posted to notification queue.

ttl
Type:

integer

Default:

300

The ttl in seconds of a message posted to notification queue.

receiver

host
Type:

string

Default:

<None>

The address for notifying and triggering receivers. It is useful for case Senlin API service is running behind a proxy.

Deprecated Variations

Group

Name

webhook

host

port
Type:

port number

Default:

8777

Minimum Value:

0

Maximum Value:

65535

The port for notifying and triggering receivers. It is useful for case Senlin API service is running behind a proxy.

Deprecated Variations

Group

Name

webhook

port

max_message_size
Type:

integer

Default:

65535

The max size(bytes) of message can be posted to receiver queue.

revision

senlin_api_revision
Type:

string

Default:

1.0

Senlin API revision.

senlin_engine_revision
Type:

string

Default:

1.0

Senlin engine revision.

senlin_api

bind_host
Type:

ip address

Default:

0.0.0.0

Address to bind the server. Useful when selecting a particular network interface.

bind_port
Type:

port number

Default:

8777

Minimum Value:

0

Maximum Value:

65535

The port on which the server will listen.

backlog
Type:

integer

Default:

4096

Number of backlog requests to configure the socket with.

cert_file
Type:

string

Default:

<None>

Location of the SSL certificate file to use for SSL mode.

key_file
Type:

string

Default:

<None>

Location of the SSL key file to use for enabling SSL mode.

workers
Type:

integer

Default:

0

Minimum Value:

0

Number of workers for Senlin service.

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 by the Keystone v3 API with big service catalogs).

tcp_keepidle
Type:

integer

Default:

600

The value for the socket option TCP_KEEPIDLE. This is the time in seconds that the connection must be idle before TCP starts sending keepalive probes.

api_paste_config
Type:

string

Default:

api-paste.ini

The API paste config file to use.

Deprecated Variations

Group

Name

paste_deploy

api_paste_config

wsgi_keep_alive
Type:

boolean

Default:

True

If false, closes the client socket explicitly.

Deprecated Variations

Group

Name

eventlet_opts

wsgi_keep_alive

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’ indicates waiting forever.

Deprecated Variations

Group

Name

eventlet_opts

client_socket_timeout

max_json_body_size
Type:

integer

Default:

1048576

Maximum raw byte size of JSON request body.

Deprecated Variations

Group

Name

DEFAULT

max_json_body_size

zaqar

auth_type
Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group

Name

zaqar

auth_plugin

auth_section
Type:

unknown type

Default:

<None>

Config Section from which to load plugin specific options

auth_url
Type:

unknown type

Default:

<None>

Authentication URL

system_scope
Type:

unknown type

Default:

<None>

Scope for system operations

domain_id
Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name
Type:

unknown type

Default:

<None>

Domain name to scope to

project_id
Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group

Name

zaqar

tenant-id

zaqar

tenant_id

project_name
Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group

Name

zaqar

tenant-name

zaqar

tenant_name

project_domain_id
Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name
Type:

unknown type

Default:

<None>

Domain name containing project

trust_id
Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

default_domain_id
Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name
Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

user_id
Type:

unknown type

Default:

<None>

User id

username
Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group

Name

zaqar

user-name

zaqar

user_name

user_domain_id
Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name
Type:

unknown type

Default:

<None>

User’s domain name

password
Type:

unknown type

Default:

<None>

User’s password

Options

senlin.conf.opts.list_opts()

Return a list of oslo.config options available.

The purpose of this function is to allow tools like the Oslo sample config file generator to discover the options exposed to users by this service. The returned list includes all oslo.config options which may be registered at runtime by the service api/engine.

This function is also discoverable via the ‘senlin.conf’ entry point under the ‘oslo.config.opts’ namespace.

Returns:

a list of (group_name, opts) tuples