NAME

cbsd jlogin — Login into local or remote jail as root user.

SYNOPSIS

DESCRIPTION

The cbsd jlogin command performs a login to the jail as root user. If the jail isn't present on the local node, but rather on one of the remote nodes, cbsd jlogin will attempt to login over ssh.

The options are as follows:

jname=<jail-name>

Login to the specified jail.

remote=1

Prevent searching the jails on remote nodes.

inter=<node-name>

Lists jails ......

src_sessions=0

Omits ...

--help

Show simple usage instructions.

If no jail is specified, a list of all known online jails in the farm is displayed (provided remote hosts were added).

If you remotely connect to a jail and node which have tmux installed, tmux will be launched at login and the session is given the name taken from the server's nodename (taken from jlogin). Additional sessions will automatically join the tmux session through a tmux-attach. When the last connection is closed the tmux session ends (you may detach via Ctrl + b , d to keep it running). Should you prefer NOT to use tmux on jlogin, copy ${workdir}/defaults/jlogin.conf to ${workdir}/etc/jlogin.conf and set tmux_login to 0.

In order to deactivate the "try to login?" question when logging into remote nodes, set always_rlogin to 1 in your ${workdir}/etc/jlogin.conf.

ENVIRONMENT

By default, CBSD displays text in color (using escape sequences ANSII). If for some reason the color is unpleasant, or you want to use output from CBSD utilities in your scripts, you can disable the color through the environment variable NOCOLOR=1. For example:

FILES

$workdir/etc/defaults/jlogin.conf

Contains defaults for the cbsd jlogin command.

$workdir/etc/jlogin.conf

Changing the values in this file will override the defaults.

EXIT STATUS

The cbsd jlogin utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

List jails that can be logged into on the farm and login into one of them:

cbsd jlogin 0 .. CANCEL 1 .. jail1 on local 2 .. jail2 on local 3 .. jail3 on local 4 .. jail4 on slave 5 .. jail5 on slave 6 .. jail6 on slave Enter id 0-6 or jail name:

Login to a jail named jail4, the search is performed on the whole farm:

cbsd jlogin jname=jail4 Found jail on remote node: slave. Try to login? [yes(1) or no(0)]

DIAGNOSTICS

To enable debugging via sh xtrace and trace all operations, use --debug argument after the CBSD command, for example:

SEE ALSO

cbsd-jconfig(8) cbsd-jregister(8) cbsd-jset(8)

AUTHORS

Oleg Ginzburg <olevole@olevole.ru>