Installieren der BAW Tools
Aus BAWiki
Diese Anleitung ist nur von Interesse, wenn die ArcMap-Erweiterung auf einem PC installiert werden soll, der sich nicht im lokalen Netz der BAW-DH befindet. Dies trifft auf externe Nutzer oder z.B. bei der Standalone-Installation auf einem Laptop zu. Auf den PCs der BAW-DH ist das ArcMap-AddIn bereits lauffähig installiert. Der hausinterne Nutzer muss ggf. noch in einem letzten Schritt die Funktionserweiterung in ArcMap zuschalten!
Systemvoraussetzungen
- ArcGIS 9; ArcMap Version 9.1, 9.2, 9.3; License Type: ArcView
- .NET-Framework, Version 1.1.4322
Konfigurationsdateien & Environment
Die "BAW_Tools" benötigen zur Laufzeit den Zugriff auf einige Dateien unterschiedlichen Typs.
Außerdem müssen drei Environment-Variablen gesetzt sein !
Anforderungen an das System :
- Erforderliche Dictionary-Dateien :
- gei_dico.dat
- ipds_dico.dat
- Die beiden Dictionary-Dateien sind in einem gemeinsamen Verzeichnis abzulegen !
- Erforderliche Konfigurations-Dateien :
- phydef.cfg.de.dat
- phydef.cfg.en.dat
- phydef.cfg.rest.dat
- phydef.cfg.si.dat
- phydef-cf.cfg.dat
- phyvgl.cfg.dat
- Die benötigten Konfigurations-Dateien sind in einem gemeinsamen Verzeichnis abzulegen !
- Environment :
- COMPSHORT = nt
- DICDIR = Verzeichnis mit den beiden Dictionary-Dateien
- CFGDIR = Verzeichnis mit den Konfigurations-Dateien
- Diese drei Umgebungsvariablen sind, am besten gleich als Systemvariablen, auf dem Rechner einzurichten !
- Erforderliche UNIX-ähnliche DOS-Kommandos :
- compress.exe
- cp.exe
- echo.exe
- GZIP.EXE
- GUNZIP.EXE
- rm.exe
- Diese Unix-Like-Executeables sind in einem der unter %PATH% erreichbaren Verzeichnisse abzulegen, z.B. in C:\WINDOWS\system32.
Stacksize der ArcMap.Exe erhöhen
Versucht ein ausführbares Programm mehr Speicher zu allokieren, als ihm zugestanden wurde kommt es zu einer System.StackOverflow-Exception. Der Fehler kann bspw. bei der Verarbeitung großer, komplexer Geometrien hervorgerufen werden. Derartige Exceptions lassen sich nicht programmtechnisch abfangen ! Das System schützt sich selbst durch sofortigen Programmabbruch.
Das Auftreten einer System.StackOverflow-Exception kann also die Ursache sein, wenn ArcMap, bspw. während eines Ladevorgangs, kommentarlos geschlossen wird. Die Stacksize für das ausführende Programm, hier die ArcMap.Exe, ist für den aktuellen Anwendungsfall zu klein bemessen und muss erhöht werden. StackOverflow ist auf Windows-PCs ein einfach zu behebender Fehler:
- [ Ein erneutes Übersetzen mit einer größeren /STACK Option erlaubt dem Executeable mehr Speicher. ]
- Die Stacksize eines Executeables läßt sich mit Hilfe des Microsoft-Kommandos editbin (kurz für edit binary) erhöhen.
Die Programme editbin.exe und dumpbin.exe werden z.B. mit Microsoft Visual Studio, aber auch mit anderen Microsoft-Compilern, geliefert. Zusätzlich benötigen diese beiden Programme noch die Dateien : link.exe und mspdb71.dll.
- Die vier Dateien in das Verzeichnis mit dem ArcMap-Executeable [ArcMap.Exe] kopieren.
- MS-DOS-Eingabeaufforderung öffnen und in das Verzeichnis wechseln.
- Mit dumpbin /headers ArcMap.Exe kann man sich die size of stack reserve im Bereich OPTIONAL HEADER VALUES ansehen.
- Der Defaultwert liegt bei 100000.
- Mit editbin /STACK:18874368 ArcMap.Exe erhöht man den Wert auf 1200000.
Da die von uns genutzten Datenmengen schnell den Rahmen sprengen, empfiehlt sich ein Heraufsetzen der Stacksize schon bei der Installation !!
"BAW_Tools" installieren
Setup durchführen:
Ein Doppelklick auf die Windows Installer Datei [*.MSI] startet die Installationsroutine des ArcGIS-AddIns.
Das Programm wird in das Verzeichnis :
C:\Programme\BAW\GDL_V2Setup\
installiert.
Funktionserweiterung in ArcMap zuschalten
Um eine Funktionserweiterung in der ArcMap-Umgebung anzubieten, muss diese, vorausgesetzt sie wurde bereits auf dem PC installiert, dem Programm noch hinzugeladen werden.
Der Abschnitt : ArcMap : Customize ... beschreibt, wie man die Werkzeugleiste BAW_Tools der Bedienoberfläche von ArcMap zuschaltet.
zurück zu ArcGIS-Anwendungen