annotate INSTALL @ 486:0952c7767d98

Added new static data matching the new data model.
author Raimund Renkert <raimund.renkert@intevation.de>
date Fri, 31 Oct 2014 21:06:19 +0100
parents dfb9c0c34271
children 10959fe61092
rev   line source
476
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
1 Installation Lada-Client
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
2 ========================
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
3 Für allgemeine Informationen schauen Sie in die README Datei.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
4
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
5 Installation
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
6 ------------
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
7 Für den Betrieb des Lada-Clients muss dieser innerhalb einer Webserver-Umgebung
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
8 installiert werden. Die folgenden Hinweise geben eine Kurze Anleitung zur
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
9 Installation eines Apache-Webserver.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
10
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
11 Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
12 Klienten auch die Installation eines Servers und entsprechender Datenbank
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
13 notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
14 der README Datei des Server-Pakets. Siehe Projektwebseite. Optional: Die
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
15 Authentifizierung kann gegen einen LDAP-Server durchgeführt werden. Beispiele
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
16 finde sich in dem Installationbeispiel.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
17
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
19 Basis eines Oracle-RedHat Linux Systems.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
20
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
21 Installation Apache
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
22 ```````````````````
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
23 Zunächst wird der Apache Webserver aus dem Repository installiert:
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
24
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
25 yum install httpd mod_ssl
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
26 service httpd start
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
27
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
28 Aktivierung der Apache Module
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
29 `````````````````````````````
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
30
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
31 Die Konfiguration, welche Module beim Start des Apache geladen werden, erfolgt
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
32 in der Datei "/etc/httpd/conf". Die zu ladende Module sind in dieser Datei mit
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
33 der Option "LoadModule" angegeben. Folgende Module werden benötigt:
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
34
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
35 * ldap_module: Authenitfizierung gegen den LDAP
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
36 * headers_module: Setzten der Header nach der Authenitifizierung
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
37 * proxy_module: Reverse Proxy des Apache zum Jboss-Server
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
38
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
39 Einrichtung der Anwendung
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
40 `````````````````````````
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
41 Zunächst hinterlegen wir die Anwendung in dem Server. Hierzu verwenden wir die
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
42 gebaute Version, welche sich im "build" Ordner befindet (Siehe Build).
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
43
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
44 cd /var/www/html
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
45 mkdir lada
484
dfb9c0c34271 Fixed INSTALL doc.
Raimund Renkert <rrenkert@intevation.de>
parents: 476
diff changeset
46 cp -r build/* lada
476
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
47
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
48 # Wichtig um SELinux dazu zu überreden das neue Verzeichnis auch zu
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
49 # servieren:
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
50 restorecon -Rv /var/www/html/
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
51
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
52 Die Anwendung sollte nun bereits unter der Adresse http://localhost/lada
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
53 erreichbar sein.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
54
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
55 Konfiguration Proxy Server
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
56 ``````````````````````````
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
57 Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
58 Daten laden zu können, ist es notwendig den Server weiter zu konfigurieren.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
59
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
60 togglesebool httpd_can_network_connect
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
61 service httpd restart
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
62
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
63 Dies erlaubt dem Apache grundsätzlich sich mit einem anderen Dienst zu verbinden.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
64 Nun muss noch ein Reverse-Proxy eingerichtet werden. Dieser ist nur für
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
65 bestimmte Adressen aktiv
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
66
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
67 Folgende Datei sollte unter "/etc/httpd/conf.d/lada.conf" angelegt werden:
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
68
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
69 <VirtualHost *:80>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
70 ServerAdmin webmaster@localhost
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
71 #ServerName dummy-host.example.com
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
72 ErrorLog logs/lada-error_log
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
73 CustomLog logs/lada-access_log common
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
74
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
75 # Set multiple Proxys
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
76 ProxyPass /lada/server http://localhost:8080/lada
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
77 ProxyPassReverse /lada/server http://localhost:8080/lada
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
78 </VirtualHost>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
79
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
80 Alle Anfragen an die Adresse "/lada/service", werden nun an den Server weitergeleitet.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
81
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
82 Authentifizierung
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
83 `````````````````
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
84 Die Authentifizierung geschieht gegen einen LDAP-Server.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
85
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
86 <Location /lada>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
87 AuthType basic
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
88 AuthName "test"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
89 AuthBasicProvider ldap
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
90 AuthLDAPURL "ldap://ike.polyhedra.intevation.de:389/cn=users,dc=icosahedron,dc=polyhedra,dc=intevation,dc=de?uid,memberof??(&(objectClass=inetOrgPerson)(memberOf=*))"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
91 Require valid-user
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
92 </Location>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
93
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
94 <Location /lada/server>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
95 RequestHeader unset Authorization
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
96 RequestHeader set X-LDAP-User "%{AUTHENTICATE_uid}e"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
97 RequestHeader set X-LDAP-Groups "%{AUTHENTICATE_memberof}e"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
98 </Location>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
99
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
100 Sofern gewünscht, kann die Authentifizierung für Testzwecke zu deaktivieren
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
101 werden. Trotz allem müssen die entsprechenden Header gesetzt werden, da der
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
102 Server zur Authentifizierung und Authorisierung erwartet.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
103
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
104 # Set Headers to simulate Authentification.
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
105 <Location /lada/server>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
106 RequestHeader set X-LDAP-User "mst_06010"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
107 RequestHeader set X-LDAP-Groups "cn=Imis_world,cn=groups,dc=icosahedron,dc=polyhedra,dc=intevation,dc=de;cn=mst_06010,cn=groups,dc=icosahedron,dc=polyhedra,dc=intevation,dc=de;cn=mst_11010,cn=groups,dc=icosahedron,dc=polyhedra,dc=intevation,dc=de"
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
108 </Location>
584003637a6b Texte zwischen README und INSTALL verschoben
Torsten Irländer <torsten.irlaender@intevation.de>
parents:
diff changeset
109

http://lada.wald.intevation.org