Nuclos Wartungsmodus: maintenance mode, REST, curl, Super-User, Jobsteuerung pausieren, Nuclet-Import, force.

Sprache: Deutsch · English

Wartungsmodus

System für Wartung sperren – per Web Client oder REST aktivieren, Status abfragen und beenden.

Auf dieser Seite

Der Wartungsmodus versetzt das System in einen Zustand ohne störende Transaktionen – ideal vor Nuclet-Import/-Export. Beim Aktivieren werden alle Benutzer außer dem startenden Super-User ausgeloggt, die Jobsteuerung pausiert und Dateiimporte gesperrt. Nur der startende Super-User bleibt angemeldet.

Über den Web Client

Ein Super-User wählt die Wartungsmodus-Arbeitsumgebung und klickt Wartungsmodus aktivieren. Nach dem Beenden laufen Jobs und Importe wieder, Benutzer können sich wieder anmelden.

Über die REST-Schnittstelle

Die meisten Aufrufe erfordern einen Super-User-Login (Beispiele mit curl).

Login

sessionId=`curl http://localhost:8080/nuclos-war/rest/login -X POST -H "Content-Type: application/json" -d '{"username":"nuclos", "password":"", "locale":"en-EN"}'`
 
# Nuclos 4.3 - 4.5:
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  }'`
# Für alle folgenden Aufrufe muss die "sessionId" als Request-Parameter übergeben werden.
 
# ab Nuclos 4.6:
curl --cookie-jar cookies.txt http://localhost:8080/nuclos-war/rest -X POST -H "Content-Type: application/json" -d '{"username":"'nuclos'", "password":"''"}';
# Anstatt des "sessionId"-Request-Parameters wird das JSESSIONID Cookie über den Cookiestore verwendet.

Wartungsmodus starten

# bis 4.28
curl --cookie cookies.txt http://localhost:8080/nuclos-war/rest/maintenance/start


# ab 4.29
curl --cookie cookies.txt -X PUT "http://localhost:2019/nuclos-war/rest/maintenance/mode" -d on
curl --cookie cookies.txt -X PUT "http://localhost:2019/nuclos-war/rest/maintenance/mode?force=true" -d on # es wird nicht darauf gewartet, bis alle Clients abgemeldet sind

Status abfragen

curl --cookie cookies.txt http://localhost:8080/nuclos-war/rest/maintenance/mode

Mögliche Werte: off (inaktiv), initialized (startet gerade), on (aktiv).

Wartungsmodus beenden

# bis 4.28
curl --cookie cookies.txt http://localhost:8080/nuclos-war/rest/maintenance/end

# ab 4.29
curl  --cookie cookies.txt -X PUT "http://localhost:2019/nuclos-war/rest/maintenance/mode" -d off

Logout

curl http://localhost:8080/nuclos-war/rest/logout?sessionid=$sessionId
 
# Nuclos 4.3 - 4.5:
curl http://localhost:8080/nuclos-war/rest?sessionId=$sessionid -X DELETE
 
# ab Nuclos 4.6:
curl --cookie-jar cookies.txt http://localhost:8080/nuclos-war/rest -X DELETE