How do I write a bash script to restart a process if it dies?
Solution 1
Avoid PID-files, crons, or anything else that tries to evaluate processes that aren't their children.
There is a very good reason why in UNIX, you can ONLY wait on your children. Any method (ps parsing, pgrep, storing a PID, ...) that tries to work around that is flawed and has gaping holes in it. Just say no.
Instead you need the process that monitors your process to be the process' parent. What does this mean? It means only the process that starts your process can reliably wait for it to end. In bash, this is absolutely trivial.
until myserver; do
echo "Server 'myserver' crashed with exit code $?. Respawning.." >&2
sleep 1
done
The above piece of bash code runs myserver
in an until
loop. The first line starts myserver
and waits for it to end. When it ends, until
checks its exit status. If the exit status is 0
, it means it ended gracefully (which means you asked it to shut down somehow, and it did so successfully). In that case we don't want to restart it (we just asked it to shut down!). If the exit status is not 0
, until
will run the loop body, which emits an error message on STDERR and restarts the loop (back to line 1) after 1 second.
Why do we wait a second? Because if something's wrong with the startup sequence of myserver
and it crashes immediately, you'll have a very intensive loop of constant restarting and crashing on your hands. The sleep 1
takes away the strain from that.
Now all you need to do is start this bash script (asynchronously, probably), and it will monitor myserver
and restart it as necessary. If you want to start the monitor on boot (making the server "survive" reboots), you can schedule it in your user's cron(1) with an @reboot
rule. Open your cron rules with crontab
:
crontab -e
Then add a rule to start your monitor script:
@reboot /usr/local/bin/myservermonitor
Alternatively; look at inittab(5) and /etc/inittab. You can add a line in there to have myserver
start at a certain init level and be respawned automatically.
Edit.
Let me add some information on why not to use PID files. While they are very popular; they are also very flawed and there's no reason why you wouldn't just do it the correct way.
Consider this:
-
PID recycling (killing the wrong process):
-
/etc/init.d/foo start
: startfoo
, writefoo
's PID to/var/run/foo.pid
- A while later:
foo
dies somehow. - A while later: any random process that starts (call it
bar
) takes a random PID, imagine it takingfoo
's old PID. - You notice
foo
's gone:/etc/init.d/foo/restart
reads/var/run/foo.pid
, checks to see if it's still alive, findsbar
, thinks it'sfoo
, kills it, starts a newfoo
.
-
PID files go stale. You need over-complicated (or should I say, non-trivial) logic to check whether the PID file is stale, and any such logic is again vulnerable to
1.
.What if you don't even have write access or are in a read-only environment?
It's pointless overcomplication; see how simple my example above is. No need to complicate that, at all.
See also: Are PID-files still flawed when doing it 'right'?
By the way; even worse than PID files is parsing ps
! Don't ever do this.
-
ps
is very unportable. While you find it on almost every UNIX system; its arguments vary greatly if you want non-standard output. And standard output is ONLY for human consumption, not for scripted parsing! - Parsing
ps
leads to a LOT of false positives. Take theps aux | grep PID
example, and now imagine someone starting a process with a number somewhere as argument that happens to be the same as the PID you stared your daemon with! Imagine two people starting an X session and you grepping for X to kill yours. It's just all kinds of bad.
If you don't want to manage the process yourself; there are some perfectly good systems out there that will act as monitor for your processes. Look into runit, for example.
Solution 2
Have a look at monit (http://mmonit.com/monit/). It handles start, stop and restart of your script and can do health checks plus restarts if necessary.
Or do a simple script:
while true
do
/your/script
sleep 1
done
Solution 3
The easiest way to do it is using flock on file. In Python script you'd do
lf = open('/tmp/script.lock','w')
if(fcntl.flock(lf, fcntl.LOCK_EX|fcntl.LOCK_NB) != 0):
sys.exit('other instance already running')
lf.write('%d\n'%os.getpid())
lf.flush()
In shell you can actually test if it's running:
if [ `flock -xn /tmp/script.lock -c 'echo 1'` ]; then
echo 'it's not running'
restart.
else
echo -n 'it's already running with PID '
cat /tmp/script.lock
fi
But of course you don't have to test, because if it's already running and you restart it, it'll exit with 'other instance already running'
When process dies, all it's file descriptors are closed and all locks are automatically removed.
Solution 4
In-line:
while true; do <your-bash-snippet> && break; done
e.g. #1
while true; do openconnect x.x.x.x:xxxx && break; done
e.g. #2
while true; do docker logs -f container-name; sleep 2; done
Solution 5
You should use monit, a standard unix tool that can monitor different things on the system and react accordingly.
From the docs: http://mmonit.com/monit/documentation/monit.html#pid_testing
check process checkqueue.py with pidfile /var/run/checkqueue.pid if changed pid then exec "checkqueue_restart.sh"
You can also configure monit to email you when it does do a restart.
Related videos on Youtube
Tom
I'm mostly a Python & JavaScript developer at the moment but I've done a lot of things...
Updated on February 23, 2022Comments
-
Tom over 2 years
I have a python script that'll be checking a queue and performing an action on each item:
# checkqueue.py while True: check_queue() do_something()
How do I write a bash script that will check if it's running, and if not, start it. Roughly the following pseudo code (or maybe it should do something like
ps | grep
?):# keepalivescript.sh if processidfile exists: if processid is running: exit, all ok run checkqueue.py write processid to processidfile
I'll call that from a crontab:
# crontab */5 * * * * /path/to/keepalivescript.sh
-
mootmoot over 7 yearsJust to add this for 2017. Use supervisord. crontab is not mean to do this kind of task. A bash script is terrible on emitting the real error. stackoverflow.com/questions/9301494/…
-
Lars Nordin over 4 yearsHow about using inittab and respawn instead of other non-system solutions? See superuser.com/a/507835/116705
-
-
Tom about 15 yearscool, that's fleshing out some of my pseudo code pretty well. two qns: 1) how do I generate PIDFILE? 2) what's psgrep? it's not on ubuntu server.
-
soulmerge about 15 yearsps grep is just a small app that does the same as
ps ax|grep ...
. You can just install it or write a function for that: function psgrep() {ps ax|grep -v grep|grep -q "$1"} -
Christian Witts about 15 yearsFile lock is released as soon as the application stops, either by killing, naturally or crashing.
-
soulmerge about 15 yearsJust noticed that I hadn't answered your first question.
-
vartec about 15 yearsOn really busy server it's possible that PID will get recycled before you check.
-
Chas. Owens about 15 yearsYou might add some code to send a message or stop the loop if it restarts too many times in a short period of time.
-
Juliano about 15 years+1 most correct answer. But you are somewhat too pragmatic about pid files... SysV init scripts are based heavily on pid files, mostly because the start and stop states may be in different pgids.
-
lhunath about 15 years@Chas. Ownes: I don't think that's necessary. It would just complicate the implementation for no good reason. Simplicity is always more important; and if it restarts often, the sleep will keep it from having any bad impact on your system resources. There is already a message anyway.
-
lhunath about 15 years@Juliano: I know PID files are used everywhere. It doesn't mean they're not just as flawed as they were before. Start foo, put its PID in foo.pid. Foo dies. Something else gets started somewhere, takes a random PID which happens to be the one foo had. Stopping foo will kill the wrong process!
-
hippietrail over 13 yearsOnly root has access to
/etc/inittab
- how would a mere user ensure that some process always gets restarted in a manner that would handle both a process crash and a system restart? -
Laurent Debricon about 13 years
-
ДМИТРИЙ МАЛИКОВ over 12 yearsSounds clear and easy until you don't need to manage some process with timeout without implementing that logic into child process. There is no convenient and easy to use built-in method to do it.
-
James Andino over 11 yearsi know this is naive... Running a script like this and then having a 2nd server ping server 1 to see if the service is up is the best peace of mind I can get I guess. There really isnt any 2nd layer to to making sure the until script is running. I mean why would there be the script is not doing anything.
-
James Andino over 11 yearstrap '~/.bin/panic' EXIT; # is this just crazy talk or does it make it safer?
-
andreabedini almost 11 years@hippietrail cron has
@reboot
time specification -
Charles Duffy almost 11 years@Tom ...to be a little more precise -- the lock is no longer active as soon as the file handle it's on closes. If the Python script never closes the file handle by intent, and makes sure it doesn't get closed automatically via the file object being garbage-collected, then it closing probably means the script exited / was killed. This works even for reboots and such.
-
orschiro over 10 yearsHow resource-intensive is such a loop and will it make a difference to use sleep greater than 1?
-
lhunath over 10 years@orschiro There is no resource consumption when the program behaves. If it exists immediately on launch, continuously, the resource consumption with a sleep 1 is still utterly negligible.
-
getWeberForStackExchange over 10 yearsCan believe I'm just seeing this answer. Thanks so much!
-
Tomáš Zato over 10 yearsUnfortunatelly, my process does not die and return error upon failure. I still need to reset it automatically.
-
lhunath over 10 years@TomášZato you can do the above loop without testing the process' exit code
while true; do myprocess; done
but note that there is now no way to stop the process. -
Tomáš Zato over 10 yearsThe problem was that the process wouldn't ever exit... I fixed that in the code however and now I'm using your answer.
-
Floyd over 10 yearsI was just writing a process monitor for my autossh tunnels, and searched for the best practice to check process alive based on the pid. I had to scrap most of the code I had already written, I hate you ;) Now it's so simple and efficient, thanks to you!
-
Sergey P. aka azure over 10 yearsIf bash that is executing provided script is closed then the process that was launched is still being executed. And that's a problem for me.
-
lhunath over 10 years@SergeyP.akaazure The only way to force the parent to kill the child on exit in bash is to turn the child into a job and signal it:
trap 'kill $(jobs -p)' EXIT; until myserver & wait; do sleep 1; done
-
Karussell almost 10 yearsLet me know if this workaround combined with a PID file is still flawed stackoverflow.com/questions/25906020/…
-
Charles Duffy over 9 yearsThere are much better ways to use
flock
... in fact, the man page explicitly demonstrates how!exec {lock_fd}>/tmp/script.lock; flock -x "$lock_fd"
is the bash equivalent to your Python, and leaves the lock held (so if you then exec a process, the lock will stay held until that process exits). -
Charles Duffy over 9 yearsMonit is a great tool, but it is not standard in the formal sense of being specified in either POSIX or SUSV.
-
Sarke almost 9 yearsMonit is exactly what you are looking for.
-
tripleee over 8 years
grep | awk
is still an antipattern - you wantawk "/$INSTALLATION/ { print \$1 }"
to conflate the uselessgrep
into the Awk script, which can find lines by regular expression itself very well, thank you very much. -
Curtis Yallop over 6 years"while 1" does not work. You need "while [ 1 ]" or "while true" or "while :". See unix.stackexchange.com/questions/367108/what-does-while-mean
-
Rutrus almost 6 yearsI downvoted you because your code is wrong. Using
flock
is the correct way, but your scripts are wrong. The only command you need to set in crontab is:flock -n /tmp/script.lock -c '/path/to/my/script.py'
-
tripleee over 5 yearsDoes this offer any advantage over the accepted answer?
-
Daniel Bradley over 5 yearsYes, I think it is preferable to use a built-in command than to write a shell script that does the same thing that will have to be maintained as a part of system codebase. Even if the functionality is required as part of a shell script the above command could also be used so it is relevant to a shell scripting question.
-
tripleee over 5 yearsThis is not "built in"; if it's installed by default on some distro, your answer should probably specify the distro (and ideally include a pointer for where to download it if yours isn't one of them).
-
tripleee over 5 yearsLooks like it's an Ubuntu utility; but it's optional even on Ubuntu. manpages.ubuntu.com/manpages/bionic/man1/run-one.1.html
-
David Kohen over 4 yearsWorth noting: the run-one utilities do exactly what their name says - you can only run one instance of any command that is run with run-one-nnnnn. Other answers here are more executable agnostic - thay don't care about the content of the command at all.
-
smartins over 2 yearsThis doesn't seem accurate, "watch - execute a program periodically", meaning it will execute every xx seconds, not if/when the process stops.
-
Tom over 2 years@smartins the delay is an interval, per the doc. So with
-n 5
it will run the command again 5 seconds after the last one stopped. You can test it withwatch -n 5 "sleep 5"
and see that it's updated every 10 seconds. -
Shodan over 2 yearsThis is my favorite answer, in-line works great, no extra software dependency, I want this in command form, let's call it jafari Here is what I used it for while true; do ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 -i :10.0 -f mpegts srt://:6666?mode=listener && break; done there should be jafari ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 -i :10.0 -f mpegts srt://:6666?mode=listener
-
Rony Tesler about 2 yearsWhat if I want to do it for multiple processes?