annotate doc/admin-manual/installation-base.tex @ 1135:706df18f0c01

Some refactoring of the proxy installation. doc/trunk@1250 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Ingo Weinzierl <ingo.weinzierl@intevation.de>
date Wed, 30 Jun 2010 09:33:47 +0000
parents cbfe708b9a17
children 17c3770e6c63
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}
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
334 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
335 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
336 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
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
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
345 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
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}
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
354 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
355 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
356 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
357 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
358
1135
706df18f0c01 Some refactoring of the proxy installation.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents: 1133
diff changeset
359 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
360 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
361
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
362 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
363
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
364 \subsubsection{Test of installation}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
365
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
366 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
367
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
368 \begin{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
369 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
370 \end{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
371
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
372 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
373
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
374 \begin{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
375 <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
376 \end{lstlisting}
cbfe708b9a17 Issue309: Documentation of the installation of the prxy-script
Tim Englich <tim.englich@intevation.de>
parents: 928
diff changeset
377

http://dive4elements.wald.intevation.org