# HG changeset patch # User Andre Heinecke # Date 1383144693 -3600 # Node ID 9cf5fd49837a3f5d860fba389c9b68218d89a36e # Parent fff862f4ef7654609e495a1f710b9552dab58d5b Dokumention zur Installation erweitert diff -r fff862f4ef76 -r 9cf5fd49837a artifacts/doc/installation_de.rst --- a/artifacts/doc/installation_de.rst Wed Oct 30 15:26:21 2013 +0100 +++ b/artifacts/doc/installation_de.rst Wed Oct 30 15:51:33 2013 +0100 @@ -1,3 +1,11 @@ +.. header:: + + ###Title### - ###Section### + +.. footer:: + + Seite ###Page### / ###Total### + ================= FLYS Installation ================= @@ -24,26 +32,47 @@ 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 @@ -69,6 +98,7 @@ 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 @@ -77,7 +107,7 @@ Oracle Client installieren -------------------------- -#. Instantclient entpacken:: +#. Instantclient entpacken (als root):: cd /opt tar -xf /opt/flys/instantclient_11_2.tar.gz @@ -100,8 +130,8 @@ --CREATE TABLESPACE for user CREATE TABLESPACE "flys3" DATAFILE - '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 500M AUTOEXTEND ON NEXT - 100M MAXSIZE 1G LOGGING ONLINE PERMANENT BLOCKSIZE 8192 EXTENT + '/u01/app/oracle/oradata/XE/flys3.dbf' SIZE 1G AUTOEXTEND ON NEXT + 100M MAXSIZE 10G LOGGING ONLINE PERMANENT BLOCKSIZE 16384 EXTENT MANAGEMENT LOCAL AUTOALLOCATE DEFAULT NOCOMPRESS SEGMENT SPACE MANAGEMENT AUTO; --CREATE USER @@ -114,11 +144,15 @@ 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 +benötigt. Speziellere Konfiguration ist mit dem zuständigen DB-Admin zu +klären. -``Schema importieren`` -~~~~~~~~~~~~~~~~~~~~~~ +``Tabellen anlegen`` +~~~~~~~~~~~~~~~~~~~~ Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein alternativer Client verwendet werden. Die SQL-Skripte liegen im Unterordner @@ -131,10 +165,16 @@ #. 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 /@:/ +SQLPlus aufrufen (mit passendem Encoding zu den scripten):: + + NLS_LANG=.AL32UTF8 /opt/instantclient_11_2/sqlplus /@:/ + +Dann im sqlplus client:: + @oracle.sql @oracle-minfo.sql @oracle-spatial.sql @@ -147,9 +187,14 @@ liegen entsprechende drop Skripte bereit. Diese sollten bei Bedarf in folgender Reihenfolge ausgeführt werden:: - #. oracle-drop-spatial.sql - #. oracle-drop-minfo.sql - #. oracle-drop.sql + @oracle-drop-spatial.sql + @oracle-drop-minfo.sql + @oracle-drop.sql + +.. raw:: pdf + + PageBreak + D4E-River Server Installieren ----------------------------- @@ -159,6 +204,21 @@ 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`` ~~~~~~~~~~~~~~~~~~~~ @@ -177,26 +237,28 @@ ``Server konfigurieren`` ~~~~~~~~~~~~~~~~~~~~~~~~ -#. Datenbank-Verbindung: - - Die externen Datenbanken von Dive4Element River werden in den Dateien - server/conf/backend-db.xml und server/conf/seddb-db.xml konfiguriert. - - In diesen sind Nutzername, Passwort und URL entsprechend den passenden - Werten anzupassen. - Die URL ist dabei nach folgendem Schema aufgebaut: - jdbc:oracle:thin:@//:/ - - Mithilfe des Eintrags:: +Die externen Datenbanken von Dive4Element River werden in den +folgenden Dateien konfiguriert.:: - ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA; + /opt/flys/flys-3.0.16/server/conf/backend-db.xml + /opt/flys/flys-3.0.16/server/conf/seddb-db.xml - kann man den initalen Schema Präfix der Datenbank ändern. - Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist. - z.B.:: +In diesen sind Nutzername, Passwort und URL entsprechend den passenden +Werten anzupassen. - ALTER SESSION SET CURRENT_SCHEMA=SEDDB; +Die URL ist dabei nach folgendem Schema aufgebaut: + jdbc:oracle:thin:@//:/ + +Mithilfe des Eintrags:: + + ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA; + +kann man den initalen Schema Präfix der Datenbank ändern. +Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist. +z.B.:: + + 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 @@ -210,13 +272,16 @@ im Eintrag 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 zu konfigurieren. z.B.:: - /home/teichmann/gewaesser-final/ + /opt/gewaesser ``Server starten`` ~~~~~~~~~~~~~~~~~~ @@ -240,7 +305,7 @@ /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:: @@ -254,7 +319,7 @@ ------------------------ 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 @@ -281,7 +346,13 @@ 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`` ~~~~~~~~~~~~~~~~~~~~ @@ -297,12 +368,15 @@ 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 @@ -311,8 +385,17 @@ 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 -wenn man zwischen https und http wechselt. Default ist https. +Ggf. ist noch der Eintrag print-url in der Datei +``/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 ----------------- @@ -332,3 +415,43 @@ 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.