# HG changeset patch # User Andre Heinecke # Date 1382966522 -3600 # Node ID affad83fd785ba5487b4177dfbd245517326643d # Parent b6e954fa8b82640e9684fa57bd0db51cf4e5dd1a Rechtschreibkorrektur (durchgeführt von Bettina) diff -r b6e954fa8b82 -r affad83fd785 artifacts/doc/installation_de.rst --- a/artifacts/doc/installation_de.rst Mon Oct 28 14:15:53 2013 +0100 +++ b/artifacts/doc/installation_de.rst Mon Oct 28 14:22:02 2013 +0100 @@ -9,9 +9,9 @@ Dieses Dokument beschreibt die Installation des Fachdienstes FLYS. -Abgehandelt werden die Installation der Server Anwendung (D4E-River), -der Webanwendung, die Einrichtung der Datenbanken sowie die Einrichtung -des Moin Wikis. +Abgehandelt werden die Installation der Server-Anwendung (D4E-River), +der Web-Anwendung, die Einrichtung der Datenbanken sowie die Einrichtung +des Moin-Wikis. Als Basis dient ein SUSE Linux Enterprise Server in Version 11.2. @@ -20,13 +20,13 @@ Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen. -#. Hinzufügen des OBS repositories von Intevation:: +#. Hinzufügen des OBS Repositorys von Intevation:: zypper addrepo -f \ http://download.opensuse.org/repositories/home:/intevation:/bfg/ SLE_11_SP1/home:intevation:bfg.repo -#. Installieren der Benötigten Pakete:: +#. Installieren der benötigten Pakete:: zypper install python-devel python-setuptools libxslt-devel libxml2-devel \ mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \ @@ -40,7 +40,7 @@ useradd -G users,flys_log,www -m flys -#. tomcat und apache zur flys_log Gruppe hinzufügen:: +#. Tomcat und Apache zur flys_log Gruppe hinzufügen:: usermod -A flys_log tomcat usermod -A flys_log wwwrun @@ -51,7 +51,7 @@ chgrp flys_log /var/log/flys chmod 775 /var/log/flys -#. Betriebsordner Anlegen:: +#. Betriebsordner anlegen:: mkdir /opt/flys chown flys /opt/flys @@ -60,13 +60,13 @@ SuSEfirewall2 off -Der Key Fingerprint des Intevations Repositories ist: +Der Key-Fingerprint des Intevations Repositorys ist: ``18F8 A017 6DFB 7FD1 22BC 20D6 A73E 24AF BC5A 7BAC`` Nun sollte der weitere Inhalt der beiliegenden CD nach /opt/flys -kopiert werden und dem Benutzer flys zugänglich gemacht werden. +kopiert und dem Benutzer flys zugänglich gemacht werden. -Oracle client installieren +Oracle Client installieren -------------------------- #. Instantclient entpacken:: @@ -80,14 +80,14 @@ cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf -Datenbank initalisieren +Datenbank initialisieren ----------------------- ``Datenbank erstellen`` ~~~~~~~~~~~~~~~~~~~~~~~ -Das erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden -sein. Wichtig ist insbesondere das der Nutzer zugriff auf die Spatial tabellen besitzt. +Das Erstellen der Datenbank sollte vom zuständigen DB-Admin bereits durchgeführt worden +sein. Wichtig ist insbesondere, dass der Nutzer Zugriff auf die Spatial-Tabellen besitzt. Im folgenden ein Beispiel:: --CREATE TABLESPACE for user @@ -113,9 +113,9 @@ ~~~~~~~~~~~~~~~~~~~~~~ Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein -alternativer client verwendet werden. Die SQL skripte liegen im unterordner -DB-Schema. Wichtig ist das die folgenden -SQL scripte in dieser Reihenfolge und in einer UTF-8 Umgebung +alternativer Client verwendet werden. Die SQL-Skripte liegen im Unterordner +DB-Schema. Wichtig ist, dass die folgenden +SQL-Skripte in dieser Reihenfolge und in einer UTF-8 Umgebung ausgeführt werden: #. oracle.sql @@ -124,7 +124,7 @@ #. oracle-spatial_idx.sql -Mit einem vorhandenden sqlplus unter /opt/instantclient_11_2:: +Mit einem vorhandenen sqlplus unter /opt/instantclient_11_2:: NLS_LANG=.AL32UTF8 rlwrap /opt/instantclient_11_2/sqlplus /@:/ @oracle.sql @@ -135,7 +135,7 @@ ``Schema löschen`` ~~~~~~~~~~~~~~~~~~ -Zum löschen der im Schritt Schema importieren importierten Schemata +Zum Löschen der im Schritt Schema importieren importierten Schemata liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in folgender Reihenfolge ausgeführt werden:: @@ -147,8 +147,8 @@ ----------------------------- Neue Versionen des gesamten FLYS Pakets werden üblicherweise als -GZIP komprimierter Tarball mit dem Namenschema flys-VERSION.tar.gz -zur verfügung gestellt. Als Beispiel wird hier die Version 3.0.16 +GZIP komprimierter Tarball mit dem Namensschema flys-VERSION.tar.gz +zur Verfügung gestellt. Als Beispiel wird hier die Version 3.0.16 angenommen. ``Server entpacken`` @@ -169,7 +169,7 @@ ``Server konfigurieren`` ~~~~~~~~~~~~~~~~~~~~~~~~ -#. Datenbank Verbindung: +#. Datenbank-Verbindung: Die externen Datenbanken von Dive4Element River werden in den Dateien server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert. @@ -191,19 +191,19 @@ ALTER SESSION SET CURRENT_SCHEMA=SEDDB; #. URL für Kartendienste - Sollte der Host Name des neuen Servers nicht flys3-devel.bafg.de lauten muss man + Sollte der Host-Name des neuen Servers nicht flys3-devel.bafg.de lauten, muss man noch die entsprechenden Verweise auf den Kartendienst anpassen:: cd /opt/flys/flys-3.0.16/server/conf sed -i s@flys3-devel.bafg.de@@ rivermap.xml floodmap.xml #. URL für das Wiki: - Die URL unter welcher das flys wiki erwartet wird ist in server/conf/conf.xml - im Eintrag konfiguriert. Dies muss auch ggf. auf den neuen Host Namen + Die URL unter welcher das Flys-Wiki erwartet wird ist in server/conf/conf.xml + im Eintrag konfiguriert. Dies muss auch ggf. auf den neuen Host-Namen angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki #. Gewässerdaten: - Zur Berechnung von Überschwemmungsflächen werden Digitale Geländemodelle benötigt. + Zur Berechnung von Überschwemmungsflächen werden digitale Geländemodelle benötigt. Der Ort an dem diese Daten liegen ist in der Datei server/conf/conf.xml als zu konfigurieren. z.B.:: @@ -217,7 +217,7 @@ exit -#. Startscript hinterlegen:: +#. Startskript hinterlegen:: cp /opt/flys/d4e-river /etc/init.d chmod u+x /etc/init.d/d4e-river @@ -232,9 +232,9 @@ /etc/init.d/d4e-river start -Nun kann sich mit einem Blick in /var/log/server-3.0.16.log -vergewissern das der Server korrekt gestartet wurde. In diesem -Fall wäre die Letze Zeile des logs in der Art:: +Nun kann man sich mit einem Blick in /var/log/server-3.0.16.log +vergewissern, dass der Server korrekt gestartet wurde. In diesem +Fall wäre die letze Zeile des Logs in der Art:: INFO Standalone - Starting org.dive4elements.artifactdatabase.rest.Standalone HTTP server on localhost:18989 @@ -252,7 +252,7 @@ /srv/www/cgi-bin/mapserv -v -Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet +Nun können die Kartendienste (river-wms, user-wms) von Flys eingerichtet werden (als root):: cp /opt/flys/*-wms /srv/www/cgi-bin/ @@ -276,9 +276,9 @@ Um verschlüsselten Zugriff über https einzurichten kann man o.g. Konfiguration entsprechend anpassen. Wie dies zu geschehen hat ist der Apache Dokumentation -zu entnehmen und soll nicht teil dieser Anleitung sein. Allerdings ist bemerkenswert -das darauf geachtet werden sollte es weiterhin zu ermöglichen Kartendienste über -http abzurufen. Dies kann man durch einen Bedingten redirect in der Konfiguration +zu entnehmen und soll nicht Teil dieser Anleitung sein. Allerdings ist zu bemerken, +dass darauf geachtet werden sollte, es weiterhin zu ermöglichen Kartendienste über +http abzurufen. Dies kann man durch einen bedingten Redirect in der Konfiguration des VirtualHosts auf Port 80 erreichen:: RewriteEngine on @@ -289,20 +289,20 @@ Web Client Installieren ----------------------- -Der Web client läuft als Tomcat Webapp. Damit tomcat diesen startet -muss der client nur an die Richtige stelle kopiert werden.:: +Der Web Client läuft als Tomcat Webapp. Damit Tomcat diesen startet +muss der Client nur an die richtige Stelle kopiert werden.:: /etc/init.d/tomcat6 stop cp /opt/flys/flys-3.0.16/client/flys-3.0.16.war /usr/share/tomcat6/webapps /etc/init.d/tomcat6 start -Das neustarten des Tomcat Servers ist hierbei optional. Kann aber dazu dienen +Das Neustarten des Tomcat Servers ist hierbei optional, kann aber dazu dienen die Stabilität des Tomcat Servers zu verbessern. -Wiki Installieren +Wiki installieren ----------------- -Das Wiki für den Fachdienst Flys ist so konfiguriert das es +Das Wiki für den Fachdienst Flys ist so konfiguriert, dass es unter /home/flys/wiki erwartet wird. Wiki entpacken::