Start/restart/stop all processes of a program with numprocs > 1 using supervisorctl start program*

[wodow]

It would be useful to be able to start and stop all processes in a program with multiple processes (i.e. numprocs > 1) by passing a wildcard to start/stop/restart, e.g.

supervisorctl start myprogram*

(This probably assumes process_name is defined like myprogram%(process_num)s)

[mnaberez]

supervisor> status
myprogram:myprogram_0 RUNNING    pid 22793, uptime 1 day, 12:33:00
myprogram:myprogram_1 RUNNING    pid 22792, uptime 1 day, 12:33:00

supervisor> stop myprogram:*
myprogram_0: stopped
myprogram_1: stopped

supervisor> start myprogram:*
myprogram_0: started
myprogram_1: started

supervisor> restart myprogram:*
myprogram_0: stopped
myprogram_1: stopped
myprogram_0: started
myprogram_1: started

[wodow]

I see. I did not observe it working in that case because all of my programs are within groups.

I tried:

supervisor> status
mygroup:myprogram0
mygroup:myprogram1
mygroup:anotherprogram

supervisor> start mygroup:myprogram*
mygroup:myprogram*: ERROR (no such process)

and

supervisor> start mygroup:myprogram:*
mygroup:myprogram:*: ERROR (no such process)

So, it is possible to start/stop/restart the whole group using start mygroup:* - but not multi-process programs that have been grouped?

[mnaberez]

Check out the supervisor-wildcards plugin.

[wodow]

Thanks - will take a look.

[sagikazarmark]

I am the author of one of the PHP client implementations for the XML-RPC API. I referenced this issue in one of the issues in the client library. The problem there is that a process started by supervisor with the numproc parameter does not let people to stop/start one of the processes one by one.

Can anyone confirm if it is possible or not?

[mnaberez]

It is possible on any 3.x version in both supervisorctl and the XML-RPC interface.

Minimal supervisord.conf:

[supervisord]
logfile = /tmp/supervisord.log

[inet_http_server]
port = 127.0.0.1:9001

[supervisorctl]
serverurl = http://127.0.0.1:9001

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[program:cat]
command = /bin/cat
process_name = cat_%(process_num)s
numprocs = 2
autostart = true

Start supervisord in the foreground with that config:

$ supervisord -n -c /path/to/supervisord.conf

Using supervisorctl:

$ supervisorctl -c /path/to/supervisord.conf
cat:cat_0                        RUNNING   pid 99013, uptime 0:00:01
cat:cat_1                        RUNNING   pid 99014, uptime 0:00:01
supervisor> stop cat:*
cat:cat_0: stopped
cat:cat_1: stopped
supervisor> start cat:cat_1
cat:cat_1: started

Using the XML-RPC interface:

$ python
Python 2.7.8 (default, Oct 16 2014, 20:49:38)
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:9001/RPC2')
>>> s.supervisor.stopProcessGroup('cat')
[{'status': 80, 'group': 'cat', 'name': 'cat_0', 'description': 'OK'}, {'status': 80, 'group': 'cat', 'name': 'cat_1', 'description': 'OK'}]
>>> s.supervisor.startProcessGroup('cat')
[{'status': 80, 'group': 'cat', 'name': 'cat_0', 'description': 'OK'}, {'status': 80, 'group': 'cat', 'name': 'cat_1', 'description': 'OK'}]
>>> s.supervisor.stopProcess('cat:cat_1')
True
>>> s.supervisor.startProcess('cat:cat_1')
True

[sagikazarmark]

Thanks for the anwser. I also tested it, and it seems to work. I found some bugs in the attached config which might solve the issue. @mnaberez thanks again. Merry Christmas.