view contrib/make_flys_release/README @ 5266:de4c12b02374

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
line wrap: on
line source
Konfiguration:
==============
Zur konfiguration des make_release scripts können umgebungsvariablen
verwendet werden oder man ändert die entsprechenden Variablen im Script.

Wichtige variablen sind:
FLYS_SOURCE_DIR
TOMCAT_PORT
MAPSERVER_URL
WIKI_URL
DEVELOPER
DEFAULT_WD

# Seddb Configuration
SEDDBURL
SEDDBPORT
SEDDBBACK
SEDDBUSER
SEDDBPASS

# Backend configuration
BACKENDURL
BACKENDPORT
BACKENDBACK
BACKENDUSER
BACKENDPASS

Prozess:
========
Nachdem die Konfigurationen angepasst wurden, kann das Skript mittels
  sh make_release.sh VERSION
von der Konsole gestartet werden. Anschließend werden die Quellen des
dive4elements, des HTTP-Clients und von FLYS über SSH aus dem HG Repository
ausgecheckt und in FLYS_SOURCE_DIR abgelegt.

Wenn mit der option -t zusätzlich ausgewählt wird diese version zu taggen
muss in der make_flys_release.sh der entsprechende accountname zum pushen
des tags als DEVELOPER angegeben werden.

Für den Client wird OpenLayers-2.11 heruntergeladen und in den Client
verschoben. Zurzeit wird das komplette OpenLayers-2.11 Verzeichnis in den Client
verschoben. Dies ist jedoch nur für die Entwicklung sinnvoll.

Das Resultat des Skripts ist ein tar.gz, welches zwei Verzeichnisses beinhaltet:
`server` und `client`. Im Server sind alle Konfigurationen sowie notwendige
Bibliotheken zum Starten des FLYS Servers enthalten. Im Client ist lediglich das
WAR Archiv für einen Servlet Container (z.B. Tomcat) enthalten.

Importer:
=========
Das script um den Importer zu bauen und zu paketieren liegt unter
bin/make-importer-package.sh
Dieses muss man anpassen und ein paar pfade setzen

Wenn man ein "Standalone" Paket bauen möchte kann man diesem script
einen Parameter übergeben an welchem sich ein tarball befindet
der mit ins importer paket gepackt werden soll. Dieser Tarball
kann abhängigkeiten (gdal / proj / oracle) enthalten.
Das skript um diesen tarball für sles zu erstellen ist
bin/make-opt-package.sh

Deployment:
===========
Der tarball kann auf ein Zielsystem übertragen werden und dort entpackt werden.
Bei den testsystemen der Intevation ist der Ort der Flys installationen
üblicherweise /opt/flys/flys-version

Anschließend deployt man den flys-client im webapps verzeichnis von tomcat
(z.b. /usr/share/tomcat6/webapps )
ggf. in WEB-INF die web.xml überprüfen / anpassen.

Bei einer konfiguration mit apache vhosts ist nun noch ein entsprechender
vhost in der apache konfiguration einzurichten.

Anschließend muss man noch sicher stellen das passende wms scripte im
mapserver verfügbar sind. In /srv/www/cgi-bin müssen entsprechende
river-wms und user-wms dateien liegen die auf die korrekte aktuelle version verweisen.
Die WMS urls sind in server/conf/floodmap.xml und server/conf/rivermap.xml konfiguriert.

Nun kann man den server starten. Dazu in das entsprechende server verzeichnis wechseln
und ./bin/run ausführen. Der server muss mit diesem arbeitsverzeichnis gestartet werden.

http://dive4elements.wald.intevation.org