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