Korrektur vom 10.06.2022:
Erweiterung der Struktur um den Parameter WEBWARE_SERVER_STATUS.INSTANCE_EVACUATED sowie Anpassung des Wertes
WEBWARE_SERVER_STATUS.LOGIN_POSSIBLE mit Berücksichtigung ob die WEBWARE Instanz evakuiert ist.
Korrektur vom 18.03.2022:
In WWS Revision >= 13248 (Build ab 22.03.2022) wird bei der JSON-Struktur der Struktur-Name WEBWARE_SERVER_STATUS nun ich Hochkomma gesetzt, zurückgegeben.
WWLINK Server Zustands Abfrage
Um den Zustand des WEBWARE-Servers von außen, also über die WEB-Schnittstelle abfragen zu können, wurde eine neue WWLINK Art: „33: WWS Zustand Abfrage“ eingeführt.
Die Erzeugung erfolgt wie bei den anderen WWLINK-Arten über die GET_RELATION 4006. Bei der Erzeugung der WWLINK-Art 33 werden alle bisherigen Parameter unterstützt.
Will man neben der Grundstruktur weitere Details abfragen so muss der Parameter Optionale Parameter mit angegeben werden. Die Verwaltung der Zustands-Links erfolgt wie bisher im Bereich:
System-Cockpit > Administration >Zugangsverwaltung > Systemfunktionen > WWLINK Zugangs-System > Server Zustand Abfrage
Dort können für die WWLINK-Art „33“ Links gesperrt, gelöscht, freigegeben und ein Zugriffsprotokoll angezeigt werden.
Nach der Erstellung eines WWLINK-Art „33“ mit Hilfe der GET_RELATION 4006 erhält man einen 32-Byte langen Hash-Wert welcher dann für die Abfrage verwendet werden kann.
Wurde ein WWLINK-Art „33“ erzeugt so kann dieser über die normale HTTP-WEB Schnittstelle des WW-Server angewendet werden.
Aufruf eines WWLINK-Art 33 erfolgt per WEB-http Aufruf mit der Vorangestellten @LNK Kennung:
https://meine-webware.de/@LNK[32-Byte-Hash-Wert]
Im Standard erhält man dann folgende JSON formatierte Rückgabe:
{
"WEBWARE_SERVER_STATUS":
{
"SERVER_STATUS":"OK",
"INSTANCE_STATUS":"INSTANCE OK",
"INSTANCE_BLOCKED":"NO",
"INSTANCE_EVACUATED":"NO",
"LOGIN_POSSIBLE": true,
}
}
Will man weitere Parameter abfragen so kann die Aufruf-Url mit 4 weiteren URL-Parametern ergänzt werden. Die Reihenfolge ist dabei unerheblich:
https://meine-webware.de/@LNK[32-Byte-Hash-Wert]?SRVSTAT?SRVDET?RARINFO?WEBINFO
-
- SRVDET – gibt Details des WW-Servers für Start/Laufzeit und Thread-Anzahl
-
- SRVSTAT – Performance-Informationen WW-Servers. CPU, RAM Informationen
-
- RARINFO – Datendurchsatz RAR-Interface
- WEBINFO – Datendurchsatz WEB-Interface
Der Abruf mit allen 4 Parametern ergibt folgende Rückgabe:
{
"WEBWARE_SERVER_STATUS": {
"SERVER_STATUS": "OK",
"INSTANCE_STATUS": "INSTANCE OK",
"INSTANCE_BLOCKED": "NO",
"INSTANCE_EVACUATED":"NO",
"LOGIN_POSSIBLE": true,
"SERVER_DETAILS": {
"SERVER_START_DATE": "24.01.2022",
"SERVER_START_TIME": "12:03:57",
"SERVER_RUNTIME": "0 Tage 0:16:33",
"SERVER_ACTIVE_THREADS": "29"
},
"SERVER_PERFORMANCE": {
"SERVER_SYS_CPU_PRZ": " 6",
"SERVER_SYS_RAM_INSTALLED_IN_MB": "30653",
"SERVER_SYS_RAM_FREE_IN_MB": "16529",
"SERVER_WWS_CPU_PRZ": " 0",
"SERVER_WWS_RAM_ACT_MB": "64.879",
"SERVER_WWS_RAM_MAX_IN_MB": "65.664"
},
"SERVER_RAR_INTERFACE": {
"WWS_RAR_RECEIVE_IN_MB": "0",
"WWS_RAR_RECEIVE_IN_KB": "314",
"WWS_RAR_SEND_IN_MB": "0",
"WWS_RAR_SEND_KB": "38",
"WWS_RAR_REQUEST_COUNT": "18",
"WWS_RAR_USER_COUNT": "1",
"WWS_RAR_CONNECTION": "13"
},
"SERVER_WEB_INTERFACE": {
"WWS_WEB_RECEIVE_IN_MB": "0",
"WWS_WEB_RECEIVE_IN_KB": "83",
"WWS_WEB_SEND_IN_MB": "1",
"WWS_WEB_SEND_KB": "1881",
"WWS_WEB_REQUEST_COUNT": "17",
"WWS_WEB_USER_COUNT": "1",
WWS_WEB_CONNECTION":"5"
}
}
}
Für Mehr Details bitte das Whitepaper beachten.