isolconsole(8) - Linux man page

Name

isolconsole - an IPMI Serial-Over-LAN Console application

Synopsis

isolconsole [-a -d -e -l -r -x -NUPETVF]

Description

This utility starts an IPMI Serial-Over-LAN console session. A Serial-over-LAN console allows the client to see and modify functions before the OS boots, such as BIOS setup, grub, etc. This utility uses either the IPMI LAN 1.5 or 2.0 SOL interface. The 1.5 SOL interface is specific to Intel BMCs, while any IPMI 2.0 BMC should support 2.0 SOL. The target system/node must first have these parameters configured before SOL sessions can be started:
- BIOS serial console redirection parameters,
- IPMI serial (tmconfig) and lan (pefconfig) parameters, and
- For Linux, the grub.conf, inittab, and securetty parameters
Be sure that the baud rate matches in all of the above places. See the ipmiutil UserGuide section 4.8 for details.

Options

-a
Activate the SOL Console session, and enter console mode. Use the escape character ('~') to exit the session.
-d
Deactivate the SOL Console session. Use this if the previous session was aborted abnormally and starting a new session gives an error.
-e
Turn Encryption off in negotiation when activating a session. By default, encryption is on for Serial-Over-LAN console sessions.
-l
Use Legacy BIOS mapping for Enter key (CR+LF) instead of just LF. This is needed for BIOS Setup menus and DOS, but causes an extra LF to occur in Linux. So, only use this option if doing BIOS or DOS changes.
-r
(Windows only) Use Raw terminal I/O instead of custom VT100 to ANSI translation. Use this option if the server is configured in BIOS and BMC for ANSI and the utility is being invoked from Windows.
-x
Causes extra debug messages to be displayed.
-N nodename
Nodename or IP address of the remote target system. If a nodename is specified, IPMI LAN interface is used. Otherwise the local system management interface is used.
-U rmt_user
Remote username for the nodename given. The default is a null username.
-P/-R rmt_pswd
Remote password for the nodename given. The default is a null password.
-E
Use the remote password from Environment variable IPMI_PASSWORD.
-F drv_t
Force the driver type to one of the followng: imb, va, open, gnu, landesk, lan2, lan, kcs, smb. The default is to detect any supported driver type and use it.
-T
Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM.
-V
Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level.
-Y
Yes, do prompt the user for the IPMI LAN remote password. Alternatives for the password are -E or -P.

Examples

isolconsole -a -N nodename -U username -P password
Starts an SOL console session to the nodename. Detect the lan protocol.

isolconsole -a -N nodename -U username -P password -Flan2
Starts an SOL console session to the nodename. Force lan protocol to 2.0.

See Also

alarms(8) bmchealth(8) fruconfig(8) getevent(8) hwreset(8) pefconfig(8) sensor(8) showsel(8) tmconfig(8) wdt(8) icmd(8) ipmiutil(8)

Warnings

See http://ipmiutil.sourceforge.net/ for the latest version of icmd and any bug fix list.

Copyright

Copyright © 2001-2007 Intel Corp.

See the file COPYING in the distribution for more details regarding redistribution.

This utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

Author

Andy Cress <arcress@users.sourceforge.net>