Mercurial > lada > lada-client

annotate INSTALL @ 497:7c0653e8d9f7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fixed some js related issues (unused vars, arrays, etc.) and code style.
author Raimund Renkert <raimund.renkert@intevation.de>
date Thu, 06 Nov 2014 10:38:17 +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