salt.modules.upstart

Module for the management of upstart systems. The Upstart system only supports service starting, stopping and restarting.

Currently (as of Ubuntu 12.04) there is no tool available to disable Upstart services (like update-rc.d). This[1] is the recommended way to disable an Upstart service. So we assume that all Upstart services that have not been disabled in this manner are enabled.

But this is broken because we do not check to see that the dependent services are enabled. Otherwise we would have to do something like parse the output of "initctl show-config" to determine if all service dependencies are enabled to start on boot. For example, see the "start on" condition for the lightdm service below[2]. And this would be too hard. So we wait until the upstart developers have solved this problem. :) This is to say that an Upstart service that is enabled may not really be enabled.

Also, when an Upstart service is enabled, should the dependent services be enabled too? Probably not. But there should be a notice about this, at least.

[1] http://upstart.ubuntu.com/cookbook/#disabling-a-job-from-automatically-starting

[2] lightdm
emits login-session-start emits desktop-session-start emits desktop-shutdown start on ((((filesystem and runlevel [!06]) and started dbus) and (drm-device-added card0 PRIMARY_DEVICE_FOR_DISPLAY=1 or stopped udev-fallback-graphics)) or runlevel PREVLEVEL=S) stop on runlevel [016]

DO NOT use this module on red hat systems, as red hat systems should use the rh_service module, since red hat systems support chkconfig

Members

disable

salt.modules.upstart.disable(name)

Disable the named service from starting on boot

CLI Example:

salt '*' service.disable <service name>

disabled

salt.modules.upstart.disabled(name)

Check to see if the named service is disabled to start on boot

CLI Example:

salt '*' service.disabled <service name>

enable

salt.modules.upstart.enable(name)

Enable the named service to start at boot

CLI Example:

salt '*' service.enable <service name>

enabled

salt.modules.upstart.enabled(name)

Check to see if the named service is enabled to start on boot

CLI Example:

salt '*' service.enabled <service name>

get_all

salt.modules.upstart.get_all()

Return all installed services

CLI Example:

salt '*' service.get_all

get_disabled

salt.modules.upstart.get_disabled()

Return the disabled services

CLI Example:

salt '*' service.get_disabled

get_enabled

salt.modules.upstart.get_enabled()

Return the enabled services

CLI Example:

salt '*' service.get_enabled

restart

salt.modules.upstart.restart(name)

Restart the named service

CLI Example:

salt '*' service.restart <service name>

start

salt.modules.upstart.start(name)

Start the specified service

CLI Example:

salt '*' service.start <service name>

status

salt.modules.upstart.status(name, sig=None)

Return the status for a service, returns a bool whether the service is running.

CLI Example:

salt '*' service.status <service name>

stop

salt.modules.upstart.stop(name)

Stop the specified service

CLI Example:

salt '*' service.stop <service name>

Parent topic

Table Of Contents

Previous topic

salt.modules.tomcat

Next topic

salt.modules.useradd