WebOffice Projektüberwachung
Die WebOffice 10.9 R4 Anwendung bietet eine Call-Schnittstelle zur Überwachung der Projekte. Mit dieser Call-Schnittstelle kann man einfach ermitteln, ob zu einem bestimmten Zeitpunkt ein WebOffice 10.9 R4 Projekt verfügbar ist oder nicht.
Die Überwachung der Projektverfügbarkeit ist wichtig zum Implementieren von
•Lastenausgleichen und /oder
•Ausfallsystemen.
Kann man ein WebOffice 10.9 R4 Projekt überwachen, fällt es leicht, präzise Informationen über die Verfügbarkeit zu geben und Überwachungssysteme zu installieren. Die Überwachungssysteme melden Probleme an technische Mitarbeiter, wenn die Überprüfung der Verfügbarkeit negativ bzw. nicht erfolgreich war.
Eine Überwachung auf WebOffice 10.9 R4 Projektebene hat einen erheblichen Vorteil: Es ist weit zuverlässiger als die bloße Überwachung des Servers, der Middleware oder des GIS Servers (ArcGIS Server), da ein Test auf WebOffice 10.9 R4 Projektebene nur positiv bzw. erfolgreich sein wird, wenn alle beteiligten Systemkomponenten (Hardware/Software) verfügbar und online sind.
Synmonitor Call-Schnittstelle
WebOffice 10.9 R4 bietet die Möglichkeit mithilfe der Synmonitor Call-Schnittstelle eine HTTP-Anfrage zur Überprüfung der Verfügbarkeit von Projektkonfigurationen und Services an.
Dabei können über den Parameter &action= in der URL http://<server>:<port>/<Anwendung>/synmonitor?project=<projekt>&user=batchadmin&password=<batchadmin-Passwort - verschlüsselt>&action= Befehle angestoßen werden.
Wert für Parameter action" |
Beschreibung |
|---|---|
- |
Wird kein action-Parameter mitgegeben, so wird die Defaultoption get_project_status gewählt, dh. der Aufruf gibt den Status von Projekten zurück |
get_project_status |
Gibt den Status von Projekten zurück |
get_service_status |
Gibt den Status von Services zurück |
validate_session |
Beschreibt den Validierungsstand der Session |
|
•Benutzer aus dem UserManagement können nicht für Synmonitor-Aufrufe herangezogen werden. •Das verschlüsselte Passwort des batchadmin-Benutzers kann unmittelbar aus der Anwendungskonfiguration unter <Anwendung>\WEB-INF\classes\configuration\application_config.xml kopiert werden. |
action=get_project_status
Mit dem Parameter action=get_project_status (oder auch ohne action-Parameter) können folgende Antworten zum Status des Projekts geliefert werden:
Antwort |
Beschreibung |
||
|---|---|---|---|
OK |
Das Projekt ist initialisiert und verfügbar
|
||
OK: but uses service which requires global SOE functionality and this service is not SOE core enabled |
Das Projekt ist initialisiert und verfügbar, aber das Ausgabeservice hat die SOE-Funktionalität nicht aktiviert |
||
OK: but uses service which requires global SOE functionality and this service is not alive |
Das Projekt ist initialisiert und verfügbar, aber das Ausgabeservice mit aktivierter SOE-Funktionalität ist nicht erreichbar. |
||
FAILED |
Das Projekt ist nicht verfügbar |
||
FAILED: INITIALIZING |
Das Projekt ist verfügbar und wird derzeit initialisiert |
||
FAILED: NOT_FOUND |
Der Projektname existiert in der Anwendung nicht |
||
FAILED: Unauthorized |
Es wurden keine batchadmin-Benutzerdaten angegeben |
||
FAILED: Forbidden |
Es wurden fehlerhafte batchadmin-Benutzerdaten eingegeben |
Mögliche Antworten auf einen Synmonitor-Aufruf get_project_status"
Überwachung eines WebOffice 10.9 R4 Projekts mit der Synmonitor Call-Schnittstelle - OK
Überwachung eines WebOffice 10.9 R4 Projekts mit der Synmonitor Call-Schnittstelle – FAILED UNLOADED
Mit WebOffice 10.9 R4 wird ein zusätzlicher, invasiver Synmonitor-Parameter namens &mode= bereitgestellt. Dieser bietet die folgenden Möglichkeiten:
Wert für Parameter mode" |
Beschreibung |
|---|---|
- |
gibt den Status zurück ob ein Projekt initialisiert ist |
OK_if_unloaded |
gibt den Status zurück, ob das Projekt entladen ist (Projekt wird nicht neu geladen) |
reinit_if_unloaded |
gibt den Status zurück, ob das Projekt entladen ist, und falls ja, wird es initialisiert |
Beispiel für einen Projektstatusaufruf mit Reinitialisierung:
http://<server>:<port>/<WebOfficeAnwendung>/synmonitor?project=<Projekt>&user=batchadmin&password=<batchadmin-Passwort - verschlüsselt>&action=get_project_status&mode=reinit_if_unloaded
|
Es ist nicht notwendig, diesen Parameter im Produktionssystem zu verwenden. Im Normalfall wird es in Produktionsszenarien nicht verwendet, da bei diesen das Projekt eigentlich durch Benutzerinteraktionen initialisiert bleibt. |
action=get_service_status
Der Aufruf gibt ohne Angabe eines speziellen Diensts den Status aller Dienste in Ihren WebOffice 10.9 R4 Projekten an:
http://<server>:<port>/<WebOfficeAnwendung>/synmonitor?user=batchadmin&password=<batchadmin-Passwort - verschlüsselt>&action=get_service_status
Der Aufruf gibt bei Angabe eines speziellen Diensts den Status dieses Dienstes an:
http://<server>:<port>/<WebOfficeAnwendung>/synmonitor?user=batchadmin&password=<batchadmin-Passwort - verschlüsselt>&action=get_service_status&service=http://<server>:<port>/arcgis/<verzeichnis>/<Dienst>/<Diensttyp>
|
Der ArcGIS Server Publisher ist nicht mehr Bestandteil der Service-Kennung. Es ist deswegen nicht notwendig, den Dienst-Benutzer im Request anzugeben. |
Antwort |
Beschreibung |
|---|---|
OK |
Der Dienst ist verfügbar |
FAILED |
Der Dienst ist nicht verfügbar |
FAILED: NOT_FOUND |
Der Dienst existiert nicht |
FAILED: No Content |
Im Projekt sind keine Dienste vorhanden |
Mögliche Antworten auf einen Synmonitor-Aufruf get_service_status"
Beispiel der Antwort vom SynMonitor-Ergebnis mit dem Parameter &action=get_service_status ohne Angabe eines expliziten Dienstes
action=validate_session&vertigis_jsessionid=...&user=...
Dient zur Validierung von Sessions.
Antwort |
Beschreibung |
|---|---|
OK |
Eine Session mit der angegebenen vertigis_jsessionid existiert und gehört dem angegebenen user. Wenn kein Usermanagement verwendet wird, ist nur der Parameter vertigis_jsessionid zu verwenden ohne Angabe eines user. |
FAILED |
[a] keine Session mit der angegebenen Session-ID besteht, oder [b] die Session besteht, aber gehört nicht dem angegebenen Benutzer |
|
Die Antwort der URL Anfrage besteht aus einem STRING, dabei wird kein HTML-Dokument zurückgegeben. |
|
Bitte beachten Sie ebenfalls das Kapitel Batchfähige Administrationsrequest zur Administration Ihrer WebOffice 10.9 R4 Anwendung. |
