hans@922: \section{Installation and Configuration}
hans@901:
hans@924: This section describes preconditions for the entire system and an installation
hans@924: on a Debian 5.0.x (Lenny) for the GNV-System without an running X-Environment.
hans@924: Mostly, the debian package management\footnote{Further information at
hans@924: \url{http://www.debian.org/doc/manuals/debian-reference/ch02.en.html}}
hans@924: using \verb+ aptitude+ is used in this manual.
hans@901:
hans@924: If existing configurations have to be changed, the following notation will be
hans@924: used: \verb|+| for adding a line replacing the marked by \verb|-|.
hans@901:
hans@901: \subsection{Preconditions}
hans@901:
hans@922: \subsubsection*{System}
hans@901:
hans@901: \begin{itemize}
hans@901: \item Storage for the delivered software: 100 MB
hans@901: \item Current processor on a 32-bit Architecture (Beginning
hans@901: 2010)\footnote{Running on a 64-bit system should work out of the box
hans@924: and improve scalibility issues (not tested yet).}
hans@901: \item RAM: 1 GB for production as minimum.\footnote{This value depends
hans@901: mainly on the amount of connected users.}
hans@901: \item Network access to Database Backend
hans@901: \item RW-Access to the filesystem for logging, shapefile-export,
hans@901: caching
hans@901: \end{itemize}
hans@901:
hans@922: \subsubsection*{Database: Software and Data}
hans@901:
hans@901: The software has been developed for the following system:
hans@901:
hans@901: \begin{itemize}
hans@901: \item ESRI ArcSDE 9.3.1 on Oracle 10.2\footnote{The development
hans@901: started in ESRI ArcSDE 9.2. There are known
hans@901: problems with this version.}
hans@901: \item ArcMarineBSH, model package "Time Series and Measurements"
hans@901: \item ArcMarineBSH, model package " MeshFeature"
hans@901: \item ArcMarineBSH, model package "Marine Feature"
hans@901: \item ArcS57 -- International Hydrographic Organization (IHO) S-57 for
hans@901: ENC Data Model. - ESRI Data Models. http://support.esri.com/datamodels
hans@901: \item CONTIS -- Federal Maritime and Hydrographic Agency (BSH). Continental
hans@924: Shelf Information System -- \\
hans@922: \url{http://www.bsh.de/en/Marine\_uses/Industry/CONTIS\_maps/index.jsp}
hans@901: \item GNV specific schema MapViewer interface -- Schema for integrating with MapViewer and
hans@901: their WMS services
hans@901: \item GNV specific schema for managing the cache -- The central
hans@901: dataware house is updated regulary. To keep the cache up-to-date,
hans@901: needs to cleaned after database updates.
hans@901: \end{itemize}
hans@901:
hans@901:
hans@901: \subsection{Operating System}
hans@901:
hans@901: {\em Hint}: Configuring of partitions, firewalls, etc. for the system is out of
hans@922: the scope of this documentation.
hans@901:
hans@901: \subsection{Java Environment}
hans@901:
hans@901: \subsubsection*{Installation Sun Java 6}
hans@901:
hans@901: This GNV-system is developed for Sun Java 6.
hans@901:
hans@901: Add non-free packages of the Debian distribution to the system in
hans@901: \verb+/etc/apt/sources.list+:
hans@901:
hans@901: \begin{lstlisting}
hans@901: [...]
hans@901: deb http://ftp.de.debian.org/debian/ lenny main non-free
hans@901: deb-src http://ftp.de.debian.org/debian/ lenny main
hans@901:
hans@901: deb http://security.debian.org/ lenny/updates main
hans@901: deb-src http://security.debian.org/ lenny/updates main
hans@901: [...]
hans@901: \end{lstlisting}
hans@901:
hans@901:
hans@901: Install Sun Java 6 and its dependencies by executing the following:
hans@901:
hans@901: \verb+ apt-get install sun-java6-jdk+
hans@901:
hans@901:
hans@901: \subsubsection*{Install Native Components for Java6 (optional)}
hans@901:
hans@924: This step is optional but recommended\footnote{For background
hans@924: information, c.f. \url{http://tomcat.apache.org/tomcat-5.5-doc/apr.html}}.
hans@901:
hans@901: For a better support of the native server technologies, the package
hans@901: \verb+libtcnative+ can be installed.
hans@901:
hans@921: \begin{lstlisting}
hans@921: apt-get install libtcnative-1
hans@921: cd /usr/lib/jvm/java-6-sun/jre/lib/i386/client
hans@921: ln -s /usr/lib/libtcnative-1.so
hans@921: \end{lstlisting}
hans@901:
hans@901: \subsubsection*{Configuration}
hans@901:
hans@922: To ensure that the Apache Tomcat and the GNV Artifact-Server will use
hans@901: Sun Java 6 exclusively, switch to the default Java version
hans@901: globally\footnote{This manual assumes that there are no other packages
hans@901: depending to another Java version.}.
hans@901:
hans@924: Use \verb+update-alternatives+ mechanism of the Debian
hans@924: system\footnote{Background information: {\tt man update-alternatives}}, execute:
hans@901:
hans@901: \verb+ update-alternatives --list java+
hans@901:
hans@901: Lists all installed Java-Environments. E.g.:
hans@901:
hans@901: \begin{lstlisting}
hans@901: Auswahl Alternative
hans@901: -----------------------------------------------
hans@901: 1 /usr/bin/gij-4.3
hans@901: + 2 /usr/lib/jvm/java-gcj/jre/bin/java
hans@901: 3 /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
hans@901: * 4 /usr/lib/jvm/java-6-sun/jre/bin/java
hans@901: \end{lstlisting}
hans@901:
hans@901:
hans@901: \verb+update-alternatives --config java+
hans@901:
hans@901: Opens a dialog to reconfigure the java version which should be used as default.
hans@901: Type the Number of the the java which should be used.
hans@901: For the example above, type "4".
hans@901:
hans@901: \subsubsection*{Test of the Installation}
hans@901:
hans@901: Execute \verb+ java -version+
hans@901:
hans@901: Check if a version of 1.6.0* has been set. Check:
hans@901:
hans@901: \begin{lstlisting}
hans@901: java version "1.6.0_12"
hans@901: Java(TM) SE Runtime Environment (build 1.6.0_12-b04)
hans@901: Java HotSpot(TM) Server VM (build 11.2-b01, mixed mode)
hans@901: \end{lstlisting}
hans@901:
hans@901:
hans@901: \subsection{Tomcat Application Server}
hans@901: To run the GNV-System a Apache Tomcat Server Version 5.5 is required.
hans@901: This section describes the steps for installing and configuring
hans@901: Apache Tomcat.
hans@901:
hans@901: \subsubsection*{Installation}
hans@901:
hans@901: To install the Tomcat Application-Server and its dependencies, execute:
hans@901:
hans@901: \verb+ apt-get install tomcat5.5+
hans@901:
hans@921: \subsubsection*{Configuration}
hans@901:
hans@901: Adapt some run-time specific properties in
hans@901: \verb+/etc/default/tomcat5.5+:
hans@901:
hans@901: \begin{lstlisting}
hans@901: - #JAVA_OPTS="-Djava.awt.headless=true -Xmx128M"
hans@901: + JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -server"
hans@901:
hans@901: - #TOMCAT5_SECURITY=yes
hans@901: + TOMCAT5_SECURITY=no
hans@901: \end{lstlisting}
hans@901:
hans@901: {\bf Hint: As there is no Java security policy for the GNV WebClient,
hans@901: Java Security Management is switched off.}
hans@901:
hans@901: The Apache Tomcat is integrate with Apache WebServer just via the Apache
hans@901: JServ Protocoll (AJP). To secure the connection, just local connections
hans@924: are allowed for AJP on Tomcat\footnote{For background information, c.f.
hans@924: \url{http://tomcat.apache.org/tomcat-5.5-doc/connectors.html}}.
hans@901:
hans@901: Modify the \verb+ /etc/tomcat5.5/server.xml+:
hans@901: \begin{lstlisting}
hans@901:
hans@901: # Deactivate Standard HTTP Connector:
hans@901:
hans@901: +
hans@901:
hans@901: -