Serv creates, removes and manages services on multiple init systems (process managers? service managers? can someone come up with a normal name for this? jeez.)

Serv is a Pythonic spinoff of Jordan Sissel's brilliant pleaserun. The question that Serv tries to answer is: "Why the hell do I have to know init systems? I just want this to run forever."

• Abstracts away the platform (systemd, upstart, etc..) - Serv identifies it by itself though it can be explicitly provided.
• Creates service configuration files on different platforms so that you don't have to.
• Allows to deploy services after generating the config on the local machine.
• Allows to start, stop, restart and remove services.
• Provides both an API and CLI for those purposes.
• Provides an API for retrieving service related information.

NOTE: Serv requires sudo/Administrator privileges! (you can't write to /etc/init.d, /lib/systemd/system and the others without root can ya?)

systemd, Upstart, nssm (Non-Sucking Service Manager for Windows) and SysVinit are mostly supported now though SysV doesn't yet support retrieving a service's status.

I intend to add:

• launchd
• runit
• supervisord
• Whichever other system that's giving you (or me) a headache.

Note: On Linux, Serv uses ld to identify the distribution.

Currently, tested on Python 2.6.x and 2.7.x Will be adding Python 3.x support soon enough.

sudo pip install serv

For dev:

sudo pip install https://github.com/nir0s/serv/archive/master.tar.gz

Before using, please read the caveats section!

$ sudo serv
...

Usage: serv [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  generate  Creates (and maybe runs) a service.
  remove    Stops and Removes a service
  restart   Stops and Removes a service
  start     Starts a service
  status    Prints out a service's status If...
  stop      Stops a service

...

$ sudo serv generate /usr/bin/python2 --name MySimpleHTTPServer --args '-m SimpleHTTPServer' --var KEY1=VALUE1 --var KEY2=VALUE2 --deploy --start
...

INFO - Generating files for systemd...
INFO - Generated /tmp/SimpleHTTPServer.service
INFO - Generated /tmp/SimpleHTTPServer
INFO - Deploying systemd service SimpleHTTPServer...
INFO - Deploying /tmp/SimpleHTTPServer.service to /lib/systemd/system/SimpleHTTPServer.service...
INFO - Deploying /tmp/SimpleHTTPServer to /etc/sysconfig/SimpleHTTPServer...
INFO - Starting systemd service SimpleHTTPServer...
INFO - Service created.


...

$ ss -lntp | grep 8000
LISTEN     0      5            *:8000                     *:*

If name is omitted, the name of the service (and therefore, the names of the files) will be deduced from the executable's name.

NOTE: Existing services which were not created by Serv can also be controlled this way.

$ sudo serv stop MySimpleHTTPServer
INFO - Stopping service: MySimpleHTTPServer...
$ ss -lntp | grep 8000
...
$ sudo serv start MySimpleHTTPServer
INFO - Starting service: MySimpleHTTPServer...
$ ss -lntp | grep 8000
LISTEN     0      5            *:8000                     *:*

$ sudo serv restart MySimpleHTTPServer
INFO - Restarting service: MySimpleHTTPServer...
$ ss -lntp | grep 8000
LISTEN     0      5            *:8000                     *:*
...

IMPORTANT NOTE: serv status is current very buggy. Except it to break and please submit issues.

NOTE: Existing services which were not created by Serv can also be controlled this way.

$ sudo serv status MySimpleHTTPServer
...

{
    "init_system": "systemd",
    "init_system_version": "default",
    "services": [
        {
            "active": "active",
            "description": "no",
            "load": "loaded",
            "name": "MySimpleHTTPServer.service",
            "sub": "running"
        }
    ]
}

...

or for all services of the same init system

$ sudo serv status
...

NOTE: Existing services which were not created by Serv can also be controlled this way.

$ sudo serv remove MySimpleHTTPServer
...

INFO - Removing Service: SimpleHTTPServer...
INFO - Service removed.
...

$ ss -lntp | grep 8000

Windows support is provided via the Non-Sucking Service Manager (nssm).

There are some differences between Windows and Linux support. While the API is practically the same, it still requires the user to be a bit more cautious.

For instance, when providing the --args flag, single quotes won't do (e.g. '-m SimpleHTTPServer') but rather doubles must be used and cmd must be loaded as Administrator to be able to install the service as it requires elevated privileges.

It's important to note that deploying a Windows service also deploys nssm itself and will not clean it up if a service is removed as it might be used by other services.

raise NotImplementedError()

Kidding.. it's there, it's easy and it requires documentation.

Serv, unless explicitly specified by the user, looks up the platform you're running on (Namely, linux distro and release unless running on Windows or OS X) and deduces which init system is running on it by checking a static mapping table or an auto-lookup mechanism.

Once an init-system matching an existing implementation (i.e supported by Serv) is found, Serv renders template files based on a set of parameters; (optionally) deploys them to the relevant directories and (optionally) starts the service.

Since Serv is aware of the init system being used, it also knows which files it needs to deploy and to where and which commands it needs to run.

• Init system identification is not robust. It relies on some assumptions (and as we all know, assumption is the mother of all fuckups). Some OS distributions have multiple init systems (Ubuntu 14.04 has Upstart, SysV and half (HALF!?) of systemd).
• Stupidly enough, I have yet to standardize the status JSON returned and it is different for each init system.
• If anything fails during service creation, cleanup is not performed. This will be added in future versions.
• Currently, all errors exit with the same error level. This will be changed soon.

In some situations, directories related to the specific init system do not exist and should be created. For instance, even if systemd (systemctl) is available, /etc/sysconfig might not exist. IT IS UP TO THE USER to create those directories if they don't exist as Serv should not change the system on that level. The exception to the rule is with nssm, which will create the required dir (c:\nssm) for it to operate.

The user will be notified of which directory is missing.

Required dirs are:

• /lib/systemd/system
• /etc/sysconfig

• /etc/init.d
• /etc/default

• /etc/init

The directory (c:\nssm) will be created for the user in case it doesn't exist.

git clone git@github.com:nir0s/serv.git
cd ld
pip install tox
tox

Pull requests are always welcome to deal with specific distributions or just for general merriment.

• Under serv/init, add a file named <init_system_name>.py (e.g. runit.py).
• Implement a class named <init_system_name> (e.g. Runit). See systemd as a reference implementation.
• Pass the Base class which contains some basic parameter declarations and provides a method for generating files from templates to your class (e.g. from serv.init.base import Base).
• Add the relevant template files to serv/init/templates. The file names should be formatted as: <init_system_name>_<init_system_version>.* (e.g. runit_default).
• In serv/init/__init__.py, import the class you implemented (e.g. from serv.init.runit import Runit).