solterm(1) IPMI Serial over LAN program solterm(1)NAME
solterm - An IPMI Serial over LAN program
SYNOPSIS
solterm
<connection parms> [-e escape_char] [-notencrypted] [-notauthenticated] [-bitrate (9600|19200|38400|57600|115200)] [-alerts (suc-
ceed|defer|fail)] [-holdoff] [-ack-retries n] [-ack-timeout microseconds] [-v] [-q]
DESCRIPTION
The solterm program allows a user to make a remote serial connection over IPMI. The requires that the remote system support IPMI 2.0
Serial Over LAN.
OPTIONS
<connection parms>
The parameters for the connection depend on the connection type. These are all described in openipmi_conparms (7)
-e escape_char
The character to use to escape, or exit, the program. Entering this chatacter right after a newline is entered causes the program
to go into command mode. A single character after this performs a command. The default escape character is "~" as shown below.
Suppported commands are:
~. Terminate the program
~B Send a serial BREAK over the connection
~F Flush all buffers
~R Assert the Ring Indicator (RI) line
~r Deassert the Ring Indicator (RI) line
~D Assert DCD and DSR lines
~d Deassert DCD and DSR lines
~C Pause the output using CTS
~c Put CTS under BMC control
~? Help on escape commands
~~ Enter the escape character twice to send it.
-notencrypted
Do not encrypt the SOL data going over the connection.
-notauthenticated
Do not do integrity checks on the SOL data going over the connection.
-bitrate
Set the bitrate to the given value. The default is whatever the BMC has set it to.
-alerts
This specifies what to do if a alert that requires a callout occurs on the line.
succeed
specifies that serial/modem alerts are to succeed while SoL is active.
deferred
specifies that serial/modem alerts are to be deferred for the duration of the SoL session.
fail specifies that serial/modem alerts automatically fail during the SoL session. This is the default.
-holdoff
Specifies that CTS, DTR, and DSR are to be deasserted at the start of the SoL session so that the configuration may be modifeid
before the handshake is released.
-v Be more verbose. Maybe specified multiple time for more output.
-q Be less verbose. Maybe specified multiple time for less output.
SEE ALSO openipmi_conparms(7)KNOWN PROBLEMS
None
AUTHOR
Darius Davis <dariusd@users.sourceforge.net>
OpenIPMI 05/13/03 solterm(1)
Check Out this Related Man Page
openipmi_conparms(7) Connection Parameters for OpenIPMI openipmi_conparms(7)NAME
openipmi_cmdparms - Connection parameters for OpenIPMI
SYNOPSIS
smi smi-num
lan [-U username] [-P password] [-p[2] port] [-A authtype] [-L privilege] [-s] [-Ra auth alg] [-Ri integ alg] [-Rc conf algo] [-Rl] [-Rk
bmc key] [-H hackname] host [ host]
DESCRIPTION
The connection parameters for OpenIPMI vary depending on the connection type. This document describes the standard connection types; oth-
ers may be available from OEMs.
OPTIONS
smi-num
The SMI interface for the local connection. There may be more than one BMC connection on a system and they are generally numbered,
like /dev/ipmi0, /dev/ipmi1, etc.
-U username
Use the given username for the LAN connection. If none is given, then no username is used.
-P password
The password to use for the connection. If none is given, the user is assumed to have an empty password
-p[2] port
The UCP port to connect to. This defaults to the standard 623 port, so it is not necessary unless a special port is required. Note
that since you can have two connections (hosts), -p is for the first host and -p2 is for the second host.
-A authtype
The authentication type to use, one of rmcp+, md5, md2, straight, or none. If you don't supply this, the most secure one available
is chosen, in the order given in the previous list.
-L privilege
The privilege to use for the connection. Lower privileges cannot execute some commands. Privileges are: callback, user, operator,
admin, and oem. The default is admin.
-Ra authentication algorithm
Set the RMCP+ authentication algorithm to use. Options are: bmcpick, rakp_none, rakp_hmac_sha1, and rakp_hmac_md5. The bmcpick
option is used by default, which means the BMC picks the algorithm it wants to use.
-Ri integrity algorithm
The RMCP+ integrity algorithm to use. This ensures that the data has not be altered between the sender and receiver. Valid options
are: bmcpick, none, hmac_sha1, hmac_md5, and md5. The bmcpick option is used by default, which means the BMC picks the algorithm it
wants to use.
-Rc confidentiality algorithm
The RMCP+ confidentiality (encryption) algorithm to use. This keeps eavesdroppers from seeing the data. Valid values are: bmcpick,
aes_cbc_128, xrc4_128, and xrc_40. The bmcpick option is used by default, which means the BMC picks the algorithm it wants to use.
-Rl If this is specified, the username is looked up using the privilege level along with the username. This allows the same name to
have different passwords with different privilege levels.
-Rk BMC Key
If the system requires two-key lookups, this specifies the second key (the BMC key) to use. This is ignored if two-key lookups are
not enabled by the BMC.
-H hackname
Well, it always happens. Things in the field don't work quite like they are supposed to. There was some vagueness in the first
IPMI specs and different vendors interpreted RMCP+ in different ways. This allows different options to be supported. Try different
hacks if your RMCP+ systems don't authenticate properly. These are:
rakp3_wrong_rolem
Some systems use the incorrect Role(m) field in a specific authentication message (the RAKP3 message). This is a common
problem.
rmcpp_integ_sik
The original IPMI 2.0 spec specified the incorrect key to use for the integrity key. This forces use of the Session Initia-
tion Key. The default is to use K(1)-s Make two connections to the BMC. This means the BMC has two different IP addresses/ports that are equivalent. If this is speci-
fied, a second host must be supplied. This is not the same as two connections to two different BMCs. This must be a connection to
the same BMC.
host The IP address (either by name lookup or specified directly) to connect to. If the -s is specified, two hosts must be supplied.
The -Ra, -Ri, -Rc, -Rk and -Rl options only apply to RMCP+ connections and will be ignored if the connection does not support RMCP+ or if a
non-RMCP+ authentication type is specified.
SEE ALSO ipmish(8), openipmicmd(8), solterm(1)KNOWN PROBLEMS
This is excessively complicated, but the defaults should be good.
AUTHOR
Corey Minyard <cminyard@mvista.org>
OpenIPMI 05/13/03 openipmi_conparms(7)