Zweck des Wartungsmodus ist es, das System in einen Zustand zu versetzen, in dem keine störenden Transaktionen von Benutzern oder der Jobsteuerung durchgeführt werden können, welche z.B. den Nuclet-Import / -Export negativ beeinflussen könnten.
Der Wartungsmodus kann über den Nuclos-Client oder alternativ über die REST-Schnittstelle aktiviert / deaktiviert werden.
Sobald das System in den Wartungsmodus versetzt wird, werden alle Benutzer, außer dem Super-User der den Wartungsmodus startet, gezwungen sich auszuloggen. Außerdem wird die Jobsteuerung pausiert.
Während der Wartungsmodus aktiv ist kann sich nur der eine Super-User anmelden, der den Wartungsmodus gestartet hat.
Nach Beenden des Wartungsmodus wird die Jobsteuerung fortgesetzt und Benutzer können sich wieder anmelden.
Verwendung des Wartungsmodus über den Nuclos Client
Der Wartungsmodus kann durch Auswahl der Wartungsmodus-Arbeitsumgebung von einem Super-User gestartet werden.
Bis alle User außer dem Initiator des Wartungsmodus ausgeloggt sind und keine Jobs mehr laufen wird folgende Maske angezeigt:
Solange der Wartungsmodus aktiv ist, ist nur diese eingeschränkte Arbeitsumgebung zugänglich.
Durch Auswahl einer anderen Arbeitsumgebung wird der Wartungsmodus wieder beendet.
Verwendung des Wartungsmodus über die REST-Schnittstelle
Die meisten Schnittstellenaufrufe können nur von einem Super-User durchgeführt werden, weshalb zuvor ein Login mit einem Super-User Account durchgeführt werden muss.
In den folgenden Schnittstellenaufrufen wird beispielhaft das Shell-Kommando curl verwendet.
Login
sessionId=`curl http://localhost:8080/nuclos-war/rest/login -X POST -H "Content-Type: application/json" -d '{"username":"nuclos", "password":"", "locale":"en-EN"}'` ab Nuclos 4.3: sessionId=`curl http://localhost:8080/nuclos-war/rest -X POST -H "Accept:application/json" -H "Content-Type: application/json" -d '{"username":"nuclos", "password":""}' | awk -v FS="\"" '{ print $4 }'`
Logout
curl http://localhost:8080/nuclos-war/rest/logout?sessionId=$sessionId ab Nuclos 4.3: curl http://localhost:8080/nuclos-war/rest?sessionId=$sessionId -X DELETE
Wartungsmodus initiieren
curl http://localhost:8080/nuclos-war/rest/maintenance/start?sessionId=$sessionId
Wartungsmodus beenden
curl http://localhost:8080/nuclos-war/rest/maintenance/end?sessionId=$sessionId
Status abfragen
curl http://localhost:8080/nuclos-war/rest/maintenance/mode
Mögliche Rückgabewerte sind:
off | Der Wartungsmodus ist nicht aktiv. |
initialized | Der Wartungsmodus wird gerade startet. |
on | Der Wartungsmodus ist aktiv. |
Nuclet-Export
Der Local Identifier des Nuclets ist Teil der URL.
curl http://localhost:8080/nuclos-war/rest/maintenance/nucletexport/PE4A?sessionId=$sessionId > ~/temp/nucletexport.nuclet
Nuclet-Import
curl -F "file=@~/temp/nucletimport.nuclet" "http://localhost:8080/nuclos-war/rest/maintenance/nucletimport?sessionId=$sessionId"