dustin@880: # Installation Lada-Client dustin@880: dustin@880: Für allgemeine Informationen schauen Sie in die README Datei. dustin@880: dustin@880: ## Installation dustin@880: dustin@880: Für den Betrieb des Lada-Clients muss dieser innerhalb einer Webserver-Umgebung dustin@880: installiert werden. Die folgenden Hinweise geben eine Kurze Anleitung zur dustin@880: Installation eines Apache-Webserver. dustin@880: dustin@880: Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem dustin@880: Klienten auch die Installation eines Servers und entsprechender Datenbank dustin@880: notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in dustin@880: der README Datei des Server-Pakets. Siehe Projektwebseite. Optional: Die dustin@880: Authentifizierung kann gegen einen LDAP-Server durchgeführt werden. Beispiele dustin@880: finde sich in dem Installationbeispiel. dustin@880: dustin@880: Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf dustin@880: Basis eines Oracle-RedHat Linux Systems. dustin@880: dustin@880: ### Compilieren und Minifizieren der Anwendung dustin@880: dustin@880: Zum Compilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz. dustin@880: Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst dustin@880: und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser erheblich dustin@880: dustin@880: Sencha bietet Sencha Cmd zum [Download](https://www.sencha.com/products/extjs/cmd-download/) dustin@880: an. Beachten Sie: Sencha Cmd ist keine freie Software. dustin@880: dustin@880: Die Fa. Sencha beschreibt die Installation von Sencha Cmd in der dustin@880: [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command) dustin@880: dustin@880: Zur Installation werden Ruby und Java benötigt. dustin@880: dustin@880: dustin@880: dustin@880: dustin@880: dustin@880: Der Befehl hierzu lautet: dustin@880: dustin@880: ``` dustin@880: sencha --sdk $PATHTOEXT compile \ dustin@880: --classpath=app,resources/datetime,resources/i18n page -str -cla lada.js \ dustin@880: -yui -i index.html -o build/index.html dustin@880: ``` dustin@880: dustin@880: Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei dustin@880: `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und dustin@880: enthält alle benötigten Klassen. dustin@880: Für die Produktivversion müssen die folgenden Dateien zusätzlich in das dustin@880: Verzeichnis `build` kopiert werden: dustin@880: dustin@880: | Quelldatei | Zieldatei | dustin@880: |--------------------------------------------------------|-------------------------------------------------------------| dustin@880: | extjs/resources/css/ext-all-gray.css | build/extjs/resources/css/ext-all-gray.css | dustin@880: | extjs/resources/ext-theme-gray/ext-theme-gray-all.css | build/extjs/resources/ext-theme-gray/ext-theme-gray-all.css | dustin@880: | resources/Lada.properties | build/resources/Lada.properties | dustin@880: | resources/Lada_de-DE.properties | build/resources/Lada_de-DE.properties | dustin@880: | gfx/* | build/gfx/ | dustin@880: dustin@880: dustin@880: ### Installation Apache dustin@880: Zunächst wird der Apache Webserver aus dem Repository installiert: dustin@880: dustin@880: ``` dustin@880: yum install httpd mod_ssl dustin@880: service httpd start dustin@880: ``` dustin@880: dustin@880: ### Aktivierung der Apache Module dustin@880: dustin@880: Die Konfiguration, welche Module beim Start des Apache geladen werden, erfolgt dustin@880: in der Datei `/etc/httpd/conf`. Die zu ladende Module sind in dieser Datei mit dustin@880: der Option `LoadModule` angegeben. Folgende Module werden benötigt: dustin@880: dustin@880: * ldap_module: Authentifizierung gegen den LDAP dustin@880: * headers_module: Setzten der Header nach der Authentifizierung dustin@880: * proxy_module: Reverse Proxy des Apache zum Jboss-Server dustin@880: dustin@880: ### Einrichtung der Anwendung dustin@880: dustin@880: Zunächst hinterlegen wir die Anwendung in dem Server. Hierzu verwenden wir die dustin@880: gebaute Version, welche sich im `build` Ordner befindet. dustin@880: dustin@880: ``` dustin@880: cd /var/www/html dustin@880: mkdir lada dustin@880: cp -r build/* lada dustin@880: ``` dustin@880: dustin@880: *Wichtig um SELinux dazu zu überreden das neue Verzeichnis auch zu servieren:* dustin@880: dustin@880: ``` dustin@880: restorecon -Rv /var/www/html/ dustin@880: ``` dustin@880: dustin@880: Die Anwendung sollte nun bereits unter der Adresse `http://localhost/lada` dustin@880: erreichbar sein. dustin@880: dustin@880: ### Konfiguration Proxy Server dustin@880: dustin@880: Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort dustin@880: Daten laden zu können, ist es notwendig den Server weiter zu konfigurieren. dustin@880: dustin@880: ``` dustin@880: togglesebool httpd_can_network_connect dustin@880: service httpd restart dustin@880: ``` dustin@880: dustin@880: Dies erlaubt dem Apache grundsätzlich sich mit einem anderen Dienst zu verbinden. dustin@880: Nun muss noch ein Reverse-Proxy eingerichtet werden. Dieser ist nur für dustin@880: bestimmte Adressen aktiv. dustin@880: dustin@880: Folgende Datei sollte unter `/etc/httpd/conf.d/lada.conf` angelegt werden: dustin@880: ``` dustin@880: dustin@880: ServerAdmin webmaster@localhost dustin@880: #ServerName dummy-host.example.com dustin@880: ErrorLog logs/lada-error_log dustin@880: CustomLog logs/lada-access_log common dustin@880: dustin@880: # Set multiple Proxys dustin@880: ProxyPass /lada/server http://localhost:8080/lada dustin@880: ProxyPassReverse /lada/server http://localhost:8080/lada dustin@880: dustin@880: ``` dustin@880: Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server weitergeleitet. dustin@880: dustin@880: ### Authentifizierung dustin@880: dustin@880: Die Authentifizierung geschieht gegen einen OpenID-Server. dustin@880: dustin@880: Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.