rt-apache - Wrapper to start Apache running RT
This script exists to make it easier to run RT under Apache for testing. It is not intended as a way to deploy RT, or to provide example Apache configuration for RT. For instructions on how to deploy RT with Apache, please read the provided docs/web_deployment.pod file.
Running this script will start apache2 with a custom-built configuration file, built based on command-line options and the contents of your RT_SiteConfig.pm. It will work with either RT 3.8.x or RT 4.0.x. As it is primarily for simple testing, it runs Apache as the current user.
rt-apache will parse your RT_SiteConfig.pm for its
WebPort configuration, and adjust its defaults accordingly.
- --root path
The path to the RT install to serve. This defaults to the
RTHOMEenvironment variable, or
- --fastcgi, --fcgid, --perl
Determines the Apache module which is used. By default, the first one of that list which exists will be used. See also "--modules".
- --port number, -p
Choses the port to listen on. By default, this is parsed from the RT_SiteConfig.pm, and falling back to 8888.
- --ssl [number]
Also listens on the provided port with HTTPS, using a self-signed certificate for
localhost. If the port number is not specified, defaults to port 4430.
- --auth [/path/to/htpasswd], -A
Turns on HTTP Basic Authentication; this is done automatically if
$WebRemoteUserAuthis set in the RT_SiteConfig.pm. The provided path should be to a htpasswd file; if not given, defaults to a file containing only user
- --single, -X
Run only one process or thread, for ease of debugging.
- --rt3, -3
Declares that the RT install in question is RT 3.8.x.
rt-apachecan usually detect this for you, however.
- --modules path
The path to the Apache2 modules directory, which is expected to contain at least one of mod_fcgid.so, mod_fastcgi.so, or mod_perl.so. Defaults to /usr/lib/apache2/modules.