gerrit/Documentation
Shawn O. Pearce e24c71fb86 Create a rc.d style start/stop script for our embedded daemon
Our startup script is extracted into $site_path/bin/gerrit.sh so
administrators can easily link to it in their /etc/rc.d management.

This script is based heavily upon the jetty.sh that comes in
any Jetty distribution, so we're opting to relicense it under the
Apache License version 2.0, rather than the Eclipse Public License.
Most of the script is intact, but I've certainly butchered and
reworked some parts that were really Jetty specific.

If /usr/bin/perl is available (these days it is on most systems) we
use that to launch the JVM rather than the shell.  This allows us to
force the process name as reported by ps to be 'GerritCodeReview'
rather than '/usr/bin/java', which can really help to nail down
which JVM is your Gerrit daemon.  If perl isn't found we stick the
unused system property -DGerritCodeReview=1 as early in the command
line as we can, to help ps challenged systems to still identify us.

We store the pid file for our running daemon in $site_path/logs,
rather than /tmp or /var/tmp, so its easier to locate and match to
a specific site path installation.

During `gerrit init` we try to capture the relevant parameters to
locate the JRE and gerrit.war and stuff them into gerrit.config so
the start script can find them later on.  Adminstrators can always
adjust these later on if necessary.

If git isn't available to read the gerrit.config with during startup
we use a crude but workable configuration parser written entirely
in Bourne shell.  It should be just good enough to scan through the
gerrit.config and pull out container.javaHome and container.war,
which is about all we need to boot ourselves.

Change-Id: I52872b1acffc22e80c5fd33fd6df0e152bc96cff
Signed-off-by: Shawn O. Pearce <sop@google.com>
2009-12-07 20:32:43 -08:00
..
javascript Make documentation table of contents anchors human readable 2009-08-20 11:03:48 -07:00
.gitignore Move documentation to gerrit.googlecode.com website 2009-01-29 08:53:07 -08:00
Makefile Quote the current directory when running asciidoc 2009-08-22 14:14:53 -07:00
access-control.txt Correct access control documentation about project ownership 2009-08-22 13:41:38 -07:00
asciidoc.conf Put a link back to the index in every page footer 2009-05-28 15:55:01 -07:00
cmd-approve.txt gerrit approve: Add user documentation 2009-08-28 20:30:26 -07:00
cmd-cherry-pick.txt Correct scp commands in documentation to include -p 2009-10-15 07:48:52 -07:00
cmd-create-project.txt style fixup: remote trailing whitespace from our source lines 2009-11-02 10:37:01 -08:00
cmd-flush-caches.txt Cleanup section anchors to be more useful 2009-08-18 19:45:33 -07:00
cmd-gsql.txt Implement query tool on command line and over SSH 2009-11-17 20:47:04 -08:00
cmd-hook-commit-msg.txt Correct scp commands in documentation to include -p 2009-10-15 07:48:52 -07:00
cmd-index.txt kill: Support killing any queued task by interrupting it 2009-11-21 13:34:56 -08:00
cmd-kill.txt kill: Support killing any queued task by interrupting it 2009-11-21 13:34:56 -08:00
cmd-ls-projects.txt Put a link back to the index in every page footer 2009-05-28 15:55:01 -07:00
cmd-receive-pack.txt Document git receive-pack with Gerrit options 2009-06-16 07:27:53 -07:00
cmd-replicate.txt Put a link back to the index in every page footer 2009-05-28 15:55:01 -07:00
cmd-show-caches.txt show-caches: Correct example output in documentation 2009-11-02 10:39:31 -08:00
cmd-show-connections.txt kill: Support killing any queued task by interrupting it 2009-11-21 13:34:56 -08:00
cmd-show-queue.txt kill: Support killing any queued task by interrupting it 2009-11-21 13:34:56 -08:00
config-contact.txt Update documentation to point to etc subdirectory 2009-11-17 16:10:10 -08:00
config-gerrit.txt Create a rc.d style start/stop script for our embedded daemon 2009-12-07 20:32:43 -08:00
config-gitweb.txt Update documentation to point to etc subdirectory 2009-11-17 16:10:10 -08:00
config-headerfooter.txt Update documentation to point to etc subdirectory 2009-11-17 16:10:10 -08:00
config-replication.txt Replication Security 2009-11-11 17:31:08 +01:00
config-sso.txt Update documentation to point to etc subdirectory 2009-11-17 16:10:10 -08:00
dev-design.txt documentation: Correct links in dev-design 2009-12-02 08:11:34 -08:00
dev-eclipse.txt Rewrite our build as modular maven components 2009-11-11 16:54:06 -08:00
dev-readme.txt Rewrite our build as modular maven components 2009-11-11 16:54:06 -08:00
i18n-readme.txt Put a link back to the index in every page footer 2009-05-28 15:55:01 -07:00
index.txt Move server programs section under User Guide 2009-11-02 10:40:14 -08:00
install.txt Automatically make first user account administrator 2009-11-17 17:43:25 -08:00
licenses.txt Embed Jetty and run it out of `java -jar gerrit.war daemon` 2009-11-11 16:54:07 -08:00
pgm-daemon.txt daemon: Fix --site-path documentation 2009-11-12 21:07:14 -08:00
pgm-gsql.txt Implement query tool on command line and over SSH 2009-11-17 20:47:04 -08:00
pgm-index.txt Implement query tool on command line and over SSH 2009-11-17 20:47:04 -08:00
pgm-init.txt init: Create a command to setup a new Gerrit installation 2009-11-17 14:52:07 -08:00
project-setup.txt Remove the branches table from the database 2009-11-02 11:25:34 -08:00
user-changeid.txt Correct scp commands in documentation to include -p 2009-10-15 07:48:52 -07:00
user-signedoffby.txt style fixup: remote trailing whitespace from our source lines 2009-11-02 10:37:01 -08:00
user-upload.txt style fixup: remote trailing whitespace from our source lines 2009-11-02 10:37:01 -08:00