mirror of
https://github.com/xcat2/confluent.git
synced 2024-11-22 09:32:21 +00:00
82 lines
3.2 KiB
Markdown
82 lines
3.2 KiB
Markdown
nodeconsole(8) -- Open a console to a confluent node
|
|
=====================================================
|
|
|
|
## SYNOPSIS
|
|
`nodeconsole [options] <noderange>`
|
|
|
|
## DESCRIPTION
|
|
|
|
**nodeconsole** opens an interactive console session to a given node. This is the
|
|
text or serial console of a system. Exiting is done by hitting `Ctrl-e`, then `c`,
|
|
then `.`. Note that console output by default is additionally logged to
|
|
`/var/log/confluent/consoles/`**NODENAME**.
|
|
|
|
When the console connection to the target is broken, then confluent on backend
|
|
will initiate an automatic retry interval that is randomized between 2 and 4 minutes.
|
|
The reopen escape sequence below requests an immediate retry, as does connecting
|
|
a new session.
|
|
|
|
## OPTIONS
|
|
|
|
* `-t`, `--tile`:
|
|
Use tmux to arrange consoles of the given noderange into a tiled layout on
|
|
the terminal screen
|
|
|
|
* `-l`, `--log`:
|
|
Perform a log reply on the current, local log in /var/log/confluent/consoles.
|
|
If in collective mode, this only makes sense to use on the current collective
|
|
manager at this time.
|
|
|
|
* `-w`, `--windowed`:
|
|
Open terminal windows for each node. The environment variable
|
|
NODECONSOLE_WINDOWED_COMMAND must be set, which should be a text string
|
|
corresponding to a command that can be used to open a windowed console,
|
|
omitting the "nodeconsole <noderange>" part of the command, for example, to
|
|
open a set of consoles for a range of nodes in separate xterm windows, set
|
|
NODECONSOLE_WINDOWED_COMMAND to "xterm -e", or in a WSL environment, to open
|
|
a set of consoles for a range of nodes in separate Windows Terminal windows,
|
|
with the title set for each node, set NODECONSOLE_WINDOWED_COMMAND to "wt.exe
|
|
--title node wsl.exe -d AlmaLinux-8 --shell-type login". Note that "node" when
|
|
in the NODECONSOLE_WINDOWED_COMMAND environment variable is treated as a keyword,
|
|
not a literal.
|
|
|
|
## ESCAPE SEQUENCE COMMANDS
|
|
|
|
While connected to a console, a number of commands may be performed through escape
|
|
sequences. To begin an command escape sequence, hit `Ctrl-e`, then `c`. The next
|
|
keystroke will be interpreted as a command. The following commands are available.
|
|
|
|
* `.`:
|
|
Exit the session and return to the command prompt
|
|
* `b`:
|
|
[send Break]
|
|
Send a break to the remote console when possible (some console plugins may not support this)
|
|
* `o`:
|
|
[reOpen]
|
|
Request confluent to disconnect and reconnect to console. For example if there is suspicion
|
|
that the console has gone inoperable, but would work if reconnected.
|
|
* `po`:
|
|
[Power Off]
|
|
Power off server immediately, without waiting for OS to shutdown
|
|
* `ps`:
|
|
[Power Shutdown]
|
|
Request OS shut down gracefully, and then power off
|
|
* `pb<ent>`:
|
|
[Power Boot]
|
|
Cause system to immediately boot, resetting or turning on as appropriate.
|
|
Hitting enter is required to execute the reboot rather than another pb sequence
|
|
* `pbs`:
|
|
[Power Boot Setup]
|
|
Request immediate boot ultimately landing in interactive firmware setup
|
|
* `pbn`:
|
|
[Power Boot Network]
|
|
Request immediate boot to network
|
|
* `r`:
|
|
[send Resize]
|
|
This queries the current terminal and sends stty commands to advertise the user termineal
|
|
size to the remote console
|
|
* `?`:
|
|
Get a list of supported commands
|
|
* `<ent>`:
|
|
Hit enter to skip entering a command at the escape prompt.
|