The nova.service Module

Generic Node base class for all workers that run on hosts.

class Launcher

Bases: object

Launch one or more services and wait for them to complete.

launch_server(server)

Load and start the given server.

Parameters:server – The server you would like to start. Returns:None

static run_server(server)

Start and wait for a server to finish.

Parameters:service – Server to run and wait for. Returns:None

stop()

Stop all services which are currently running.

Returns:None

wait()

Waits until all services have been stopped, and then returns.

Returns:None

class ProcessLauncher

Bases: object

launch_server(server, workers=1)

wait()

Loop waiting on children to die and respawning as necessary.

class ServerWrapper(server, workers)

Bases: object

class Service(host, binary, topic, manager, report_interval=None, periodic_enable=None, periodic_fuzzy_delay=None, periodic_interval_max=None, db_allowed=True, *args, **kwargs)

Bases: object

Service object for binaries running on hosts.

A service takes a manager and enables rpc by listening to queues based on topic. It also periodically runs tasks on the manager and reports it state to the database services table.

basic_config_check()

Perform basic config checks before starting processing.

classmethod create(host=None, binary=None, topic=None, manager=None, report_interval=None, periodic_enable=None, periodic_fuzzy_delay=None, periodic_interval_max=None, db_allowed=True)

Instantiates class and passes back application object.

Parameters:

• host – defaults to CONF.host
• binary – defaults to basename of executable
• topic – defaults to bin_name - ‘nova-‘ part
• manager – defaults to CONF.<topic>_manager
• report_interval – defaults to CONF.report_interval
• periodic_enable – defaults to CONF.periodic_enable
• periodic_fuzzy_delay – defaults to CONF.periodic_fuzzy_delay
• periodic_interval_max – if set, the max time to wait between runs

kill()

Destroy the service object in the datastore.

periodic_tasks(raise_on_error=False)

Tasks to be run at a periodic interval.

start()

stop()

wait()

class ServiceLauncher

Bases: nova.service.Launcher

wait()

exception SignalExit(signo, exccode=1)

Bases: exceptions.SystemExit

class WSGIService(name, loader=None, use_ssl=False, max_url_len=None)

Bases: object

Provides ability to launch API from a ‘paste’ configuration.

start()

Start serving this service using loaded configuration.

Also, retrieve updated port number in case ‘0’ was passed in, which indicates a random port should be used.

Returns:None

stop()

Stop serving this API.

Returns:None

wait()

Wait for the service to stop serving this API.

Returns:None

serve(server, workers=None)

wait()