dive4elements/gnv-client: doc/admin-manual/installation-base.tex annotate

annotate doc/admin-manual/installation-base.tex @ 949:11d8cc2deb92 1.0

merged doc/1.0

author	Thomas Arendsen Hein <thomas@intevation.de>
date	Fri, 28 Sep 2012 12:13:58 +0200
parents	3b67f53ff57b
children	cbfe708b9a17

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.

Mercurial > dive4elements > gnv-client

annotate doc/admin-manual/installation-base.tex @ 949:11d8cc2deb92 1.0