Mercurial > dive4elements > river

annotate contrib/make_flys_release/README @ 5266:de4c12b02374

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add some Intevation specific deployment advice.
author Andre Heinecke <aheinecke@intevation.de>
date Wed, 13 Mar 2013 10:33:46 +0100
parents 6064ab3984b3
children df7028d0cb93
rev   line source
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
1 Konfiguration:
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
2 ==============
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
3 Zur konfiguration des make_release scripts können umgebungsvariablen
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
4 verwendet werden oder man ändert die entsprechenden Variablen im Script.
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
5
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
6 Wichtige variablen sind:
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
7 FLYS_SOURCE_DIR
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
8 TOMCAT_PORT
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
9 MAPSERVER_URL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
10 WIKI_URL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
11 DEVELOPER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
12 DEFAULT_WD
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
13
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
14 # Seddb Configuration
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
15 SEDDBURL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
16 SEDDBPORT
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
17 SEDDBBACK
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
18 SEDDBUSER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
19 SEDDBPASS
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
20
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
21 # Backend configuration
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
22 BACKENDURL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
23 BACKENDPORT
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
24 BACKENDBACK
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
25 BACKENDUSER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
26 BACKENDPASS
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
27
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
28 Prozess:
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
29 ========
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
30 Nachdem die Konfigurationen angepasst wurden, kann das Skript mittels
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
31 sh make_release.sh VERSION
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
32 von der Konsole gestartet werden. Anschließend werden die Quellen des
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
33 dive4elements, des HTTP-Clients und von FLYS über SSH aus dem HG Repository
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
34 ausgecheckt und in FLYS_SOURCE_DIR abgelegt.
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
35
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
36 Wenn mit der option -t zusätzlich ausgewählt wird diese version zu taggen
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
37 muss in der make_flys_release.sh der entsprechende accountname zum pushen
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
38 des tags als DEVELOPER angegeben werden.
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
39
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
40 Für den Client wird OpenLayers-2.11 heruntergeladen und in den Client
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
41 verschoben. Zurzeit wird das komplette OpenLayers-2.11 Verzeichnis in den Client
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
42 verschoben. Dies ist jedoch nur für die Entwicklung sinnvoll.
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
43
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
44 Das Resultat des Skripts ist ein tar.gz, welches zwei Verzeichnisses beinhaltet:
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
45 `server` und `client`. Im Server sind alle Konfigurationen sowie notwendige
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
46 Bibliotheken zum Starten des FLYS Servers enthalten. Im Client ist lediglich das
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
47 WAR Archiv für einen Servlet Container (z.B. Tomcat) enthalten.
5097
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
48
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
49 Importer:
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
50 =========
5179
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
51 Das script um den Importer zu bauen und zu paketieren liegt unter
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
52 bin/make-importer-package.sh
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
53 Dieses muss man anpassen und ein paar pfade setzen
5097
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
54
5179
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
55 Wenn man ein "Standalone" Paket bauen möchte kann man diesem script
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
56 einen Parameter übergeben an welchem sich ein tarball befindet
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
57 der mit ins importer paket gepackt werden soll. Dieser Tarball
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
58 kann abhängigkeiten (gdal / proj / oracle) enthalten.
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
59 Das skript um diesen tarball für sles zu erstellen ist
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
60 bin/make-opt-package.sh
5266
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
61
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
62 Deployment:
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
63 ===========
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
64 Der tarball kann auf ein Zielsystem übertragen werden und dort entpackt werden.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
65 Bei den testsystemen der Intevation ist der Ort der Flys installationen
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
66 üblicherweise /opt/flys/flys-version
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
67
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
68 Anschließend deployt man den flys-client im webapps verzeichnis von tomcat
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
69 (z.b. /usr/share/tomcat6/webapps )
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
70 ggf. in WEB-INF die web.xml überprüfen / anpassen.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
71
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
72 Bei einer konfiguration mit apache vhosts ist nun noch ein entsprechender
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
73 vhost in der apache konfiguration einzurichten.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
74
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
75 Anschließend muss man noch sicher stellen das passende wms scripte im
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
76 mapserver verfügbar sind. In /srv/www/cgi-bin müssen entsprechende
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
77 river-wms und user-wms dateien liegen die auf die korrekte aktuelle version verweisen.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
78 Die WMS urls sind in server/conf/floodmap.xml und server/conf/rivermap.xml konfiguriert.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
79
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
80 Nun kann man den server starten. Dazu in das entsprechende server verzeichnis wechseln
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
81 und ./bin/run ausführen. Der server muss mit diesem arbeitsverzeichnis gestartet werden.
http://dive4elements.wald.intevation.org