-------------------------------------------------------------------------------
Installation JDK
Für den Betrieb des Generischen Viewers und der Artefakt-Datenbank wird Java
benötigt. Um Sun Java über die Apt-Pakete zu installieren, ist es notwendig die
'non-free' Quellen in die Apt-Quellen einzutragen. Folgender Eintrag ist in die
Quellen einzutragen:
deb http://hetzner:download@download.hetzner.de/debian/mirror lenny main contrib non-free
Anschließend müssen folgende Befehle abgesetzt werden, um die Pakete
sun-java6-jdk zu installieren:
aptitude update
aptitude install sun-java6-jdk
Der Befehl
java -version
sollte anschließend etwas ergeben, was dem folgenden ähnelt.
java version "1.6.0_12"
Java(TM) SE Runtime Environment (build 1.6.0_12-b04)
Java HotSpot(TM) Client VM (build 11.2-b01, mixed mode, sharing)
Die Installation ist erfolgreich abgeschlossen.
-------------------------------------------------------------------------------
Installation/Konfiguration Apache HTTP
Für eine Installation von Apache wir unter anderem das Paket libapache2-mod-jk2
benötigt. Es stellt Connectoren bereit, um den Apache Webserver mit dem Tomcat
Server zu verbinden.
aptitude install libapache2-mod-jk2
Dieser Befehl ist für eine Installation des Apache Webservers ausreichend. Alle
weiteren benötigten Pakete werden automatisch mit installiert.
Nach der Installation der Pakete müssen ein paar kleine Einstellungen
vorgenommen werden, die den Pfad des Tomcat und des JDKs festlegen. Dazu öffne
man die Datei /etc/libapache2-mod-jk/workers.properties mit einem Editor seiner
Wahl, und Ändere die folgenden Zeilen:
gvim /etc/libapache2-mod-jk/workers.properties
- workers.tomcat_home=/usr/share/tomcat5
+ workers.tomcat_home=/usr/share/tomcat5.5
- workers.java_home=/usr/lib/jvm/java-gcj
+ workers.java_home=/usr/lib/jvm/java-6-sun/jre
Des Weiteren sind in der http.conf des Apache2 folgende Einträge hinzuzufügen:
gvim /etc/apache2/http.conf
+ JkWorkersFile "/etc/libapache2-mod-jk/workers.properties"
+ JkLogFile "/var/log/mod_jk.log"
In der Datei /etc/sites-available/default wird anschließend folgender Eintrag
benötigt, um das Forwarding vom Apachen zum Tomcat für den GenerischenViewer
einzurichten:
+ JkMount /gnv ajp13_worker
+ JkMount /gnv/* ajp13_worker
+
+ AuthType Basic
+ AuthName "BSH GenViewer"
+ AuthBasicProvider file
+ AuthUserFile /etc/apache2/passwd/genviewer
+ Require valid-user
+
+ # Insert filter
+ SetOutputFilter DEFLATE
+
+ # Netscape 4.x has some problems...
+ BrowserMatch ^Mozilla/4 gzip-only-text/html
+
+ # Netscape 4.06-4.08 have some more problems
+ BrowserMatch ^Mozilla/4\.0[678] no-gzip
+
+ # MSIE masquerades as Netscape, but it is fine
+ BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
+ # Don't compress images
+ SetEnvIfNoCase Request_URI \
+ \.(?:gif|jpe?g|png)$ no-gzip dont-vary
+
+ # Make sure proxies don't deliver the wrong content
+ Header append Vary User-Agent env=!dont-vary
+
+
+
Diese Konfiguration bedarf noch der Aktivierung eines Apache Moduls, was mit
folgendem Aufruf getan wird:
a2enmod headers
Die Konfiguration des Apache ist beendet. Starten Sie den Webserver mit
folgendem Aufruf:
/etc/init.d/apache2 start
Bei erfolgreicher Installation sollten im Browser bei der Adresse
http://localhost folgender Text ausgegeben werden:
It works!
-------------------------------------------------------------------------------
Installation/Konfiguration Tomcat
Für den Betrieb des Tomcat Servers werden die Pakete tomcat5.5 und
tomcat5.5-webapps benötigt. Installieren Sie diese über die Apt-Quellen mit
folgendem Befehl:
aptitude install tomcat5.5 tomcat5.5-webapps
Anschließend deaktivieren wir den Standard-HTTP-Connector des Tomcat. Dieser
soll nicht direkt angesprochen werden können, sondern nur über den Apache
erreichbar sein. Dazu wird in der Datei /usr/share/tomcat5.5/conf/server.xml
folgender Code auskommentiert:
Damit der AJP-Connector, der zur Verbindung des Apache und des Tomcat dient, nur
auf die Adresse 127.0.0.1, also auf den localhost, lauscht, wird folgende Zeile
in der Datei /etc/tomcat5.5/server.xml ausgetauscht:
-
+
Die Konfiguration des Tomcat ist nun beendet. Dieser lässt sich mit folgendem
Kommando starten:
/etc/init.d/tomcat5.5 start
-------------------------------------------------------------------------------
Download/Installation Geo-Backend
Die Installation des Geo-Backends benötigt neben dem Repository des Geo-Backends
selbst noch eine weitere, aus denen Jar-Files für benötigt werden. Laden Sie sich
also folgende Quellen herunter (${GNV} steht hier für das Verzeichnis, in das
Sie die Quellen laden):
svn co /path/to/conterra-repo ${GNV}/conterra-repo
svn co /path/to/geo-backend/trunk ${GNV}/geo-backend
Zuerst müssen die Bibliotheken installiert werden, von denen das Geo-Backend
abhängig ist. Dazu folgende Befehle, die die Jar-Files in das lokale Maven
Repository kopiert (in der Regel nach ~/.m2). Diese können später von Maven
automatisch dazugeladen werden, wenn Abhängigkeiten zu ihnen bestehen:
cd ${GNV}/conterra-repo
mvn install:install-file -DgroupId=com.esri.sde -DartifactId=jsde_sdk \
-Dversion=9.2.5 -Dpackaging=jar -Dfile=conterra-repo/com/esri/sde/jsde_sdk/9.2.5/jsde_sdk-9.2.5.jar
mvn install:install-file -DgroupId=com.esri.sde -DartifactId=jpe_sdk \
-Dversion=9.2.5 -Dpackaging=jar -Dfile=conterra-repo/com/esri/sde/jpe_sdk/9.2.5/jpe_sdk-9.2.5.jar
mvn install:install-file -DgroupId=com.ibm -DartifactId=icu4j \
-Dversion=3.2 -Dpackaging=jar -Dfile=conterra-repo/com/ibm/icu4j/3.2/icu4j-3.2.jar
Danach wechselt man in das Verzeichnis des Geo-Backends und setzt folgende
Maven Befehle ab, die die Quellen compilieren und ebenfalls in das lokale Maven
Repository installieren:
cd ${GNV}/geo-backend
mvn -Dmaven.test.skip=true clean compile package
mvn install:install-file \
-DgroupId=de.intevation.bsh.geo-backend \
-DartifactId=geo-backend \
-Dversion=1.0-SNAPSHOT \
-Dpackaging=jar \
-Dfile=target/geo-backend-1.0-SNAPSHOT.jar
-------------------------------------------------------------------------------
Download/Installation Artifact-Server
Laden Sie die Quellen des Artefakt-Servers mit folgendem svn Befehl herunter:
svn co /path/to/artifacts/trunk ${GNV}/artifacts
Compilieren Sie die Quellen und installieren sie das Jar-File mit folgendem
Befehl in das lokale Maven Repository:
cd ${GNV}/artifacts
mvn -Dmaven.test.skip=true clean compile install
Zur Installation des Artefakt-Servers werden die Verzeichnisse
/opt/artifacts/bin und /opt/artifacts/conf benötigt, in die die Start-Scripte
und Konfigurationen kopiert werden:
mkdir -p /opt/artifacts/bin (Ort für Startscripte)
mkdir /opt/artifacts/bin/lib (Ort für benötigte Bibliotheken)
mkdir /opt/artifacts/conf (Ort für die Konfiguration der Artefakte)
mkdir /opt/artifacts/artifact-database (Ort der Artefakt-Datenbank)
Kopieren Sie anschließend das Start-Script ${GNV}/artifacts/bin/run.sh nach
/opt/artifacts/bin und geben dem Script Ausführrechte:
cp ${GNV}/artifacts/bin/run.sh /opt/artifacts/bin
chmod 750 /opt/artifacts/bin
-------------------------------------------------------------------------------
Download/Installation GNV-Artefakte
Laden Sie die Quellen der GNV-Artefakte folgendermaßen herunter:
svn co /path/to/gnv-artifacts/trunk ${GNV}/gnv-artifacts
Compilieren Sie die Quellen mit folgendem Befehl (Abhängigkeiten werden
automatisch aus dem lokalen Maven Repo geladen):
cd ${GNV}/gnv-artifacts
mvn -Dmaven.test.skip=true \
clean compile \
dependency:copy-dependencies \
package
Setzen abschließend folgenden Befehl ab, der die benötigten Bibliotheken zu
einem Zip-Archiv packt. Diese werden später im Artefakt-Server benötigt:
find target -name \*.jar -print | zip ${GNV}/libs.zip -j -@
-------------------------------------------------------------------------------
Abschließende Konfiguration der Komponenten
Entpacken Sie nun das erstellte Zip-Archiv nach /opt/artifacts/bin/lib :
unzip ${GNV}/libs.zip -d /opt/artifacts/bin/lib/
Kopieren Sie die Konfiguration der Artefakte nach /opt/artifacts/conf :
cp -R ${GNV}/gnv-artifacts/doc/* /opt/artifacts/conf/
Am Ende der Konfigurationsdatei /opt/artifacts/conf/conf.xml können
Einstellungen der Datenbank vorgenommen werden. Ändern Sie dort den User in
einen beliebigen Nutzer $USER und das Passwort in ein beliebiges Passwort
$PASSWORT. Setzen Sie den Pfad der der Datenbank außerdem auf
/opt/artifacts/artifact-database:
vim /opt/artifacts/conf/conf.xml
- USER
- PASSWORD
-