dive4elements/river: artifacts/doc/installation

comparison artifacts/doc/installation_de.rst @ 7472:9cf5fd49837a

Dokumention zur Installation erweitert

author	Andre Heinecke <aheinecke@intevation.de>
date	Wed, 30 Oct 2013 15:51:33 +0100
parents	d9488ca6090b
children

comparison

equal deleted inserted replaced

-:fff862f4ef76
+:9cf5fd49837a
+.. header::
+###Title### - ###Section###
+.. footer::
+Seite ###Page### / ###Total###
 =================
 FLYS Installation
 =================
 Übersicht
 Vorbereitung des Systems
 ---------------------------
 Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen.
+Je nach OpenSUSE Version müssen noch weitere Repositories hinzugefügt werden.
+Unter ``10.140.90.89/wiki`` können durch eine Suche nach ``repos`` weitere
+repositories hinzugefügt werden.
+#. Einloggen als root nutzer::
+su
 #. 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
+#. Zusätzlich muss noch das SLES 11 SDK repo hinzgefügt werden::
+zypper ar -t YUM http://voss-update/repo/\$RCE/
+SLE11-SDK-Pool/sle-11-x86_64 SLE11-SDK-POOL
 #. 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 \
-proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs
+proj xerces-c FastCGI php MyODBC-unixODBC postgresql-libs gd
+Sollte es Probleme mit der Abhängikeitsauflösung von xerces-c geben kann
+darauf verzichtet werden xerces-c 2.x zu installieren. Dies sollte
+als Optionsfrage zur Auswahl stehen.
 #. Anlegen der Logger Gruppe::
 gropadd flys_log
-#. Anlegen des Flys Nutzers::
+#. Anlegen des Flys Nutzers (sofern noch nicht vorhanden)::
 useradd -G users,flys_log,www -m flys
+#. Flys Nutzer der Gruppe flys_log hinzufügen (wenn nutzer bereits vorhanden)::
+usermod -A flys_log flys
 #. Tomcat und Apache zur flys_log Gruppe hinzufügen::
 usermod -A flys_log tomcat
 usermod -A flys_log wwwrun
 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 und dem Benutzer flys zugänglich gemacht werden.
+(z.B.: cp -r /media/UDF\ Volume/* /opt/flys)
 .. raw:: pdf
 PageBreak
 Oracle Client installieren
 --------------------------
-#. Instantclient entpacken::
+#. Instantclient entpacken (als root)::
 cd /opt
 tar -xf /opt/flys/instantclient_11_2.tar.gz
 chown -R flys /opt/instantclient_11_2
 sein. Wichtig ist insbesondere, dass der Nutzer Zugriff auf die Spatial-Tabellen besitzt.
 Im folgenden ein Beispiel::
 --CREATE TABLESPACE for user
 CREATE TABLESPACE "flys3" DATAFILE
-'/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT
+'/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 1G AUTOEXTEND ON NEXT
-100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT
+100M MAXSIZE 10G LOGGING ONLINE PERMANENT BLOCKSIZE 16384 EXTENT
 MANAGEMENT LOCAL AUTOALLOCATE DEFAULT NOCOMPRESS SEGMENT SPACE
 MANAGEMENT AUTO;
 --CREATE USER
 CREATE USER flys3 IDENTIFIED BY flys3;
 -- USER SQL
 -- QUOTA for user on TABLESPACE
 ALTER USER flys3 QUOTA UNLIMITED ON "flys3";
 GRANT ALL on "MDSYS"."ALL_SDO_GEOM_METADATA" to flys3 ;
 GRANT CREATE SESSION TO flys3 ;
 GRANT CREATE VIEW TO flys3;
-GRANT CONNECT, RESOURCE TO flys3;
+GRANT CONNECT TO flys3;
+Dieses Beispiel soll nur zur groben Orientieren dienen welche Rechte FLYS
-``Schema importieren``
+benötigt. Speziellere Konfiguration ist mit dem zuständigen DB-Admin zu
-~~~~~~~~~~~~~~~~~~~~~~
+klären.
+``Tabellen anlegen``
+~~~~~~~~~~~~~~~~~~~~
 Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein
 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
 #. oracle.sql
 #. oracle-minfo.sql
 #. oracle-spatial.sql
 #. oracle-spatial_idx.sql
+Wechseln in den db-schema Ordner (als flys nutzer)::
-Mit einem vorhandenen sqlplus unter /opt/instantclient_11_2::
+cd /opt/flys/db-schema
-NLS_LANG=.AL32UTF8 /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<dbname>
+SQLPlus aufrufen (mit passendem Encoding zu den scripten)::
+NLS_LANG=.AL32UTF8 /opt/instantclient_11_2/sqlplus <user>/<pass>@<ip>:<port>/<service>
+Dann im sqlplus client::
 @oracle.sql
 @oracle-minfo.sql
 @oracle-spatial.sql
 @oracle-spatial_idx.sql
 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::
-#. oracle-drop-spatial.sql
+@oracle-drop-spatial.sql
-#. oracle-drop-minfo.sql
+@oracle-drop-minfo.sql
-#. oracle-drop.sql
+@oracle-drop.sql
+.. raw:: pdf
+PageBreak
 D4E-River Server Installieren
 -----------------------------
 Neue Versionen des gesamten FLYS Pakets werden üblicherweise als
 GZIP komprimierter Tarball mit dem Namensschema flys-VERSION.tar.gz
 zur Verfügung gestellt. Als Beispiel wird hier die Version 3.0.16
 angenommen.
+``Passende Java Version installieren``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+D4E-River benötigt ein Sun oder OpenJDK Java. Dieses muss extra
+installiert werden::
+cd /opt/flys
+sh ./jdk-6u26-linux-x64-rpm.bin
+update-alternatives --install /usr/bin/java java /usr/java/jdk1.6.0_26/bin/java 5
+update-alternatives --install /etc/alternatives/jre jre /usr/java/jdk1.6.0_26/jre 5
+update-alternatives --config java
+In dem folgenden Menü sollte als option die Java Version auswählen, welche unter
+/usr/java liegt.
 ``Server entpacken``
 ~~~~~~~~~~~~~~~~~~~~
 #. Als Nutzer flys einloggen::
 ln -s flys-3.0.16 current
 ``Server konfigurieren``
 ~~~~~~~~~~~~~~~~~~~~~~~~
-#. Datenbank-Verbindung:
+Die externen Datenbanken von Dive4Element River werden in den
-Die externen Datenbanken von Dive4Element River werden in den Dateien
+folgenden Dateien konfiguriert.::
-server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert.
+/opt/flys/flys-3.0.16/server/conf/backend-db.xml
-In diesen sind Nutzername, Passwort und URL entsprechend den passenden
+/opt/flys/flys-3.0.16/server/conf/seddb-db.xml
-Werten anzupassen.
+In diesen sind Nutzername, Passwort und URL entsprechend den passenden
-Die URL ist dabei nach folgendem Schema aufgebaut:
+Werten anzupassen.
-jdbc:oracle:thin:@//<hostname>:<port>/<backend>
+Die URL ist dabei nach folgendem Schema aufgebaut:
-Mithilfe des Eintrags::
+jdbc:oracle:thin:@//<hostname>:<port>/<service>
-<connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
+Mithilfe des Eintrags::
-kann man den initalen Schema Präfix der Datenbank ändern.
+<connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA;</connection-init-sqls>
-Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist.
-z.B.::
+kann man den initalen Schema Präfix der Datenbank ändern.
+Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist.
-<connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
+z.B.::
+<connection-init-sqls>ALTER SESSION SET CURRENT_SCHEMA=SEDDB;</connection-init-sqls>
 #. URL für Kartendienste
 Sollte der Host-Name des neuen Servers nicht flys3-devel.bafg.de lauten, muss man
 noch die entsprechenden Verweise auf den Kartendienst anpassen::
 #. URL für das Wiki:
 Die URL unter welcher das Flys-Wiki erwartet wird ist in server/conf/conf.xml
 im Eintrag <help-url> konfiguriert. Dies muss auch ggf. auf den neuen Host-Namen
 angepasst werden. Standard ist: https://flys3-devel.bafg.de/wiki
+#. Gewässerdaten auf das System kopieren:
+Die Gewässerdaten müssen auf das System übertragen werden und
 #. Gewässerdaten:
 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 <dgm-path>
 zu konfigurieren. z.B.::
-<dgm-path>/home/teichmann/gewaesser-final/</dgm-path>
+<dgm-path>/opt/gewaesser<dgm-path>
 ``Server starten``
 ~~~~~~~~~~~~~~~~~~
 #. Zurück auf root wechseln::
 #. Server starten::
 /etc/init.d/d4e-river start
-Nun kann man sich mit einem Blick in /var/log/server-3.0.16.log
+Nun kann man sich mit einem Blick in /var/log/flys/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
 Kartendienste einrichten
 ------------------------
 In SuSE Linux Enterprise ist kein Paket für den benötigten Mapserver
-vorhanden. Dieses muss manuell installiert werden::
+vorhanden. Dieses muss manuell installiert werden (root)::
 cd /opt/flys/mapserver-pakete
 rpm -i --nodeps *.rpm
 Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver
 da in diesem die URL enthalten ist.
 Apache Konfiguration kopieren::
 cp /opt/flys/flys.conf /etc/apache2/vhosts.d
-/etc/init.d/apache2 reload
+In der Konfigurationsdatei ``/etc/apache2/vhosts.d/flys.conf`` muss ggf.
+der redirect auf einen anderen Host geändert werden.
+Apache neu starten::
+/etc/init.d/apache2 restart
 ``HTTPS einrichten``
 ~~~~~~~~~~~~~~~~~~~~
 Um verschlüsselten Zugriff über https einzurichten kann man o.g. Konfiguration
 RewriteEngine on
 RewriteCond %{REQUEST_URI} !^/cgi-bin/
 RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L]
+.. raw:: pdf
+PageBreak
 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.::
+muss der Client nur an die richtige Stelle kopiert werden. (als root)::
 /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
 die Stabilität des Tomcat Servers zu verbessern.
-Ggf. ist noch der eintrag print-url in der web.xml anzupassen insbesondere
+Ggf. ist noch der Eintrag print-url in der Datei
-wenn man zwischen https und http wechselt. Default ist https.
+``/usr/share/tomcat/webapps/flys-3.0.16/WEB-INF/web.xml`` anzupassen
+insbesondere wenn man zwischen https und http wechselt. Default ist https.
+In der Datei ``/var/log/tomcat6/catalina.out`` kann man nachsehen ob
+der Start erfolgreich war. Gab es Probelme mit Java muss man
+ggf. die verwendete Java Version in /etc/tomcat6/tomcat6.conf
+anpassen indem man den Eintrag JAVA_HOME ändert::
+JAVA_HOME="/usr/java/jdk1.6.0_26/jre"
 Wiki installieren
 -----------------
 Das Wiki für den Fachdienst Flys ist so konfiguriert, dass es
 Rechte für wwwrun setzen::
 cd /home/flys/wiki/moin-2013-02-01/wiki/
 chown -R wwwrun data underlay
+.. raw:: pdf
+PageBreak
+FLYS-Importer
+-------------
+Um den Flys Importer nach /opt/flys zu installieren
+reicht es Diesen zu entpacken (als Nutzer flys).::
+cd /opt/flys
+tar -xf /opt/flys-importer_201310251707.tar.gz
+Dieser liegt anschließend unter /opt/flys-importer
+bereit. Die Konfiguration und Verwendung ist der
+Importer Dokumentation zu entnehmen. Diese liegt
+nun unter::
+/opt/flys/flys-importer/importer-manual.pdf
+AFT-DIPS
+--------
+AFT Dips nach /opt/flys installieren::
+cd /opt/flys/
+tar -xf aft-dips-etl.tar.gz
+Ggf. muss nun noch die Konfiguration der Datenbanken angepasst werden.
+Die zugehörige Konfigurationsdatei ist::
+/opt/flys/aft-dips-etl/conf/conf.xml
+Der Prozess kann nun ausgeführt werden::
+/opt/flys/aft-dips-etl/bin/run.sh
+Logs des AFT/DIPS synchronisationsprozesses werden unter
+``/opt/flys/aft-dips-etl/logs`` abgelegt.

Mercurial > dive4elements > river

comparison artifacts/doc/installation_de.rst @ 7472:9cf5fd49837a