Mercurial > dive4elements > gnv-client
annotate doc/admin-manual/installation-base.tex @ 1145:dfe1ac687c7f tip
added tags
| author | Thomas Arendsen Hein <thomas@intevation.de> |
|---|---|
| date | Fri, 28 Sep 2012 12:16:15 +0200 |
| 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 |