Mercurial > dive4elements > gnv-client
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} +