Mercurial > dive4elements > framework

comparison HOWTO @ 56:f027204baf5d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added HOWTO to setup the environment artifacts/trunk@325 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Ingo Weinzierl <ingo.weinzierl@intevation.de>
date Wed, 11 Nov 2009 16:25:26 +0000
parents
children
comparison
equal deleted inserted replaced
55:9a29899b31e5 56:f027204baf5d
1 -------------------------------------------------------------------------------
2 Installation JDK
3
4 Für den Betrieb des Generischen Viewers und der Artefakt-Datenbank wird Java
5 benötigt. Um Sun Java über die Apt-Pakete zu installieren, ist es notwendig die
6 'non-free' Quellen in die Apt-Quellen einzutragen. Folgender Eintrag ist in die
7 Quellen einzutragen:
8 deb http://hetzner:download@download.hetzner.de/debian/mirror lenny main contrib non-free
9
10 Anschließend müssen folgende Befehle abgesetzt werden, um die Pakete
11 sun-java6-jdk zu installieren:
12 aptitude update
13 aptitude install sun-java6-jdk
14
15 Der Befehl
16 java -version
17 sollte anschließend etwas ergeben, was dem folgenden ähnelt.
18
19 java version "1.6.0_12"
20 Java(TM) SE Runtime Environment (build 1.6.0_12-b04)
21 Java HotSpot(TM) Client VM (build 11.2-b01, mixed mode, sharing)
22
23 Die Installation ist erfolgreich abgeschlossen.
24
25
26 -------------------------------------------------------------------------------
27 Installation/Konfiguration Apache HTTP
28
29 Für eine Installation von Apache wir unter anderem das Paket libapache2-mod-jk2
30 benötigt. Es stellt Connectoren bereit, um den Apache Webserver mit dem Tomcat
31 Server zu verbinden.
32 aptitude install libapache2-mod-jk2
33 Dieser Befehl ist für eine Installation des Apache Webservers ausreichend. Alle
34 weiteren benötigten Pakete werden automatisch mit installiert.
35
36 Nach der Installation der Pakete müssen ein paar kleine Einstellungen
37 vorgenommen werden, die den Pfad des Tomcat und des JDKs festlegen. Dazu öffne
38 man die Datei /etc/libapache2-mod-jk/workers.properties mit einem Editor seiner
39 Wahl, und Ändere die folgenden Zeilen:
40
41 gvim /etc/libapache2-mod-jk/workers.properties
42
43 - workers.tomcat_home=/usr/share/tomcat5
44 + workers.tomcat_home=/usr/share/tomcat5.5
45
46 - workers.java_home=/usr/lib/jvm/java-gcj
47 + workers.java_home=/usr/lib/jvm/java-6-sun/jre
48
49 Des Weiteren sind in der http.conf des Apache2 folgende Einträge hinzuzufügen:
50
51 gvim /etc/apache2/http.conf
52
53 + JkWorkersFile "/etc/libapache2-mod-jk/workers.properties"
54 + JkLogFile "/var/log/mod_jk.log"
55
56 In der Datei /etc/sites-available/default wird anschließend folgender Eintrag
57 benötigt, um das Forwarding vom Apachen zum Tomcat für den GenerischenViewer
58 einzurichten:
59
60 + JkMount /gnv ajp13_worker
61 + JkMount /gnv/* ajp13_worker
62
63 + <Location /gnv>
64 + AuthType Basic
65 + AuthName "BSH GenViewer"
66 + AuthBasicProvider file
67 + AuthUserFile /etc/apache2/passwd/genviewer
68 + Require valid-user
69 +
70 + # Insert filter
71 + SetOutputFilter DEFLATE
72 +
73 + # Netscape 4.x has some problems...
74 + BrowserMatch ^Mozilla/4 gzip-only-text/html
75 +
76 + # Netscape 4.06-4.08 have some more problems
77 + BrowserMatch ^Mozilla/4\.0[678] no-gzip
78 +
79 + # MSIE masquerades as Netscape, but it is fine
80 + BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
81 + # Don't compress images
82 + SetEnvIfNoCase Request_URI \
83 + \.(?:gif|jpe?g|png)$ no-gzip dont-vary
84 +
85 + # Make sure proxies don't deliver the wrong content
86 + Header append Vary User-Agent env=!dont-vary
87 + </Location>
88 +
89 + <Location /servlets-examples/>
90
91 Diese Konfiguration bedarf noch der Aktivierung eines Apache Moduls, was mit
92 folgendem Aufruf getan wird:
93
94 a2enmod headers
95
96 Die Konfiguration des Apache ist beendet. Starten Sie den Webserver mit
97 folgendem Aufruf:
98
99 /etc/init.d/apache2 start
100
101 Bei erfolgreicher Installation sollten im Browser bei der Adresse
102 http://localhost folgender Text ausgegeben werden:
103
104 It works!
105
106 -------------------------------------------------------------------------------
107 Installation/Konfiguration Tomcat
108
109 Für den Betrieb des Tomcat Servers werden die Pakete tomcat5.5 und
110 tomcat5.5-webapps benötigt. Installieren Sie diese über die Apt-Quellen mit
111 folgendem Befehl:
112
113 aptitude install tomcat5.5 tomcat5.5-webapps
114
115 Anschließend deaktivieren wir den Standard-HTTP-Connector des Tomcat. Dieser
116 soll nicht direkt angesprochen werden können, sondern nur über den Apache
117 erreichbar sein. Dazu wird in der Datei /usr/share/tomcat5.5/conf/server.xml
118 folgender Code auskommentiert:
119
120 <!--
121 <Connector port="8180" maxHttpHeaderSize="8192" address="127.0.0.1"
122 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
123 enableLookups="false" redirectPort="8443" acceptCount="100"
124 connectionTimeout="20000" disableUploadTimeout="true" />
125 -->
126
127 Damit der AJP-Connector, der zur Verbindung des Apache und des Tomcat dient, nur
128 auf die Adresse 127.0.0.1, also auf den localhost, lauscht, wird folgende Zeile
129 in der Datei /etc/tomcat5.5/server.xml ausgetauscht:
130
131 - <Connector port="8009"
132 - enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />
133
134 + <Connector port="8009" address="127.0.0.1"
135 + enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />
136
137 Die Konfiguration des Tomcat ist nun beendet. Dieser lässt sich mit folgendem
138 Kommando starten:
139
140 /etc/init.d/tomcat5.5 start
141
142 -------------------------------------------------------------------------------
143 Download/Installation Geo-Backend
144
145 Die Installation des Geo-Backends benötigt neben dem Repository des Geo-Backends
146 selbst noch eine weitere, aus denen Jar-Files für benötigt werden. Laden Sie sich
147 also folgende Quellen herunter (${GNV} steht hier für das Verzeichnis, in das
148 Sie die Quellen laden):
149
150 svn co /path/to/conterra-repo ${GNV}/conterra-repo
151 svn co /path/to/geo-backend/trunk ${GNV}/geo-backend
152
153 Zuerst müssen die Bibliotheken installiert werden, von denen das Geo-Backend
154 abhängig ist. Dazu folgende Befehle, die die Jar-Files in das lokale Maven
155 Repository kopiert (in der Regel nach ~/.m2). Diese können später von Maven
156 automatisch dazugeladen werden, wenn Abhängigkeiten zu ihnen bestehen:
157
158 cd ${GNV}/conterra-repo
159 mvn install:install-file -DgroupId=com.esri.sde -DartifactId=jsde_sdk \
160 -Dversion=9.2.5 -Dpackaging=jar -Dfile=conterra-repo/com/esri/sde/jsde_sdk/9.2.5/jsde_sdk-9.2.5.jar
161
162 mvn install:install-file -DgroupId=com.esri.sde -DartifactId=jpe_sdk \
163 -Dversion=9.2.5 -Dpackaging=jar -Dfile=conterra-repo/com/esri/sde/jpe_sdk/9.2.5/jpe_sdk-9.2.5.jar
164
165 mvn install:install-file -DgroupId=com.ibm -DartifactId=icu4j \
166 -Dversion=3.2 -Dpackaging=jar -Dfile=conterra-repo/com/ibm/icu4j/3.2/icu4j-3.2.jar
167
168 Danach wechselt man in das Verzeichnis des Geo-Backends und setzt folgende
169 Maven Befehle ab, die die Quellen compilieren und ebenfalls in das lokale Maven
170 Repository installieren:
171
172 cd ${GNV}/geo-backend
173 mvn -Dmaven.test.skip=true clean compile package
174 mvn install:install-file \
175 -DgroupId=de.intevation.bsh.geo-backend \
176 -DartifactId=geo-backend \
177 -Dversion=1.0-SNAPSHOT \
178 -Dpackaging=jar \
179 -Dfile=target/geo-backend-1.0-SNAPSHOT.jar
180
181 -------------------------------------------------------------------------------
182 Download/Installation Artifact-Server
183
184 Laden Sie die Quellen des Artefakt-Servers mit folgendem svn Befehl herunter:
185
186 svn co /path/to/artifacts/trunk ${GNV}/artifacts
187
188 Compilieren Sie die Quellen und installieren sie das Jar-File mit folgendem
189 Befehl in das lokale Maven Repository:
190
191 cd ${GNV}/artifacts
192 mvn -Dmaven.test.skip=true clean compile install
193
194 Zur Installation des Artefakt-Servers werden die Verzeichnisse
195 /opt/artifacts/bin und /opt/artifacts/conf benötigt, in die die Start-Scripte
196 und Konfigurationen kopiert werden:
197
198 mkdir -p /opt/artifacts/bin (Ort für Startscripte)
199 mkdir /opt/artifacts/bin/lib (Ort für benötigte Bibliotheken)
200 mkdir /opt/artifacts/conf (Ort für die Konfiguration der Artefakte)
201 mkdir /opt/artifacts/artifact-database (Ort der Artefakt-Datenbank)
202
203 Kopieren Sie anschließend das Start-Script ${GNV}/artifacts/bin/run.sh nach
204 /opt/artifacts/bin und geben dem Script Ausführrechte:
205
206 cp ${GNV}/artifacts/bin/run.sh /opt/artifacts/bin
207 chmod 750 /opt/artifacts/bin
208
209 -------------------------------------------------------------------------------
210 Download/Installation GNV-Artefakte
211
212 Laden Sie die Quellen der GNV-Artefakte folgendermaßen herunter:
213
214 svn co /path/to/gnv-artifacts/trunk ${GNV}/gnv-artifacts
215
216 Compilieren Sie die Quellen mit folgendem Befehl (Abhängigkeiten werden
217 automatisch aus dem lokalen Maven Repo geladen):
218
219 cd ${GNV}/gnv-artifacts
220 mvn -Dmaven.test.skip=true \
221 clean compile \
222 dependency:copy-dependencies \
223 package
224
225 Setzen abschließend folgenden Befehl ab, der die benötigten Bibliotheken zu
226 einem Zip-Archiv packt. Diese werden später im Artefakt-Server benötigt:
227
228 find target -name \*.jar -print | zip ${GNV}/libs.zip -j -@
229
230 -------------------------------------------------------------------------------
231 Abschließende Konfiguration der Komponenten
232
233 Entpacken Sie nun das erstellte Zip-Archiv nach /opt/artifacts/bin/lib :
234
235 unzip ${GNV}/libs.zip -d /opt/artifacts/bin/lib/
236
237 Kopieren Sie die Konfiguration der Artefakte nach /opt/artifacts/conf :
238
239 cp -R ${GNV}/gnv-artifacts/doc/* /opt/artifacts/conf/
240
241 Am Ende der Konfigurationsdatei /opt/artifacts/conf/conf.xml können
242 Einstellungen der Datenbank vorgenommen werden. Ändern Sie dort den User in
243 einen beliebigen Nutzer $USER und das Passwort in ein beliebiges Passwort
244 $PASSWORT. Setzen Sie den Pfad der der Datenbank außerdem auf
245 /opt/artifacts/artifact-database:
246
247 vim /opt/artifacts/conf/conf.xml
248 - <user>USER</user>
249 - <password>PASSWORD</password>
250 - <!-- url>jdbc:h2:/opt/artifacts/artifacts/artifacts.db</url>
251
252 + <user>$USER</user>
253 + <password>$PASSWORD</password>
254 + <!-- url>jdbc:h2:/opt/artifacts/artifact-database/artifacts.db</url>
255
256
257 Diese Einstellungen werden nun beim Anlegen der Datenbank benötigt. Dazu setzen
258 Sie folgende Befehle ab und setzen an Stelle von $USER und $PASSWORD den von
259 ihnen konfigurierte Nutzer und entsprechendes Passwort sowie den Pfad zur
260 Datenbank ein:
261
262 cd /opt/artifacts
263 java -cp bin/lib/h2-1.1.117.jar org.h2.tools.RunScript \
264 -user $USER \
265 -password $PASSWORD \
266 -url jdbc:h2:artifact-database/artifacts.db \
267 -script ${GNV}/artifacts/artifact-database/doc/schema-h2.sql
268
269 -------------------------------------------------------------------------------
270 Start des GNV
271
272 Sollten Sie den Apache2 Webserver bzw den Tomcat Server noch nicht gestartet
273 haben, tun Sie dies nun. Desweiteren starten Sie den Artefakt-Server mit
274 folgendem Befehl:
275
276 cd /opt/artifacts/bin
277 ./run.sh
http://dive4elements.wald.intevation.org