michielovertoom.com

CherryPy integration in FreeBSD • 20 Jan 2009

Note: I posted this earlier on the CherryPy wiki. Nowadays I run CherryPy under mod_wsgi in Apache.

CherryPy logo

This describes how to start a cherrypy site using its built-in HTTP server and cherryd in such a way that it integrates nicely with FreeBSD's rc system. FreeBSD uses a text file /etc/rc.conf in combination with a set of scripts in /usr/local/etc/rc.d to start local daemons.

I set out to achieve the following:

In the following example I have my site defined in chsite.py and chsite.conf, which both reside in /www.

First, make sure the cherryd script itself is executable. In a standard install of cherrypy under FreeBSD:

chmod a+x /usr/local/lib/python2.5/site-packages/cherrypy/cherryd

Include the following lines in /etc/rc.conf:

cherryd_enable="YES" cherryd_wwwdir="/www" cherryd_flags="-c chsite.conf -i chsite"

Put the following script as cherryd in /usr/local/etc/rc.d, and don't forget to make it executable:

#!/bin/sh # # cherryd for FreeBSD 7.0 rc.d usage, by Michiel Overtoom, motoom@xs4all.nl # based on http://www.djangosnippets.org/snippets/1050/ by David Blewett # # PROVIDE: cherryd # REQUIRE: LOGIN # KEYWORD: shutdown # Add these lines to /etc/rc.conf: # # cherryd_enable="YES" # cherryd_wwwdir="/www" # where the site .py and .conf files are # cherryd_flags="-c CONFIG -i IMPORTS" # specify config file(s) and imports to use # # Make sure the cherryd script is chmodded as executable. # # Before playing interactively with this script and not having added the # config lines to rc.conf yet, you might want to do: setenv cherryd_enable YES . /etc/rc.subr # On FreeBSD 7, the default location for python is /usr/local/bin, # but during boot /usr/local/bin isn't in the PATH yet. # The cherryd script uses the following shebang line: #!/usr/bin/env python # to make that shebang work, we have to add /usr/local/bin to the PATH. PATH="$PATH:/usr/local/bin" name="cherryd" rcvar=`set_rcvar` pidfile="/var/run/${name}.pid" command_interpreter="python" command="/usr/local/lib/python2.5/site-packages/cherrypy/${name}" command_args="-d -p $pidfile ${cherryd_flags}" start_cmd="echo \"Starting ${name}.\"; cd ${cherryd_wwwdir}; ${command} ${command_args}" load_rc_config $name run_rc_command "$1"

After these changes, the site should start automatically when the machine is restarted. To stop, start, restart the site you'd use the commands:

# /usr/local/etc/rc.d/cherryd stop # /usr/local/etc/rc.d/cherryd start # /usr/local/etc/rc.d/cherryd restart

See also daemonization.

Fork me on GitHub

content last edited on October 31, 2010, 13:37 - rendered in 2.51 msec