Mercurial > dive4elements > gnv-client
annotate doc/admin-manual/installation-base.tex @ 1133:cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
doc/trunk@1243 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author | Tim Englich <tim.englich@intevation.de> |
---|---|
date | Tue, 29 Jun 2010 12:08:30 +0000 |
parents | 3b67f53ff57b |
children | 706df18f0c01 |
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 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
57 \subsection{Java Environment} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
58 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
59 \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
|
60 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
61 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
|
62 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
63 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
|
64 \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
|
65 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
66 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
67 [...] |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
68 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
|
69 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
|
70 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
71 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
|
72 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
|
73 [...] |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
74 \end{lstlisting} |
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 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
77 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
|
78 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
79 \verb+ apt-get install sun-java6-jdk+ |
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 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
82 \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
|
83 |
924
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
84 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
|
85 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
|
86 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
87 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
|
88 \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
|
89 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
90 \begin{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
91 apt-get install libtcnative-1 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
92 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
|
93 ln -s /usr/lib/libtcnative-1.so |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
94 \end{lstlisting} |
901
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
95 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
96 \subsubsection*{Configuration} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
97 |
922
237f3a809aee
Removed sections that were not tested
Hans Plum <hans.plum@intevation.de>
parents:
921
diff
changeset
|
98 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
|
99 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
|
100 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
|
101 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
|
102 |
924
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
103 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
|
104 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
|
105 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
106 \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
|
107 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
108 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
|
109 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
110 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
111 Auswahl Alternative |
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 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
|
114 + 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
|
115 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
|
116 * 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
|
117 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
118 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
119 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
120 \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
|
121 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
122 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
|
123 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
|
124 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
|
125 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
126 \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
|
127 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
128 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
|
129 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
130 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
|
131 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
132 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
133 java version "1.6.0_12" |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
134 Java(TM) SE Runtime Environment (build 1.6.0_12-b04) |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
135 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
|
136 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
137 |
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 \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
|
140 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
|
141 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
|
142 Apache Tomcat. |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
143 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
144 \subsubsection*{Installation} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
145 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
146 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
|
147 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
148 \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
|
149 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
150 \subsubsection*{Configuration} |
901
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
151 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
152 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
|
153 \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
|
154 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
155 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
156 - #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
|
157 + 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
|
158 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
159 - #TOMCAT5_SECURITY=yes |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
160 + TOMCAT5_SECURITY=no |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
161 \end{lstlisting} |
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 {\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
|
164 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
|
165 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
166 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
|
167 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
|
168 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
|
169 \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
|
170 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
171 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
|
172 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
173 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
174 # 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
|
175 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
176 +<!-- |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
177 <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
|
178 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
|
179 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
|
180 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
|
181 +--> |
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 - <Connector port="8009" |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
184 - 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
|
185 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
186 + <Connector port="8009" |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
187 + 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
|
188 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
189 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
190 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
|
191 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
192 \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
|
193 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
194 \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
|
195 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
196 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
|
197 \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
|
198 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
199 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
|
200 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
201 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
|
202 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
203 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
204 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
|
205 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
|
206 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
|
207 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
208 \subsection{Apache Webserver} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
209 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
|
210 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
|
211 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
|
212 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
|
213 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
214 \subsubsection*{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 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
|
217 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
218 \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
|
219 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
220 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
|
221 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
|
222 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
223 \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
|
224 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
225 \subsubsection*{Configuring mod\_jk} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
226 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
227 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
|
228 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
|
229 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
|
230 information can be found at \\ |
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
231 \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
|
232 |
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 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
235 - 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
|
236 + 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
|
237 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
238 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
239 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
|
240 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
241 \begin{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
242 + 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
|
243 + 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
|
244 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
245 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
246 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
|
247 WebServer: \verb+ a2enmod jk+ and restart the server |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
248 \verb+ /etc/init.d/apache restart+. |
901
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
249 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
250 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
251 \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
|
252 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
253 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
|
254 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
|
255 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
|
256 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
|
257 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
258 Disable default configuration |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
259 \verb+ a2dissite default+ |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
260 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
261 Adapt eMail-address for configuration in |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
262 \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
|
263 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
264 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
|
265 \begin{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
266 cp -i $ARTIFACT_SERVER_HOME/install/debian/apache2 to /etc/apache2/sites-available |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
267 # Activate site for GNV |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
268 a2ensite gnv |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
269 /etc/init.d/apache reload |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
270 \end{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
271 |
901
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
272 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
273 \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
|
274 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
275 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
|
276 |
924
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
277 \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
|
278 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
279 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
|
280 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
|
281 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
282 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
283 \subsection{UMN MapServer: Installation and configuration} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
284 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
|
285 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
|
286 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
|
287 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
288 \subsubsection*{Installation} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
289 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
|
290 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
|
291 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
|
292 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
293 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
|
294 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
|
295 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
296 \begin{lstlisting} |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
297 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
|
298 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
|
299 \end{lstlisting} |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
300 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
301 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
|
302 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
303 \begin{lstlisting} |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
304 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
|
305 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
|
306 \end{lstlisting} |
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 Provide a possibility to integrate MapServer properly and transfer |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
309 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
|
310 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
311 \begin{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
312 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
|
313 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wms . |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
314 \end{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
315 |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
316 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
|
317 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
|
318 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
|
319 |
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
320 \subsubsection*{Test of installation} |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
321 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
|
322 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
323 \begin{lstlisting} |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
324 cd root |
924
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
325 curl \ |
928
3b67f53ff57b
Adapted name of gnv-wrapper to clearify function
Hans Plum <hans.plum@intevation.de>
parents:
924
diff
changeset
|
326 "http://localhost/cgi-bin/gnv-wms?service=WMS&request=GetCapabilities&version=1.1.1" \ |
924
9d94bf77e442
Finalized documentation with references, unifying tools, adding logos.
Hans Plum <hans.plum@intevation.de>
parents:
922
diff
changeset
|
327 -o mapserver |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
328 \end{lstlisting} |
901
1ebde13e620f
Moved all admin-manual specific files in new directory admin-manual
Hans Plum <hans.plum@intevation.de>
parents:
diff
changeset
|
329 |
921
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
330 For a sucessful configuration, the response document \verb+ mapserver+ |
fb1e051713cc
Improved artifact, webclient and operations section
Hans Plum <hans.plum@intevation.de>
parents:
901
diff
changeset
|
331 contains a XML document describing the capabilities of the mapserver. |
1133
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
332 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
333 \subsection{Proxy-Script: Installation and Configuration} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
334 The Proxy-Script is required to allow requests which are send by the Map-Client |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
335 which is integrated in the GNV-Web-Client. This is required because of security- |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
336 policies according Java-Script which load further Documents during runtime. |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
337 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
338 \subsubsection{Installation} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
339 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
340 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
|
341 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
|
342 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
343 \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
|
344 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
345 Than the script itself must be published on the server by executing the |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
346 following steps: |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
347 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
348 \begin{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
349 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
|
350 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
|
351 \end{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
352 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
353 \subsubsection{Configuration} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
354 The Proxy-Script can only communicate with servers which it is allowed to. |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
355 To enable the communication to the server where the UMN-Mapserver is hosted |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
356 or to other Server it is necessary to edit the Proxy-Script at line 18. |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
357 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
358 There you have tor replace the placeholder THISHOSTNAME with the name which |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
359 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
|
360 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
361 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
|
362 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
363 \subsubsection{Test of installation} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
364 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
365 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
|
366 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
367 \begin{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
368 curl http://localhost/cgi-bin/proxy.cgi?url=http%3A%2F%2Flocalhost |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
369 \end{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
370 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
371 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
|
372 |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
373 \begin{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
374 <html><body><h1>It works!</h1></body></html> |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
375 \end{lstlisting} |
cbfe708b9a17
Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents:
928
diff
changeset
|
376 |