Mercurial > lada > lada-client

comparison INSTALL.markdown @ 897:44e970cec920

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moved README to a markdown file, fixed typos in INSTALL.markdown
author Dustin Demuth <dustin@intevation.de>
date Fri, 24 Jul 2015 11:04:40 +0200
parents 237bca579fc7
children f2001df0e494
comparison
equal deleted inserted replaced
896:237bca579fc7 897:44e970cec920
9 Installation eines Apache-Webserver. 9 Installation eines Apache-Webserver.
10 10
11 Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem 11 Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem
12 Klienten auch die Installation eines Servers und entsprechender Datenbank 12 Klienten auch die Installation eines Servers und entsprechender Datenbank
13 notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in 13 notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in
14 der README Datei des Server-Pakets. Siehe Projektwebseite. Optional: Die 14 der README Datei des Server-Pakets.
15 Authentifizierung kann gegen einen LDAP-Server durchgeführt werden. Beispiele 15 Weitere Information finden Sie auf der Projektwebseite:
16 finde sich in dem Installationbeispiel. 16 http://wald.intevation.org/projects/lada
17 17
18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf 18 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf
19 Basis eines Oracle-RedHat Linux Systems. 19 Basis eines Oracle-RedHat Linux Systems.
20 20
21 Der Lada-Client ist eine Anwendung die auf dem Framework extJs 4.2.1 basiert, 21 Der Lada-Client ist eine Anwendung die auf dem Framework ExtJs 4.2.1 basiert,
22 Damit der Client funktiniert müssen Sie dieses Framework herunterladen und 22 Damit der Client funktioniert müssen Sie dieses Framework herunterladen und
23 entpacken. Dies kann direkt in das root-Verzeichnis des Lada-Clients geschehen. 23 entpacken. Dies kann direkt in das root-Verzeichnis des Lada-Clients geschehen.
24 24
25 Für Applikationen die ebenfalls unter der GPL lizenziert wird - so wie der Lada 25 Für Applikationen die ebenfalls unter der GPL lizenziert wird - so wie der Lada
26 Client - kann extJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip) 26 Client - kann ExtJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip)
27 werden. 27 werden.
28 28
29 Legen Sie nach dem Entpacken einen Symlink auf dieses Verzeichnis an: 29 Legen Sie nach dem Entpacken einen Symlink auf dieses Verzeichnis an:
30 30
31 ``` 31 ```
34 34
35 ### Kompilieren und Minifizieren der Anwendung 35 ### Kompilieren und Minifizieren der Anwendung
36 36
37 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz. 37 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz.
38 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst 38 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst
39 und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser erheblich 39 und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser
40 erheblich
40 41
41 Sencha bietet Sencha Cmd zum [Download](https://www.sencha.com/products/extjs/cmd-download/) 42 Sencha bietet Sencha Cmd zum [Download](https://www.sencha.com/products/extjs/cmd-download/)
42 an. Beachten Sie: Sencha Cmd ist keine freie Software. 43 an. Beachten Sie: Sencha Cmd ist keine freie Software.
43 44
44 Die Fa. Sencha beschreibt die Installation von Sencha Cmd in der 45 Die Fa. Sencha beschreibt die Installation von Sencha Cmd in der
57 --classpath=app,resources/lib/ext/upload,resources/lib/ext/i18n page \ 58 --classpath=app,resources/lib/ext/upload,resources/lib/ext/i18n page \
58 -yui -i index.html -o build/index.html 59 -yui -i index.html -o build/index.html
59 ``` 60 ```
60 61
61 Ersetzen Sie heirbei `$PATHTOSENCHACMD` mit dem Pfad zu Ihrer Installation von 62 Ersetzen Sie heirbei `$PATHTOSENCHACMD` mit dem Pfad zu Ihrer Installation von
62 Sencha Cmd. $PATHTOEXTJS gibt den Pfad an, an dem sich Ihre Kopie von extJs 63 Sencha Cmd. $PATHTOEXTJS gibt den Pfad an, an dem sich Ihre Kopie von ExtJs
63 befindet. 64 befindet.
64 65
65 66
66 Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei 67 Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei
67 `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und 68 `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und
77 | resources/i18n/Lada_de-DE.properties | build/resources/i18n/Lada_de-DE.properties | 78 | resources/i18n/Lada_de-DE.properties | build/resources/i18n/Lada_de-DE.properties |
78 | resources/img/* | build/ressources/img* | 79 | resources/img/* | build/ressources/img* |
79 | resources/lib/* (alles ausser ext Ordner) | build/resources/lib | 80 | resources/lib/* (alles ausser ext Ordner) | build/resources/lib |
80 81
81 82
82 Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das Verzeichnis 83 Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das
83 `build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl aus: 84 Verzeichnis `build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl
85 aus:
84 86
85 ``` 87 ```
86 python build.py 88 python build.py
87 ``` 89 ```
88 90
102 Die Konfiguration, welche Module beim Start des Apache geladen werden, erfolgt 104 Die Konfiguration, welche Module beim Start des Apache geladen werden, erfolgt
103 in der Datei `/etc/httpd/conf`. Die zu ladende Module sind in dieser Datei mit 105 in der Datei `/etc/httpd/conf`. Die zu ladende Module sind in dieser Datei mit
104 der Option `LoadModule` angegeben. Folgende Module werden benötigt: 106 der Option `LoadModule` angegeben. Folgende Module werden benötigt:
105 107
106 * headers_module: Setzten der Header nach der Authentifizierung 108 * headers_module: Setzten der Header nach der Authentifizierung
107 * proxy_module: Reverse Proxy des Apache zum Jboss-Server 109 * proxy_module: Reverse Proxy des Apache zum Lada-Server
108 110
109 ### Einrichtung der Anwendung 111 ### Einrichtung der Anwendung
110 112
111 Zunächst hinterlegen wir die Anwendung in dem Server. Hierzu verwenden wir die 113 Zunächst hinterlegen wir die Anwendung in dem Server. Hierzu verwenden wir die
112 gebaute Version, welche sich im `build` Ordner befindet. 114 gebaute Version, welche sich im `build` Ordner befindet.
151 #ServerName dummy-host.example.com 153 #ServerName dummy-host.example.com
152 ErrorLog logs/lada-error_log 154 ErrorLog logs/lada-error_log
153 CustomLog logs/lada-access_log common 155 CustomLog logs/lada-access_log common
154 156
155 # Set multiple Proxys 157 # Set multiple Proxys
156 ProxyPass /lada/server http://localhost:8080/lada 158 ProxyPass /lada/server http://LADASERVER/lada
157 ProxyPassReverse /lada/server http://localhost:8080/lada 159 ProxyPassReverse /lada/server http://LADASERVER/lada
158 </VirtualHost> 160 </VirtualHost>
159 ``` 161 ```
160 Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server weitergeleitet. 162 Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server
163 weitergeleitet.
161 164
162 ### Authentifizierung 165 ### Authentifizierung
163 166
164 Die Authentifizierung geschieht gegen einen OpenID-Server. 167 Die Authentifizierung geschieht derzeit gegen einen OpenID-Server.
168 Früher Ansätze nutzten LDAP, in Zukunft soll auch Authentifizierung via SAML2
169 möglich sein.
165 170
166 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter. 171 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.
167 172
168 # Lizenzen und Bibliotheken 173 # Lizenzen und Bibliotheken
169 174
200 ## Installation der Bibliotheken 205 ## Installation der Bibliotheken
201 206
202 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei 207 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei
203 heruntergeladen werden. 208 heruntergeladen werden.
204 209
205 Dabei ist auf die korrekte Versionnummer zu achten, falls dies in der Liste 210 Dabei ist auf die korrekte Versionsnummer zu achten, falls dies in der Liste
206 oben angegeben wurde. 211 oben angegeben wurde.
207 212
208 ``` 213 ```
209 cd /var/www/html/lada/resources/ 214 cd /var/www/html/lada/resources/
210 mkdir lib/ 215 mkdir lib/
231 unzip Ext-i18n-Bundle-v0-3-3.zip 236 unzip Ext-i18n-Bundle-v0-3-3.zip
232 unzip Ext-ux-Upload-1-1-1.zip 237 unzip Ext-ux-Upload-1-1-1.zip
233 ``` 238 ```
234 239
235 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen. 240 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen.
236 Dies is praktisch wenn die Bibliothek ausgetauscht wird, 241 Dies ist praktisch wenn die Bibliothek ausgetauscht wird,
237 dann müssen die Quelltexte nicht angepasst werden 242 dann müssen die Quelltexte nicht angepasst werden
238 243
239 ``` 244 ```
240 cd .. 245 cd ..
241 ln -s Blob.js-master Blob 246 ln -s Blob.js-master Blob
http://lada.wald.intevation.org