annotate contrib/make_flys_release/README @ 5910:b8adee716970

Discharge Info Service: Added 'bfg-id' to result document.
author Sascha L. Teichmann <teichmann@intevation.de>
date Tue, 07 May 2013 11:33:02 +0200
parents 8698e3284b7a
children 75803c9eb63b
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
5530
7f8d6b49afad Make FONT_PATH configurable in release script.
Andre Heinecke <aheinecke@intevation.de>
parents: 5326
diff changeset
10 FONT_PATH
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
11 WIKI_URL
5268
df7028d0cb93 Add LOG_DIR to make release to configure a logging directory. And
Andre Heinecke <aheinecke@intevation.de>
parents: 5266
diff changeset
12 LOG_DIR
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
13 DEVELOPER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
14 DEFAULT_WD
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
15
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
16 # Seddb Configuration
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
17 SEDDBURL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
18 SEDDBPORT
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
19 SEDDBBACK
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
20 SEDDBUSER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
21 SEDDBPASS
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
22
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
23 # Backend configuration
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
24 BACKENDURL
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
25 BACKENDPORT
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
26 BACKENDBACK
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
27 BACKENDUSER
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
28 BACKENDPASS
4065
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 Prozess:
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
31 ========
5900
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
32 Als erstes muss man eine halbwegs aktuelle version von artifacts-common
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
33 und artifacts-database in dem h2 verzeichnis verlinken.
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
34
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
35 Beispiel:
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
36 cd h2
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
37 ln -s ~/.m2/repository/org/dive4elements/artifacts-common/1.0-SNAPSHOT/artifacts-common-1.0-SNAPSHOT.jar
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
38 ln -s ~/.m2/repository/org/dive4elements/artifact-database/1.0-SNAPSHOT/artifact-database-1.0-SNAPSHOT.jar
8698e3284b7a Update after renaming and remove the binary artifact-database and common
Andre Heinecke <aheinecke@intevation.de>
parents: 5618
diff changeset
39
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
40 Nachdem die Konfigurationen angepasst wurden, kann das Skript mittels
5253
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
41 sh make_release.sh VERSION
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
42 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
43 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
44 ausgecheckt und in FLYS_SOURCE_DIR abgelegt.
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
45
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
46 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
47 muss in der make_flys_release.sh der entsprechende accountname zum pushen
6064ab3984b3 Update documentation
Andre Heinecke <aheinecke@intevation.de>
parents: 5220
diff changeset
48 des tags als DEVELOPER angegeben werden.
4065
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
49
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
50 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
51 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
52 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
53
9d404069f361 Added build script for FLYS release.
Ingo Weinzierl <ingo.weinzierl@intevation.de>
parents:
diff changeset
54 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
55 `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
56 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
57 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
58
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
59 Importer:
415ac9bc5a56 Add importer packaging script and some doc about it
Andre Heinecke <aheinecke@intevation.de>
parents: 4065
diff changeset
60 =========
5179
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
61 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
62 bin/make-importer-package.sh
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
63 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
64
5179
4355b4cecef8 Improve importer packaging by just expecting a tarball with
Andre Heinecke <aheinecke@intevation.de>
parents: 5097
diff changeset
65 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
66 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
67 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
68 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
69 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
70 bin/make-opt-package.sh
5266
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 Deployment:
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
73 ===========
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
74 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
75 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
76 üblicherweise /opt/flys/flys-version
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
77
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
78 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
79 (z.b. /usr/share/tomcat6/webapps )
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
80 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
81
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
82 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
83 vhost in der apache konfiguration einzurichten.
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
84
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
85 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
86 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
87 river-wms und user-wms dateien liegen die auf die korrekte aktuelle version verweisen.
5618
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
88 Hinweis:
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
89 Für Oracle muss in diesen scripten die NLS_LANG umgebungsvariable auf UTF-8 gesetzt werden.
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
90 Beispiel für ein user-wms script:
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
91
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
92 #!/bin/sh
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
93 export LC_ALL="de_DE.UTF-8"
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
94 export NLS_LANG=".AL32UTF8"
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
95 export MS_MAPFILE=/opt/flys/current/server/flys.map
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
96 /srv/www/cgi-bin/mapserv
d03171f66511 Expand doc for river-wms and user-wms and add note about oracle
Andre Heinecke <aheinecke@intevation.de>
parents: 5530
diff changeset
97
5266
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
98 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
99
5326
555835611acd Add documentation about dgm-path option
Andre Heinecke <aheinecke@intevation.de>
parents: 5268
diff changeset
100 In server/conf/conf.xml muss dgm-path angepasst werden um an die richtige stelle
555835611acd Add documentation about dgm-path option
Andre Heinecke <aheinecke@intevation.de>
parents: 5268
diff changeset
101 zu zeigen an der im dateisystem die dgm's liegen.
555835611acd Add documentation about dgm-path option
Andre Heinecke <aheinecke@intevation.de>
parents: 5268
diff changeset
102 Wichtig: Der Pfad muss mit einem / enden
555835611acd Add documentation about dgm-path option
Andre Heinecke <aheinecke@intevation.de>
parents: 5268
diff changeset
103
5266
de4c12b02374 Add some Intevation specific deployment advice.
Andre Heinecke <aheinecke@intevation.de>
parents: 5253
diff changeset
104 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
105 und ./bin/run ausführen. Der server muss mit diesem arbeitsverzeichnis gestartet werden.

http://dive4elements.wald.intevation.org