#summary Guide explaining how to run Taskr as Linux init.d service

= Introduction =

Once you have Taskr configured, you'll probably want to run it as a system service. On Linux this is easily done via the standard `init.d` mechanism. On Windows, I have no idea. Maybe someone can suggest something :)

= Installing as an `init.d` service =

Each Linux distribution has a slightly different way of deploying system services. The following is an example of a SuSE init.d script, but it should be roughly equivalent for other distributions.

First, create the `/etc/init.d/taskr` file and make it executable (you'll need to do this as root):

{{{
su -
touch /etc/init.d/taskr
chmod +x /etc/init.d/taskr
}}}

Now open up the file in a text editor and paste in the following code:

{{{
#! /bin/sh
#
# chkconfig - 85 15
# description: Provides a networked scheduling service.
#
### BEGIN INIT INFO
# Provides: taskr
# Required-Start: $syslog
# Should-Start:
# Required-Stop:  $syslog
# Should-Stop:
# Default-Start:  3 5
# Default-Stop:   0 1 2 6
# Description:    Start the Taskr daemon
### END INIT INFO

CTL=taskr-ctl

# Source config
. /etc/rc.status

rc_reset
case "$1" in
    start)
        $CTL start
        rc_status -v
        ;;
    stop)
        $CTL stop
        rc_status -v
        ;;
    restart)
        $0 stop
        $0 start
        rc_status
        ;;
    status)
        $CTL status
        rc_status -v
        ;;
    *)
        echo "Usage: $0 {start|stop|status|restart}"
        exit 1
        ;;
esac
rc_exit
}}}

Again, the above will probably differ slightly for your distribution. Open up any other file in `/etc/init.d` and take a look at how its done.

Now that you have the init.d script in place, try it out by running:

{{{
/etc/init.d/taskr start
}}}

If everything is alright, you should see the Taskr server start up.

= Running Taskr as a Boot Service =

Once you have the `init.d` script set up, you can configure Taskr to start up during boot using the following command:

{{{
chkconfig -a taskr
}}}

Note that this command will vary depending on your distribution. For example on Debian/Ubuntu it's:

{{{
update-rc.d taskr defaults
}}}