Installieren der 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 Funktionserweiterung in ArcMap zuschalten!

Systemvoraussetzungen

Die "BAW_Tools" stehen für ArcGIS_9.x als ArcMap-Extension und ab ArcGIS_10.0 als esriAddIn-File zur Verfügung.

• ArcMap-Extension:
  • ArcGIS 9; ArcMap Version 9.1, 9.2, 9.3; License Type: ArcView
  • .NET-Framework, Version 1.1.4322
• ESRI AddIn File:
  • ArcGIS 10.0; License Type: ArcView
  • Erforderliche .NET-Framework-Versionen: v2.0.50727 und v3.5

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 :

1. Erforderliche Dictionary-Dateien :
   • gei_dico.dat
   • ipds_dico.dat

   Die beiden Dictionary-Dateien sind in einem gemeinsamen Verzeichnis abzulegen !

2. 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 !

3. 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 !

4. 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

---

Strukturübersicht