Batchfähige Administrationsrequests |
  
|
Batchfähige Administrationsrequests |
|
Administrationsrequests ermöglichen ein einfaches Administrieren über eine Skript- bzw. Batch-Datei. Administrationsrequests bewirken primär eine Veränderung des Status, während Projektüberwachungsrequests primär zur Abfrage eines bestimmten Status dienen und keine Veränderungen bewirken. Bei den Administrationsrequests können dabei über den Parameter &action= in der URL http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action= Befehle ausgeführt werden.
Dabei müssen folgende Parameter enthalten sein:
•client
•user
•password
•action
•weitere eventuell nötige Parameter
Konfiguration und Auslesen des verschlüsselten 'batchadmin' Passwortes aus der Applikationskonfiguration
Die Konfiguration eines Passwortes für den 'batchadmin' Benutzer wird in der Applikationskonfiguration definiert.
Hinweis: Nähere Informationen zur Konfiguration des verschlüsselten Passwortes für den batchadmin Benutzer in der Applikationskonfiguration finden Sie im Kapitel Admin User für Batch Requests.
Hinweis: Aus Sicherheitsgründen sollte das Passwort des Benutzers batchadmin nicht identisch mit dem Passwort zum Zugriff auf SynAdmin sein.
Nach der Festlegung und Speicherung des Passwortes kann dieses verschlüsselt aus dem WebOffice 10.7 SP1 Applikationskonfigurationsdatei (application_config.xml) ausgelesen werden.
Dafür öffnen Sie die Applikationskonfiguration unter folgenden Pfad C:\Tomcat\webapps\<WebOffice-Applikation>\WEB-INF\classes\configuration\application_config.xml und suchen nach dem Begriff BATCHADMIN_USER. Das Passwort wird unter dem Attribut pwd in der Applikationsdatei angezeigt.
Auslesen des verschlüsselten Passworts des 'batchadmin' Benutzers in der Applikationskonfiguration
Administrationsparameter
Der Parameter action kann dabei folgende Inhalte annehmen:
•action=restart
ermöglicht ein 'Neuladen' der Applikation
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=restart
•action=reload_resources
ermöglicht ein 'Ressourcen neu laden' eines bestimmten Projektes (in Verbindung mit Parameter &project=)
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=reload_resources&project=<project>
•action=recreate_fts_index
ermöglicht eine Neuberechnung eines bestimmten Index. Angabe der kompletten Subindex-Bezeichnung erforderlich.
Für den Parameter <subindexname> können folgende Werte verwendet werden:
1. Globaler Subindex - Vollständiger Name eines Globalen Subindex wie in WebOffice SynAdmin aufgelistet - siehe nachfolgender Screenshot über die Schaltfläche "Subindex Details anzeigen"
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=recreate_fts_index&subindex=user@http://<server>:6080/arcgis/SampleProject/SampleProject_Cadaster/MapServer//Properties
2. Thematischer Subindex - Vollständiger Name eines Thematischen Subindex wie in WebOffice SynAdmin aufgelistet - siehe nachfolgender Screenshot über die Schaltfläche "Subindex Details anzeigen"
Die Bezeichnung thematischer Subindizes setzt sich aus Projektname und der externen Kennung des Suchlayers (Projektname_KennungfürexterneSuche) zusammen.
Beispiel:
3.subindex=ALL - Berechnung aller definierten Subindices
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=recreate_fts_index&subindex=ALL
4.subindex=ALL_OUTDATED - Berechnung aller definierten Subindices die ein Update benötigen weil diese derzeit einen Status von SCHEDULED, ABORTING, MISSING, OUT_OF_DATE oder FAILED haben
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=recreate_fts_index&subindex=ALL_OUTDATED
Antwort
Folgende Antworten können beim Parameter action=recreate_fts_index zurückgegeben werden:
•OK (Der oder die beschriebenen Subindizes werden sobald als möglich erstellt)
•FAILED (Es gibt keinen Subindex mit dem angegeben Namen)
Hinweis: Bei der Verwendung der Uhrzeit der Index-Neuerstellung werden ALLE Subindizes periodisch aktualisiert.
Hinweis: Die Index-Erstellung kann/soll mittels Batch-Files automatisiert werden, wobei die Batch-Files über die Windows Aufgabenplanung (Scheduler) stündlich/täglich ausgeführt werden können. Während der Index neu generiert wird, kann im Projekt normal gesucht, etc. werden, da die Neuberechnung komplett im Hintergrund läuft. Beachten Sie, dass der Benutzer, der den Windows Task ausführt, auch Zugriff auf das Batch-File selbst hat.
Wenn Sie den Befehl chcp 1252 am Anfang des Batch-Files anhängen, müssen Sie sich um eine Enkodierung der Sonderzeichen keine Gedanken mehr machen.
Beispiel:
date /t
time /t
@ECHO OFF
chcp 1252
echo.
start "Recreate Subindex" "http://<server>:8080/<WebOffice-Applikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=ALL&user=batchadmin&password=<Batchadmin Passwort"
Wichtiger Hinweis: Denken Sie daran, dass Windows .bat Dateien eine spezielle Syntax benötigen und in einer URL Sonderzeichen wie '&' (kaufmännisches Und) oder '|' (Verkettungszeichen) oder ' ' (Leerzeichen) innerhalb von Anführungszeichen stehen müssen. Ein Beispiel, wie eine Batch-Datei aussehen könnte, wäre:
start "http://<server>:8080/<WebOffice application>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=user@http://<server>:6080/arcgis/SampleProject/SampleProject_Cadaster/MapServer//Properties&user=batchadmin&password=xxx"
Hinweis: Alternativ zum Öffnen der Batch-URL in einem grafischen Browser, kann der Befehl auch "silent" geschickt werden, z.B. mit einem Tool wie 'curl'.
Als Beispiel kann das Tool 'curl' unter http://www.paehl.com/open_source/ bezogen werden.
Ein Befehl könnte dann etwa so aussehen:
"<Path_to_curl>\curl.exe" "http://<Server>/<Applikation>/synadmin?client=adminbatch&action=recreate_fts_index&subindex=ALL&user=batchadmin&password=<Batchadmin_Passwort_verschlüsselt>"
Ein Beispiel für ein Batch-Skript zum Neu-Berechnen aller FTS-Indizes können Sie hier downloaden. In diesem Beispiel müssen Sie noch den
▪Host-Namen,
▪Namen der WebOffice-Applikation und
▪Passwort des SynAdmin
anpassen.
•action=status_fts_index
gibt Auskunft über den aktuellen Zustand eines bestimmten Subindex. Angabe der kompletten Subindex-Bezeichnung erforderlich.
Für den Parameter <subindexname> können folgende Werte verwendet werden:
1. Globaler Subindex - Vollständiger Name eines Globalen Subindex wie in WebOffice SynAdmin aufgelistet - siehe nachfolgender Screenshot über die Schaltfläche "Subindex Details anzeigen"
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=status_fts_index&subindex=user@http://<server>:6080/arcgis/SampleProject/SampleProject_Cadaster/MapServer//Properties
2.Thematischer Subindex - Vollständiger Name eines Thematischen Subindex wie in WebOffice SynAdmin aufgelistet - siehe nachfolgender Screenshot über die Schaltfläche "Subindex Details anzeigen
Die Bezeichnung thematischer Subindizes setzt sich aus Projektname und der externen Kennung des Suchlayers (Projektname_KennungfürexterneSuche) zusammen.
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=status_fts_index&subindex=PGIS_standorte
3.subindex=ALL - Berechnung aller definierten Subindices
Beispiel:
http://<server>:<port>/<WebOfficeApplikation>/synadmin?client=adminbatch&user=batchadmin&password=<batchadmin_passwort_verschlüsselt>&action=status_fts_index&subindex=ALL
Antwort
Folgende Antworten können beim Parameter action=status_fts_index zurückgegeben werden:
•OK (Eine Liste aller definierten Subindices mit deren aktuellem Status wird zurückgegeben)
Hinweis:
Der Status eines FTS Subindex kann folgende Werte aufweisen:
▪SCHEDULED
▪CREATING
▪CREATED
▪UNNEEDED
▪MISSING
▪FAILED
▪ABORTING
▪OUT_OF_DATE
▪NO_CONNECTION
▪PENDING_COMMIT
Beispiel:
PGIS_standorte CREATED
siteadmin@http://w-cus-gca:6080/arcgis/PGIS_DYNAMISCH/MapServer//ANLAGEN//Standorte CREATED
siteadmin@http://w-cus-gca:6080/arcgis/PGIS_DYNAMISCH/MapServer//BAUAUFSICHT//Bauaufsicht OUT_OF_DATE
siteadmin@http://w-cus-gca:6080/arcgis/PGIS_DYNAMISCH/MapServer//KATASTER//Berge und Täler SCHEDULED
siteadmin@http://w-cus-gca:6080/arcgis/PGIS_DYNAMISCH/MapServer//KATASTER//Grundstücke CREATED
siteadmin@http://w-cus-gca:6080/arcgis/PGIS_DYNAMISCH/MapServer//KATASTER//Riede CREATED
•FAILED (Es gibt keinen Subindex mit dem angegeben Namen)
Hinweis: Bitte beachten Sie ebenfalls das Kapitel WebOffice Projektüberwachung zur Überwachen ihrer ArcGIS Server Dienste (Esri System Monitor) und ihrer WebOffice 10.7 SP1 Projekte.