Der GEONIS server Interceptor erlaubt das Abfangen von Anfragen an Kartenservices. Die Antwort des Kartenservices kann dadurch vorgängig durch GEONIS spezifische Funktionalitäten angepasst werden und erlaubt zum Beispiel das Einpflegen von sprachabhängigen Lookup-Werten direkt auf dem Kartenservice selbst. Somit ist kein Umweg über den GEONIS Web Adaptor nötig und die Systemarchitektur kann vereinfacht und die Fehleranfälligkeit kann verringert werden.
Diese Anleitung beschreibt Schritt für Schritt den Umstieg auf GEONIS server Interceptor. Das Vorgehen gilt sowohl für ein Update einer älteren, als auch für die Ablösung einer aktuellen Installation. Bei einer kompletten Neuinstallation kann das Vorgehen in einzelnen Punkten abweichen.
Falls nicht bereits in Betrieb, empfehlen wir den ArcGIS Web Adaptor zu installieren.
https://enterprise.arcgis.com/de/server/latest/install/windows/about-the-arcgis-web-adaptor.htm
Vorgehen
- GEONIS server Interceptor im ArcGIS Server Manager hinzufügen
- Bei allen Kartendiensten welche Lookups und/oder Rules verwenden den Interceptor aktivieren. Hier kann nach Kartendiensten mit GEONIS Mapservice Connector gefiltert werden. Dazu muss in den Suchoptionen "Funktionen" aktiviert werden:
Bei diesen Kartendiensten kann der GEONIS Mapservice Connector deaktiviert und der GEONIS server Interceptor aktiviert werden. - Nachdem alle Kartendienste konfiguriert sind, muss ein Cache für diese Kartendienste deaktiviert werden:
- Das Werkzeug agsAdmin2.exe aus deployment\setup\utilities\agsAdmin auf den GIS Server kopieren
- Die Eingabeaufforderung öffnen (Ggf. als Administrator)
- Zum Speicherort mit dem kopierten Werkzeug wechseln
-
Skript zur Deaktivierung der Caches mit folgendem Aufruf starten:
agsAdmin2.exe <arcgis_server> <arcgis_server_siteadmin> <admin_password> disablecache
- Bei einem Update, GEONIS server SOE im ArcGIS Server Manager aktualisieren
- GEONIS Web Adaptor deinstallieren
- GEONIS server UI deinstallieren
- GEONIS server UI neu installieren. Das Setup wird automatisch den GEONISserverSOE Kartendienst als GEONIS Endpunkt vorschlagen. Dieser muss gegebenenfalls angepasst werden, wenn der Dienst in einem Ordner liegt.
- Im WebGIS (WebOffice) müssen sämtliche Kartendienst URLs angepasst werden. Der GEONIS Web Adaptor darf nicht mehr als Endpunkt verwendet werden. Das kann entweder im WebOffice Author oder in den Projekt-XML's mit "Suchen/Ersetzen" gemacht werden.
Beispiel:
Alt: https://<servername>/geonis/arcgis/rest/services/oberburg/oberburg_wat/MapServer
Neu: https://<servername>/arcgis/rest/services/oberburg/oberburg_wat/MapServer
Wichtige Hinweise
Bei manchen Architekturen oder Szenarien kann es nötig sein, zusätzlich GEONIS Web Adaptor zu installieren. Ein Mischbetrieb ist problemlos möglich:
Mischbetrieb mit Web Adaptor und Interceptor
Falls unklar ist welches Szenario sinnvoll oder machbar ist, hilft Ihnen der VertiGIS Support gerne weiter.
ArcGIS Server Sicherheit
Wenn die ArcGIS Server Sicherheit verwendet wird, um Kartendienste zu sichern, muss die GEONIS server UI Konfiguration manuell erweitert werden.
Wichtig: Diese Konfiguration ist ab GEONIS server 2022 Service Pack 1 unterstützt. Ab Version 2023 wird diese Konfiguration im Setup vom GEONIS server UI durchgeführt und muss nicht mehr manuell in den Konfigurationsdateien angepasst werden.
- Im web.config unter C:\inetpub\wwwroot\GEONISserverUI2022 müssen folgende Zeilen angepasst werden:
<add key="tokenUrl" value="https://<servername>/arcgis/tokens/generateToken" />
<add key="username" value="arcgis_user" />
<add key="password" value="password123" />
Wichtig ist, dass servername mit den Kartendienst URL's in GEONIS Berichten übereinstimmt.
passwordEncrypted wird beim ersten Aufruf einer Attributmaske oder Berichts automatisch verschlüsselt eingetragen und das Passwort in Klartext wird entfernt.
- Im configWO.js unter C:\inetpub\wwwroot\GEONISserverUI2022\AttributeEditor\config muss Zeile 35 angepasst werden:
authentication: "arcgis",
Alle übrigen Parameter z.B. portalUrl oder serverUrl müssen nicht geändert werden. Diese werden nicht benötigt und ignoriert so lange keine clientId eingetragen ist.
Diese Konfiguration muss analog auch für die weiteren Module (Report, Datalist etc.) aktiviert werden.
GEONIS Netzverfolgung in WebOffice
Bei der Verwendung des Werkzeugs "GEONIS Netzverfolgung" in WebOffice müssen folgende Anpassungen vorgenommen werden:
- Beim Werkzeug "GEONIS Netzverfolgung" muss beim Parameter Server die URL zur GEONIS server SOE angegeben werden. Bsp.:
https://<servername>/arcgis/rest/services/GEONISserverSOE2023/MapServer/exts/GEONISserver2023/nettrace/GetNetTrace?project=oberburg_ele&datasource=oberburg_ele&f=pjson&lang=de - Im datasource.xml muss die URL ohne Mapservice Connector Extension angegeben werden. Bsp.:
<param key="esrimapconnectorurl" value="https://<servername>/arcgis/rest/services/oberburg/oberburg_ele/MapServer" />
Hinweis: Bei Verwendung von WebOffice mit einem Patchstand vor dem 07.06.2023 kann es zu Problemen mit gesicherten Kartendiensten kommen.
ArcGIS Enterprise
Wenn GEONIS server zusammen mit ArcGIS Enterprise (Portal for ArcGIS) betrieben wird, kann es zu Problemen kommen, wenn ein Benutzer nicht angemeldet ist. Hier muss folgender Abschnitt der Dokumentation beachtet werden:
Falls bereits GEONIS server und ArcGIS Enterprise mit Portal for ArcGIS in Betrieb ist, wurden allenfalls die Items im Portal for ArcGIS für GEONIS Web Adaptor angepasst. Diese Anpassung ist nicht mehr nötig und muss geändert werden.
Alt:
Neu:
Weitere Informationen und Quellen
Neue Funktionen in GEONIS server 2022
Installation | GEONIS server Interceptor
GEONIS 2022 | GEONIS server Interceptor und weitere Neuerungen
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.