Provided by: ipmiutil_3.0.7-1build1_amd64 
NAME
ipmiutil_serial - configure a system for Serial/EMP management functions, such as Terminal Mode, and
optionally share the port with the Serial Console.
SYNOPSIS
ipmiutil serial [-bcdeflq#rsvxB -m0 -m1 -n ser_chan -u user -p passwd -NUPREFJTVY]
DESCRIPTION
ipmiutil serial is a program that uses an IPMI driver to send IPMI commands which configure a system to
enable EMP/serial Terminal Mode management functions within the firmware, so that an administrator can
use command-line character commands via the serial port to power cycle the system and perform other
functions, even if the system is not running an OS. This level of access needs to be protected by a
username/password login, which can be specified with this utility. This utility can use either the
/dev/ipmi0 driver from OpenIPMI, the /dev/imb driver from Intel, the /dev/ipmikcs driver from valinux,
direct user-space IOs, or the IPMI LAN interface if -N.
OPTIONS
Command line options are described below.
-b Set up and enable the Serial Port EMP parameters for Basic Mode management functions. This does
not set a username or password.
-c Configure and enable the Serial Port EMP parameters for Terminal Mode management functions, shared
with BIOS Console Redirection. Setting a new username and password for serial access via -u and
-p is recommended for security.
-d Disable the serial port access for IPMI commands. The serial port is then only available for BIOS
console and OS functions. A side-effect of this option is that it sets the default user (1) back
to admin access.
-e Enable EMP Terminal Mode without shared BIOS console. The serial port is then only available for
EMP Terminal Mode functions.
-f Specifies the Flow Control for the Serial EMP. 0 means no flow control, and 1 means RTS/CTS flow
control (default). This must match the BIOS Serial Console setting.
-l Show LAN Parameters. This option reads and displays the LAN Parameter configuration also.
-m0 Switch the Serial Port MUX to Baseboard/BIOS Console operation. Set no other configuration
parameters.
-m1 Switch the Serial Port MUX to Terminal Mode management. Set no other configuration parameters.
-n ser_chan
Sets the IPMI channel number to use for the EMP serial channel (often 4). Note that the IPMI
channels for LAN, Serial, etc. are numbered differently on each platform type. The default is to
detect the first available IPMI serial channel.
-# Same as -q below.
-q Specify an alternate user number for the EMP Username from the -u option. This is normally user
number 2, 3, or 4, where 3 is the default. The maximum number of users is 15.
-r Read Only. This option just reads the Serial Parameter configuration without writing any values.
-s Set up and enable the Serial Port EMP parameters for Shared operation between Basic Mode
management functions and Baseboard (BIOS) Remote Console. This option switches the Serial Port
MUX to Baseboard Console operation.
-t Configure and enable the Serial Port EMP parameters for Terminal Mode management functions, shared
with BIOS Console Redirection. Same as -c, but easier to remember.
-u username
This specifies a username for the EMP Terminal Mode login. It can be any string, up to 15
characters. If -u is not used, the default user 1 (null) will be assumed. The username, if
specified, will be set for user 3, unless option -q is specified.
-p password
This specifies a password for the EMP Terminal Mode login. It can be any string, up to 15
characters. A null password is used if none is specified. This password applies to user 3 if -u
is used, to user 1 otherwise.
-v priv
Set a specific access priVilege for this user, where priv can be: 1=Callback, 2=User, 3=Operator,
4=Admin, 5=OEM, 15=NoAccess The default if not specified or specified in error, is to use 4=Admin.
-x Causes extra debug messages to be displayed.
-B Set the Baud rate of the serial port to one of the following: 9600, 19,2K, 38.4K, 57.6K, or
115.2K. The default is 19.2K bps.
-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.
-P/-R rmt_pswd
Remote password for the nodename given. The default is a null password.
-U rmt_user
Remote username for the nodename given. The default is a null username.
-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, lan, lan2, lan2i, kcs,
smb. Note that lan2i means lan2 with intelplus. The default is to detect any available driver
type and use it.
-J Use the specified LanPlus cipher suite (0 thru 17): 0=none/none/none, 1=sha1/none/none,
2=sha1/sha1/none, 3=sha1/sha1/cbc128, 4=sha1/sha1/xrc4_128, 5=sha1/sha1/xrc4_40, 6=md5/none/none,
... 14=md5/md5/xrc4_40. Default is 3.
-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
ipmiutil serial -t (or -c)
Enables Terminal Mode management functions, shared with BIOS Serial Console redirection. The user
can switch between serial console operations and IPMI Terminal Mode commands by typing ESC ')' and
ESC 'Q'.
ipmiutil serial -s
Enables Basic Mode management functions shared with BIOS Serial Console redirection. The user can
switch between serial console operations and IPMI Basic Mode management programs on the same
serial port.
ipmiutil serial -d
Disables the serial port management functions. This would be used if only the BIOS Serial Console
were used and no BMC serial management functions.
How to login to a Terminal Mode console:
ESC ( (switch to Terminal mode)
[SYS PWD -N ] (login for default user, null psw)
[SYS PWD -U ROOT -N PASSWORD] (syntax example for user 3)
[SYS 000157 ACTIVATE] (activate advanced commands)
[SYS HEALTH QUERY]
[SYS HELP]
[SYS PWD] (logoff)
ESC Q (switch to BIOS console)
See IPMI 1.5 Spec, Appendix E, and Intel TIGPR2U TPS for more information.
DEPENDENCIES
The ipmiutil serial utility is intended to configure the EMP serial port on the server for shared access
between BMC/IPMI functions and BIOS Console Redirection. Some platforms only support only Basic Mode for
BMC/IPMI functions. Basic Mode requires a remote client application to utilize it (Windows ISC
Console/DPC, or a special modified Linux telnet). There are some platforms which implement Terminal Mode
via IPMI v1.5 Appendix E to make remote management with character commands available on the serial port
without a special remote client application.
For example, Intel TSRLT2 systems would use "ipmiutil serial -s" for Basic Mode shared functions, but
Intel TIGPR2U systems could use "ipmiutil serial -c" to configure Terminal Mode functions. On your
system, run "ipmiutil serial -r" to check whether Serial Param(29): "Terminal Mode Config" is supported.
If not, configure Basic Mode via "ipmiutil serial -s".
PLATFORM SERIAL PORT CONFIGURATION EXAMPLES
First, enter BIOS Setup for Serial Console Redirection parameters: (these vary by platform)
Console Redirection = Serial Port B
ACPI Redirection = Disabled
Baud Rate = 115.2K
Flow Control = CTS/RTS
Terminal Type = VT100
Legacy Redirection = Enabled
Note that the Baud Rate can vary, but it must match in all locations where it is used (BIOS, IPMI, and
Linux).
For some non-Intel platforms, the serial console would be COM1 instead of COM2, but should be enabled in
BIOS.
From Linux, run "ipmiutil serial -c" for Terminal Mode shared configuration.
Or, on older Intel TSRLT2 platforms: From Linux, run "ipmiutil serial -s" for Basic Mode Shared
configuration.
LINUX CONFIGURATION FOR SERIAL CONSOLE
If using lilo, in /etc/lilo.conf, add
append="console=ttyS1,19200n8 console=tty0"
(and comment out the "message=" line because it includes graphics)
Note that the append line can be placed in the global section and removed from each kernel section if
there are no other differences.
Or, if using grub, edit /boot/grub/grub.conf as follows:
#Omit the splashimage or gfxmenu
# splashimage=(hd0,0)/grub/splash.xpm.gz
#The serial and terminal lines are not usually needed
# serial --unit=1 --speed=19200 --word=8 --parity=no --stop=1
# terminal --timeout=10 serial console
#Add the console=ttyS* parameter to the kernel line
kernel (hd0,0) /vmlinuz root=/dev/sda2 console=ttyS1,19200n8
Add this line to /etc/initab, if ttyS1 is not already there:
co:2345:respawn:/sbin/agetty ttyS1 19200 vt100
Add this line to /etc/securetty, if ttyS1 is not already there:
ttyS1
SEE ALSO
ipmiutil(8) ialarms(8) iconfig(8) icmd(8) idiscover(8) ievents(8) ifru(8) igetevent(8) ihealth(8) ilan(8)
ireset(8) isel(8) isensor(8) isol(8) iwdt(8)
WARNINGS
See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list.
COPYRIGHT
Copyright (C) 2009 Kontron America, Inc.
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 at users.sourceforge.net>
Version 2.2: 17 Feb 2010 ISERIAL(8)