Implementing InteProxy Functionality with Apache
================================================

This directory contains a minimal configuration for Apache 2 so that it
behaves like InteProxy.  This configuration was tested mainly on Debian
GNU Linux.  Some of the instructions may have to be adjusted for other
platforms.

With the default configuration, the Apache server listens on localhost,
port 64609.  For a set of configured WMS servers, when a request for a
URL like this

  http://localhost:64609/wms.example.com/cgi-bin/wms?query=...

is sent to the server, Apache transparently converts it into a request
for a URL like

  https://wms.example.com/cgi-bin/wms?user=...&password=...&query=...

and returns the resource found there to the client.


Requirements
------------

Make sure you have configured Apache2 webserver with the following modules
enabled:
 - mod_rewrite
 - mod_authz_host
 - mod_proxy
 - mod_proxy_http
 - mod_ssl
 - mod_filter
 - mod_substitute

It is recommended to run InteProxy Server in a separate Virtual Host.


Configuration
-------------

1. Adapt to local platform

conf/platform-debian.conf contains debian specific configuration.  To
use the configuration on a different platform adjust this file.

2. Convert InteProxy configuration.

  ../create-rewrite-rules.py --config-file=... \
      --server-prefix=http://localhost:64609/ -o conf/inteproxy-rewrite.conf

create-rewrite-rules.py reads the InteProxy config file and writes Apache
RewriteRule and Substitute directives to the output file.


Starting Apache
---------------

  apache2ctl -d /path/to/inteproxy/apache/ -f conf/httpd.conf -k start

To stop or restart Apache, use stop resp. restart instead of start with
the -k option.

The ServerRoot specified with the -d parameter should be the directory
containing this README.txt file so that conf/httpd.conf which is
interpreted relative to the ServerRoot points to the right file.  The
Include directives and other directives in httpd.conf also make this
assumption.