~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to docs/start-loggerhead.rst

  • Committer: John Arbash Meinel
  • Date: 2011-02-10 00:43:37 UTC
  • mto: This revision was merged to the branch mainline in revision 426.
  • Revision ID: john@arbash-meinel.com-20110210004337-8rwedln8fgg4un16
Add a <noop> command to the RequestWorker.

This allows us to push the workers to stop immediately, in case
they are currently blocked waiting on another item in the queue.
This makes the test suite integration tests faster, but also
makes the script runner exit in a timely manner as well.

Also creating a trivial load_test script, just for example
purposes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
:command:`start-loggerhead`
 
2
===========================
 
3
 
 
4
The :command:`start-loggerhead` command starts a new standalone Loggerhead
 
5
server.  By default, the server runs in the background (daemonized).
 
6
 
 
7
.. program:: start-loggerhead
 
8
 
 
9
Usage
 
10
-----
 
11
 
 
12
.. code-block:: sh
 
13
 
 
14
    start-loggerhead [OPTIONS]
 
15
 
 
16
Options
 
17
-------
 
18
 
 
19
.. cmdoption:: --version
 
20
 
 
21
    Print the software version and exit.
 
22
 
 
23
.. cmdoption:: -h, --help
 
24
 
 
25
    Show this help message and exit.
 
26
 
 
27
.. cmdoption:: --foreground
 
28
 
 
29
    Run in the foreground;  don't daemonize.
 
30
 
 
31
.. cmdoption:: -C, --check
 
32
 
 
33
    Only start if not already running (useful for cron jobs).
 
34
 
 
35
.. cmdoption:: -p, --pidfile=PIDFILE
 
36
 
 
37
    Override pid file location.
 
38
 
 
39
.. cmdoption:: -c, --config-file=CONFIGFILE
 
40
 
 
41
    Override configuration file location (the default is
 
42
    :file:`/etc/loggerhead.conf`).
 
43
 
 
44
.. cmdoption:: --log-folder=LOG_FOLDER
 
45
 
 
46
    The directory in which to place log files.