| Auszug |
|---|
|
Nuclos maintenance mode: REST, curl, super user, pause job control, nuclet import, force. |
Language: Deutsch · English
Maintenance mode
Lock the system for maintenance – activate via web client or REST, query status and end it.
| Status |
|---|
| colour | Blue |
|---|
| title | Administrator |
|---|
|
| Status |
|---|
| colour | Green |
|---|
| title | Updated: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | applies to Nuclos 4.2026.x |
|---|
|
The maintenance mode puts the system into a state without disruptive transactions – ideal before nuclet import/export. When activated, all users except the starting super user are logged out, job control is paused and file imports are blocked. Only the starting super user stays logged in.
Via the web client
A super user selects the maintenance mode working environment and clicks activate maintenance mode. After ending it, jobs and imports resume and users can log in again.
Via the REST interface
Most calls require a super user login (examples using curl).
Login
| Codeblock |
|---|
|
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. |
Start maintenance mode
| Codeblock |
|---|
|
# 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 |
Query status
| Codeblock |
|---|
|
curl --cookie cookies.txt http://localhost:8080/nuclos-war/rest/maintenance/mode |
Possible values: off (inactive), initialized (starting), on (active).
End maintenance mode
| Codeblock |
|---|
|
# 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
| Codeblock |
|---|
|
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 |
Related pages
Management Console
Console.
Open →
