# HG changeset patch # User Tim Englich # Date 1277813310 0 # Node ID cbfe708b9a1765b4701bb822936c36f3c419b7be # Parent 03c404871d50b2c235c78914e0bee53db7629ce7 Issue309: Documentation of the installation of the prxy-script doc/trunk@1243 c6561f87-3c4e-4783-a992-168aeb5c3f6f diff -r 03c404871d50 -r cbfe708b9a17 doc/ChangeLog --- 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 +2010-06-29 Tim Englich + + * 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 * config-manual/general_settings.tex: Added section with the description how to add a new diff -r 03c404871d50 -r cbfe708b9a17 doc/admin-manual/installation-base.tex --- 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} +

It works!

+\end{lstlisting} +