Transcript WEGA-GDM Server Schulungsunterlagen

M.O.S.S.
GDM – wega-gdm_server_upset_fh.ppt
Computer Grafik Systeme
Geoinformationssysteme
Eigenschaften dieses ppt-Dokuments
Überschrift: Position Hor 1,91 Ver 0,85; Times New Roman 28;
Textfelder: Erstes Position Hor 1,91 Ver 3,73;
Überschrift Arial 18
Fließtext Arial 16
Code Courier New 12 nach Zeilenumbruch und 3 Leerzeichen, "Anführungszeichen"
 Aufzählung
Todo:
Dbinitialize.tcl Version aus pama0015 übernehmen.
(1)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Installation einer Applikation
Computer Grafik Systeme
Geoinformationssysteme
Die Installation einer Applikation ist in einem Unternehmen oder einer Behörde Aufgabe
des Systemadministrators, der umfassende Rechte hat, um systemweite Änderungen
durchzuführen und Programme zu installieren sowie auf alle Dateien zuzugreifen.
Im Unterricht am CADCAM-Labor der FH können Ihnen solche Rechte nicht gegeben
werden. Daher können Sie nur einen Server einrichten, der während ihrer Sitzung
läuft. Solange ist er aktiv und kann von allen Arbeitsplätzen angesprochen werden. Im
folgenden wird davon ausgegangen, daß Sie den Benutzernamen pama0015 haben.
Alle Dateien, die applikationsspezifische Inhalte haben, sollen getrennt von der M.O.S.S.Software gespeichert werden.
Zur besseren Lesbarkeit diese Abkürzungen. Sie müssen sie jeweils ersetzten:
Original-Software von M.O.S.S.
<server>
<client>
:= "V:\Apps\local\Wega\Admin"
:= "V:\Apps\Local\Wega\client\setup\client"
Über Start aufrufbare Tools
<desktop>
:= "V:\homes\Dokumente und Einstellungen\Desktop"
Applikationsspezifische Dateien
<applsrv>
(2)
:= "P:\pama0015\cityGuideFr"
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Bestandteile einer Applikation
Computer Grafik Systeme
Geoinformationssysteme
Eine Applikation besteht aus vier Teilen, die miteinander stark verbunden sind:
 GeoDatenbank: ODBC Access-Datenbank mit SQL-Programmierung, enthält
Systemtabellen und applikationsspezifische Tabellen mit Sachdaten. Die Füllung der
Datenbank mit Massendaten erledigen Sie mit Hilfe von Tcl-Skripts.
 GeoBasis und Übersichtskarte: Die GeoBasis ist eine sgd-RoSY-Datei. Sie enthält
eine layer-Struktur und die georeferenzierten Vektor-Objekte. Die Übersichtskarte ist
eine Rastergraphik mit Georeferenz. Die Georeferenz ist entweder Teil der
RasterDatei (z.B. Geotiff-Datei) oder wird über eine World-Datei (z.B. tfw-Datei)
geleistet.
 Server mit Tcl/TK-Programmierung. Tcl/TK steht für Tool Command Language / Tool
Kit.
 Client mit vba-Programmierung
Es wird exemplarisch gezeigt, wie Sie als Benutzer pama0015 die Applikation cityGuideFR
einrichten.
(3)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Ordnerstruktur von <desktop>
Computer Grafik Systeme
Geoinformationssysteme
Beim Arbeiten im CADCAM-Labor werden Ihre persönlichen Einstellungen zwischen
Sessions nicht gespeichert. Sie erhalten vielmehr jeweils eine standardisierte
Arbeitsumgebung. Es ist aber V:\homes ein Speicherbereich, in dem Sie Dateien
sichern können, die eine personalisierte Arbeitsumgebung einrichten. Dazu legen Sie
in V:\homes\Dokumente und Einstellungen diese Ordnerstruktur an. Die dort
abgelegten Dateien verhalten sich dann – nach Neustart – so, als lägen sie in
C:\Dokumente und Einstellungen\pama0015.
In <desktop> legen Sie alle ausführbaren Dateien, die Sie häufig benötigen.
(4)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Ordnerstruktur von <applsrv>
Computer Grafik Systeme
Geoinformationssysteme
Zum Speichern Ihrer Projektdaten dient das P:-Laufwerk. Zu Beginn jeder Sitzung müssen
Sie eine Verbindung zu P: herstellen. Das erledigt das Skript V:\etc\projects\PS05003.bat. Es enthält diese Zeile:
NET USE P: \\CAD-SMB-01\PS05-003
Am besten stellen Sie davon eine Verknüpfung her und legen sie in <desktop>. Dann
können Sie nach jedem Login mit einem Mausklick die Verbindung zu P: herstellen.
Im P:-Laufwerk legen Sie Ihren Ordner pama0015 an. Er hat diese Struktur:
Alle Kursteilnehmer haben in P:
Schreib- und Leserechte!
(5)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – WEGAshell anlegen
Computer Grafik Systeme
Geoinformationssysteme
Zum Ausführen von tcl-Scripts stellen Sie von <server>\rosy\exe\WEGAshell.exe am besten
eine Verknüpfung her und legen sie als WEGAshell in <desktop> ab. Wenn Sie dann
durch Doppelklick auf WEGAshell Tcl/TK durch Eingabe von tclsh aufrufen, können Sie
recht einfach Tcl/TK ausprobieren.
Eigenschaften/Verknüpfung/Ziel: <server>\rosy\exe\WEGAshell.exe
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <applsrv>
Links die Eigenschaften der WEGAshellVerknüpfung, oben eine geöffnete WEGAshell.
(6)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – GeoDatenbank aufsetzen (1)
Computer Grafik Systeme
Geoinformationssysteme
Im Prinzip können Datenbanken unterschiedlicher Hersteller verwendet werden, zum
Beispiel ODBC, Oracle, Informix, SQLITE. An der FH verwenden Sie bitte die ODBCMicrosoft-Access-DB.
Sie können eine vorhandene Datenbank verwenden oder eine Datenbank neu erstellen.
Eine vorhandene Datenbank zu verwenden, ist anfangs einfacher, eine neue
Datenbank zu erstellen, ist insgesamt flexibler.
Vorhandene Datenbank verwenden:
Kopieren von <server>\server\demo\srvfiles nach <applsrv>\srvfiles
WegaGdmDB.mdb

cityGuideFR.mdb
Neue Datenbank erstellen:
Mit Microsoft Access legen Sie eine leere Datenbank cityGuideFR.mdb in
<applsrv>\srvfiles an.
Kopieren von <server>\server\sql nach <applsrv>\sql
dbinitialize.tcl
base
(7)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH


dbinitialize.tcl
base
M.O.S.S.
GDM – GeoDatenbank aufsetzen (2)
Computer Grafik Systeme
Geoinformationssysteme
In beiden Fällen müssen Sie in jeder Sitzung (!) die folgenden Schritte durchführen.
 Es wird eine neue Datenquelle mit MSAccess-Treiber als Benutzer-DSN
hinzugefügt.
 Start/Einstellungen/Systemsteuerung/
Verwaltung/Datenquellen (ODBC)/
Benutzer-DSN/Hinzufügen.../Microsoft
Access Treiber (*.mdb)/Fertig stellen
 Eintrag in Datenquellenname:
cityGuideFR
 Beliebiger Eintrag in Beschreibung
 Über Auswählen <applsrv>\srvfiles
cityGuideFR.mdb einstellen.
Es gibt jetzt eine ODBC-Verbindung von
cityGuideFR zur Access-Datenbank
cityGuideFR.mdb
(8)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – GeoDatenbank aufsetzen (3)
Computer Grafik Systeme
Geoinformationssysteme
Wenn Sie eine neue Datenbank erstellen, können Sie jetzt mit Hilfe des tcl-Skripts
dbinitialize.tcl die Datenbank initialisieren. Dabei werden alle tcl-Skripte, die in
<applsrv>/sql/base liegen, ausgeführt. Das tcl-Skript tblwegatypes.tcl zum Beispiel
legt eine Tabelle an, während tblwegatypesvalues.tcl diese Tabelle mit Zeilen füllt. In
einer WEGAshell werden die folgenden Zeilen eingegeben:
easish
set dbName "cityGuideFR"
set verboseMode 0
source sql/dbinitialize.tcl
pwd
cd sql/base
createDB 1
pwd
cd ../cityGuideFR
source loadextra.tcl
sqlDisconnect
exit
;#
;#
;#
;#
;#
kein Echo der sql-Befehle; Default 1
DB-Befehle werden bereit gestellt
Prüfen, ob im richtigen Verzeichnis
Base-Tabellen-Verzeichnis
Alle *.tcl-Dateien in sql/base werden ausgeführt
;# Applikationsspezifisches Tabellen-Verzeichnis
;# spezifische Ergänzungen (Tabellen und/oder Zeilen)
Außer einigen Fehlermeldungen zu DROP TABLE und DROP INDEX sollten keine
weiteren Fehlermeldungen erscheinen. Achtung: Dokumentnamen dürfen keine
Blanks enthalten. gif-Dateien werden zwar vom Server zum Client übertragen, werden
aber nicht angezeigt.
(9)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Übersichtskarte besorgen
Computer Grafik Systeme
Geoinformationssysteme
Es sind viele Rasterformate möglich. Wichtig ist aber, daß die Rasterkarten georeferenziert
sind. Den Pixelkoordinaten müssen also immer Weltkoordinaten zugeordnet werden.
Das Rasterformat kann entweder eine interne Georeferenzierung (z.B. bei tif-Dateien)
vorsehen, die Georeferenz kann in einer eigenen World-Datei enthalten sein oder die
Georeferenz wird in cityGuideFR.dat vermittelt:
set geoSetup(overviewFile)
set geoSetup(overviewFile,worldBox)
set geoSetup(mcWorldBox)
cityGuideFR.jpg
"3406106 5313160 3421898 5323887"
"3406000 5314000 3422000 5324000"
cityGuideFR.jpgw als Beispiel einer externen World-Datei zu cityGuideFR.jpg, beide ligen in
<applsrv>\documents:
12.37625157
0.0
0.0
-13.56101391
3406106.378
5323887.065
Die linke, obere Ecke hat die Welt-Koordinate (3406106.378 5323887.065), in horizontaler
Richtung gehen 12.37625157 Pixel auf eine Welt-Koordinaten-Einheit und in vertikaler
Richtung 13.56101391.
Rasterformate und ihre Georeferenzierung
CVIM, JPEG, TIFF, PNG, GIF, PBM, PGM, PPM, PNM, BMP mit World-Dateimethode
CVIM, JPEG, TIFF, PNG, GIF, PBM, PGM, PPM, PNM, BMP mit .tab oder .map-Datei
TIFF mit M.O.S.S.-GeoInfo, TIFF mit AED-GeoInfo, GeoTIFF (Aufhängepunkt, Passpunkte oder
Matrix)
(10)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – GeoBasis erstellen
Computer Grafik Systeme
Geoinformationssysteme
Kopieren von <server>\server\demo\srvfiles nach <applsrv>
gdm_index.def

gdm_index.def
gdm_index.def enthält die Layers der GeoBasis!
Jetzt starten Sie die WEGAshell. Es öffnet sich ein neues Eingabe-Fenster mit einigen
M.O.S.S.-Informationen. Mit set können Sie sich die in diesem Fenster gesetzten
Umgebungsvariablen anzeigen lassen. Versuchen Sie crenv!
Mit Hilfe des EASI-Skripts newsgdfile.tcl erstellen Sie eine „leere“ SGD-Datei, indem Sie
Folgendes zeilenweise eingeben:
easish
source <server>/server/demo/srvfiles/newsgdfile.tcl
newSGD sgd/cityGuideFR.sgd "3406000 5314000" "3422000 5324000" ;# siehe mcWorldBox
file copy sgd/cityGuideFR.sgd sgd/cityGuideFR.org ;# Org-Datei für Recovery
exit
In <applsrv>\sgd finden Sie jetzt die Dateien cityGuideFR.sgd und cityGuideFR.org. Sie
enthalten die Paßpunkte und die Attributtabelle (Layer) für die GeoBasis. Die Layer
werden von der Datei gdm_index.def übernommen.
(11)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Server aufsetzen (1)
Computer Grafik Systeme
Geoinformationssysteme
 Kopieren von <server>\server\srvfiles\democd nach <applsrv>\srvfiles
forstsrv.dat

cityGuideFR.dat
 Anpassen von cityGuideFR.dat
cityGuideFR.dat ist eine tcl-Datei! Sie lernen jetzt also nebenbei auch ein wenig Tcl/Tk.
# Parameter Datei fuer cityGuideFR
set geoSetup(applName)
set geoSetup(serverID)
set geoSetup(licenseOwner)
set geoSetup(licenseCode)
set geoSetup(licenseFeat)
set geoSetup(serverPort)
set geoSetup(overviewFile)
set geoSetup(overviewFile,worldBox)
set geoSetup(mcWorldBox)
set geoSetup(dbConnect)
set geoSetup(applPath)
(12)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
cityGuideFR
111
"Demo CD"
AQ2PLSXBINC70S-CN%MF.WT
"1 2 4 6"
15999
cityGuideFR.jpg
"3406106 5323887 3421898 5313160"
"3406000 5323000 3422000 5314000"
"ODBC cityGuideFR"
<applsrv>
M.O.S.S.
GDM – Server aufsetzen (2)
Computer Grafik Systeme
Geoinformationssysteme
 Server anlegen und testen
Einen Server, der nur für die Dauer einer Sitzung besteht, legen Sie an, indem Sie in einer
Eigabeaufforderung diese Zeilen eingeben:
V:
cd \
cd <server>\server
server start <applsrv>\srvfiles\cityGuideFR.dat
Den Server fahren Sie in der gleichen Eingabeaufforderung herunter mit:
server stop <applsrv>\srvfiles\cityGuideFR.dat
Die log-Ergebnisse finden Sie in <applsrv>\log.
 Automatisiertes Starten und Stoppen
In <applsrv>/srvfiles legen Sie die Datei start.bat mit folgendem Inhalt an:
server start <applsrv>\srvfiles\cityGuideFR.dat
Dann stellen Sie eine Verknüpfung mit start.bat her, legen sie in <desktop> unter dem Namen
start ab und stellen die Eigenschaften so ein:
Eigenschaften/Verknüpfung/Ziel: <server>\rosy\exe\WEGAshell.exe /C <applsrv>\srvfiles\start.bat
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <server>\server
In gleicher Weise legen Sie sich die Dateien stop.bat und recover.bat sowie die
Verknüpfungen stop und recover an.
(13)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Server aufsetzen (3)
Computer Grafik Systeme
Geoinformationssysteme
Sie sollten die Ergebnisse des Hochfahrens am Terminal und in den log- und dat-Dateien
überprüfen. In der Eingabeaufforderung sollte lediglich stehen:
Starte Geo-Server…
Zugleich wurde eine weitere Eingabeaufforderung „WEGA-Shell zur Version 5.3.04“ mit
einem laufenden Prozess gestartet.
In der log-Datei finden Sie diese Einträge (Auswahl):
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
05/06/15
(14)
13:10:26 Logging of process 3520 started: WEGA-GDM GeoServer
13:10:26: (setup) Starting geoserver in directory 'V:/Apps/Local/Wega/Admin/server
13:10:26: (setup) Try to connect to database...
13:10:26: (setup) ODBC connect to cityGuideFR
13:10:26: (setup) Try to connect to sgdfile...
13:10:27: (info) Using SGD-File 'P:/pama0015/cityGuideFR/sgd/cityGuideFR.sgd'
13:10:27: (criti) Server ID 111 Name 'CityGuide Freiburg' with (1, 1)
13:10:27: (setup) Server SRS set to 'GK_DHDN'
13:10:27: (setup) Checking License...
13:10:27: (setup) License yields 10 max. Clients
13:10:27: (setup) Activated Features GeoTIFF,CPTdialog,Attachments,LZWCompression
13:10:27: (setup) Setup listener socket...
13:10:28: (notic) Start listening...
13:10:28: (info) Closing sgdfile...
13:10:28: (notic) Unload sgdfile until client connects...
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Erweiterungen des Servers
Computer Grafik Systeme
Geoinformationssysteme
Es sind Erweiterungen des Servers möglich, zum Beispiel:
srvSources: die angegebenen Quellen werden sofort geladen (in Phase 1)
set geoSetup(srvSources)
"geomar mhdokdb mhgeschbuch"
file2ppGenerator: Prozedur zum Erzeugen von Paßpunkten aus dem Dateinamen
set geoSetup(file2ppGenerator)
dasy_marTif2PP
dokidGenerator: Prozedur zum Generieren einer eindeutigen Dokumentenkennung
(DokID) anhand von Sachdaten und Dokumententyp
set geoSetup(dokidGenerator)
dasy_marDokID
Die Prozeduren dasy_marTif2PP und dasy_marDokID sind in geomar.tcl enthalten.
(15)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Client starten
Computer Grafik Systeme
Geoinformationssysteme
 Kopieren von <server>\server\demo\clntscripts nach <applsrv>\clntscripts. Von
<client>\GDM-Client.exe legen Sie eine Verknüpfung an, bringen sie nach <desktop>
und starten sie.
 Um die GeoClient-Aktionen in einer log-Datei zu erhalten, muß im GeoClient unter
Bearbeiten/Einstellungen/Log-Verwaltung die maximale Größe auf zum Beispiel 1 MB
eingestellt werden. Die GeoClient-Aktionen werden in log.txt unter
C:\Dokumente und Einstellungen\keha0001\Lokale Einstellungen\Temp\GDM-Cache
fortlaufend dokumentiert.
 Prüfung des Verbindungsaufbaus: Rechnername und Portnummer
 Prüfung, ob Overview erscheint und die angezeigten Koordinaten plausibel sind.
 Unnötige Dateien entfernen und VBS-Dateien anpassen, insbesondere die Dateien
init.vbs
login.vbs
add_hit.vbs
 Mit den dynamischen Formularen beginnen:
GDM_DYNAMISCH.ocx
 Die Clientskripte müssen beim Login zum Client transferiert werden.
 Prüfen, ob OCX richtig registriert, indem man die Suchmaske aktiviert.
(16)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Weitere Dokumenttypen, Ausbau
Computer Grafik Systeme
Geoinformationssysteme
Weitere Dokumenttypen einbringen
 Mit Hilfe des tcl-Skriptes dotypdeftvalues.tcl die SQL-Tabelle dotypdeft
entsprechend erweitern.
 zugeordnete Sachdatentabellen definieren und als tcl-Skripte
<tabellenname>.tcl im Unterverzeichnis <server>/sql/cityGuideFR speichern,
z.B. hotelsd.tcl
 wenn Sachdaten vorhanden, dann Dictionary-Tabellen tblWegaGDM und
tblWegaColumns erweitern und in den zugeordneten tcl-Skripten speichern.
 danach sollte der Server neu gestartet werden!
Server und Client weiter ausbauen
- Applikationen, Formulare, EASI/Tcl-Prozeduren
(17)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Dienst installieren (1)
Computer Grafik Systeme
Geoinformationssysteme
Sitzungsunabhängigen Server (Dienst) installieren
Kopieren von <server>\server\demo\srvfiles nach <applsrv>\srvfiles
GDM-Server-Demo.exe
GDM-Server-Demo.ini


cityGuideFR.exe
cityGuideFR.ini
Anpassen von cityGuideFR.ini
cityGuideFR.exe startet den Server als Windows-Dienst. cityGuideFR.ini ist die zugehörige
Initialisierungsdatei, die der Server braucht und die Sie anpassen müssen.
[System]
ServiceName=cityGuideFR
Debug=<applsrv>\log\cityGuideFR.txt
[GDMStart]
Cmd=<server>\server\server.bat
Params=start <applsrv>\srvfiles\cityGuideFR.dat
Path= <applsrv>
[GDMStop]
Cmd=<server>\server\server.bat
Params=stop <applsrv>\srvfiles\cityGuideFR.dat
Path= <applsrv>
Sie nutzen damit die unveränderte M.O.S.S.-Datei server.bat und Ihre eigene Datei
cityGuideFR.dat, die Sie wie beim sitzungsabhängigen Server anpassen müssen.
(18)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH
M.O.S.S.
GDM – Dienst installieren (2)
Computer Grafik Systeme
Geoinformationssysteme
Install, Start, End, Uninstall des Dienstes
Dazu legen Sie am besten Verknüpfungen an. Jeweils eine Verknüpfung vom
cityGuideFR.exe:
Zum Installieren (nur einmalig ausführen, der Dienst wird dadurch registriert)
Eigenschaften/Verknüpfung/Ziel: <applsrv>\srvfiles\cityGuideFR.exe -i
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <applsrv>
Zum Starten (kann auch per Dienstefenster gemacht werden)
Eigenschaften/Verknüpfung/Ziel: <applsrv>\srvfiles\cityGuideFR.exe -s
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <applsrv>
Zum Stoppen (kann auch per Dienstefenster gemacht werden)
Eigenschaften/Verknüpfung/Ziel: <applsrv>\srvfiles\cityGuideFR.exe -e
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <applsrv>
Zum Deinstallieren (Dienst wird aus Windows entfernt)
Eigenschaften/Verknüpfung/Ziel: <applsrv>\srvfiles\cityGuideFR.exe -u
Eigenschaften/Verknüpfung/Arbeitsverzeichnis: <applsrv>
Geeignete Icons finden Sie in den Ordnern von <server> als .ico-Dateien. Die erstellten
Verknüpfungen legen Sie am besten in <desktop> ab.
Mit diesen Werkzeugen können Sie jetzt den cityGuideFR-Server installieren, starten,
stoppen und deinstallieren. Log-Informationen erhalten Sie in <applsrv>\log und in
Start/Einstellungen/Systemsteuerung/Verwaltung/Dienste ist der Server aufgelistet.
(19)
© Copyright by M.O.S.S. Computer Grafik Systeme GmbH