Quelltext der Seite Installieren der BAW Tools

[[en:How to install BAW Tools]]
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 [[Installieren der BAW Tools#Funktionserweiterung in ArcMap zuschalten|Funktionserweiterung in ArcMap zuschalten]]!
==Systemvoraussetzungen==
* ArcGIS 9; ArcMap Version 9.1, 9.2, 9.3; License Type: ArcView
* .NET-Framework, Version 1.1.4322
==Setup durchführen==
Ein Doppelklick auf die Windows Installer Datei [*.MSI] startet die Installationsroutine des ArcGIS-AddIns.<br />
Das Programm wird in das Verzeichnis :<br />
'''C:\Programme\BAW\GDL_V2Setup\'''
installiert. 
==Konfigurationsdateien & Environment==
Die ArcMap-Erweiterung benötigt zur Laufzeit den Zugriff auf einige Dateien unterschiedlichen Typs.<br />
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.
==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.<br />Der Abschnitt : [[ArcMap : Customize ...]] beschreibt, wie man die Werkzeugleiste '''BAW_Tools''' der Bedienoberfläche von ArcMap zuschaltet. 
==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 !!  
----
zurück zu [[ArcGIS-Anwendungen]]
----
[[Strukturübersicht]]