annotate doc/admin-manual/installation-base.tex @ 1137:bc1d817b80a4

Include README about how to actually build the documentation. doc/trunk@4875 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Felix Wolfsteller <felix.wolfsteller@intevation.de>
date Thu, 05 Jul 2012 16:32:37 +0000
parents 17c3770e6c63
children
rev   line source
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
1 \section{Installation and Configuration}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
2
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
3 This section describes preconditions for the entire system and an installation
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
4 on a Debian 5.0.x (Lenny) for the GNV-System without an running X-Environment.
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
5 Mostly, the debian package management\footnote{Further information at
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
6 \url{http://www.debian.org/doc/manuals/debian-reference/ch02.en.html}}
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
7 using \verb+ aptitude+ is used in this manual.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
8
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
9 If existing configurations have to be changed, the following notation will be
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
10 used: \verb|+| for adding a line replacing the marked by \verb|-|.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
11
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
12 \subsection{Preconditions}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
13
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
14 \subsubsection*{System}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
15
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
16 \begin{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
17 \item Storage for the delivered software: 100 MB
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
18 \item Current processor on a 32-bit Architecture (Beginning
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
19 2010)\footnote{Running on a 64-bit system should work out of the box
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
20 and improve scalibility issues (not tested yet).}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
21 \item RAM: 1 GB for production as minimum.\footnote{This value depends
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
22 mainly on the amount of connected users.}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
23 \item Network access to Database Backend
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
24 \item RW-Access to the filesystem for logging, shapefile-export,
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
25 caching
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
26 \end{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
27
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
28 \subsubsection*{Database: Software and Data}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
29
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
30 The software has been developed for the following system:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
31
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
32 \begin{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
33 \item ESRI ArcSDE 9.3.1 on Oracle 10.2\footnote{The development
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
34 started in ESRI ArcSDE 9.2. There are known
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
35 problems with this version.}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
36 \item ArcMarineBSH, model package "Time Series and Measurements"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
37 \item ArcMarineBSH, model package " MeshFeature"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
38 \item ArcMarineBSH, model package "Marine Feature"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
39 \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
40 ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
41 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
42 Shelf Information System -- \\
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
43 \url{http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
44 \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
45 their WMS services
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
46 \item GNV specific schema for managing the cache -- The central
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
47 dataware house is updated regulary. To keep the cache up-to-date,
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
48 needs to cleaned after database updates.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
49 \end{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
50
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
51
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
52 \subsection{Operating System}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
53
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
54 {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
55 the scope of this documentation.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
56
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
57 \subsection{Preparations}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
58
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
59 In some steps it is required to use templates wich are packed in
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
60 \verb+ artifact-server-$VERSION.tar.bz2+ to get access to those files.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
61
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
62 Please extract the tar.bz2 file as explained in
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
63 Chapter~\ref{ref:artifact-server-install},
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
64 p.~\pageref{ref:artifact-server-install}.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
65
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
66 The complete document use the system-variable \verb+$ARTIFACT_SERVER_HOME+
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
67 to refer the root-directory of the Artifac-Server.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
68 It might be helpful to export this variable using the following command:
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
69
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
70 \verb+ export ARTIFACT_SERVER_HOME=/opt/artifact-server+
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
71
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
72 \subsection{Java Environment}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
73
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
74 \subsubsection*{Installation Sun Java 6}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
75
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
76 This GNV-system is developed for Sun Java 6.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
77
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
78 Add non-free packages of the Debian distribution to the system in
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
79 \verb+/etc/apt/sources.list+:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
80
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
81 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
82 [...]
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
83 deb http://ftp.de.debian.org/debian/ lenny main non-free
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
84 deb-src http://ftp.de.debian.org/debian/ lenny main
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
85
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
86 deb http://security.debian.org/ lenny/updates main
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
87 deb-src http://security.debian.org/ lenny/updates main
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
88 [...]
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
89 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
90
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
91
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
92 Install Sun Java 6 and its dependencies by executing the following:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
93
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
94 \begin{lstlisting}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
95 apt-get update
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
96 apt-get install sun-java6-jdk
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
97 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
98
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
99 \subsubsection*{Install Native Components for Java6 (optional)}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
100
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
101 This step is optional but recommended\footnote{For background
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
102 information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
103
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
104 For a better support of the native server technologies, the package
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
105 \verb+libtcnative+ can be installed.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
106
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
107 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
108 apt-get install libtcnative-1
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
109 cd /usr/lib/jvm/java-6-sun/jre/lib/i386/client
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
110 ln -s /usr/lib/libtcnative-1.so
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
111 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
112
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
113 \subsubsection*{Configuration}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
114
922
237f3a809aee Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents: 921
diff changeset
115 To ensure that the Apache Tomcat and the GNV Artifact-Server will use
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
116 Sun Java 6 exclusively, switch to the default Java version
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
117 globally\footnote{This manual assumes that there are no other packages
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
118 depending to another Java version.}.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
119
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
120 Use \verb+update-alternatives+ mechanism of the Debian
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
121 system\footnote{Background information: {\tt man update-alternatives}}, execute:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
122
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
123 \verb+ update-alternatives --list java+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
124
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
125 Lists all installed Java-Environments. E.g.:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
126
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
127 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
128 Auswahl Alternative
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
129 -----------------------------------------------
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
130 1 /usr/bin/gij-4.3
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
131 + 2 /usr/lib/jvm/java-gcj/jre/bin/java
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
132 3 /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
133 * 4 /usr/lib/jvm/java-6-sun/jre/bin/java
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
134 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
135
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
136
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
137 \verb+update-alternatives --config java+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
138
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
139 Opens a dialog to reconfigure the java version which should be used as default.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
140 Type the Number of the the java which should be used.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
141 For the example above, type "4".
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
142
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
143 \subsubsection*{Test of the Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
144
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
145 Execute \verb+ java -version+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
146
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
147 Check if a version of 1.6.0* has been set. Check:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
148
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
149 \begin{lstlisting}
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
150 java version "1.6.0_20-b02"
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
151 Java(TM) SE Runtime Environment (build 1.6.0_20-b02)
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
152 Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode)
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
153 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
154
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
155
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
156 \subsection{Tomcat Application Server}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
157 To run the GNV-System a Apache Tomcat Server Version 5.5 is required.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
158 This section describes the steps for installing and configuring
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
159 Apache Tomcat.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
160
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
161 \subsubsection*{Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
162
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
163 To install the Tomcat Application-Server and its dependencies, execute:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
164
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
165 \verb+ apt-get install tomcat5.5+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
166
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
167 \subsubsection*{Configuration}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
168
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
169 Adapt some run-time specific properties in
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
170 \verb+/etc/default/tomcat5.5+:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
171
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
172 \begin{lstlisting}
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
173 - #JAVA_HOME="/usr/lib/jvm/java-6-sun/"
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
174 + JAVA_HOME="/usr/lib/jvm/java-6-sun/"
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
175
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
176 - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
177 + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
178
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
179 - #TOMCAT5_SECURITY=yes
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
180 + TOMCAT5_SECURITY=no
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
181 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
182
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
183 {\bf Hint: As there is no Java security policy for the GNV WebClient,
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
184 Java Security Management is switched off.}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
185
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
186 The Apache Tomcat is integrate with Apache WebServer just via the Apache
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
187 JServ Protocoll (AJP). To secure the connection, just local connections
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
188 are allowed for AJP on Tomcat\footnote{For background information, c.f.
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
189 \url{http://tomcat.apache.org/tomcat-5.5-doc/connectors.html}}.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
190
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
191 Modify the \verb+ /etc/tomcat5.5/server.xml+:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
192 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
193
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
194 # Deactivate Standard HTTP Connector:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
195
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
196 +<!--
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
197 <Connector port="8180" maxHttpHeaderSize="8192" address="127.0.0.1"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
198 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
199 enableLookups="false" redirectPort="8443" acceptCount="100"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
200 connectionTimeout="20000" disableUploadTimeout="true" />
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
201 +-->
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
202
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
203 - <Connector port="8009"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
204 - enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
205
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
206 + <Connector port="8009"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
207 + enableLookups="false" redirectPort="8443" protocol="AJP/1.3" address="127.0.0.1"/>
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
208 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
209
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
210 To activate these changes, restart Apache Tomcat:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
211
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
212 \verb+ /etc/init.d/tomcat5.5 restart+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
213
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
214 \subsubsection*{Test of the Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
215
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
216 Check if the port 8009 is opened via:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
217 \verb+ netstat -nltp | grep 8009+
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
218
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
219 A possible listing looks like this:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
220 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
221 tcp 0 0 127.0.0.1:8009 0.0.0.0:* LISTEN 19252/jsvc
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
222 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
223
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
224 So fare, there is no commandline client for AJP to test the connection.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
225 If there are problems, setup \verb+ mod_jk+ module in Apache WebServer
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
226 and check its according log files.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
227
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
228 \subsection{Apache Webserver}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
229 This section describes the required steps for the installation and configuration
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
230 of the Apache Webserver Version 2.2. Apache WebServer controls all
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
231 HTTP-Connections to the outside of the system. Apache Tomcat is
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
232 integrated via mod\_jk.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
233
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
234 \subsubsection*{Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
235
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
236 To install the Apache Webserver you have to execute the following command:
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
237
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
238 \verb+ apt-get install apache2+
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
239
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
240 To establish the connection between the Tomcat application server and
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
241 Apache Webserver an additional Module "mod\_jk" has to be installed.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
242
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
243 \verb+ apt-get install libapache2-mod-jk+
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
244
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
245 \subsubsection*{Configuring mod\_jk}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
246
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
247 Edit the settings for mod\_jk in
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
248 file \verb+ /etc/libapache2-mod-jk/workers.properties+. For further
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
249 information, there are comments in the configuration file\footnote{Background
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
250 information can be found at \\
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
251 \url{http://tomcat.apache.org/connectors-doc/generic\_howto/workers.html}}.
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
252
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
253
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
254 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
255 - workers.java_home= /usr/lib/jvm/java-gcj/
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
256 + workers.java_home=/usr/lib/jvm/java-6-sun
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
257 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
258
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
259 In file \verb+ /etc/apache2/httpd.conf+:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
260
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
261 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
262 + JkWorkersFile "/etc/libapache2-mod-jk/workers.properties"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
263 + JkLogFile "/var/log/mod_jk.log"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
264 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
265
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
266 After finishing the configuration, enable the module in Apache
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
267 WebServer: \verb+ a2enmod jk+ and restart the server
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
268 \verb+ /etc/init.d/apache2 restart+.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
269
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
270
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
271 \subsubsection*{Publish the site in Apache WebServer}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
272
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
273 Depending of the existing configuration of Apache WebServer, the
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
274 following steps can differ. In this case, a vanilla configuration is
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
275 assumed\footnote{Background information about Apache WebServer can
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
276 be found at \url{http://httpd.apache.org/docs/2.2/}}.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
277
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
278 Disable default configuration
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
279 \verb+ a2dissite default+
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
280
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
281 Adapt eMail-address for configuration in
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
282 \verb+ $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv+.
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
283
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
284 Enable the specific site (VirtualHost) in Apache WebServer:
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
285 \begin{lstlisting}
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
286 cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2/gnv to /etc/apache2/sites-available
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
287 # Activate site for GNV
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
288 a2ensite gnv
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
289 /etc/init.d/apache reload
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
290 \end{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
291
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
292
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
293 \subsubsection*{Test of the Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
294
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
295 You can test the installation by executing the following url:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
296
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
297 \verb+ curl "http://localhost/gnv/" -o test+
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
298
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
299 After a successful installation, the file {test} will contain HTML describing
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
300 the startpage of the GNV WebClient.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
301
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
302
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
303 \subsection{UMN MapServer: Installation and configuration}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
304 The UMN MapServer is part of the artifact server. It is responsible for
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
305 rendering shapefiles produced by the artifact-server and publish them as
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
306 OGC Web Map Service.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
307
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
308 \subsubsection*{Installation}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
309 It is recommended to use a more recent version than the one in Debian
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
310 Lenny. In the installation package, there is a debian package of
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
311 MapServer that should be installed.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
312
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
313 In order to verify the integrity of the installation package, it is necessary to import
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
314 a GPG-Key which was used to sign the packages:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
315
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
316 \begin{lstlisting}
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
317 gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
318 gpg --export EC70B1B8 | apt-key add -
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
319 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
320
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
321 Installing the mapserver-gp and its dependencies, executing the following command:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
322
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
323 \begin{lstlisting}
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
324 cd $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
325 dpkg -i cgi-mapserver-gp_5.6.3-1~gp+1_i386.deb
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
326 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
327
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
328 If there are libraries which are required by the Mapserver but not
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
329 installed yet run the following command:
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
330 \begin{lstlisting}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
331 apt-get -f install
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
332 \end{lstlisting}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
333
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
334
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
335 Provide a possibility to integrate Mapserver properly and transfer
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
336 configurations to MapServer during runtime:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
337
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
338 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
339 cd /usr/lib/cgi-bin
928
3b67f53ff57b Adapted name of gnv-wrapper to clearify function
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
340 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wms .
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
341 chmod +x gnv-wms
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
342 \end{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
343
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
344 For setting proper contact details in the WMS Capabilities response,
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
345 edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+
928
3b67f53ff57b Adapted name of gnv-wrapper to clearify function
Hans Plum <hans.plum@intevation.de>
parents: 924
diff changeset
346 in the section WEB $\rightarrow$ METADATA.
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
347
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
348 The Mapserver will need fonts for rendering lables in the map.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
349 To provide this it is required to install the freefonts.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
350 \begin{lstlisting}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
351 apt-get install ttf-freefont
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
352 \end{lstlisting}
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
353
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
354
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
355 \subsubsection*{Test of installation}
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
356 Check for a sucessful installation via:
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
357
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
358 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
359 cd root
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
360 curl \
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
361 "http://localhost/cgi-bin/gnv-wms" \
924
9d94bf77e442 Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents: 922
diff changeset
362 -o mapserver
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
363 \end{lstlisting}
901
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff changeset
364
921
fb1e051713cc Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents: 901
diff changeset
365 For a sucessful configuration, the response document \verb+ mapserver+
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
366 contains a Value which contains the following message of the mapserver.
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
367
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
368 TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
369
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
370 \subsection{Proxy-Script: Installation and Configuration}
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
371 The Proxy-Script is required to allow the Map-Client to request external
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
372 services. Security policies forbit and prevent requesting those services - like
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
373 a GetFeatureInfo request - directly.
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
374
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
375 \subsubsection{Installation}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
376
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
377 First make sure that python is installed on the operating system.
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
378 Otherwise install python using the following command:
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
379
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
380 \verb+ apt-get install python+
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
381
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
382 Then the script itself must be published on the server by executing the
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
383 following steps:
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
384
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
385 \begin{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
386 cd /usr/lib/cgi-bin
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
387 cp -i $ARTIFACT_SERVER_HOME/install/debian/ol-proxy/proxy.cgi .
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
388 \end{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
389
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
390 \subsubsection{Configuration}
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
391 The Proxy-Script can only communicate with servers it is allowed to.
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
392 To enable the communication to the server where the UMN-Mapserver is hosted
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
393 or to other Server it is necessary to edit {\tt allowedHosts} in the
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
394 Proxy-Script at line 18.
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
395
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
396 There you have to replace the placeholder THISHOSTNAME with the name which
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
397 will be used to reach the GNV-Web-Client.
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
398
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
399 You can add further servers using the syntax which is given in the script.
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
400
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
401 \subsubsection{Test of installation}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
402
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
403 It is possible to test the installation using the following command:
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
404
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
405 \begin{lstlisting}
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
406 curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost/cgi-bin/mapserv-gp
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
407 \end{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
408
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
409 If localhost is allowed in the proxy-script the result might be this:
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
410
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
411 \begin{lstlisting}
1136
17c3770e6c63 Added corrections and wishes of the training on the installation which was given to the BSH.
Tim Englich <tim.englich@intevation.de>
parents: 1135
diff changeset
412 TODO: QUERYSTRING WAS EMPTY HINZUFUEGEN
1133
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
413 \end{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
414

http://dive4elements.wald.intevation.org