simplevisor command
simplevisor 0.7.1 - simple daemons supervisor
SYNOPSIS
simplevisor
[–conf CONF] [–daemon] [–interval INTERVAL] [-h] [–log LOG] [–logfile LOGFILE] [–loglevel LOGLEVEL] [-p PIDFILE] [–store STORE] [–version]
command [path]
DESCRIPTION
Simplevisor is a simple daemons supervisor, it is inspired
by Erlang OTP and it can supervise hierarchies of services.
COMMANDS
If a path is given or only one service entry is given:
- for given command X
- run the service X command where service is the only entry provided
or the entry identified by its path
If path is not given and root entry is a supervisor:
- start
- start the simplevisor process which start the supervision.
It can be used with –daemon if you want it as daemon
- stop
- stop the simplevisor process and all its children, if running
- status
- return the status of the simplevisor process
- check
- return the comparison between the expected state and the actual state.
0 -> everything is fine
1 -> warning, not expected
- restart
- stop + start the simplevisor process
- single
- execute one cycle of supervision and exit.
Useful to be run in a cron script
- stop_supervisor
- stop only the simplevisor process and the supervision
- stop_children
- stop only the children
- configuration_check
- just check the configuration
- pod
- generate pod format help to be used by pod2man to generate man page
- rst
- generate rst format help to be used in the web doc
- help
- same as -h/–help, print help page
OPTIONS
positional arguments:
- command
- check, configuration_check, help, pod, restart, rst, single, start, status, stop, stop_children, stop_supervisor
- path
- path to a service, subset of commands available: start, stop, status, check, restart
optional arguments:
- –conf CONF
- configuration file
- –daemon
- daemonize, ONLY with start
- –interval INTERVAL
- interval to wait between supervision cycles (default: 60)
- -h, –help
- print the help page
- –log LOG
- available: null, file, syslog, stdout (default: stdout)
- –logfile LOGFILE
- log file, ONLY for file
- –loglevel LOGLEVEL
- log level (default: warning)
- -p, –pidfile PIDFILE
- the pidfile
- –store STORE
- file where to store the state, it is not mandatory,however recommended to store the simplevisor nodes status between restarts
- –version
- print the program version
EXAMPLES
Create and edit the main configuration file:
## look for simplevisor.conf.example in the examples.
Run it:
simplevisor --conf /path/to/simplevisor.conf start
to run it in daemon mode:
simplevisor --conf /path/to/simplevisor.conf --daemon start
For other commands:
Given the example configuration, to start the httpd service:
simplevisor --conf /path/to/simplevisor.conf start svisor1/httpd