annotate INSTALL @ 413:34aa9a296b0f

Kontaktdaten BFS eingefügt
author Torsten Irländer <torsten.irlaender@intevation.de>
date Mon, 20 Jan 2014 15:12:31 +0100
parents dfe537458afb
children c65587869b3f
rev   line source
411
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
1 Installation
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
2 ============
412
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
3 Allgemeine Informationen finden Sie in der README Datei
411
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
4
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
5 Die Installation der Serverkomponente erfordert folgende Vorraussetzungen:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
6
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
7 * PostgreSQL-9.2/PostGIS-2.0 Datenbank inklusive Testdaten
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
8 * JBoss-AS
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
9
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
10
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
11 Datenbank
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
12 ---------
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
13 Die LADA Anwendung basiert auf einer PostgreSQL/PostGIS Datenbank in den
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
14 Versionen PostgreSQL 9.2/PostGIS 2.0.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
15 Beipieldaten sind in dem Datenbankdump lada-db.zip verfügbar und können
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
16 in eine PostgreSQL/PostGIS Datenbank importiert werden.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
17 Der dadurch verfügbare Testdatensatz enthält zusätzlich Daten zu Gemeinden und
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
18 Verwaltungen in Deutschland, die vom BKG zur Verfügung gestellt werden.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
19
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
20 Einrichtung der Datenbankverbindung im JBoss AS
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
21 -----------------------------------------------
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
22 Die Datenbankverbindung wird im Application Server eingerichtet. Hierzu muss der
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
23 entsprechende Treiber zunächst als Modul eingefügt werden. Die folgenden
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
24 Schritte setzen vorraus, dass der JBoss AS in dem Ordner
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
25 /opt/jboss-as-7.1.1-Final installiert ist.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
26
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
27 1. Anlegen des Verzeichnisses und herunterladen der Treiber.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
28
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
29 $cd /opt/jboss-as-7.1.1.Final/modules/org
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
30 $mkdir -p postgresql/main/
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
31 $cd postgresql/main
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
32 $curl -O "http://jdbc.postgresql.org/download/postgresql-9.2-1002.jdbc4.jar"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
33 $curl -O "http://www.hibernatespatial.org/repository/org/postgis/postgis-jdbc/1.5.2/postgis-jdbc-1.5.2.jar"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
34
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
35 2. In dem Ordner /opt/jboss-as-7.1.1.Final/modules/org/postgresql/main/ eine
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
36 Datei module.xml mit folgendem Inhalt anlegen.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
37
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
38 <?xml version="1.0" encoding="UTF-8"?>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
39 <module xmlns="urn:jboss:module:1.0" name="org.postgresql">
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
40 <resources>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
41 <resource-root path="postgresql-9.2-1002.jdbc4.jar"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
42 <resource-root path="postgis-jdbc-1.5.2.jar"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
43 </resources>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
44 <dependencies>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
45 <module name="javax.api"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
46 <module name="javax.transaction.api"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
47 </dependencies>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
48 </module>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
49
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
50 3. Einfügen der Hibernate-Spatial Komponenten.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
51
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
52 $cd /opt/jboss-as-7.1.1.Final/modules/org/hibernate/main
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
53 $curl -O "http://www.hibernatespatial.org/repository/org/hibernate/hibernate-spatial/4.0/hibernate-spatial-4.0.jar"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
54 $curl -O "http://repo1.maven.org/maven2/com/vividsolutions/jts/1.13/jts-1.13.jar"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
55
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
56 4. Eintragen der Hibernate-Spatial Komponenten in
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
57 /opt/jboss-as-7.1.1.Final/modules/org/hibernate/main/module.xml
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
58
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
59 <resources>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
60 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
61 <resource-root path="hibernate-spatial-4.0.jar"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
62 <resource-root path="jts-1.13.jar"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
63 </resources>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
64 <dependencies>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
65 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
66 <module name="org.postgresql"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
67 </dependencies>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
68
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
69 5. Einfügen des PostgreSQL Moduls als Treiber in die JBoss Konfiguration.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
70
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
71 In den Abschnitt <datasources> folgenden Block einfügen:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
72
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
73 <driver name="postgis" module="org.postgresql">
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
74 <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
75 </driver>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
76
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
77
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
78 Nun kann man eine neue Datenbankverbindung mit dem neuen Treiber einrichten.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
79 Dazu verbindet man sich mit dem soeben angelegten Management-Nutzer mit der
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
80 Administrations-Webinterface unter der Adresse: http://localhost:9990
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
81
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
82 1. Datesources auswählen. Hier werden alle derzeit eingerichteten Datenquellen
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
83 angzeigt. Wir wollen eine neue einrichten. Hierzu
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
84 2. Oben rechts von "Runtime" auf "Profile" wechseln.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
85 3. "Add" wählen.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
86 4. Name: Lada, JNDI: java:/jboss/Lada
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
87 5. Treiber Wählen: postgis
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
88 6. Weitere Verbindungsparameter angeben.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
89 a) connection url: jdbc:postgresql_postGIS://localhost:5432/lada
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
90 b) Nutzer
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
91 c) Password
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
92
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
93 7.Da während dieser Einrichtung die Standard PostgreSQL Treiberklasse gewählt
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
94 wird, muss diese noch in der Datei
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
95 /opt/jboss-as-7.1.1.Final/standalone/configuration/standalone.xml
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
96 geändert werden:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
97 Hierzu wird im Abschnitt <datasources> für die neu angelegte Datenquelle
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
98 <driver-class>org.postgresql.Driver</driver-class> gegen
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
99 <driver-class>org.postgis.DriverWrapper</driver-class> ausgetauscht.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
100
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
101 Installation der LADA Anwendung
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
102 ===============================
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
103 Zur Installation der LADA Anwendung müssen folgende Schritte unternommen werden:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
104
412
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
105 mvn clean compile package
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
106 cd /opt/jboss-as-7.1.1.Final/standalone/deployments
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
107 cp /path/where/the/war/file/is/lada.war .
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
108 touch lada.war.dodeploy
dfe537458afb Textpassagen zwischen README und INSTALL ausgetauscht.
Torsten Irländer <torsten.irlaender@intevation.de>
parents: 411
diff changeset
109
411
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
110 $cd /opt/jboss-as-7.1.1.Final/standalone/deployments
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
111 $cp /path/where/the/war/file/is/lada.war .
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
112 $touch lada.war.dodeploy
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
113
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
114 Zum Aktualisieren der Anwendung genügt es, wenn die lada.war Datei aktualisiert
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
115 wird.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
116
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
117 Die Anwendung ist dann unter dem Pfad "/lada" (abhängig vom Archivnamen)
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
118 erreichbar.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
119
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
120 Konfiguration der LADA Anwendung
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
121 ================================
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
122 Die Konfigurationsdateien sind Dateien im JSON-Format und können an einer
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
123 beliebigen Stelle im System abgelegt werden, solang diese Dateien für den
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
124 Nutzer, mit dem JBoss-Server gestartet wird, gelesen werden kann.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
125
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
126 Bei Änderungen an der Konfigurationsdatei muss der Server nicht neu gestartet
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
127 werden. Es reicht ein erneutes Laden der Anwendung durch den Client.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
128 Vorbereitete und vollständige Konfigurationsdateien sind in dem Ordner
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
129 'config' zu finden.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
130
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
131 Importer
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
132 --------
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
133 Der Pfad an dem diese Konfigurationsdatei zu finden ist wird in einer JBoss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
134 Konfigurationsdatei "standalone.xml" abgelegt. Diese Datei findet sich im JBoss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
135 Ordner ($JBOSSHOME/standalone/configuration/standalone.xml).
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
136
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
137 In dieser Datei wird der Pfad in Form einer Property abgelegt:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
138
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
139 <server xmlns="urn:jboss:domain:1.2">
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
140 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
141
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
142 <system-properties>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
143 <property name="de.intevation.lada.importconfig"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
144 value="/pfad/zur/konfigurations/datei/des/importers.json"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
145 </system-properties>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
146
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
147 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
148 </server>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
149
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
150 Flexible Suche
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
151 --------------
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
152 Der Pfad an dem diese Konfigurationsdatei zu finden ist wird in einer JBoss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
153 Konfigurationsdatei "standalone.xml" abgelegt. Diese Datei findet sich im JBoss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
154 Ordner ($JBOSSHOME/standalone/configuration/standalone.xml).
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
155
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
156 In dieser Datei wird der Pfad in Form einer Property abgelegt:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
157
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
158 <server xmlns="urn:jboss:domain:1.2">
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
159 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
160
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
161 <system-properties>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
162 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
163 <property name="de.intevation.lada.sqlconfig"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
164 value="/pfad/zur/konfigurations/datei/der/abfragen.json"/>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
165 </system-properties>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
166
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
167 ...
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
168 </server>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
169
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
170 Einrichtung des Webservers (Apache)
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
171 ===================================
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
172 Die folgenden Module des Apache Webserver sind nötig, um die LADA Anwendung zu
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
173 betreiben:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
174 * ldap_module: Authenitfizierung gegen den LDAP
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
175 * headers_module: Setzten der Header nach der Authenitifizierung
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
176 * proxy_module: Reverse Proxy des Apache zum Jboss-Server
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
177
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
178 Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort Daten
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
179 laden zu können ist es notwendig den Server weiter zu konfigurieren.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
180
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
181 togglesebool httpd_can_network_connect
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
182 service httpd restart
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
183
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
184 Dies erlaubt dem Apache grundsätzlich sich an einen anderen Dienst zu verbinden.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
185
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
186 Nun muss noch ein Reverse-Proxy eingerichtet werden. Dieser ist nur für
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
187 bestimmte Adressen aktiv
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
188
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
189 Folgende Datei sollte unter "/etc/httpd/conf.d/lada.conf" angelegt werden:
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
190
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
191 <VirtualHost *:80>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
192 ServerAdmin webmaster@localhost
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
193 #ServerName dummy-host.example.com
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
194 ErrorLog logs/lada-error_log
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
195 CustomLog logs/lada-access_log common
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
196
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
197 # Set multiple Proxys
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
198 ProxyPass /lada/server http://localhost:8080/lada
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
199 ProxyPassReverse /lada/server http://localhost:8080/lada
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
200 </VirtualHost>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
201
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
202 Alles Anfragen an die Adresse "/lada/service" werden nun an den JBoss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
203 weitergeleitet.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
204
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
205 Authentifizierung
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
206
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
207 Die Authentifizierung geschieht gegen einen LDAP-Server.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
208
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
209 <Location /lada>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
210 AuthType basic
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
211 AuthName "test"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
212 AuthBasicProvider ldap
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
213 AuthLDAPURL "ldap://ike.polyhedra.intevation.de:389/cn=users,dc=icosahedron,dc=polyhedra,dc=intevation,dc=de?uid,memberof??(&(objectClass=inetOrgPerson)(memberOf=*))"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
214 Require valid-user
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
215 </Location>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
216
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
217 <Location /lada/server>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
218 RequestHeader unset Authorization
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
219 RequestHeader set X-LDAP-User "%{AUTHENTICATE_uid}e"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
220 RequestHeader set X-LDAP-Groups "%{AUTHENTICATE_memberof}e"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
221 </Location>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
222
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
223 Sofern gewünscht ist die Authentifizierung für Testzwecke zu deaktivieren muss
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
224 trotz allem die entsprechenden Header gesetzt werden, da der Server diese
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
225 derzeit erwartet.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
226
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
227 # Set Headers to simulate Authentification.
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
228 <Location /lada/server>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
229 RequestHeader set X-LDAP-User "mst_06010"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
230 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"
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
231 </Location>
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
232
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
233 Dokumentation
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
234 =============
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
235 Eine HTML-Dokumenation des Quellcodes(Javadoc) ist in dem Ordner 'doc' hinterlegt und
f7fa401563ee Added INSTALL file.
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
236 kann über einen Webserver (z.B. Apache WebServer) bereitgestellt werden.
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)