rebootmgrctl
[ --help | --version ]
rebootmgrctl
is-active [--quiet]
rebootmgrctl
reboot [ fast | now ]
rebootmgrctl
cancel
rebootmgrctl
status [--quiet]
rebootmgrctl
set-strategy best-effort | etcd-lock | maint-window | instantly | off
rebootmgrctl
get-strategy
rebootmgrctl
set-group group
rebootmgrctl
get-group
rebootmgrctl
set-window time
duration
rebootmgrctl
get-window
rebootmgrctl
set-max [--group group
] number
rebootmgrctl
lock [--group group
] [machine-id
]
rebootmgrctl
unlock [--group group
] [machine-id
]
rebootmgrctl is used to
query and configure the
rebootmgrd(8)
process. Options regarding to etcd-lock
are only available if
rebootmgrctl was compiled with etcd support.
--help
¶display help text and exit
--version
¶output version information and exit
cancel
¶Cancels an already running reboot.
is-active
[--quiet]¶Prints if the rebootmgrd is running and active or not. With the
[--quiet] option,
rebootmgrctl does not print any output, but returns
"0
" if rebootmgrd is running or
"1
" if not.
reboot
[fast|now]¶Tells rebootmgr to schedule a reboot. With the [now] option, a forced reboot is done, no lock from etcd is requested and a set maintenance window is ignored. With the [fast] option, a lock from etcd is requested if needed, but a defined maintenance window is ignored.
status
[--quiet]¶Prints the current status of rebootmgrd, including current data structure stored in etcd if available. With the [--quiet] option, rebootmgrctl does not print any output, but returns the current reboot status as return value. Valid values are:
set-strategy
best-effort|etcd-lock|maint-window|instantly|off¶
A new strategy to reboot the machine is set and written into
/etc/rebootmgr.conf
.
This is the default strategy. If etcd is
running, etcd-lock
is used. If no
etcd is running, but a maintenance window
is specified, the strategy will be
maint-window
. If no maintenance window is
specified, the machine is immediately rebooted
(instantly
).
A lock at etcd for the specified
lock-group
will be acquired before reboot. If
a maintenance window is specified, the lock is only acquired
during this window.
Reboot does happen only during a specified maintenance
window. If no window is specified, the
instantly
strategy is followed.
Other services will be informed that a reboot will happen. Reboot will be done without getting any locks or waiting for a maintenance window.
Reboot requests are temporary
ignored. /etc/rebootmgr.conf
is not
modified.
get-strategy
¶The currently used reboot strategy of rebootmgrd will be printed.
set-window
time
duration
¶
Set's the maintenance window. The format of time
is the same as described in systemd.time(7).
The format of duration
is
"[XXh][YYm]
".
get-window
¶The currently set maintenance window will be printed.
set-group
etcd-lock-group
¶Set's the group, to which this machine belongs to get a reboot lock from etcd.
get-group
¶The currently set lock group for etcd.
set-max
[--group group
]
number
¶Set the maximal number of hosts in a group, which are allowed to reboot at the same time.
lock
[--group group
]
[machine-id
]¶
Lock a machine. If no group
is specified, the
local default group will be used. If no
machine-id
is specified, the local machine will
be locked.
The machine-id is a network wide, unique ID. Per default the ID from
/etc/machine-id
is used.
unlock
[--group group
]
[machine-id
]¶
Unlock a machine. If no group
is specified, the
local default group will be used. If no
machine-id
is specified, the local machine will
be unlocked.