Bug 475403: A RHEL SysV Init Script for jobqueue.pl

Patch by Max Kanat-Alexander <mkanat@bugzilla.org> r=dkl, a=mkanat

1 files changed, 19 insertions, 1 deletions

diff --git a/jobqueue.pl b/jobqueue.pl
index eae05456a..78490ddf0 100755
--- a/jobqueue.pl
+++ b/jobqueue.pl
@@ -37,7 +37,7 @@ jobqueue.pl - Runs jobs in the background for Bugzilla.
 
 =head1 SYNOPSIS
 
- ./jobqueue.pl [OPTION] { start | stop | restart | check | help | version }
+ ./jobqueue.pl [OPTIONS] COMMAND
 
    OPTIONS:
    -f        Run in the foreground (don't detach)
@@ -53,9 +53,27 @@ jobqueue.pl - Runs jobs in the background for Bugzilla.
    restart   Stops a running jobqueue if one is running, and then
              starts a new one.
    check     Report the current status of the daemon.
+   install   On some *nix systems, this automatically installs and
+             configures jobqueue.pl as a system service so that it will
+             start every time the machine boots.
+   uninstall Removes the system service for jobqueue.pl.
    help      Display this usage info
    version   Display the version of jobqueue.pl
 
 =head1 DESCRIPTION
 
 See L<Bugzilla::JobQueue> and L<Bugzilla::JobQueue::Runner>.
+
+=head1 Running jobqueue.pl as a System Service
+
+For systems that use Upstart or SysV Init, there is a SysV/Upstart init
+script included with Bugzilla for jobqueue.pl: F<contrib/bugzilla-queue>.
+It should work out-of-the-box on RHEL, Fedora, CentOS etc.
+
+You can install it by doing C<./jobqueue.pl install> as root, after
+already having run L<checksetup> at least once to completion
+on this Bugzilla installation.
+
+If you are using a system that isn't RHEL, Fedora, CentOS, etc., then you
+may have to modify F<contrib/bugzilla-queue> and install it yourself
+manually in order to get C<jobqueue.pl> running as a system service.