annotate INSTALL.markdown @ 935:cd809e56dff6

Merged heads
author Dustin Demuth <dustin@intevation.de>
date Tue, 29 Sep 2015 17:29:09 +0200
parents 44e970cec920
children f2001df0e494
rev   line source
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
1 # Installation Lada-Client
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
2
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
3 Für allgemeine Informationen schauen Sie in die README Datei.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
4
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
5 ## Installation
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
6
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
7 Für den Betrieb des Lada-Clients muss dieser innerhalb einer Webserver-Umgebung
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
8 installiert werden. Die folgenden Hinweise geben eine Kurze Anleitung zur
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
9 Installation eines Apache-Webserver.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
10
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
11 Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
12 Klienten auch die Installation eines Servers und entsprechender Datenbank
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
13 notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
14 der README Datei des Server-Pakets.
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
15 Weitere Information finden Sie auf der Projektwebseite:
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
16 http://wald.intevation.org/projects/lada
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
17
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
19 Basis eines Oracle-RedHat Linux Systems.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
20
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
21 Der Lada-Client ist eine Anwendung die auf dem Framework ExtJs 4.2.1 basiert,
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
22 Damit der Client funktioniert müssen Sie dieses Framework herunterladen und
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
23 entpacken. Dies kann direkt in das root-Verzeichnis des Lada-Clients geschehen.
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
24
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
25 Für Applikationen die ebenfalls unter der GPL lizenziert wird - so wie der Lada
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
26 Client - kann ExtJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip)
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
27 werden.
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
28
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
29 Legen Sie nach dem Entpacken einen Symlink auf dieses Verzeichnis an:
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
30
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
31 ```
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
32 ln -s ext-4.2.1.883 extjs
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
33 ```
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
34
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
35 ### Kompilieren und Minifizieren der Anwendung
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
36
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
37 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz.
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
38 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
39 und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
40 erheblich
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
41
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
42 Sencha bietet Sencha Cmd zum [Download](https://www.sencha.com/products/extjs/cmd-download/)
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
43 an. Beachten Sie: Sencha Cmd ist keine freie Software.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
44
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
45 Die Fa. Sencha beschreibt die Installation von Sencha Cmd in der
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
46 [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command)
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
47
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
48 Zur Installation von Sencha Cmd werden Ruby und Java benötigt.
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
49
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
50 Bevor Sie die Anwendung kompilieren können, müssen Sie die im Abschnitt
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
51 *Lizenzen und Bibliotheken* genannten Bibliotheken zum Projekt hinzufügen.
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
52
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
53
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
54 Zum Kompilieren nutzen Sie die folgende Anweisung:
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
55
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
56 ```
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
57 $PATHTOSENCHACMD --sdk-path $PATHTOEXTJS compile \
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
58 --classpath=app,resources/lib/ext/upload,resources/lib/ext/i18n page \
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
59 -yui -i index.html -o build/index.html
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
60 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
61
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
62 Ersetzen Sie heirbei `$PATHTOSENCHACMD` mit dem Pfad zu Ihrer Installation von
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
63 Sencha Cmd. $PATHTOEXTJS gibt den Pfad an, an dem sich Ihre Kopie von ExtJs
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
64 befindet.
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
65
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
66
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
67 Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
68 `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
69 enthält alle benötigten Klassen.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
70 Für die Produktivversion müssen die folgenden Dateien zusätzlich in das
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
71 Verzeichnis `build` kopiert werden:
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
72
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
73 | Quelldatei | Zieldatei |
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
74 |--------------------------------------------------------|-------------------------------------------------------------|
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
75 | extjs/resources/css/ext-all-gray.css | build/extjs/resources/css/ext-all-gray.css |
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
76 | extjs/resources/ext-theme-gray/ext-theme-gray-all.css | build/extjs/resources/ext-theme-gray/ext-theme-gray-all.css |
896
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
77 | resources/i18n/Lada.properties | build/resources/i18n/Lada.properties |
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
78 | resources/i18n/Lada_de-DE.properties | build/resources/i18n/Lada_de-DE.properties |
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
79 | resources/img/* | build/ressources/img* |
237bca579fc7 More Instructions
Dustin Demuth <dustin@intevation.de>
parents: 888
diff changeset
80 | resources/lib/* (alles ausser ext Ordner) | build/resources/lib |
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
81
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
82
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
83 Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
84 Verzeichnis `build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
85 aus:
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
86
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
87 ```
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
88 python build.py
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
89 ```
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
90
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
91 Dies erstellt eine Datei `OpenLayers.js` innerhalb des Verzeichnisses.
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
92 Diese wird in der Webanwendung referenziert.
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
93
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
94 ### Installation Apache
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
95 Zunächst wird der Apache Webserver aus dem Repository installiert:
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
96
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
97 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
98 yum install httpd mod_ssl
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
99 service httpd start
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
100 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
101
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
102 ### Aktivierung der Apache Module
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
103
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
104 Die Konfiguration, welche Module beim Start des Apache geladen werden, erfolgt
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
105 in der Datei `/etc/httpd/conf`. Die zu ladende Module sind in dieser Datei mit
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
106 der Option `LoadModule` angegeben. Folgende Module werden benötigt:
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
107
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
108 * headers_module: Setzten der Header nach der Authentifizierung
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
109 * proxy_module: Reverse Proxy des Apache zum Lada-Server
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
110
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
111 ### Einrichtung der Anwendung
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
112
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
113 Zunächst hinterlegen wir die Anwendung in dem Server. Hierzu verwenden wir die
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
114 gebaute Version, welche sich im `build` Ordner befindet.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
115
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
116 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
117 cd /var/www/html
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
118 mkdir lada
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
119 cp -r build/* lada
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
120 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
121
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
122 *Wichtig um SELinux dazu zu überreden das neue Verzeichnis auch zu servieren:*
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
123
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
124 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
125 restorecon -Rv /var/www/html/
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
126 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
127
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
128 Die Anwendung sollte nun bereits unter der Adresse `http://localhost/lada`
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
129 erreichbar sein.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
130
888
Dustin Demuth <dustin@intevation.de>
parents: 886
diff changeset
131 Damit die Anwendung vollständig funktioniert, müssen ggfs. noch weitere
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
132 Bibliotheken hinzugefügt werden.
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
133 Dies wird im Abschnitt *Lizenzen und Bibliotheken* näher beschrieben
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
134
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
135 ### Konfiguration Proxy Server
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
136
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
137 Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
138 Daten laden zu können, ist es notwendig den Server weiter zu konfigurieren.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
139
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
140 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
141 togglesebool httpd_can_network_connect
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
142 service httpd restart
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
143 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
144
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
145 Dies erlaubt dem Apache grundsätzlich sich mit einem anderen Dienst zu verbinden.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
146 Nun muss noch ein Reverse-Proxy eingerichtet werden. Dieser ist nur für
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
147 bestimmte Adressen aktiv.
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
148
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
149 Folgende Datei sollte unter `/etc/httpd/conf.d/lada.conf` angelegt werden:
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
150 ```
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
151 <VirtualHost *:80>
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
152 ServerAdmin webmaster@localhost
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
153 #ServerName dummy-host.example.com
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
154 ErrorLog logs/lada-error_log
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
155 CustomLog logs/lada-access_log common
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
156
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
157 # Set multiple Proxys
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
158 ProxyPass /lada/server http://LADASERVER/lada
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
159 ProxyPassReverse /lada/server http://LADASERVER/lada
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
160 </VirtualHost>
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
161 ```
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
162 Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
163 weitergeleitet.
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
164
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
165 ### Authentifizierung
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
166
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
167 Die Authentifizierung geschieht derzeit gegen einen OpenID-Server.
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
168 Früher Ansätze nutzten LDAP, in Zukunft soll auch Authentifizierung via SAML2
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
169 möglich sein.
880
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
170
c63ecb95dffb move INSTALL to a markdown File
Dustin Demuth <dustin@intevation.de>
parents:
diff changeset
171 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
172
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
173 # Lizenzen und Bibliotheken
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
174
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
175 Die Anwendung verwendet mehrere Unterkomponenten, diese sind typischerweise im
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
176 Ordner `resources/lib` zu finden.
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
177
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
178 Folgende Bibliotheken werden neben ExtJs verwendet:
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
179
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
180 * Filesaver.js
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
181 https://github.com/eligrey/FileSaver.js
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
182 MIT - License
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
183 * Blob.js
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
184 https://github.com/eligrey/Blob.js
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
185 MIT - License
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
186 * Openlayers 2.13.1
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
187 http://www.openlayers.org
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
188 https://github.com/openlayers/openlayers
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
189 2-Clause BSD-License
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
190
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
191 Diese sind im Ordner `resources/lib` zu finden, und werden in der `Index.html`
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
192 referenziert.
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
193
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
194 Im Ordner resources/lib/ext befinden sich Bibliotheken die ExtJs ergänzen und in
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
195 der Datei `app.js` aufgeführt werden.
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
196
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
197 * Ext.i18n.Bundle 0.3.3 (referenced as Ext.i18n in app.js)
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
198 https://github.com/elmasse/Ext.i18n.Bundle/tree/v0.3.3
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
199 MIT - License
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
200 * Ext.ux.upload 1.1.1
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
201 https://github.com/ivan-novakov/extjs-upload-widget/tree/1.1.1
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
202 3-Clause BSD-License
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
203
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
204
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
205 ## Installation der Bibliotheken
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
206
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
207 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
208 heruntergeladen werden.
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
209
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
210 Dabei ist auf die korrekte Versionsnummer zu achten, falls dies in der Liste
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
211 oben angegeben wurde.
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
212
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
213 ```
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
214 cd /var/www/html/lada/resources/
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
215 mkdir lib/
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
216 cd lib
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
217 wget https://github.com/eligrey/FileSaver.js/archive/master.zip -O FileSaver-js.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
218 wget https://github.com/eligrey/Blob.js/archive/master.zip -O Blob-js.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
219 wget https://github.com/openlayers/openlayers/archive/release-2.13.1.zip -O OpenLayers-2-13-1.zip
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
220
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
221 mkdir ext
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
222 cd ext
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
223 wget https://github.com/elmasse/Ext.i18n.Bundle/archive/v0.3.3.zip -O Ext-i18n-Bundle-v0-3-3.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
224 wget https://github.com/ivan-novakov/extjs-upload-widget/archive/1.1.1.zip -O Ext-ux-Upload-1-1-1.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
225 ```
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
226
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
227 Die Dateien sind im Ordner `resources/lib/` zu entpacken
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
228
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
229 ```
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
230 cd ..
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
231 unzip FileSaver-js.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
232 unzip Blob-js.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
233 unzip OpenLayers-2-13-1.zip
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
234
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
235 cd ext
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
236 unzip Ext-i18n-Bundle-v0-3-3.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
237 unzip Ext-ux-Upload-1-1-1.zip
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
238 ```
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
239
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
240 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen.
897
44e970cec920 Moved README to a markdown file, fixed typos in INSTALL.markdown
Dustin Demuth <dustin@intevation.de>
parents: 896
diff changeset
241 Dies ist praktisch wenn die Bibliothek ausgetauscht wird,
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
242 dann müssen die Quelltexte nicht angepasst werden
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
243
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
244 ```
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
245 cd ..
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
246 ln -s Blob.js-master Blob
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
247 ln -s FileSaver.js-master FileSaver
886
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
248 ln -s openlayers-release-2.13.1/build OpenLayers
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
249
03f3ef7e480b Install.markdown
Dustin Demuth <dustin@intevation.de>
parents: 884
diff changeset
250 cd ext
884
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
251 ln -s Ext.i18n.Bundle-0.3.3/i18n i18n
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
252 ln -s extjs-upload-widget-1.1.1/lib/upload upload
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
253 ```
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
254
98d7a325f894 More Instructions: How to deal with libraries
Dustin Demuth <dustin@intevation.de>
parents: 880
diff changeset
255 Somit ist die Installation der Bibliotheken abgeschlossen.

http://lada.wald.intevation.org