From 093e9636944a0a928af3736c524c84b131fe37c9 Mon Sep 17 00:00:00 2001 From: Richard Maw Date: Sat, 24 Dec 2016 16:31:01 +0000 Subject: Document HTTP test mode dependencies --- TESTING | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'TESTING') diff --git a/TESTING b/TESTING index d06f400..4a195d7 100644 --- a/TESTING +++ b/TESTING @@ -32,6 +32,23 @@ to HTTP mode if you are changing the CGI code by running: The protocol being used during a test run is exposed in the GTT_PROTO environment variable passed to implementations. +HTTP mode test dependencies +--------------------------- + +HTTP tests work via password access rather than key access, +so the `htpasswd` binary must be in your `PATH`. +In debian this can be accomplised by installing `apache2-utils`. + +HTTP tests require starting an HTTP server on an unused port. +The test suite implements this using `lighttpd`, +so that binary must be in your `PATH`. +In debian this can be accomplished by installing `lighttpd`. +This starts it by default, so you probably want to run +`systemctl disable --now lighttpd.service` to stop it. + +This defaults to starting at 8080 and walking up to find a free one. +If there is a better port to use set `HTTP_FIRST_TEST_PORT`. + The fundamental parts of the `testing/` directory are ===================================================== -- cgit v1.2.1