gatling for Debian
==================

Startup
-------

The daemon is started via "/etc/init.d/gatling start". To automatically start
it on bootup, edit /etc/default/gatling and set "START_DAEMON" to "YES" (as
documented there).

You can also configure gatling options there.

By default, gatling chroots to /var/www and serves a default index.html from
/var/www/default.


HTTP and HTTPS with tlsgatling
------------------------------

The following applies to tlsgatling, the SSL-enabled OpenSSL linked version of
gatling. This is the default in Debian.

By default, Gatling serves HTTP on port 80 and HTTPS on port 443 (defaults).
HTTP should work out of the box when the daemon is first started up.  However,
the necessary certificates for HTTPS (via OpenSSL) are not available by default
and you need to generate them yourself (or let some authority do it for you).

For a self-signed server.pem certificate, you can do the following:
  $ dd if=/dev/random of=rand.dat bs=1024 count=1
  $ openssl genrsa -out cakey.key -rand rand.dat 2048
  $ openssl req -new -key cakey.key -out cakey.csr
  $ openssl x509 -req -days 1780 -set_serial 1 -in cakey.csr -signkey cakey.key -out cakey.pem
  $ cat cakey.key cakey.pem > server.pem

You must copy server.pem to the web server root, (/var/www by default)

Further, gatling chroots to the webserver root directory. When using HTTPS via
libssl, it needs /dev/random and/or /dev/urandom. You can create this with for
example (as root):

  # mkdir /var/www/dev
  # cp -a /dev/random /dev/urandom /var/www/dev

At this point, HTTPS should be working.

Besides tlsgatling, there is also gatling (Non-SSL version) and ptlsgatling
(PolarSSL version) available. You can choose one of them in
/etc/default/gatling.


Other protocols (FTP, SMB)
--------------------------

For the other protocols (FTP, SMB), you need to explicitly enable support via
command line options in /etc/default/gatling.


-- Roland Stigge <stigge@antcom.de>, Sat, 16 Jul 2011 14:19:54 +0200
