changeset 1133:cbfe708b9a17

Issue309: Documentation of the installation of the prxy-script doc/trunk@1243 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Tim Englich <tim.englich@intevation.de>
date Tue, 29 Jun 2010 12:08:30 +0000
parents 03c404871d50
children 411b09d348ca
files doc/ChangeLog doc/admin-manual/installation-base.tex
diffstat 2 files changed, 53 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/doc/ChangeLog	Tue Jun 29 10:28:51 2010 +0000
+++ b/doc/ChangeLog	Tue Jun 29 12:08:30 2010 +0000
@@ -1,4 +1,11 @@
-2010-06-29  Tim Englich  <tim@intevation.de>
+2010-06-29  Tim Englich <tim@intevation.de>
+
+	* admin-manual/installation-base.tex:
+	Added Section which explains how to install the proxy-script
+	which is required for the OpenLayers-Client which is integrated in the
+	GNV-Web-Client.
+
+2010-06-29  Tim Englich <tim@intevation.de>
 
 	* config-manual/general_settings.tex:
 	Added section with the description how to add a new
--- a/doc/admin-manual/installation-base.tex	Tue Jun 29 10:28:51 2010 +0000
+++ b/doc/admin-manual/installation-base.tex	Tue Jun 29 12:08:30 2010 +0000
@@ -329,3 +329,48 @@
 
 For a sucessful configuration, the response document \verb+ mapserver+
 contains a XML document describing the capabilities of the mapserver.
+
+\subsection{Proxy-Script: Installation and Configuration}
+The Proxy-Script is required to allow requests which are send by the Map-Client
+which is integrated in the GNV-Web-Client. This is required because of security-
+policies according Java-Script which load further Documents during runtime.
+
+\subsubsection{Installation}
+
+First make sure that python is installed on the operating system.
+Otherwise install python using the following command:
+
+\verb+ apt-get install python+
+
+Than the script itself must be published on the server by executing the
+following steps:
+
+\begin{lstlisting}
+cd /usr/lib/cgi-bin
+cp -i $ARTIFACT_SERVER_HOME/install/debian/ol-proxy/proxy.cgi .
+\end{lstlisting}
+
+\subsubsection{Configuration}
+The Proxy-Script can only communicate with servers which it is allowed to.
+To enable the communication to the server where the UMN-Mapserver is hosted
+or to other Server it is necessary to edit the Proxy-Script at line 18.
+
+There you have tor replace the placeholder THISHOSTNAME with the name which
+will be used to reach the GNV-Web-Client.
+
+You can add further servers using the syntax which is given in the script.
+
+\subsubsection{Test of installation}
+
+It is possible to test the installation using the following command:
+
+\begin{lstlisting}
+curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost
+\end{lstlisting}
+
+If localhost is allowed in the proxy-script the result might be this:
+
+\begin{lstlisting}
+<html><body><h1>It works!</h1></body></html>
+\end{lstlisting}
+

http://dive4elements.wald.intevation.org