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

annotate doc/admin-manual/installation-base.tex @ 923:95b48f7d0acf

Added a specialized Makefile doc/trunk@1060 c6561f87-3c4e-4783-a992-168aeb5c3f6f

author	Hans Plum <hans.plum@intevation.de>
date	Thu, 06 May 2010 05:57:12 +0000
parents	237f3a809aee
children	9d94bf77e442

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
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	3 This section describes preconditions for the entire system and an
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	4 installation on a Debian 5.0.x (Lenny) for the GNV-System without an
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	5 running X-Environment.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	6
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	7 For installing and operating the GNV-system access with {\bf root
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	8 rights} is needed. If other permissions are needed, there will be a
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	9 hint in this manual.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	10
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	11 If existing configurations have to be changed, the following notation will be used:
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	12 \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	13
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	14 \subsection{Preconditions}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	15
922 237f3a809aee Removed sections that were not tested Hans Plum <hans.plum@intevation.de> parents: 921 diff changeset	16 \subsubsection*{System}
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	17
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	18 \begin{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	19 \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	20 \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	21 2010)\footnote{Running on a 64-bit system should work out of the box
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	22 and improve scalibility issues.}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	23 \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	24 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	25 \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	26 \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	27 caching
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	28 \end{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	29
922 237f3a809aee Removed sections that were not tested Hans Plum <hans.plum@intevation.de> parents: 921 diff changeset	30 \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	31
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	32 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	33
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	34 \begin{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	35 \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	36 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	37 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	38 \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	39 \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	40 \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	41 \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	42 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	43 \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	44 Shelf Information System --
922 237f3a809aee Removed sections that were not tested Hans Plum <hans.plum@intevation.de> parents: 921 diff changeset	45 \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	46 \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	47 their WMS services
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	48 \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	49 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	50 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	51 \end{itemize}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	52
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 \subsection{Operating System}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	55
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	56 {\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	57 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	58
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	59 \subsection{Java Environment}
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 \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	62
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	63 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	64
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	65 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	66 \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	67
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	68 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	69 [...]
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	70 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	71 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	72
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	73 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	74 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	75 [...]
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	76 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	77
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	78
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	79 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	80
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	81 \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	82
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	83
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	84 \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	85
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	86 This step is optional but recommended.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	87
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	88 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	89 \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	90
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	91 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	92 apt-get install libtcnative-1
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	93 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	94 ln -s /usr/lib/libtcnative-1.so
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	95 \end{lstlisting}
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	96
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	97 \subsubsection*{Configuration}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	98
922 237f3a809aee Removed sections that were not tested Hans Plum <hans.plum@intevation.de> parents: 921 diff changeset	99 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	100 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	101 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	102 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	103
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	104 Use \verb+update-alternatives+ mechanism of the Debian system, execute:
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
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	168 are allowed for AJP on Tomcat.
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	169
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	170 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	171 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	172
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	173 # 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	174
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 <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	177 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	178 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	179 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	180 +-->
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 - <Connector port="8009"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	183 - 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	184
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	185 + <Connector port="8009"
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	186 + 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	187 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	188
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	189 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	190
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	191 \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	192
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	193 \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	194
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	195 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	196 \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	197
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	198 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	199 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	200 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	201 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	202
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	203 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	204 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	205 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	206
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	207 \subsection{Apache Webserver}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	208 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	209 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	210 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	211 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	212
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	213 \subsubsection*{Installation}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	214
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	215 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	216
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	217 \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	218
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	219 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	220 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	221
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	222 \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	223
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	224 \subsubsection*{Configuring mod\_jk}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	225
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	226 Edit the settings for mod\_jk in
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	227 file \verb+ /etc/libapache2-mod-jk/workers.properties+:
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	228
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	229
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	230 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	231 - 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	232 + 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	233 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	234
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	235 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	236
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	237 \begin{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	238 + 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	239 + 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	240 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	241
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	242 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	243 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	244 \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	245
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	246
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	247 \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	248
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	249 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	250 following steps can differ. In this case, a vanilla configuration is
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	251 assumed.
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 Disable default configuration
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	254 \verb+ a2dissite default+
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	255
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	256 Adapt eMail-address for configuration in
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	257 \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	258
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	259 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	260 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	261 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	262 # Activate site for GNV
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	263 a2ensite gnv
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	264 /etc/init.d/apache reload
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	265 \end{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	266
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	267
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	268 \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	269
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	270 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	271
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	272 \verb+ wget http://localhost/gnv/ -O test+
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	273
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	274 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	275 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	276
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	277
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	278 \subsection{UMN MapServer: Installation and configuration}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	279 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	280 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	281 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	282
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	283 \subsubsection*{Installation}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	284 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	285 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	286 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	287
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	288 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	289 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	290
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	291 \begin{lstlisting}
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	292 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	293 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	294 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	295
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	296 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	297
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	298 \begin{lstlisting}
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	299 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	300 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	301 \end{lstlisting}
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	302
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	303 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	304 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	305
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	306 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	307 cd /usr/lib/cgi-bin
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	308 cp -i $ARTIFACT_SERVER_HOME/install/debian/umn-mapserver/gnv-wrapper .
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	309 \end{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	310
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	311 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	312 edit the file \verb+ $ARTIFACT_SERVER_HOME/conf/maptemplates/mapfile.vm+
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	313 in the section WEB > METADATA.
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	314
1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	315 \subsubsection*{Test of installation}
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	316 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	317
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	318 \begin{lstlisting}
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	319 cd root
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	320 wget \
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	321 "http://localhost/cgi-bin/gnv-wrapper?service=WMS&request=GetCapabilities&version=1.1.1" \
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	322 -O mapserver
fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	323 \end{lstlisting}
901 1ebde13e620f Moved all admin-manual specific files in new directory admin-manual Hans Plum <hans.plum@intevation.de> parents: diff changeset	324
921 fb1e051713cc Improved artifact, webclient and operations section Hans Plum <hans.plum@intevation.de> parents: 901 diff changeset	325 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	326 contains a XML document describing the capabilities of the mapserver.

Mercurial > dive4elements > gnv-client

annotate doc/admin-manual/installation-base.tex @ 923:95b48f7d0acf