# HG changeset patch # User Andre Heinecke # Date 1382966153 -3600 # Node ID b6e954fa8b82640e9684fa57bd0db51cf4e5dd1a # Parent 6b8d9c001329d11ea09e39af37e9fa9baa52a87f More installation documentation diff -r 6b8d9c001329 -r b6e954fa8b82 artifacts/doc/installation_de.rst --- a/artifacts/doc/installation_de.rst Mon Oct 28 12:14:46 2013 +0100 +++ b/artifacts/doc/installation_de.rst Mon Oct 28 14:15:53 2013 +0100 @@ -20,10 +20,17 @@ Die Vorbereitung des Systems ist als Root auf dem Zielsystem durchzuführen. +#. Hinzufügen des OBS repositories 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:: zypper install python-devel python-setuptools libxslt-devel libxml2-devel \ - mozilla-nss-devel apache2 tomcat6 mapserver + mozilla-nss-devel apache2 tomcat6 java-1_6_0-ibm libgeos0 netcdf \ + proj xerces-c FastCGI php MyODBC-unixODBC posgresql-libs #. Anlegen der Logger Gruppe:: @@ -31,26 +38,47 @@ #. Anlegen des Flys Nutzers:: - useradd -g flys -G users,flys_log,www -m -c "Flys Service User" flys + useradd -G users,flys_log,www -m flys #. tomcat und apache zur flys_log Gruppe hinzufügen:: - usermod -G flys_log,tomcat tomcat - usermod -G flys_log,wwwrun,www wwwrun + usermod -A flys_log tomcat + usermod -A flys_log wwwrun #. Logging Verzeichnis anlegen:: mkdir /var/log/flys chgrp flys_log /var/log/flys - chmod 770 /var/log/flys + chmod 775 /var/log/flys #. Betriebsordner Anlegen:: mkdir /opt/flys chown flys /opt/flys -Anschließend sollte der weitere Inhalt der beiliegenden CD nach /opt/flys -kopiert werden und dem Benutzer flys zugägnlich gemacht werden. +#. Firewall ausschalten:: + + SuSEfirewall2 off + +Der Key Fingerprint des Intevations Repositories 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. + +Oracle client installieren +-------------------------- + +#. Instantclient entpacken:: + + cd /opt + tar -xf /opt/flys/instantclient_11_2.tar.gz + chown -R flys /opt/instantclient_11_2 + +#. Library loader konfigurieren:: + + cp /opt/flys/oci.conf /etc/ld.so.conf.d/oci.conf + Datenbank initalisieren ----------------------- @@ -60,9 +88,7 @@ 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. -Im folgenden ein Beispiel: - -.. code:: sql +Im folgenden ein Beispiel:: --CREATE TABLESPACE for user CREATE TABLESPACE "flys3" DATAFILE @@ -84,9 +110,11 @@ ``Schema importieren`` +~~~~~~~~~~~~~~~~~~~~~~ Abweichend von der hier beschriebenen Vorgehensweise kann natürlich ein -alternativer client verwendet werden. Wichtig ist das die folgenden +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 ausgeführt werden: @@ -137,12 +165,11 @@ #. Symlink für die aktuelle Version anlegen:: - rm -f flys-current - ln -s flys-3.0.16 flys-current + ln -s flys-3.0.16 current ``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. @@ -158,7 +185,7 @@ ALTER SESSION SET CURRENT_SCHEMA=$SCHEMA; kann man den initalen Schema Präfix der Datenbank ändern. - Wobei $SCHEMA ein Platzhalterfür das zu verwendende Schema ist. + Wobei $SCHEMA ein Platzhalter für das zu verwendende Schema ist. z.B.:: ALTER SESSION SET CURRENT_SCHEMA=SEDDB; @@ -168,7 +195,7 @@ noch die entsprechenden Verweise auf den Kartendienst anpassen:: cd /opt/flys/flys-3.0.16/server/conf - sed -i @flys3-devel.bafg.de@@ rivermap.xml floodmap.xml + 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 @@ -193,12 +220,13 @@ #. Startscript hinterlegen:: cp /opt/flys/d4e-river /etc/init.d + chmod u+x /etc/init.d/d4e-river cd /etc/init.d/rc3.d - ln -s S10d4e-river ../d4e-river - ln -s K10d4e-river ../d4e-river + ln -s ../d4e-river S10d4e-river + ln -s ../d4e-river K10d4e-river cd /etc/init.d/rc5.d - ln -s S10d4e-river ../d4e-river - ln -s K10d4e-river ../d4e-river + ln -s ../d4e-river S10d4e-river + ln -s ../d4e-river K10d4e-river #. Server starten:: @@ -213,20 +241,50 @@ Kartendienste einrichten ------------------------ +In SuSE Linux Enterprise ist kein Paket für den benötigten Mapserver +vorhanden. Dieses muss manuell installiert werden:: + + cd /opt/flys/mapserver-pakete + rpm -i --nodeps *.rpm + +Ob die Installation erfolgreich war kann man durch Abfrage der Mapserver +Version testen:: + + /srv/www/cgi-bin/mapserv -v + Nun können die Kartendienste (river-wms, user-wms) von flys eingerichtet werden (als root):: cp /opt/flys/*-wms /srv/www/cgi-bin/ + chmod a+x /srv/www/cgi-bin/*-wms Apache konfigurieren -------------------- -** TODO ** +Eine Beispielkonfiguration für den Apache Webserver ist die Datei flys.conf +auf der beigelegten CD. Diese kann in das Apache vhosts.d Verzeichnis kopiert +werden. In dieser muss ggf. der Redirect für das Geoportal angepasst werden, +da in diesem die URL enthalten ist. + +Apache Konfiguration kopieren:: + + cp /opt/flys/flys.conf /etc/apache2/vhosts.d + /etc/init.d/apache2 reload ``HTTPS einrichten`` ~~~~~~~~~~~~~~~~~~~~ -** TODO ** +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 +des VirtualHosts auf Port 80 erreichen:: + + RewriteEngine on + RewriteCond %{REQUEST_URI} !^/cgi-bin/ + RewriteRule (.*) https://flys3-devel.bafg.de/$1 [R=301,L] + Web Client Installieren ----------------------- @@ -239,15 +297,16 @@ /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. +die Stabilität des Tomcat Servers zu verbessern. Wiki Installieren ----------------- -** TODO ** +Das Wiki für den Fachdienst Flys ist so konfiguriert das es +unter /home/flys/wiki erwartet wird. -``SAML`` -~~~~~~~~ +Wiki entpacken:: -** TODO ** - + su - flys + cd /home/flys + tar -xf /opt/flys/flys-wiki.tar.gz