From 8262281483410b997049e0bfbcb95e029adc6f61 Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Tue, 11 Mar 2008 19:58:53 +0000 Subject: [PATCH] Adding a Debian init script for the Luminotes server. --- INSTALL | 6 ++ NEWS | 4 + config/Development.py | 2 +- luminotes.py | 2 + tools/luminotes_debian_initscript | 153 ++++++++++++++++++++++++++++++ 5 files changed, 166 insertions(+), 1 deletion(-) create mode 100755 tools/luminotes_debian_initscript diff --git a/INSTALL b/INSTALL index 2d8ddb3..6726698 100644 --- a/INSTALL +++ b/INSTALL @@ -130,6 +130,12 @@ Then to actually start the production mode server, run: You should be able to connect to the site at whatever domain you've configured Apache to serve. +Optionally, you can copy tools/luminotes_debian_initscript to +/etc/init.d/luminotes and use the following command to start the Luminotes +server instead: + + /etc/init.d/luminotes start + sending email ------------- diff --git a/NEWS b/NEWS index 3c4f87c..a3bd672 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,7 @@ +1.2.11: March 11, 2008 + * Added a Debian init script to run the Luminotes server from + /etc/init.d/luminotes. + 1.2.10: March 11, 2008 * More intelligent scrolling when displaying messages and errors. diff --git a/config/Development.py b/config/Development.py index 584757a..858d7ec 100644 --- a/config/Development.py +++ b/config/Development.py @@ -6,7 +6,7 @@ settings = { "global": { "server.thread_pool": 10, "autoreload.on": True, - "static_filter.root": os.path.abspath( "." ), + "static_filter.root": os.getcwd(), }, "/static": { "static_filter.on": True, diff --git a/luminotes.py b/luminotes.py index 433a731..e336441 100644 --- a/luminotes.py +++ b/luminotes.py @@ -1,3 +1,5 @@ +#!/usr/bin/python2.4 + import cherrypy from controller.Database import Database from controller.Root import Root diff --git a/tools/luminotes_debian_initscript b/tools/luminotes_debian_initscript new file mode 100755 index 0000000..ae0afcd --- /dev/null +++ b/tools/luminotes_debian_initscript @@ -0,0 +1,153 @@ +#! /bin/sh +### BEGIN INIT INFO +# Provides: luminotes +# Required-Start: $local_fs $remote_fs +# Required-Stop: $local_fs $remote_fs +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Luminotes +# Description: personal wiki notebook server +### END INIT INFO + +# Author: Dan Helfman + +# Do NOT "set -e" + +# PATH should only include /usr/* if it runs after the mountnfs.sh script +PATH=/sbin:/usr/sbin:/bin:/usr/bin +DESC="personal wiki notebook server" +NAME=luminotes +DAEMON=/home/luminotes/luminotes/$NAME.py +DAEMON_ARGS="" +PIDFILE=/var/run/$NAME.pid +SCRIPTNAME=/etc/init.d/$NAME +CHUID=luminotes +CHDIR=/home/luminotes/luminotes + +# Exit if the package is not installed +[ -x "$DAEMON" ] || exit 0 + +# Read configuration variable file if it is present +[ -r /etc/default/$NAME ] && . /etc/default/$NAME + +# Load the VERBOSE setting and other rcS variables +. /lib/init/vars.sh + +# Define LSB log_* functions. +# Depend on lsb-base (>= 3.0-6) to ensure that this file is present. +. /lib/lsb/init-functions + +# +# Function that starts the daemon/service +# +do_start() +{ + # Return + # 0 if daemon has been started + # 1 if daemon was already running + # 2 if daemon could not be started + start-stop-daemon --start --quiet --chuid $CHUID --chdir $CHDIR --make-pidfile --pidfile $PIDFILE --background --exec $DAEMON --test > /dev/null \ + || return 1 + start-stop-daemon --start --quiet --chuid $CHUID --chdir $CHDIR --make-pidfile --pidfile $PIDFILE --background --exec $DAEMON -- \ + $DAEMON_ARGS \ + || return 2 + # Add code here, if necessary, that waits for the process to be ready + # to handle requests from services started subsequently which depend + # on this one. As a last resort, sleep for some time. +} + +# +# Function that stops the daemon/service +# +do_stop() +{ + # Return + # 0 if daemon has been stopped + # 1 if daemon was already stopped + # 2 if daemon could not be stopped + # other if a failure occurred + start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME + RETVAL="$?" + [ "$RETVAL" = 2 ] && return 2 + # Wait for children to finish too if this is a daemon that forks + # and if the daemon is only ever run from this initscript. + # If the above conditions are not satisfied then add some other code + # that waits for the process to drop all resources that could be + # needed by services started subsequently. A last resort is to + # sleep for some time. + start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON + [ "$?" = 2 ] && return 2 + # Many daemons don't delete their pidfiles when they exit. + rm -f $PIDFILE + return "$RETVAL" +} + +# +# Function that sends a SIGHUP to the daemon/service +# +do_reload() { + # + # If the daemon can reload its configuration without + # restarting (for example, when it is sent a SIGHUP), + # then implement that here. + # + start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME + return 0 +} + +case "$1" in + start) + [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME" + do_start + case "$?" in + 0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;; + 2) [ "$VERBOSE" != no ] && log_end_msg 1 ;; + esac + ;; + stop) + [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME" + do_stop + case "$?" in + 0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;; + 2) [ "$VERBOSE" != no ] && log_end_msg 1 ;; + esac + ;; + #reload|force-reload) + # + # If do_reload() is not implemented then leave this commented out + # and leave 'force-reload' as an alias for 'restart'. + # + #log_daemon_msg "Reloading $DESC" "$NAME" + #do_reload + #log_end_msg $? + #;; + restart|force-reload) + # + # If the "reload" option is implemented then remove the + # 'force-reload' alias + # + log_daemon_msg "Restarting $DESC" "$NAME" + do_stop + case "$?" in + 0|1) + do_start + case "$?" in + 0) log_end_msg 0 ;; + 1) log_end_msg 1 ;; # Old process is still running + *) log_end_msg 1 ;; # Failed to start + esac + ;; + *) + # Failed to stop + log_end_msg 1 + ;; + esac + ;; + *) + #echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2 + echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2 + exit 3 + ;; +esac + +: