Professional Documents
Culture Documents
Contents v
vi IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chapter 1. Introduction
This topic provides a short introduction to the BladeCenter advanced management
module command-line interface. Information about the command-line interface for
management modules other than the advanced management module is in a
separate document.
All IBM BladeCenter units are referred to throughout this document as the
BladeCenter unit. All management modules are referred to throughout this
document as the management module. Unless otherwise noted, all commands can
be run on all management-module and BladeCenter unit types.
v When a command is labeled "BladeCenter H only", it can run on all types of
BladeCenter H units (BladeCenter H and BladeCenter HT).
v When a command is labeled "BladeCenter T only", it can run on all types of
BladeCenter T units (BladeCenter T and BladeCenter HT).
v When a command is labeled "Blade Center S only", it can run on all types of
BladeCenter S units.
The most recent versions of all BladeCenter documentation are available from
http://www.ibm.com/systems/support/.
IBM Redbooks publications are developed and published by the IBM International
Technical Support Organization (ITSO). The ITSO develops and delivers skills,
technical know-how, and materials to IBM technical professionals, Business
Partners, clients, and the marketplace in general. For IBM Redbooks publications
for your BladeCenter, go to http://www.redbooks.ibm.com/portals/bladecenter.
Accessibility features
Keyboard navigation
You can view the publications for IBM BladeCenter in Adobe® Portable Document
Format (PDF) using the Adobe Acrobat® Reader. The PDFs are provided on a CD
See the IBM Human Ability and Accessibility Center for more information about
the commitment that IBM has to accessibility.
Chapter 1. Introduction 3
4 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chapter 2. Using the command-line interface
This topic tells you how to use the management module command-line interface.
Some commands do not require options and some command options do not
require parameters. You can add multiple options to a command on one line to
avoid repeating the same command. Options that display a value and options that
set a value must not be used together in the same command. The following
examples illustrate valid command option syntax:
v command
v command -option_set
v command -option_set parameter
v command -option1_set parameter -option2_set parameter
The information for each option is returned in the order in which it was entered
and is displayed on separate lines.
Note: If you receive a Command not found error, make sure that you are typing
the command in the correct case. For a list of valid commands, type help or ?.
v Data types
The ip_address data type uses a predefined formatted string of xxx.xxx.xxx.xxx,
where xxx is a number from 0 to 255.
v Delimiters
– Options are delimited with a minus sign.
– In a command that requires parameters, a single space is expected between an
option and its parameter. Any additional spaces are ignored.
v Output format
– Failed commands generate failure messages.
– Successful commands are indicated by the message OK or by the display of
command results.
v Strings
– Strings that contain spaces must be enclosed in quotation marks, for example,
snmp -cn "John B. Doe".
– String parameters can be mixed case.
v The help command lists all commands and a brief description of each command.
You can also issue the help command by typing ?. Adding the -h parameter to
any command displays its syntax.
v You can use the Up Arrow and Down Arrow keys in the command-line interface
to access the last eight commands that you entered.
You can use the command-line interface to target commands to the management
module or to other devices in the BladeCenter unit. The command-line prompt
indicates the persistent command environment: the environment in which
commands are entered unless they are otherwise redirected. When a command-line
interface session is started, the persistent command environment is system; this
indicates that commands are being directed to the BladeCenter unit.
You can change the persistent command environment for the remainder of a
command-line interface session by using the env command (see “env
(environment) command” on page 131). When you list the target as a command
attribute by using the -T option, you change the target environment for the
command that you are entering, temporarily overriding the persistent command
environment. You can specify target environments by using the full path name or
by using a partial path name that is based on the persistent command
environment. Full path names always begin with "system". The levels in a path
name are divided using a colon (:).
For example:
v Use the -T system:mm[1] option to redirect a command to the management
module in bay 1.
v Use the -T system:switch[1] option to redirect a command to the I/O (switch)
module in I/O (switch) module bay 1.
v Use the -T sp option to redirect a command to the integrated service processor
in the blade server in blade server bay 3, when the persistent command
environment is set to the blade server in blade server bay 3.
Some commands in the command-line interface can be executed only by users who
are assigned a required level of authority. Users with Supervisor command
authority can execute all commands. Commands that display information do not
require any special command authority; however, users can be assigned restricted
read-only access, as follows:
v Users with Operator command authority can execute all commands that display
information.
v Users with Chassis Operator custom command authority can execute commands
that display information about the common BladeCenter unit components.
v Users with Blade Operator custom command authority can execute commands
that display information about the blade servers.
v Users with Switch Operator custom command authority can execute commands
that display information about the I/O modules.
Table 1 on page 9 shows the command-line interface commands and their required
authority levels. To use the table, observe the following guidelines:
v The commands in this table apply only to the command variants that set values
or cause an action and require a special command authority: display variants of
the commands do not require any special command authority.
v If a command requires only one command authority at a time, each of the
applicable command authorities is indicated by a dot (v). If a command requires
a combination of two or more command authorities, the applicable command
authorities are indicate by L or ‡. For example, the boot -c command is
available to a user with the Supervisor command authority and to a user with
both the Blade Administration and Blade Remote Presence command authorities.
Notes:
1. LDAP (lightweight directory access protocol) authority levels are not supported
by management modules other than the advanced management module.
2. LDAP authority levels are not supported by the management-module web
interface.
3. To use the LDAP authority levels, you must make sure that the version of
LDAP security that is used by the management module is set to v2 (enhanced
role-based security model). See “ldapcfg command” on page 210 for
information.
Chassis Administration
Blade Administration
Blade Configuration
Supervisor
Command
accseccfg v v
advfailover v v
airfilter v v v v v
alarm -c, -r, -s v v v v
alarm -q -g v v v
alertcfg v v
alertentries v v
alertentries -test v v v v v v v v v
autoftp v v
baydata v v
bofm v v
boot v v
(blade server)
boot -c v L L
boot -p v v
bootmode v v
bootseq v v
buildidcfg v v v v
chconfig v v
chlog v v
chmanual v v v v v v v v v v
cin v L L
clear v L L ‡ ‡
clearlog v v
clock v v
config v v
(blade server)
config v v
(management module or
BladeCenter unit)
console v v
displaylog -lse v v
dns v v
Chassis Administration
Blade Administration
Blade Configuration
Supervisor
Command
ethoverusb v v
events -che v v v v v v v v v v
events -che -add -rm v v
feature v v
files -d v v v v v v v
fuelg v v
groups v v
identify v v v
ifconfig (blade server target) v v
ifconfig (blade server ISMP, v v
management module, and
system targets)
ifconfig (I/O module target) v v
ifconfig -pip (I/O module v v v
target)
kvm -b v v
kvm -local v v
ldapcfg v v
led -info, -d, -loc v v v v v
(system target)
led -info, -loc v v v v
(blade server target)
mcad v v
monalerts v v
mt -b v v
mt -local, -remote v v
nat v v
ntp v v
ping -i v v v
(see Note 1)
pmpolicy v v
portcfg v v
ports v v
Chassis Administration
Blade Administration
Blade Configuration
Supervisor
Command
ports (I/O module target) v
power -on, -off, -softoff, -cycle v v v
power -on -c, -cycle -c v L L
power -wol, -local v v v
power -fp v v
(global)
power -fp v v
(I/O module)
rdoc v v
read v v
reset v v
(blade server or ISMP)
reset v v
(I/O module)
reset v v
(management module)
reset -c, -clr, -dg, -ddg, -sft, v L L
(blade server)
reset -sms v v
(blade server)
reset -exd, -full, -std v v
(I/O module)
reset -f, -standby, -force v v
(management module)
scale v v
sddump v v
sdemail v v v v v v v v v v
security v v
service v v
shutdown v v
slp v v
smtp v v
snmp v v
sol v v v
Chassis Administration
Blade Administration
Blade Configuration
Supervisor
Command
sshcfg v v
sslcfg v v
syslog v v
tcpcmdmode v v
telnetcfg v v
trespass v v
uicfg v v
update v v v v
uplink v v
users v v
users -disable, -enable, -unlock v v v v
write v v
zonecfg v v
Note:
1. All users can execute the ping -i command directed to a specific IP address.
Users with Supervisor, Operator (general operator), I/O Module
Administration, I/O Module Configuration, or I/O Module Operator authority
can execute the ping -i command option with no arguments or ping a specific
IP address that is identified using its index number.
You must connect a client system to the management module to configure and
manage operation of the BladeCenter unit. All management modules support a
remote management and console (Ethernet) connection. The advanced management
module also supports connection through the serial management port.
You can manage the BladeCenter unit by using by using the command-line
interface that you access through Telnet or through the serial management port.
You can also use the graphical user interface that is provided by the
management-module web interface to manage the BladeCenter unit and blade
servers that support KVM. To make management connections to blade servers that
do not support KVM, use an SOL session through the management-module
command-line interface.
For information about accessing the management-module web interface, see the
BladeCenter Advanced Management Module User’s Guide.
The following topics describe how to cable to the management module to perform
initial configuration of the BladeCenter unit. See the Installation Guide for your
management module for specific cabling instructions.
Networked connection
This topic describes how to connect the management module to a network.
Direct connection
This topic tells you how to connect a client computer directly to the management
module.
Connect one end of a serial cable to the serial connector on the management
module. Connect the other end of the serial cable to the serial connector on the
client system. See the Installation Guide for your management module for cabling
information and instructions.
For the advanced management module, you can also access the command-line
interface using a serial connection. You can establish up to 20 separate Telnet,
serial, or SSH sessions to the BladeCenter management module, giving you the
ability to have 20 command-line interface sessions active at the same time.
The following SSH clients are available. Although some SSH clients have been
tested, support or nonsupport of any particular SSH client is not implied.
v The SSH clients that are distributed with operating systems such as Linux, AIX®,
and UNIX (see your operating-system documentation for information). The SSH
client of Red Hat Linux 8.0 Professional was used to test the command-line
interface.
v The SSH client of cygwin (see http://www.cygwin.com for information)
v Putty (see http://www.chiark.greenend.org.uk/~sgtatham/putty for
information)
The following table shows the types of encryption algorithms that are supported,
depending on the client software version that is being used.
Note: The advanced management module does not have a fixed static IPv6 IP
address by default. For initial access to the advanced management module in an
IPv6 environment, users can either use the IPv4 IP address or the IPv6 link-local
address. See “IPv6 addressing for initial connection” for information about
determining IPv6 addressing for initial connection.
v IPv4 IP address: 192.168.70.125 (primary and secondary management module)
v IPv4 Subnet: 255.255.255.0
v User ID: USERID (all capital letters)
v Password: PASSW0RD (note the number zero, not the letter O, in PASSW0RD)
For IPv4, the system that you are connecting to the management module must be
configured to operate on the same subnet as the BladeCenter management module.
If the IP address of the management module is outside of your local domain, you
must change the Internet protocol properties on the system that you are
connecting.
Note: For advanced management modules, the available password options depend
on the password options that are configured for the BladeCenter unit.
The link-local address is a unique IPv6 address for the advanced management
module that is automatically generated based on its MAC address. It is of the
form: FE80::3BA7:94FF:FE07:CBD0.
The link-local address for the advanced management module can be determined in
one of the following ways:
v Some advanced management modules will list the link-local address on a label
that is attached to the advanced management module.
v If you are able to log in to the management module command-line interface
(CLI) using IPv4 addressing, the link-local address can be viewed using the
ifconfig command (see “ifconfig command” on page 171 for information).
v If you are able to log in to the management module web interface using IPv4
addressing, the link-local address can be viewed in the Primary Management
Module, IPv6 section of the MM Control → Network Interfaces page (see the
BladeCenter Advanced Management Module User's Guide for information).
If the advanced management module does not have a label listing the link-local
address and you are unable to access the advanced management module using
IPv4, complete the following steps to calculate link-local address:
1. Write down the MAC address of the advanced management module. It is on a
label on the management module, below the IP reset button. The label reads
MMxxxxxxxxxxxx, where xxxxxxxxxxxx is the MAC address. For example,
39-A7-94-07-CB-D0
2. Split the MAC address into two parts and insert FF-FE in the middle. For
example,
39-A7-94-FF-FE-07-CB-D0
For a MAC address of 39-A7-94-07-CB-D0, the link-local address used for initial
IPv6 access is FE80::3BA7:94FF:FE07:CBD0.
Telnet connection
This topic tells you how to establish a Telnet session with the management
module.
The CLI command prompt is displayed. You can now enter commands for the
management module.
After you connect a serial cable from the management module to the client system,
complete the following steps:
1. Open a terminal session on the client system, and make sure that the serial port
settings for the client system match the settings for the serial port on the
management module. The default management-module serial port settings are
as follows:
v Baud rate (BPS): 57600
v Data bits: 8
v Parity: no parity
v Stop bits: 1
v Flow control: none
2. If any of the serial port settings for the client system were changed, reset the
management module (see the Installation Guide for your management module
for instructions).
3. At the login prompt, type the management-module user ID. At the password
prompt, type the management-module password. The user ID and password
are case sensitive and are the same as those that are used for
management-module web access. The default management-module user name
is USERID, and the default password is PASSW0RD (note the number zero, not
the letter O, in PASSW0RD).
The CLI command prompt is displayed. You can now enter commands for the
management module.
To log on to the management module using SSH, complete the following steps:
1. Make sure that the SSH service on the network-management workstation is
enabled. See your operating-system documentation for instructions.
2. Make sure that the SSH server on the BladeCenter management module is
enabled. See the BladeCenter Advanced Management Module User's Guide for
instructions.
3. Start an SSH session to the management module, using the SSH client of your
choice. For example, if you are using the cygwin client, from a command
prompt on the network-management workstation, type ssh ip_address (where
ip_address is the management module IP address), and press Enter. For the first
connection to the management module, use the default IP address of the
management module; if a new IP address has been assigned to the
management module, use that one instead.
The CLI command prompt is displayed. You can now enter commands for the
management module.
The following SSH clients are available. Although some SSH clients have been
tested, support or nonsupport of any particular SSH client is not implied.
v The SSH clients that are distributed with operating systems such as Linux, AIX®,
and UNIX® (see your operating-system documentation for information).
v The SSH client of cygwin (see http://www.cygwin.com for information).
If you are using the Secure Shell client that is based on OpenSSH, such as the
client that is included in Red Hat Linux version 7.3, to start an interactive
command-line Secure Shell session to a management module with network address
192.168.70.2, type a command similar to the following example:
If the CLI command requires special characters such as quotation marks, you must
escape them so that they are not consumed by the command shell on your client
system. For example, to set a new trespass warning, type a command similar to the
following example:
To start a Serial over LAN text redirection session to a blade server, the process is
similar, but in this case you must specify that the Secure Shell server session uses a
pseudo-terminal (PTY) to get the correct output formatting and keystroke
handling. In the following example, which starts a Serial over LAN session to the
blade server in slot 2, the -t SSH client option specifies that a PTY is to be
allocated.
Using SMASH
You can use the System Management Architecture for Server Hardware Command
Line Protocol (SMASH CLP) for the advanced management module. See the IBM
SMASH Proxy Installation and User's Guide for more information.
where -p 50022 specifes TCP port 50022, the default port number for Secure
SMASH on the advanced management module, and -l USERID specifies one of the
12 local account login IDs.
where -t specifies that a PTY is required for the session and show /modular1 is the
SMASH command that is to be executed on the advanced management module.
If you are using a Telnet client to start an interactive SMASH CLP session, you
must specify the correct TCP port number. By default, the port that is assigned to
the SMASH protocol is 50023.
All CLI commands that are run in an SSH client single-command environment
provide exit codes to indicate their outcomes. The following table shows exit codes
that are supported; other exit codes are reserved for future use.
Table 2. SSH CLI exit codes
Value
Name (decimal) Description
EX_OK 0 Successful command execution.
EX_USAGE 64 Command-line usage error: syntax error, wrong command arguments
or number of arguments, or invalid command target.
EX_DATAERR 65 Input data error: invalid configuration file or SSH key parsing error.
EX_NOINPUT 66 The input file does not exist or is not readable.
EX_UNAVAILABLE 69 The command-line interface is not available: CLI oversubscribed, CLI
disabled, or the data returned by a command has an unexpected value.
EX_SOFTWARE 70 Internal software error. Check the management-module event log for
other error indications.
EX_TEMPFAIL 75 The command could not perform a write operation because the device
or management module was not in the correct state. Check for
conflicting tasks or conditions and try to run the command again.
CLI_ERR_NOT_AUTHORIZED 126 Authorization error: the user does not have sufficient privileges to
execute command.
CLI_ERR_CNF 127 Command not found.
The BladeCenter unit automatically detects the modules and blade servers that are
installed and stores the vital product data (VPD). When the BladeCenter unit is
started, the management module automatically configures the remote management
port of the management module, so that you can configure and manage
BladeCenter components. You configure and manage BladeCenter components
remotely by using the management-module command-line interface (CLI) or the
management-module web interface.
To communicate with network resources and with the I/O modules in the
BladeCenter unit, you must configure IP addresses for the management module
and I/O modules. You can configure management-module IP addresses by using
the web interface or command-line interface. You can configure the I/O modules
through the management-module web interface or through an external I/O-module
port that is enabled through the management module, using a Telnet interface, a
serial connection, or a web browser. See the documentation that comes with each
I/O module for information and instructions.
You configure only the primary (active) management module. The standby
(redundant) management module, if present, receives the configuration and status
information automatically from the primary management module when necessary.
The configuration information in this topic applies to the primary management
module, which might be the only management module in the BladeCenter unit.
If the management module that you installed is a replacement for the only
management module in the BladeCenter unit and you saved the configuration file
before you replaced the management module, you can apply the saved
configuration file to the replacement management module. For advanced
management modules, see “read command” on page 280 for information about
applying a saved configuration file.
For the primary management module to communicate, you must configure the IP
address for the external Ethernet (remote management) port (eth0) of the
management module. The initial automatic management module configuration
enables a remote console to connect to the management module to configure the
port completely and to configure the rest of the BladeCenter unit.
Note: The internal Ethernet ports (eth1) for the advanced management module
cannot be configured.
After you connect the primary management module to the network, the Ethernet
port connection is configured in one of the following ways. Either of these actions
enables the Ethernet connection on the primary management module.
v If you have an accessible, active, and configured dynamic host configuration
protocol (DHCP) server on the network, the IP address, gateway address, subnet
mask, and DNS server IP address are set automatically. The host name is set to
the management-module MAC address by default, and the domain server
cannot change it.
v If the DHCP server does not respond within 2 minutes after the port is
connected, the management module uses the factory-defined static IP address
and default subnet address.
Note: If the management-module DHCP setting is set to try the DHCP server
and then use the static IP address, the management module uses the static IP
address when the DHCP server is not available during management-module
startup. When this occurs, the IP address might not be reachable if multiple
management modules were started with the same static IP address.
Important: You cannot connect your system to the management module by using
the factory-defined static IP address and default subnet address until at least 3
minutes after management-module startup.
Note: If the IP configuration is assigned by the DHCP server, you can use the
MAC address of the management-module network interface to find out what IP
Notes:
v The internal Ethernet management port on each I/O module provides for
communication with the management module. You configure this port by
configuring the IP address for the I/O module (see the BladeCenter Advanced
Management Module User's Guide and the User's Guide for your I/O module
type for information and instructions). Some types of I/O modules, such as
the pass-thru module, have no management port. See the documentation that
comes with each I/O module to determine what else you must configure in
the I/O module.
v For I/O-module communication with a remote management station, such as
an IBM® Systems Director management server, through the
management-module external Ethernet port, the I/O-module internal
network interface and the management-module internal and external
interfaces must be on the same subnet.
v To communicate with the blade servers for functions such as deploying an
operating system or application program, you also must configure at least
one external (in-band) port on an Ethernet I/O module.
Note: Serial over LAN (SOL) must be enabled for both the BladeCenter unit and
the blade server before you can start an SOL session with the blade server. See “sol
(serial over LAN) command” on page 328 and the BladeCenter Serial over LAN Setup
Guide for information about setting up and enabling SOL.
Because you can start up to 20 separate web interface, Telnet, serial, or SSH
sessions to the BladeCenter management module, simultaneous SOL sessions can
be active for each blade server installed in the BladeCenter unit.
Start an SOL session by using the console command, from the command line,
indicating the target blade server. For example, to start an SOL connection to the
blade server in blade bay 6, type
console -T system:blade[6]
Note: A blade server assembly that occupies more than one blade server bay is
identified by the lowest bay number that it occupies.
After an SOL session is started, all commands are sent to the blade server that is
specified by the console command until the SOL session is ended, regardless of the
persistent command target that was in effect before the SOL session.
See “sol (serial over LAN) command” on page 328 and the IBM BladeCenter Serial
over LAN Setup Guide for information about configuring a blade server for SOL. See
When the SOL session ends, the command-line interface returns to the persistent
command target that was in effect before the SOL session. If you want to end the
Telnet or SSH command-line session, type exit.
Note: Exiting an SOL session does not stop the flow of serial data.
Adding a -h, -help, or ? option to a command displays syntax help for that
command. For example, to display help for the environment command, type one of
the following commands:
v env -h
v env -help
v env ?
You can target a command to a device other than the one that is set as the default
by adding a -T option to a command. See “Selecting the command target” on page
6 for information.
Command syntax
Each of the following topics describes a command-line interface command and its
syntax. Each command description also includes an example of command use.
Example:
To set management-module account security to use the high level defaults, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
accseccfg -high
To display the account security settings for the management module, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
accseccfg
Example:
To disable the network interface for the standby management module, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
advfailover -ip off
The following example shows the information that is returned from these two
commands:
system:mm[1]> advfailover -ip off
OK
system:mm[1]> advfailover
-ip off
system:mm[1]>
To set the notification interval to three months, while management module 1 is set
as the persistent command environment, at the system:mm[1]> prompt, type
airfilter -freq 3
The following example shows the information that is returned when these
commands are entered:
system:mm[1]> airfilter
-freq 1
system:mm[1]>
system:mm[1]> airfilter -freq 3
OK
system:mm[1]>
Example: To display the alarm status for the BladeCenter T unit, while the
BladeCenter T unit is set as the persistent command environment, at the system>
prompt, type
alarm -q
To display the power alarm status for the BladeCenter T unit, while the
BladeCenter T unit is set as the persistent command environment, at the system>
prompt, type
alarm -p
To display detailed power alarm status for the power module in power bay 2,
while the BladeCenter T unit is set as the persistent command environment, at the
system> prompt, type
alarm -T system:power[2] -q
system> alarm -q -p
Alarms Summary List
Module ACK Severity Power Software
=========== === ======== ===== ========
power[2] No Critical Yes No
system>
To set the retry interval to 3.5 minutes, include service information in the alert, and
set the remote alert retry limit to 7, while management module 1 is set as the
persistent command environment, at the system:mm[1]> prompt, type
alertcfg -dr 3.5 -si enabled -rl 7
The following example shows the information that is returned from these
commands:
system:mm[1]> alertcfg
-dr 2.0
-si disabled
-rl 6
system:mm[1]> alertcfg -dr 3.5 -si enabled -rl 7
OK
system:mm[1]> alertcfg
-dr 3.5
-si enabled
-rl 7
system:mm[1]>
where:
v recip_number is a
number from 1 to 12
that corresponds to an
unused recipient
number in the "Display
alert properties for all
recipients" list.
v recip_name is a
alphanumeric string up
to 31 characters in
length containing any
character, including
spaces, except for angle
brackets ( < and > ). If
the string includes
spaces it must be
enclosed in
double-quotes.
v alert_status is on or off
for receipt of alerts.
v filter_type filters the alert
types received: critical
(receive critical alerts
only) or none (receive
all alerts).
v notification_method is
email, director (IBM
Systems Director) or
snmp.
– For email, you must
specify an email
address (-e
argument).
– For director you
must specify an IP
address (-i
argument).
– If snmp is selected,
the -e and -i
arguments are not
needed.
v email_addr is a valid
email address string up
to 63 characters in
length.
(continued on next page)
To configure alert recipient 3 to receive all alert notifications through IBM Systems
Director, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
alertentries -3 -n test3 -status on -f none -t director -i 192.168.70.140
To configure alert recipient 4 to receive all alert notifications through SNMP, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
alertentries -4 -n test4 -status on -f none -t snmp
The following example shows the information that is returned from these
commands:
system:mm[1]> alertentries -1
-status on
-n test1
-f critical
-t email
-e test1@us.ibm.com
system:mm[1]> alertentries -2 -n test2 -status on -f critical -t email
-e test2@us.ibm.com
OK
system:mm[1]> alertentries -3 -n test3 -status on -f none -t director
-i 192.168.70.140
OK
system:mm[1]> alertentries -4 -n test4 -status on -f none -t snmp
OK
system:mm[1]>
The following example shows the information that is returned from these
commands:
system:mm[1]> autoftp
-m ftp
-i ftp.ibm.com
-p 6
-u smlite
system:mm[1]> autoftp -m tftp -i tftp.ibm.com -p 69
OK
system:mm[1]>
Example: To view the bay data for all blades, while the management module is set
as the persistend command environment, at the system> prompt, type
baydata
The following example shows the information that is returned from this command:
system> baydata
Bay Status Definition
1 Unsupported
2 No blade present
3 No blade present
4 No blade present
5 No blade present
6 No blade present
7 No blade present
8 No blade present
9 No blade present
10 No blade present
11 No blade present
12 No blade present
13 No blade present
14 No blade present
system>
Notes:
1. Open Fabric Manager is not a standard management module feature; it is
offered and documented separately. See the BladeCenter Open Fabric Manager
Installation and Users Guide for more detailed information.
2. If the number of advanced management module TCP command mode
connections is zero, or if all available TCP command mode connections are in
use, a connection failure message is generated by the BOFM feature. Make sure
that the advanced management module TCP command mode connection limit
is positive and that no more than the available number of connections are in
use. See the BladeCenter Open Fabric Manager Installation and Users Guide for
additional information.
Table 11. bofm command
Function What it does Command Valid targets
Apply BOFM Copies a configuration file from a bofm -l filename -i -T system:mm[x]
configuration to TFTP server to the specified ip_address
specified BladeCenter management module, which then where x is the primary
units, bays, and ports configures BladeCenter units, where: management-module
blade servers, and I/O modules. v filename is the name of bay number.
the configuration file.
The configuration file is a v ip_address is the IPv4 or
comma-separated values (CSV) file IPv6 IP address of the
that assigns IP addresses and other TFTP server where the
values to BladeCenter units, bays, configuration file is
and ports. located.
Note: Both the -l filename
option and the -i
ip_address option need to
be specified.
Example:
To apply a new BOFM configuration file to a set of BladeCenter units and view
details of the procedure, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
bofm -i 9.148.8.2 -l apply.csv -v
The following example shows the information that is returned from this command:
system:mm[1]> bofm -i 9.148.8.2 -l apply.csv -v
TFTP file upload successful.
Starting to apply new BOFM configuration on MM
Percent complete: 100%
Status: Confirmed configuration change.
Percent complete: 100%
Status: Configuration applied.
Applying new BOFM configuration on MM - Completed.
system:mm[1]>
Example: To view the boot mode of the blade server in bay 2, while this blade
server is set as the persistent command environment, at the system:blade[2]>
prompt, type
bootmode
To set the boot mode of the blade server in bay 2 to permanent, while this blade
server is set as the persistent command environment, at the system:blade[2]>
prompt, type
bootmode -p perm
The following example shows the information that is returned from these
commands:
system:blade[2]> bootmode
active: temporary
pending: Invalid boot mode type
system:blade[2]> bootmode -p perm
Set the blade boot mode to permanent succeeded.
The setting will become active after the next reboot of the blade.
system:blade[2]> bootmode
active: temporary
pending: permanent
system:blade[2]>
A boot sequence of up to
four boot devices can be
specified. If fewer than
four devices are specified,
the remaining items in the
sequence are set to nodev.
Example: To set a boot sequence of diskette drive, CD-ROM drive, and hard disk
drive 0 for the blade server in blade bay 3, while the blade server in blade bay 3 is
set as the persistent command environment, at the system:blade[3]> prompt, type
bootseq floppy cd hd0
To display the boot sequence for the blade server in blade bay 3, while the blade
server in blade bay 3 is set as the persistent command environment, at the
system:blade[3]> prompt, type
bootseq
The following example shows the information that is returned from these two
commands:
system:blade[3]> bootseq floppy cd hd0
OK
system:blade[3]> bootseq
floppy
cd
hd0
nodev
system:blade[3]>
Example: To create the initial build ID list, while the BladeCenter unit is set as the
persistent command environment, at the system> prompt, type
buildidcfg -create
To view the build ID list, while the BladeCenter unitis set as the persistent
command environment, at the system> prompt, type
buildidcfg
The following example shows the information that is returned from these
commands:
system> buildidcfg -create
OK
system> buildidcfg
Index Manufacture Machine Type Firmware Type Build ID Revision
1 IBM 8853 Blade Sys Mgmt Processor BCBT58A 1.18
system>
where:
v "company" is the
quote-delimited contact
company name, of up to
30 characters in length.
v "name" is the
quote-delimited contact
name, of 1 to 30
characters in length.
v "phone" is the
quote-delimited contact
phone number, of 5 to
30 characters in length.
v email is email address of
the contact person in
the form
userid@hostname (30
characters maximum).
The userid can be
alphanumeric
characters, ".", "-", or "_"
but must begin and end
with alphanumeric
characters. The
hostname can be
alphanumeric
characters, ".", "-", or "_".
It must contain at least
two domain items.
Every domain item
should begin and end
with an alphanumeric
character and the last
domain item should be
from 2 to 20 alphabetic
characters.
v "address" is the
quote-delimited street
address of the machine
location, of 1 to 30
characters in length.
v "city" is the
quote-delimited city of
the machine location, of
1 to 30 characters in
length.
Example:
To accept the Service Advisor terms and conditions, while management module 1
is set as the persistent command environment, at the system:mm[1]> prompt, type
chconfig -li accept
Example: To display five call-home activity log entries, while management module
1 is set as the persistent command environment, at the system:mm[1]> prompt, type
chlog
The following example shows the information that is returned from these two
commands:
system:mm[1]> chlog
Index Ack Send Result Assigned Num Event ID Sev Source
Time Message
14 No Success NULL 0x00016802 I CHASSIS
06/04/08 09:11:11 Test Call Home generated by USERID.
15 No Pending NULL 0x00016802 I CHASSIS
06/04/08 09:11:12 Test Call Home generated by USERID.
Example:
To manually send a test message, while the system is set as the persistent
command environment, at the system> prompt, type
chmanual -test
The following example shows the information that is returned from these two
commands:
system> chmanual -desc "This is a test."
OK
system> chmanual -test
OK
system>
Note: where:
v If the index is not empty, the ID v entry_index is a number
can be specified separately. between 1 and 14
v The VLAN ID must be different v vlan_id is a number
from that of the management between 3 and 4094
module. (inclusive).
Example:
To view chassis internal network information for the management module, while
this management module is set at the persistent command environment, at the
system> prompt, type
cin
The following example shows the information that is returned from this command:
system> cin
-global -en off
Index 1
-id 11
-ip 11.1.1.1
-en on
Index 2
-id 12
-ip 22.1.1.1
-en on
Index 3
not used
Index 4
not used
Index 5
not used
Index 6
not used
Index 7
not used
100 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Index 8
not used
Index 9
not used
Index 10
not used
Index 11
not used
Index 12
-id 123
-ip 23.1.1.1
-en on
Index 13
not used
Index 14
not used
system>
Example:
To display five entries of the CIN status table, while the BladeCenter unit is set as
the persistent environment, at the system> prompt, type
cinstatus
The following example shows the information that is returned from this command
system> cinstatus
Note: * next to IP address indicates a learned entry
102 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
clear command
This command restores the primary management module configuration or an I/O
(switch) module configuration to the default settings.
No results are returned from this command. After the management module resets,
you will need to start a new command-line session.
104 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
clearlog command
This command clears the management-module audit event log, the system event
log, or both.
Table 22. clearlog (clear management-module event log) command
Function What it does Command Valid targets
Clear Clears the management-module clearlog -T system:mm[x]
management-module event log and displays a message
event log confirming that the specified event This command can only where x is the primary
log was cleared. be run by users who have management-module
one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis log
management
See “Commands and user
authority” on page 8 for
additional information.
Clear advanced Clears the management-module clearlog -l log_type -T system:mm[x]
management-module audit event log, the system event
audit or system event log, or both, and displays a where log_type is audit or where x is the primary
log message confirming that the system. management-module
specified event log was cleared. bay number.
Notes: This command can only
be run by users who have
v Audit log events are created by one or more of the
the actions of users. following command
v If the log_type is not specified, authorities:
this command will clear both v Supervisor
logs. v Chassis log
v Although system events and management
audit events are stored internally See “Commands and user
in separate log files, they are authority” on page 8 for
presented to the user as a single additional information.
log that can be filtered.
106 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 23. clock command (continued)
Function What it does Command Valid targets
Set advanced Sets the time for the advanced clock -g offset -T system:mm[x]
management module management module clock.
clock GMT offset where offset is a value where x is the primary
between +12 and -12, in management-module
hours and minutes. bay number.
Positive offsets are entered
using the form:
GMT+hh:mm, +hh:mm,
+hh, hh:mm, or hh; where,
the hours and minutes can
be input as single digits.
Negative offsets are
entered using the form:
GMT-hh:mm, -hh:mm, or
-hh; where, the hours and
minutes can be input as
single digits. Valid offsets
are:
v GMT+0:00
v GMT+1:00
v GMT+2:00
v GMT+3:00
v GMT+3:30
v GMT+4:00
v GMT+4:30
v GMT+5:00
v GMT+5:30
v GMT+6:00
v GMT+7:00
v GMT+8:00
v GMT+9:00
v GMT+9:30
v GMT+10:00
v GMT+11:00
v GMT+12:00
v GMT-12:00
v GMT-11:00
v GMT-10:00
v GMT-9:00
v GMT-8:00
v GMT-7:00
v GMT-6:00
v GMT-5:00
v GMT-4:00
v GMT-3:30
v GMT-3:00
v GMT-2:00
v GMT-1:00
108 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 23. clock command (continued)
Function What it does Command Valid targets
Set advanced Sets the daylight-savings time mode clock -dst dst_mode -T system:mm[x]
management module for the advanced management
clock daylight-savings module clock. where dst_mode is one of where x is the primary
time mode the following: management-module
v off bay number.
v on
v for GMT+2:00:
– off
– ee (Eastern Europe)
– gtb (Great Britain)
– egt (Egypt)
– fle (Finland)
v for GMT+10:00:
– off
– ea (Eastern Australia)
– tas (Tasmania)
– vlad (Vladivostok)
v for GMT-9:00 to
GMT-5:00:
– off
– uc (United States and
Canada)
– other (other
locations)
v for GMT-4:00:
– off
– can (Canada)
– other (other
locations)
Daylight-savings time is
not observed in the
following GMT offsets:
GMT+4:00, GMT+4:30,
GMT+5:30, GMT+6:00,
GMT+7:00, GMT+8:00,
GMT+11:00, GMT-12:00,
GMT-11:00, and
GMT-10:00.
To display the clock information for the primary management module, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
clock
The following example shows the information that is returned from these two
commands:
system:mm[1]> clock -g +5 -dst uc
OK
system:mm[1]> clock
10/17/2006 02:27:11 GMT+5:00 dst uc
system:mm[1]>
110 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
config command
This command sets and displays the name of the advanced management module
or blade server and the location and contact name for the advanced management
module.
Table 24. config command
Function What it does Command Valid targets
Display name of blade Displays the name of the specified config -T system:blade[x]
server blade server.
where x is the blade
server bay number.
Display name of Displays the following information config -T system:mm[x]
management module for the command target:
v Name where x is the primary
v Location management-module
v Contact name bay number.
Display identifying Displays the following information config -T system
information for for the command target:
BladeCenter unit v Universally unique identifier
v Serial number
v Type/model
Set name of Sets the name of the primary config -name name -T system:mm[x]
management module or management module or specified -T system:blade[x]
blade server blade server. where name is up to 15
characters in length. where x is the primary
management-module
Blade server names cannot
or a blade server bay
contain angle brackets ("<"
number.
and ">"), and advanced
management module
names can only contain
alphanumeric characters,
hyphens, pound signs,
underscores, and periods.
Advanced management
module locations can
contain any character
other than "<" and ">".
Advanced management
module contact names can
contain any character
other than "<" and ">".
112 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 24. config command (continued)
Function What it does Command Valid targets
Set universally unique Sets the universally unique config -uuid "unique_id" -T system
identifier (UUID) for identifier for the BladeCenter unit.
BladeCenter unit Notes: where "unique_id" is 32
hexadecimal digits and is
v Change the -uuid value only if
contained within
you are certain it was not
double-quotes.
programmed correctly on the
hardware. To prevent disrupting This command can only
the operation of IBM Systems be run by users who have
Director, you should edit this one or more of the
field only if the midplane of following command
your system has been replaced authorities:
with a new midplane that does v Supervisor
not have this information v Chassis configuration
programmed on it.
v If you change the UUID on an See “Commands and user
existing system to a random new authority” on page 8 for
value, IBM Systems Director will additional information.
treat this as a new system,
distinct from the one identified
by the old UUID.
v Changes to the UUID take effect
after the next restart of the
advanced management module.
Set type/model for Sets the type or model designator config -tm "type_model" -T system
BladeCenter unit for the BladeCenter unit.
Notes: where "type_model" is up
to seven characters in
v Change the -tm value only if you
length and contained
are certain it was not
within double-quotes.
programmed correctly on the
hardware. To prevent disrupting Advanced management
the operation of IBM Systems module type / model
Director, you should edit this designators can contain
field only if the midplane of any character other than
your system has been replaced "<" and ">".
with a new midplane that does
not have this information This command can only
programmed on it. be run by users who have
v Changes to the type/model take the following command
effect after the next restart of the authorities:
advanced management module. v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
To display the management module name, location, and contact name, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
config
The following example shows the information that is returned from these two
commands:
system:mm[1]> config -name IBM_lab
OK
system:mm[1]> config
-name IBM_lab
-contact John_Doe
-loc Main_Lab
system:mm[1]>
114 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
console command
This command sets up a serial over LAN connection to the command console of a
blade server.
Esc (
Table 25. console command
Function What it does Command Valid targets
Create SOL session with Creates an SOL connection to the console -T system:blade[x]
blade server specified blade server.
Note: The advanced management This command can only where x is the blade
module supports a persistent SOL be run by users who have server bay number.
connection that remains intact until one or more of the
you escape from the SOL console, following command
or another user uses the override authorities:
option to take over your SOL v Supervisor
console. A persistent command, if v Blade remote presence
dropped, automatically attempts to See “Commands and user
reconnect. authority” on page 8 for
additional information.
Create override SOL Creates an SOL connection to the console -o -T system:blade[x]
session with blade specified blade server, with the
server override option enabled. This This command can only where x is the blade
enables you to end an existing SOL be run by users who have server bay number.
session to that blade server and one or more of the
start a new one. following command
Note: The advanced management authorities:
module supports combing this is v Supervisor
option with the -l option to v Blade remote presence
override an existing session, and See “Commands and user
not reconnect if the connection authority” on page 8 for
drops. additional information.
Create non-persistent Creates an SOL connection to the console -l -T system:blade[x]
SOL session with blade specified blade server for users
server who do not want to use a This command can only where x is the blade
persistent session. be run by users who have server bay number.
Note: This option can be combined one or more of the
with the -o option to override an following command
existing session, and not reconnect authorities:
if the connection drops. v Supervisor
v Blade remote presence
See “Commands and user
authority” on page 8 for
additional information.
116 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
dhcpinfo command
This command displays the IP configuration that is assigned by a DHCP server to
the primary management module external network interface, blade server
management network interfaces, and I/O module DHCPv6 server.
Note: The dhcpinfo command does not apply to management module channel
eth1, which always uses a static IP configuration.
Table 26. dhcpinfo command
Function What it does Command Valid targets
Display Ethernet If the IP configuration for dhcpinfo -eth0 -T system:mm[x]
channel 0 DHCP management module eth0 is
configuration for assigned by a DHCP server, the where x is the primary
management module configuration that is assigned by management-module
the DHCP server and DHCP server bay number.
information is displayed. If the IP
configuration for eth0 is not
assigned by a DHCP server, an
error message is displayed. Possible
configuration values returned are:
v -server dhcp_ip_address
v -n hostname
v -i ip_address
v -g gateway_address
v -s subnet_mask
v -d domainname
v -dns1 primary_dns_ip_address
v -dns2 secondary_dns_ip_address
v -dns3 tertiary_dns_ip_1address
v -server6 IPv6_dhcp_ip_address
v -i6 IPv6_address
v -d6 IPv6_domainname
v -dns61
IPv6_primary_dns_ip_address
v -dns62
IPv6_secondary_dns_ip_address
v -dns63
IPv6_tertiary_dns_ip_1address
Display management If the IPv6 configuration for the dhcpinfo -ethx -T system:blade[x]
network DHCP specified blade server management
configuration for blade network Ethernet channel is where x is the blade server where x is the blade
server assigned by a DHCP server, the management network server bay number.
IPv6 IP address is displayed. If the channel number to
IP configuration for the specified display.
blade server management network
Ethernet channel is not assigned by
a DHCP server, an error message is
displayed.
Display DHCP If the IPv6 configuration for the dhcpinfo -T system:switch[x]
configuration for I/O specified I/O module is assigned
module by a DHCP server, the IPv6 IP where x is the
address is displayed. If the IPv6 I/O-module bay
configuration for the I/O module is number.
not assigned by a DHCP server, an
error message is displayed.
To display the DHCP server assigned network settings that support IPv6 for
Ethernet channel 0, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
dhcpinfo -eth0
118 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
displaylog command
This command displays management-module event log entries.
Note: Event descriptions and suggested user actions for items shown by the
displaylog command can be viewed using the “eventinfo command” on page 138.
Table 27. displaylog (display management-module event log) command
Function What it does Command Valid targets
Display Displays five entries from the displaylog -T system:mm[x]
management-module management-module event log.
event log entries The first time the command is where x is the primary
executed, the five most recent log management-module
entries are displayed. Each bay number.
subsequent time the command is
issued, the next five entries in the
log display.
Display Resets the counter and displays the displaylog -f -T system:mm[x]
management-module first five most recent entries in the
event log entries (reset management-module event log. where x is the primary
counter) management-module
bay number.
Display log entries with Displays log entries with Event ID. displaylog -e -T system:mm[x]
Event ID
where x is the primary
management-module
bay number.
Display log entries with Displays log entries with their displaylog -c -T system:mm[x]
their call-home flag call-home flag.
where x is the primary
management-module
bay number.
Display all Displays all entries in the displaylog -a -T system:mm[x]
management-module management module event log.
event log entries where x is the primary
management-module
bay number.
Display all event log Displays all filters that can be used displaylog -filters -T system:mm[x]
filters to control management module
event log output. where x is the primary
management-module
bay number.
120 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 27. displaylog (display management-module event log) command (continued)
Function What it does Command Valid targets
Display event log entries Displays management module log displaylog -src -T system:mm[x]
filtered by every flag information that is stored in logs !filter_out
except the one specified other than the specified log. where x is the primary
Note: where filter_out is the management-module
v This command displays the first category of event log bay number.
five most recent entries in the entries that is not to be
management-module event log displayed. Use the
that meet the specified filter displaylog -filters
criteria. Adding the -a option to command to discover
the command displays all entries excludable event log
that meet the specified filter categories.
criteria.
v If the filter criteria entered does
not match the criteria previously
specified, this resets the counter
and displays the first five most
recent log entries that match the
specified filter criteria.
v The index number displayed for
each filtered log entry might not
match the index number shown
for the same log entry displayed
in an unfiltered list.
Display audit log entries Displays management module displaylog -src -T system:mm[x]
filtered by source audit log information that meets source_filter
the specified source filter criteria. where x is the primary
Note: where source_filter is a management-module
v This command displays the first pipe ( | ) separated list of bay number.
five most recent entries in the source filters. To specify a
management-module event log range of blade servers as
that meet the specified filter the source, use a hyphen (
criteria. Adding the -a option to - ), as follows:
the command displays all entries Blade_01-08.
that meet the specified filter
criteria.
v If the filter criteria entered does
not match the criteria previously
specified, this resets the counter
and displays the first five most
recent log entries that match the
specified filter criteria.
v The index number displayed for
each filtered log entry might not
match the index number shown
for the same log entry displayed
in an unfiltered list.
122 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example:
To display all log entries generated by the management module in bay 1 other
than those in the audit log, while the BladeCenter unit is set as the persistent
command environment, at the system> prompt, type
displaylog -src !Audit -T mm[1]
To display audit log entries generated by the management module in bay 1, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
displaylog -src Audit -T mm[1]
The following example shows the information that is returned from these
commands:
system> displaylog -src !Audit -T mm[1]
1 I SERVPROC 08/04/08 14:18:06 Recovery Event log full
2 I SERVPROC 08/04/08 14:18:06 Alarm Manager removed a MNR
alert during recovery of Event
log full
(There are no more entries in the event log.)
system> displaylog -src audit -T mm[1]
1 I Audit 08/04/08 14:28:38 Remote logoff successful for
user ’spdev’from Telnet at
IP 9.44.124.157
2 I Audit 08/04/08 14:28:18 Remote login successful for
user ’spdev’ from Telnet at
IP 9.44.124.157
3 I Audit 08/04/08 14:18:15 Audit log cleared by ’spdev’.
(There are no more entries in the event log.)
system>
Service information for the management modules includes BladeCenter VPD, the
management-module event log, connection status, and self-test results. If multiple
user interface sessions issue the displaysd command, the commands will be
processed in the order that they are received. Some types of service information are
displayed for only the primary management module.
Table 28. displaysd command
Function What it does Command Valid targets
Capture and display Capture and display service displaysd -T system:mm[x]
service information information on page from the
primary or standby management where x is the primary
module. or standby
management-module
bay number.
Display management Displays connection status and displaysd -mmstat -T system:mm[x]
module connection and latest self-test results for the
self-test status primary management module. where x is the primary
management-module
bay number.
Save service information Saves service information from displaysd -save filename -T system:mm[x]
to TFTP server primary management module with -i ipaddress
the specified filename to the where x is the primary
specified TFTP server. where: management-module
Note: The -save and -i command v filename is the location bay number.
options must be run together. where service
information will be
saved. The filename
should use a .tgz
extension to allow
support personnel to
identify the file.
v ip_address is the IPv4 or
IPv6 IP address of the
TFTP server.
Display all blade server Displays a list of the most recent displaysd -src list -T system:blade[x]
SRC records (up to 32) SRCs for the specified
blade server. where x is the blade
Note: SRC information is available serverbay number.
for only those blade servers that
support this feature.
Display specific blade Displays a specific SRC, based on displaysd -src index -T system:blade[x]
server SRC record the specified record number, for the
specified blade server. where index is the SRC where x is the blade
Note: SRC information is available record number to display, serverbay number.
for only those blade servers that between 1 and 32.
support this feature.
124 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To capture and display service information from the management
module in bay 1, while the chassis is set as the persistent command environment,
at the system> prompt, type
displaysd -T system:mm[1]
To capture service information from the management module in bay 1 and save it
to a file named sdc.tgz on a TFTP server with a IP address of 9.67.22.176, while the
chassis is set as the persistent command environment, at the system> prompt, type
displaysd -T system:mm[1] -save sdc.tgz -i 9.67.22.176
The following example shows the information that is returned from these
commands:
system> displaysd -T system:mm[1]
SPAPP Capture Available
Time: 10/04/2005 21:47:43
UUID: Not Available
•
•
•
system> displaysd -T system:mm[1] -save sdc.tgz -i 9.67.22.176
OK
system>
126 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 29. dns command (continued)
Function What it does Command Valid targets
DNS first IPv4 IP Sets the first IPv4 IP address. dns -i1 ip_address -T system:mm[x]
address - set
where ip_address is the where x is the primary
first IP address in dotted management-module
decimal IP address format. bay number.
128 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 29. dns command (continued)
Function What it does Command Valid targets
DNS server priority - set Sets the DNS server priority for the dns -p priority -T system:mm[x]
management module to IPv4 or
IPv6.. where priority is ipv4 or where x is the primary
ipv6. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
To display the DNS status of the primary management module, while management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
dns
The following example shows the information that is returned from these two
commands:
system:mm[1]> dns -i1 192.168.70.29 -on
Changes to the network settings will take effect after the next reset of the MM.
system:mm[1]> dns
Enabled
-i1 192.168.70.29
-i2 0.0.0.0
-i3 0.0.0.0
system:mm[1]>
To display the DNS status of a primary management module that supports IPv6,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
dns
130 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
env (environment) command
This command sets the persistent environment for commands that are entered
during the remainder of the current session.
The following table lists BladeCenter components and the command paths that are
supported as targets by the env command.
Table 30. Components and command paths
Component Target path
BladeCenter unit system
Management module system:mm[x]
Blade server system:blade[x]
Blade server integrated system management processor system:blade[x]:sp
(BMC or service processor)
Blade server I/O-expansion card system:blade[x]:exp[y]
Blade server management card system:blade[x]:mgmtcrd
Blade server microprocessor system:blade[x]:cpu[y]
Blade server storage expansion unit system:blade[x]:be[y]
Blade server high-speed expansion card system:blade[x]:hsec[y]
Blade server memory system:blade[x]:memory[y]
Blade server mezzanine for double-width form factor system:blade[x]:sb
Blade server concurrent KVM feature card system:blade[x]:ckvm
I/O (switch) module system:switch[x]
Power module system:power[x]
Blower system:blower[x]
Media tray system:mt[x]
Media tray battery backup unit system:mt[x]:bbu[y]
Alarm panel (BladeCenter HT only) system:tap
Multiplexer expansion module (BladeCenter HT only) system:mux[x]
Network clock module (BladeCenter HT only) system:ncc[x]
Storage module (BladeCenter S unit only) system:storage[x]
Storage module disk drive (BladeCenter S unit only) system:storage[x]:disk[y]
where x is the
management-module
bay number.
Set blade server as Sets the specified blade server as env -T system:blade[x] The env command can
command target the persistent target for commands be directed to any
during the current session. where x is the blade bay installed device, in this
that identifies the blade case
server. A blade server that
-T system:blade[x]
occupies more than one
blade bay is identified by where x is the blade
the lowest bay number bay that identifies the
that it occupies. blade server.
132 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 31. env (environment) command (continued)
Function What it does Command Valid targets
Set blade server Sets the specified sub-component env -T The env command can
sub-component as on the specified blade server as the system:blade[x]:comp be directed to any
command target persistent target for commands installed device, in this
during the current session. Valid where x is the blade bay case
sub-components are: that identifies the blade
v Integrated system management server on which the -T
processor (BMC or service sub-component is system:blade[x]:comp
processor) installed. A blade server
v I/O-expansion card that occupies more than where x is the blade
v Microprocessor one blade bay is identified bay that identifies the
v Storage expansion unit by the lowest bay number blade server on which
v High-speed expansion card that it occupies. the integrated system
v Memory management processor
v Mezzanine assembly for where comp is the is installed.
double-width form factor blade sub-component:
v sp for BMC or service where comp is the
servers
processor sub-component:
v exp[x] for v sp for BMC or
I/O-expansion card service processor
(where x identifies the v exp[x] for
expansion card) I/O-expansion card
v cpu[x] for (where x identifies
microprocessor (where x the expansion card)
identifies the v cpu[x] for
microprocessor) microprocessor
v be[x] for storage (where x identifies
expansion unit (where x the microprocessor)
identifies the expansion v be[x] for storage
unit) expansion unit
v ckvm for concurrent (where x identifies
KVM feature card the expansion unit)
v hsec[x] for high-speed v ckvm for concurrent
expansion card (where x KVM feature card
identifies the high-speed v hsec[x] for
expansion card) high-speed
v memory[x] for memory expansion card
(where x identifies the (where x identifies
memory module) the high-speed
v mgmtcrd for expansion card)
management card v memory[x] for
v sb for mezzanine memory (where x
assembly for identifies the
double-width form memory module)
factor blade servers ) v mgmtcrd for
management card
v sb for mezzanine
assembly for
double-width form
factor blade servers )
where x is the
I/O-module bay where
the I/O module is
installed.
Set power module as Sets the specified power module as env -T system:power[x] The env command can
command target the persistent target for commands be directed to any
during the current session. where x is the power installed device, in this
module bay where the case
power module is installed.
-T system:power[x]
where x is the
media-tray bay where
the media tray is
installed.
Set media tray battery Sets the specified battery backup env -T The env command can
backup unit as unit on the specified media tray as system:mt[x]:bbu[y] be directed to any
command target the persistent target for commands installed device, in this
during the current session. where x is the media tray case
on which the battery
backup unit is installed. -T
system:mt[x]:bbu[y]
where y is the battery
backup unit number: where x is the media
tray on which the
battery backup unit is
installed.
134 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 31. env (environment) command (continued)
Function What it does Command Valid targets
Set alarm panel as Sets the alarm panel as the env -T system:tap The env command can
command target persistent target for commands be directed to any
during the current session. installed device, in this
(BladeCenter HT units case
only)
-T system:tap
Set multiplexer Sets the multiplexer expansion env -T system:mux[x] The env command can
expansion module as module as the persistent target for be directed to any
command target commands during the current where x is the multiplexer installed device, in this
session. expansion module case
(BladeCenter HT units number.
-T system:mux[x]
only)
where x is the
multiplexer expansion
module number.
Set network clock Sets the network clock module as env -T system:ncc[x] The env command can
module as command the persistent target for commands be directed to any
target during the current session. where x is the network installed device, in this
clock module number. case
(BladeCenter HT units
-T system:ncc[x]
only)
where x is the network
clock module number.
Set storage module as Sets the storage module as the env -T system:storage[x] The env command can
command target persistent target for commands be directed to any
during the current session. where x is the installed device, in this
(BladeCenter S units storage-module bay where case
only) the storage module is
installed. -T system:storage[x]
where x is the
storage-module bay
where the storage
module is installed.
Set storage module disk Sets the specified disk drive in the env -T The env command can
drive as command target specified storage module as the system:storage[x]:disk[y] be directed to any
persistent target for commands installed device, in this
(BladeCenter S units during the current session. where x is the storage case
only) module on which the disk
-T system:storage[x]:
drive is installed. disk[y]
where y is the disk drive where x is the storage
number: module on which the
disk drive is installed.
To set the persistent target of commands to the service processor on the blade
server in blade bay 5, while the BladeCenter unit is set as the default command
target, at the system> prompt, you can also type
env -T blade[5]:sp
To issue the reset command on the blade server in blade bay 5, while the
management module is set as the default command target, at the system:mm[x]>
prompt, type
reset -T system:blade[5]
136 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ethoverusb command
This command sets and displays the setting for the Ethernet-over-USB command
interface of a blade server service processor, for blade servers that support this
feature.
Table 32. ethoverusb command
Function What it does Command Valid targets
Display blade server Displays the Ethernet-over-USB ethoverusb -T system:blade[x]
Ethernet-over-USB command interface setting for the
setting service processor of the specified where x is the blade
blade server. server bay number.
Note: This command will execute
only on blade servers that support
an Ethernet-over-USB command
interface for the service processor.
Set blade server Enables or disables the ethoverusb -s state -T system:blade[x]
Ethernet-over-USB Ethernet-over-USB command
setting interface setting for the service where state is enabled or where x is the blade
processor of the specified blade disabled. server bay number.
server.
Note: This command will execute This command can only
only on blade servers that support be run by users who have
an Ethernet-over-USB command one or more of the
interface for the service processor. following command
authorities:
v Supervisor
v Blade administration
See “Commands and user
authority” on page 8 for
additional information.
Example: To view the Ethernet-over-USB command interface setting for the service
processor of the blade server in bay 2, while this blade server is set as the
persistent command environment, at the system:blade[2]> prompt, type
ethoverusb
The following example shows the information that is returned from these
commands:
system:blade[2]> ethoverusb
enabled
system:blade[2]> ethoverusb -s disabled
OK
system:blade[2]> ethoverusb
disabled
system:blade[2]>
138 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 33. eventinfo command (continued)
Function What it does Command Valid targets
Display event user Displays the suggested user action eventinfo -id -u -T system:mm[x]
action for the specified event ID.
where id is the event ID where x is the primary
displayed from the management-module
“displaylog command” on bay number.
page 119.
Example: To view the event description and suggested user action for an event
with an ID of 0x00104204, while the BladeCenter unit is set as the persistent
command environment, at the system:> prompt, type
eventinfo -T mm[1] -00104204
The following example shows the information that is returned from this command:
system> eventinfo -T mm[1] -00104204
Event Description:
The primary advanced management module was reset.
Recommended Action:
Information only; no action is required.
system>
140 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 34. events command (continued)
Function What it does Command Valid targets
Remove a Call Home Removes a Call Home event from events -che -rm event_ID -T system:mm[x]
event from the Call the Call Home exclusion list.
Home Exclusion list Events removed from this list are where event_ID is where x is the primary
included in the Call Home reports. v an eight-digit management-module
Note: The Service Advisor terms hexadecimal number bay number.
and conditions must first be with an optional prefix
accepted, or the Automated of 0x or 0X to remove a
FTP/TFTP Report of Service Data single Call Home event
must be enabled before using this v all to remove all the
command. Call Home events from
the exclusion list
Example: To view the Call Home exclusion list and the number of remaining
events can be added to the list, while the BladeCenter unit is set as the persistent
command environment, at the system:> prompt, type
events -T mm[1] -che
To add Call Home event number 0x00020003 to the Call Home exclusion list, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
events -T mm[1] -che -add 0x00020003
To remove Call Home event number 0x00020001 from the Call Home exclusion list,
while the BladeCenter unit is set as the persistent command environment, at the
system> prompt, type
events -T mm[1] -che -rm 0x00020001
The following example shows the information that is returned from these
commands:
system> events -T mm[1] -che
A maximum of 20 events can be added to this exclusion list, currently
18 more events can be added.
Call Home Exclusion List is illustrated as follows:
Index Event ID
1 0x00020001
2 0x00020002
system> events -T mm[1] -che -add 0x00020003
OK
system> events -T mm[1] -che
A maximum of 20 events can be added to this exclusion list, currently
17 more events can be added.
Call Home Exclusion List is illustrated as follows:
Index Event ID
1 0x00020001
2 0x00020002
142 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
exit command
This command exits the command-line interface, terminating the current session.
Table 35. exit command
Function What it does Command Valid targets
Exit Terminates the current exit Any installed device.
command-line interface session. Note: You can also use
the Ctrl-D key
combination to end the
current session and exit
the command-line
interface.
144 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 36. feature command (continued)
Function What it does Command Valid targets
Import datacenter Import a datacenter feature feature -apply -T system:mm[x]
feature licenses licensing file for use by the file_location
BladeCenter unit. where x is the primary
where file_location is a management-module
The file name to import must qualified location for the bay number.
specify a qualified location for the license file of up to 256
licensing file that indicates the characters in length that
protocol to be used. For example, indicates the protocol to
tftp://192.168.0.1/license.csv be used (tftp, ftp, ftps,
http, or https) and
contains any character
except the percent sign (
% ) or double-quote ( ).
To remove the license for the first feature in the list, while the BladeCenter unit is
set as the persistent command environment, at the system> prompt, type
feature -T mm[1] -1 -remove
The following example shows the information that is returned from these
commands:
system> feature -T mm[1]
1. IBM BladeCenter Open Fabric Manager
-serial 2304369
License Status: Active
system> feature -T mm[1] -1 -remove
OK
system> feature -T mm[1]
1. IBM BladeCenter Open Fabric Manager
License Status: No License
system> feature -retrieve -T mm[1] tftp://10.11.20.23/IBMtest.csv
................
OK
system>
146 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
files command
This command manages files uploaded to the advanced management module.
Table 37. files command
Function What it does Command Valid targets
Display file list and free Displays a list of files and space files -T system:mm[x]
space remaining in the advanced
management module file system. where x is the primary
management-module
bay number.
Delete file Deletes a file from the advanced files -d filename -T system:mm[x]
management module file system.
Note: This command can only be where filename is a valid, where x is the primary
used to delete files: it will not existing filename of less management-module
delete directories. than 256 characters in bay number.
length.
Example: To view the files and remaining space in the management module file
system, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
files
148 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
fuelg command
This command displays power domain information, listing the power modules that
are installed in the BladeCenter unit and information about how the power in each
domain is used. This command also configures the power domain policies for
power redundancy loss and limiting fan noise during thermal events.
Note: For scripting purposes, the -qm and -os fuelg options for management
modules other than the advanced management module are supported by the
advanced management module.
Table 38. fuelg command
Function What it does Command Valid targets
Display power domain Displays health status, total power fuelg -T system
status overview usage, total dc power available,
total ac power in use, thermal
response (acoustic mode) settings,
total thermal output in BTU/hour,
and the polling intervals used for
trending for all power domains.
Note: For the BladeCenter S unit,
output will indicate whether the
chassis is running in 220 V ac or
110 V ac mode.
Display blade server Displays the power management fuelg -T system:blade[x]
power status overview and capping setting (on/off) and
power management capability for where x is the
the specified blade server. blade-server bay
Depending on the power number.
management capability of the
specified blade server, the
following information will also
display:
v CPU duty cycles
v Effective and maximum CPU
speeds
v Power capping value (minimum
and maximum)
v Maximum, minimum, and
average power levels
v Time when above data was
captured
v Power saver mode status (on,
off)
Display I/O module Displays the maximum, minimum, fuelg -T system:switch[x]
power status and average power information for
the specified I/O module. where x is the
I/O-module bay
number.
Display blower power Displays the maximum power, fuelg -T system:blower[x]
status and temperature minimum power, average power,
and current temperature where x is the blower
information for the specified bay number.
blower module.
Display media tray Displays the current temperature fuelg -T system:mt[x]
temperature for the specified media tray.
where x is the media
tray number.
150 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Set power domain Sets how the BladeCenter unit fuelg domain -pm policy -T system
redundancy loss policy responds to a condition that could
cause a loss of redundant pow where:
Note: For the BladeCenter S, v domain is:
output will indicate whether the – pd1 for power domain
chassis is running in 220 V or 110 1.
V ac mode.er. – pd2 for power domain
2.
– If no domain is
specified, the policy is
applied to all power
domains.
v policy of:
– nonred (default)
allows loss of
redundancy.
– redwoperf prevents
components from
turning on that will
cause loss of power
redundancy.
– redwperf power
throttles components
to maintain power
redundancy and
prevents components
from turning on that
will cause loss of
power redundancy.
152 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Thermal event response Sets the acoustic mode of fuelg -am setting -T system
(acoustic mode) BladeCenter-unit blowers response
to thermal events. where the acoustic-mode
setting of:
v off (default) allows
blowers to increase
speed to provide
additional cooling.
v on keeps blowers at a
fixed speed and power
throttles BladeCenter
components to reduce
power consumption
(only for BladeCenter
components that support
power throttling).
154 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Static low power saver Turns the static low power saver fuelg -ps setting -T system:blade[x]
mode - enable or disable mode for the specified blade server
for blade server on or off. where a setting of: where x is the
Notes: v off (default) disables blade-server bay
v A blade server must be turned power saver mode for number.
on before you can enable power the blade server.
saver mode for it. v on enables power saver
v Not all blade servers support the mode for the blade
power saver mode. server.
Example: To view a power domain status overview, while the BladeCenter unit is
set as the persistent command environment, at the system> prompt, type
fuelg
To view the detailed power domain status for power domain 1, while the
BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
fuelg pd1
To view BladeCenter unit power trending information for the past 6 hours, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
fuelg -pt 6
To view the power status for the blade server in blade bay 1, while the
BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
fuelg -T blade[1]
The following example shows the information that is returned from these
commands when the fuelg command is run on an advanced management module.
system> fuelg
Note: All power values are displayed in Watts.
Power Domain 1
--------------
Status: This power domain has mismatched power modules.
Replace the power module.
Modules:
Bay 1: 2880
156 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Bay 2: 3160
Power Management Policy: Basic Power Management
Power in Use: 1313 (+/- 16.0%)
Total Power: 4000
Allocated Power (Max): 1423
Remaining Power: 2577
Power Domain 2
--------------
Status: Power domain status is good.
Modules:
Bay 3: 2880
Bay 4: 2880
Power Management Policy: Basic Power Management
Power in Use: 73 (+/- 16.0%)
Total Power: 4000
Allocated Power (Max): 1082
Remaining Power: 2918
-am on
-e enterprise
-int 10
system> fuelg pd1
Maximum Power Limit: 1450
Power In Use: 856
Domain totals:
Allocated Power 856 1414 1407
-pm nonred
158 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
groups command
This command displays and configures Active Directory groups of the primary
management module. This group information is used only when LDAP servers are
enabled for authentication with local authorization.
Table 39. groups (Active Directory groups) command
Function What it does Command Valid targets
Display all Active Displays all Active Directory groups -T system:mm[x]
Directory groups groups, up to 16, configured for the
BladeCenter unit. where x is the primary
management-module
bay number.
Display specific Active Displays information for the groups -group_num -T system:mm[x]
Directory group specified Active Directory group.
where group_num is a where x is the primary
number from 1 to 16, management-module
inclusive, that identifies bay number.
the Active Directory
group.
Set Active Directory Sets a name for the specified Active groups -group_num -n -T system:mm[x]
group name Directory group. group_name
where x is the primary
where: management-module
v group_num is a number bay number.
from 1 to 16, inclusive,
that identifies the Active
Directory group.
v group_name is a
alphanumeric string up
to 63 characters in
length that can include
periods ( . ) and
underscores ( _ ). Each
of the 16 group names
must be unique.
160 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 39. groups (Active Directory groups) command (continued)
Function What it does Command Valid targets
Set Active Directory where the scope is one or
group authority level more of the following
devices, separated by a
(continued) vertical bar ( | ). Ranges
of devices are separated
by a dash ( - ).
v cn (Chassis n, where n
is 1 for the Active
Directory environment.)
v bn (Blade n, where n is
a valid blade bay
number in the chassis)
v sn (I/O module n,
where n is a valid I/O
module bay number in
the chassis)
The following example shows the information that is returned from these
commands:
system:mm[1]> groups -3 -n group3 -a rbs:super:c1|b1-b14|s1-s4
OK
system:mm[1]> groups -3
-n group3
-a Role:supervisor
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14
Chassis:1
Modules:1|2|3|4
system:mm[1]>
162 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
health command
This command displays the current health status of the command target. It can
also be used to display the alerts that are active for the command target.
You can only specify one command target each time you run the health command.
Table 40. health command
Function What it does Command Valid targets
Display health status Displays the current health status health -T system
of the command target. Return -T system:mm[x]
values are different for the
-T system:blade[x]
BladeCenter and BladeCenter T
configurations. -T system:switch[x]
v Possible return values for the -T system:power[x]
BladeCenter configuration are: -T system:blower[x]
– ok
– warning -T system:storagex]
(for BladeCenter
– critical
S units)
v Possible return values for the
BladeCenter T configurations are: where x is the primary
– ok management-module,
– minor blade server, I/O
– major module, power
– critical module, blower bay, or
storage bay number.
Display health status for Displays the current health status health -l depth -T system
tree of the tree structure of devices -T system:mm[x]
present in the BladeCenter unit, where depth
-T system:blade[x]
starting at the command target v 1 displays health status
level. If management-module bays of the current command -T system:switch[x]
are part of the tree, they will be target -T system:power[x]
identified as primary or standby v 2, all, or a displays a -T system:blower[x]
(redundant). Return values are full tree display, starting
different for the BladeCenter and at the command target where x is the primary
BladeCenter T configurations. level management-module,
v Possible return values for the blade server, I/O
BladeCenter configuration are: module, power
– ok module, or blower bay
– warning number.
– critical
v Possible return values for the
BladeCenter T configurations are:
– ok
– minor
– major
– critical
Example: To display the overall health status of the BladeCenter T unit, while the
BladeCenter T unit is set as the default command target, at the system> prompt,
type
health
To display the health status of all components installed in the BladeCenter T unit,
that are valid command targets, while the BladeCenter T unit is set as the default
command target, at the system> prompt, type
health -l a
To display the health status of the blade server installed in blade bay 5, while the
BladeCenter T unit is set as the default command target, at the system> prompt,
type
health -T system:blade[5]
164 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
To display the health status and alerts for all components installed in the
BladeCenter T unit, that are valid command targets, while the BladeCenter T unit
is set as the default command target, at the system> prompt, type
health -l a -f
The following example shows the information that is returned from these
commands:
system> health
system:major
system> health -l a
system: Major
mm[1] : OK
blade[1] : OK
blade[3] : OK
blade[5] : Minor
power[1] : OK
power[2] : Minor
blower[1] : OK
blower[2] : OK
blower[3] : OK
blower[4] : OK
switch[1] : Major
system> health -T system:blade[5]
system: blade[5] : Minor
system> health -l a -f
system: Major
blade[5] : Minor
5V over voltage
CPU1 temperature warning
power[2] : Minor
5V over voltage
switch[1] : Major
temperature fault
system>
You can also issue the help command by typing ?. Adding a -h, -help, or ? option
to a command displays syntax help for the command.
Table 41. help command
Function What it does Command Valid targets
Help Displays a list of commands and a help Any installed device.
brief description of each command.
? Any installed device.
166 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ldapcfg -- View/edit LDAP config
led -- Display and control Leds
list -- Display installed targets
mcad -- Displays and configures MCAD
modactlog -- Displays module activity log
monalerts -- Displays and configures monitored alerts
mt -- Controls the media tray owner
nat -- Display and configure NAT
ntp -- View/edit NTP config
ping -- Pings targeted switch module
pmpolicy -- View/edit power management policy settings
portcfg -- Serial port configuration
ports -- Port configuration
power -- Control target power
rdoc -- Controls the remote DiskOnCard
read -- Restore configuration from the chassis or a file
remotechassis -- Chassis discovered over the network
reset -- Reset target
scale -- Display and configure the settings of scalable complexes
sddump -- Initiate service data dump
sdemail -- Send service information using email
security -- View/edit security config
service -- Enable debugging by service personnel
shutdown -- Shutdown target
slp -- View/edit SLP parameters
smtp -- View/edit SMTP config
snmp -- View/edit SNMP config
sol -- View SOL status and view/edit SOL config
sshcfg -- View/edit SSH config
sslcfg -- View/edit SSL config
syslog -- View/edit syslog config
tcpcmdmode -- View/edit TCP command mode config
telnetcfg -- View/edit telnet config
temps -- View temperatures
trespass -- View/edit trespassing warning config
uicfg -- View/edit user interface configuration
update -- Update firmware from remote location
uplink -- View/edit failover on network uplink loss config
users -- View/edit user login profiles
volts -- View voltages
write -- Save configuration to chassis or a local file
zonecfg -- Zone configuration for I/O modules
To obtain help about the env command, type one of the following commands:
v env -h
v env -help
v env ?
You choose the command to re-enter from the displayed list by typing an
exclamation point (!) followed immediately by the numeric designation the
command is assigned in the list. You can also recall one of the past eight
previously entered commands using the up-arrow and down-arrow keys.
Table 42. history command
Function What it does Command Valid targets
Command history Displays the last eight commands history Any installed device.
that were entered.
Re-enter previous Re-enters a numerically-specified !x Any installed device.
command using numeric command from the command
designation history. where x is the number of
the command (0 - 7) to
re-enter from the
command history list.
Example: To display a list of the last eight commands entered, while management
module 1 is set as the default command target, at the system:mm[1]> prompt, type
history
The following example shows the information that is returned from these two
commands:
system:mm[1]> history
0 dns
1 dns -on
2 dns
3 dns -i1 192.168.70.29
4 dns
5 dns -i1 192.168.70.29 -on
6 dns
7 history
system:mm[1]> !2
Enabled
-i1 192.168.70.29
-i2 0.0.0.0
-i3 0.0.0.0
system:mm[1]>
168 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
identify (location LED) command
This command controls operation of the location LED in a blade server or in the
BladeCenter unit. It can also be used to display the state of a location LED.
Table 43. identify (location LED) command
Function What it does Command Valid targets
Display location LED Displays the current state of the identify -T system
state location LED in the command
-T system:blade[x]
target.
where x is the blade
Possible LED states are:
bay number.
v off
v on
v blink
Set location LED state Sets the state of the location LED in identify -s state -T system
the command target.
where state is -T system:blade[x]
v on
where x is the blade
v off
bay number.
v blink
To light the location LED in the blade server in blade bay 4, while the BladeCenter
unit is set as the persistent command environment, at the system> prompt, type
identify -s on -T system:blade[4]
The following example shows the information that is returned from a series of
identify commands:
system> identify -T system:blade[4]
-s off
system> identify -s on -T system:blade[4]
OK
system> identify -T system:blade[4]
-s on
system>
170 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ifconfig command
This command configures and displays the network interface settings for the
management-module Ethernet interface, I/O-module Ethernet interface, and the
blade server integrated system management processors and installed options.
Table 44. ifconfig command
Function What it does Command Valid targets
Display primary Displays the current configuration ifconfig -eth0 -T system:mm[x]
management module of Ethernet channel 0 for the
Ethernet channel 0 primary management module. where x is the primary
configuration Possible return values are: management-module
v enabled bay number.
v disabled
v -i static_ip_address (dotted
decimal IPv4 IP address format)
v -g gateway_address (dotted
decimal IPv4 IP address format)
v -s subnet_mask (dotted decimal
IPv4 IP address format)
v -n hostname
v -c config_method
v -r data_rate
v -d duplex_mode
v -m mtu
v -l locally_administered_mac_addr
v -b burnedin_mac_address
v -dn domain_name
v -ipv6 ipv6_state
v -ipv6static static_ipv6_state
v -i6 static_ip_address (IPv6 format)
v -p6 address_prefix_length
v -g6 gateway-default_route
v -dhcp6 dhcpv6_state
v -sa6 ipv6_stateless_autoconfig_state
172 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management module Sets the IPv4 static IP address for ifconfig -eth0 -i -T system:mm[x]
Ethernet channel 0 static Ethernet channel 0 for the ip_address
IP address (IPv4) management module. where x is the primary
Note: Changes made to the IP where ip_address is the management-module
configuration of the primary static IP address for bay number.
management module take effect Ethernet channel 0 in
after the next reset of the primary dotted decimal IP address
management module. format.
174 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management module Sets the IPv4 subnet mask for ifconfig -eth0 -s -T system:mm[x]
Ethernet channel 0 Ethernet channel 0 for the sub_mask
subnet mask (IPv4) management module. where x is the primary
Note: Changes made to the IP where sub_mask is the management-module
configuration of the primary subnet mask for Ethernet bay number.
management module take effect channel 0 in dotted
after the next reset of the primary decimal IP address format.
management module.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set management module Sets the host name for Ethernet ifconfig -eth0 -n -T system:mm[x]
Ethernet channel 0 channel 0 for the management hostname
hostname module. where x is the primary
Note: Changes made to the IP where hostname is the host management-module
configuration of the primary name for Ethernet channel bay number.
management module take effect 0. The hostname can be a
after the next reset of the primary string up to 63 characters
management module. in length that includes
alphanumeric characters,
hyphens, and underscores.
176 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management module Sets the data rate for Ethernet ifconfig -eth0 -r -T system:mm[x]
Ethernet channel 0 data channel 0 for the management data_rate
rate module. where x is the primary
where data_rate is management-module
v auto bay number.
v 10
v 100
178 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management module Sets the domain name for Ethernet ifconfig -eth0 -dn -T system:mm[x]
Ethernet channel 0 channel 0 for Ethernet channel 0 for domain
domain name the management module. where x is the primary
Note: Changes made to the IP where domain is an management-module
configuration of the primary alphanumeric string up to bay number.
management module take effect 127 characters in length.
after the next reset of the primary The domain name must
management module. contain at least one dot (.).
180 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Display primary Displays the current configuration ifconfig -eth1 -T system:mm[x]
management module of Ethernet channel 1 for the
Ethernet channel 1 primary management module. where x is the primary
configuration Possible return values are: management-module
v up (enabled) bay number.
v down (disabled)
v -i static_ip_address (dotted
decimal IPv4 IP address format)
v -g gateway_address (dotted
decimal IPv4 IP address format)
v -s subnet_mask (dotted decimal
IPv4 IP address format)
v -r data_rate
v -d duplex_mode
v -m mtu
v -l locally_administered_mac_addr
v -b burnedin_mac_address
Set management module Sets the static IP address (IPv4) for ifconfig -eth1 -i -T system:mm[x]
Ethernet channel 1 static Ethernet channel 1 for the ip_address
IP address (IPv4) management module. where x is the primary
Note: Changes made to the IP where ip_address is the management-module
configuration of the primary static IP address for bay number.
management module take effect Ethernet channel 1 in
after the next reset of the primary dotted decimal IP address
management module. format.
182 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management module Sets the MTU (maximum ifconfig -eth1 -m mtu -T system:mm[x]
Ethernet channel 1 MTU transmission unit) for Ethernet
channel 1 for the management where mtu is between 60 where x is the primary
module. and 1500, inclusive. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set management module Sets the locally administered MAC ifconfig -eth1 -l address -T system:mm[x]
Ethernet channel 1 static address to the specified MAC
MAC address (locally address for Ethernet channel 1 for where address is the locally where x is the standby
administered) the management module. administered MAC management-module
Note: Changes made to the IP address for Ethernet bay number.
configuration of the primary channel 1. The MAC
management module take effect address is 6 bytes in
after the next reset of the primary length, hexadecimal,
management module. separated by colons. The
MAC address can not be a
multicast address (the first
byte must be even).
184 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disable cKVM Enable or disable cKVM feature for ifconfig -ckvm state -T system:blade[x]
feature for blade server the specified blade server.
Note: The cKVM feature requires where state is enabled or where x is the
special hardware and is not disabled. blade-server bay
available for all blade servers. number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
Set blade server Ethernet Sets the IPv4 static IP address for ifconfig -ethx -i -T system:blade[x]
channel static IP address the specified Ethernet channel of ip_address
(IPv4) the specified blade server. where x is the
Note: This command will run only where: blade-server bay
if the target blade server supports v x is the NIC number. number.
manual configuration of its v ip_address is the static IP
management network interface. address for Ethernet
channel x in dotted
decimal IP address
format.
186 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set blade server Ethernet Sets the IPv6 gateway/default ifconfig -ethx -g6 -T system:blade[x]
channel gateway/default route for the specified Ethernet ip_address -id id
route (IPv6) channel of the specified blade where x is the
server. where: blade-server bay
Note: v x is the NIC number. number.
v This command will run only if v ip_address is the
the target blade server supports gateway/default route
manual IPv6 configuration of its for Ethernet channel x
management network interface.. in IPv6 format.
v A static IPv6 configuration ID is v id is the static IPv6
required for network interfaces configuration ID.
that support more than one static
configuation. This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
Set blade server Ethernet Sets the IPv4 subnet mask for the ifconfig -ethx -s -T system:blade[x]
channel subnet mask specified Ethernet channel of the sub_mask
(IPv4) specified blade server. where x is the
Note: This command will run only where: blade-server bay
if the target blade server supports v x is the NIC number. number.
manual configuration of its v sub_mask is the subnet
management network interface. mask for Ethernet
channel x in dotted
decimal IP address
format.
188 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set state for blade server Enables or disables the VLAN ID ifconfig -ethx -ve state -T system:blade[x]
Ethernet channel VLAN for the specified Ethernet channel
ID of the specified blade server. where: where x is the
Note: This command will run only v x is the NIC number. blade-server bay
if the target blade server supports v state is enable or number.
manual configuration of its disable.
management network interface.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
Set blade server Ethernet Sets the host name for the specified ifconfig -ethx -n -T system:blade[x]
channel hostname Ethernet channel of the specified hostname
blade server. where x is the
Note: This command will run only where: blade-server bay
if the target blade server supports v x is the NIC number. number.
manual configuration of its v hostname is the host
management network interface. name. The hostname
can be a string up to 63
characters in length that
includes alphanumeric
characters, hyphens,
and underscores.
190 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disable Enable or disable static DHCPv6 ifconfig -ethx -dhcp6 -T system:blade[x]
DHCPv6 for blade for the specified Ethernet channel state
server interface of the specified blade where x is the
server. where: blade-server bay
Note: This command will run only v x is the NIC number. number.
if the target blade server supports v state is enabled or
manual IPv6 configuration of its disabled.
management network interface.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable IPv6 Enable or disable IPv6 stateless ifconfig -ethx -sa6 state -T system:blade[x]
stateless auto-configuration for the specified
auto-configuration for Ethernet channel interface of the where: where x is the
blade server specified blade server. v x is the NIC number. blade-server bay
Note: This command will run only v state is enabled or number.
if the target blade server supports disabled
manual IPv6 configuration of its
management network interface. This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
Set blade server ISMP Sets the IPv4 static IP address for ifconfig -i ip_address -T system:blade[x]:sp
static IP address (IPv4) the integrated system management
processor (ISMP) of the specified where ip_address is the where x is the
blade server. static IP address for the blade-server bay
Note: This command will run only blade server ISMP in number.
if the target blade server supports dotted decimal IP address
manual configuration of its format.
management network interface.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
192 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disable global Enable or disable cKVM feature ifconfig -ckvm state -T system
cKVM feature for globally for the BladeCenter unit.
BladeCenter unit (This is the same as running the where state is enabled or
ifconfig -ckvm enable command disabled.
directed to each blade server.)
Note: The cKVM feature requires This command can only
special hardware and is not be run by users who have
available for all blade servers. one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Display network settings Displays network settings for the ifconfig -T system:switch[x]
for I/O module specified I/O module. Valid return
values are: where x is the
v I/O-module type I/O-module bay
v -i ip_address (dotted decimal IPv4 number.
IP address format)
v -s subnet_mask (dotted decimal
IPv4 IP address format)
v -g gateway_address (dotted
decimal IPv4 IP address format)
v -em ext_mgt_status
v -ep ext_port_status
v -pm enabled/disabled (protected
mode)
v -pip enabled/disabled
v -c config_method
v -ipv6 ipv6_state
v -ipv6static static_ipv6_state
v -i6 static_ip_address (IPv6 format)
v -p6 address_prefix_length (IPv6
format)
v -g6 gateway-default_route (IPv6
format)
v -dhcp6 dhcpv6_state
v -sa6 ipv6_stateless_autoconfig_state
194 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set I/O-module gateway Sets the IPv6 gateway/default ifconfig -g6 ip_address -T system:switch[x]
IP address (IPv6) route for the specified I/O module.
where ip_address is the where x is the
gateway IP address for the I/O-module bay
I/O module in IPv6 number.
format.
196 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disable Enables or disables protected mode ifconfig -pm state -T system:switch[x]
protected mode for I/O for the specified I/O module.
module where state is enabled or where x is the
disabled. I/O-module bay
number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v I/O module
configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable IPv6 Enable or disable IPv6 addressing ifconfig -ipv6 state -T system:switch[x]
addressing for I/O for the specified I/O module.
module where state is enabled or where x is the
disabled. I/O-module bay
number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v I/O module
configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable static Enable or disable static IPv6 ifconfig -ipv6static -T system:switch[x]
IPv6 configuration for configuration for the specified I/O state
I/O module module. where x is the
where state is enabled or I/O-module bay
disabled. number.
198 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set IP addresses for Sets IPv4 IP addresses for RAID ifconfig -i ip_address_a -T system:switch[x]
RAID controller and controller and SAS system. -ir ip_address_b
SAS system (IPv4) where x is the RAID
where controller bay number.
(BladeCenter S units v ip_address_a is the IP
only) address of the specified
SAS system in dotted
decimal IP address
format.
v ip_address_b is the IP
address of the
associated RAID
controller in dotted
decimal IP address
format.
Example:
To display the configuration for Ethernet channel 0, that does not support IPv6,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
ifconfig -eth0
To set the IPv4 static IP address for Ethernet channel 0 to 192.168.70.133, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
ifconfig -eth0 -i 192.168.70.133 -c static
To set the IPv4 IP addresses for the BladeCenter S SAS subsystem to 9.186.10.16
and the IPv4 IP address for the RAID controller to 9.186.10.17, while switch
module 3 is set as the persistent command environment, at the system:switch[3]>
prompt, type
ifconfig -i 9.186.10.16 -ir 9.186.10.17
200 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
To set the IPv4 gateway address for the BladeCenter S SAS subsystem to 9.186.10.1
and the IPv4 gateway address for the RAID controller to 9.186.11.1, while switch
module 3 is set as the persistent command environment, at the system:switch[3]>
prompt, type
ifconfig -g 9.186.10.1 -gr 9.186.11.1
The following example shows the information that is returned from these
commands:
system:mm[1]> ifconfig -eth0
Enabled
-i 10.10.10.10
-g 0.0.0.0
-s 255.255.255.0
-n MM00096BCA0C80
-c Try DHCP server. If it fails, use static IP config.
-r Auto
-d Auto
-m 1500
-l 00:00:00:00:00:00
-b 00:09:6B:CA:0C:80
system:mm[1]> ifconfig -eth0 -i 192.168.70.133 -c static
Changes to the network settings will take effect after the next reset of the MM.
system:mm[1]>
system:switch[3]>ifconfig -i 9.186.10.16 -ir 9.186.10.17
OK
system:switch[3]>ifconfig -g 9.186.10.1 -gr 9.186.11.1
OK
system:mm[1]>
To display the configuration for Ethernet channel 0, that supports IPv6, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
ifconfig -eth0
The following example shows the information that is returned from these
commands:
system:mm[1]> ifconfig -eth0
Enabled
-i 10.13.3.230
-g 10.13.1.1
-s 255.255.0.0
-n primaryAMM
-c static
-r auto
-d auto
-m 1500
-l 00:00:00:00:00:00
-b 00:14:5E:DF:0F:CE
-dn primaryAMM.com
-ipv6 enabled
-ipv6static disabled
-i6 6::6
-p6 1
-g6 ::
-dhcp6 enabled
-sa6 enabled
Link-local address: fe80::214:5eff:fedf:fce
Stateless auto-config IP Addresses Prefix Length
--------------------------------------- -------------
202 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
info (configuration information) command
This command displays information about BladeCenter components and their
configuration, and how to reload the component information.
Table 45. info (configuration information) command
Function What it does Command Valid targets
Display component Displays identification and info -T system
information configuration information for the -T system:mm[x]
command target. Note: Only one target at a
time can be viewed with -T system:blade[x]
the info command. -T system:blower[x]
-T system:ncc[x]
-T system:mux[x]
-T system:tap
-T system:blade[x]:
exp[y]
-T system:blade[x]:
mgmtcrd
-T system:blade[x]:sp
-T system:blade[x]:
be[y]
-T system:blade[x]:
be[y]:exp[z]
-T system:blade[x]:
be[y]:hsec[z]
-T system:blade[x]:sb
-T system:blade[x]:
cpu[y]
-T system:blade[x]:
memory[y]
-T system:blade[x]:
hsec[y]
-T system:blade[x]:ckvm
-T system:switch[x]
-T system:power[x]
-T system:mt[x]
-T system:mt[x]:
bbu[y]
-T system:storage[x]
-T system:storage[x]:
disk[y]
204 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Notes:
1. The command target -T system:blade[x]:exp[y] is shown with a line break
before the :exp[y]. When this command target is entered, the entire entry must
all be on one line.
2. This command returns vital product data (VPD) information that is unique for
each command target. For some targets, additional VPD information is
available when using the advanced management module.
3. Even if the command target is specified, the -reload option acts globally,
reloading information not just for the specified target but for all targets in the
corresponding category; for example, all MAC addresses are reloaded for all
targets when the command is info -reload mac with system:blade[x] as the
target.
The following example shows the information that might be returned from the info
command:
system:mm[1]> info
Name: AMM_KP
Manufacturer: Not Available (Not Available)
Manufacturer ID: 288
Product ID: 1
Mach type/model: Management Module
Mach serial number: Not Available
Manuf date: 3005
Hardware rev: 51
Part no.: 26R099000000
FRU no.: 25R5777
FRU serial no.: 0J1U9E584130
CLEI: Not Available
AMM firmware
Build ID: BPET30U
File name: CNETCMUS.PKT
Rel date: 08-09-07
Rev: 30
AMM firmware (Flashed - pending restart)
Build ID: BPET30x
File name: CNETCMUS.PKT
Rel date: 09-09-08
Rev: 30
system:mm[1]>
Example: To view I/O module compatibility information for all blade servers and
I/O modules, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
iocomp -T system
To view I/O module compatibility information for the blade server in blade bay 1,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
iocomp -T system:blade[1]
To view I/O module compatibility information for the I/O module in bay 2, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
iocomp -T system:switch[2]
The following example shows the information that is returned from these
commands:
system:mm[1]> iocomp -T system
Blades
1 xPert1 OK
2 xPert2 OK
3 Development OK
4 Marketing OK
5 xpert3 OK
6 Sales OK
7 xPert4 OK
9 xPert5 OK
11 Finance OK
12 HR OK
13 xPert6 OK
14 xPert7 OK
I/O Modules
1 OK
2 OK
3 OK
4 OK
206 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
system:mm[1]> iocomp -T system:blade[1]
Bay Power Fabric Type Fabric on Blade Compt
------- ------- ---------------------- --------------- -------
IOM 1 On Ethernet Switch Module Ethernet OK
IOM 2 On Ethernet Switch Module Ethernet OK
system:mm[1]> iocomp -T system:switch[1]
Bay Power Fabric Type Compat
---------- ------- -------------- ----------
Blade 1 On Ethernet OK
Blade 2 On Ethernet OK
Blade 3 On Ethernet OK
Blade 4 On Ethernet OK
Blade 5 Off Ethernet OK
Blade 6 On Ethernet OK
Blade 7 On Ethernet OK
n/a No Fabric
Blade 9 On Ethernet OK
Ethernet OK
Blade 11 On Ethernet OK
Blade 12 On Ethernet OK
Blade 13 On Ethernet OK
Blade 14 On Ethernet OK
system:mm[1]>
208 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example:
To set the KVM owner to the blade server in blade bay 1, while management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
kvm -T system -b 1
To display the KVM owner and global local KVM switching state for all blade
servers, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
kvm -T system
The following example shows the information that is returned from these two
commands:
system:mm[1]> kvm -T system -b 1
OK
system:mm[1]> kvm -T system
-b 1
-local enabled
system:mm[1]>
210 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Set LDAP server Sets the method to use for ldapcfg -server method -T system:mm[x]
discovery method discovering LDAP servers that
provide user authentication. where method is: where x is the primary
Note: v dns for dynamic management-module
v If the dns method is specified, discovery bay number.
the following values must also v preconf to use an LDAP
be set: server that was
– A domain source using the manually
-ds command option. pre-configured
– A service name using the -sn
command option. This command can only
– A search domain must be set be run by users who have
using the -sd command one or more of the
option. following command
v If the preconf method is authorities:
specified, the following values v Supervisor
must also be set: v Chassis configuration
– An LDAP server hostname or See “Commands and user
IP address using the -i1, -i2, authority” on page 8 for
and -i3 command options. additional information.
– A port for each LDAP server
hostname or IP address using
the -p1, -p2, and -p3
command options.
Set LDAP server domain Sets the search domain to use for ldapcfg -dn domain -T system:mm[x]
name Domain Controller (DC) dynamic
discovery. where domain is an where x is the primary
alphanumeric string up to management-module
31 characters in length. bay number.
212 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Fourth LDAP server host Checks syntax and sets the fourth ldapcfg -i4 -T system:mm[x]
name or IP address - set LDAP server host name or IP hostname/ip_address
address to use for pre-configured where x is the primary
LDAP server discovery. where hostname/ip_address management-module
Note: A port for this LDAP server is the fourth host name or bay number.
hostname or IP address must be set IP address.
using the -p4 command option.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
First LDAP server port Sets the port number of the first ldapcfg -p1 port -T system:mm[x]
number - set LDAP server to use for
pre-configured LDAP server where port is from 1 to where x is the primary
discovery. 65535, inclusive. If you management-module
enter a value outside this bay number.
range, an error will be
displayed.
214 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Set LDAP UID search Sets the UID search attribute that ldapcfg -usa "UID" -T system:mm[x]
attribute represents the user IDs stored on
the LDAP server. where "UID" is up to 23 where x is the primary
characters in length and management-module
On Active Directory servers, the contained within bay number.
UID search attribute is typically set double-quotes. The UID
to "sAMAccountName". On Novell can contain only letters,
eDirectory and OpenLDAP servers, numbers, spaces, and the
it is typically set to "uid". following characters: "-",
"(", ")", "+", ",", ".", "/", ":",
and"?".
216 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Set LDAP group filter Sets the group filter for the ldapcfg -gf "filter" -T system:mm[x]
management module that can be
used for authentication during where "filter" is a where x is the primary
LDAP server login. quote-delimited string of management-module
up to 511 characters in bay number.
length and consists of one
or more group names. The
colon (:) character is used
to delimit multiple group
names. Leading spaces
and trailing spaces are
ignored. Other spaces are
treated as part of the
group name. The wildcard
character (*) is not
supported for security
reasons. A group name
can be specified as a full
domain name or by using
the common name (cn)
portion.
Note: The -ds, -sd, and -sn options for the ldapcfg command have been deleted
and replaced by the -dn and -fn command options. To implement this transition,
the items specified for dynamic discovery have changed and must be modified to
match the syntax required by the new command options.
Example:
To enable the authentication mode to use the LDAP server for authentication only
with local authorization, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
ldapcfg -aom enabled
The following example shows the information that is returned from these two
commands:
system:mm[1]> ldapcfg
-server preconf
Parameters for ’-server dns’ configuration:
-dn
-fn test_fn
Parameters for ’-server preconf’ configuration:
-i1
-p1
-i2
-p2
-i3
-p3
-i4 192.168.1.23
-p4 11
Miscellaneous Parameters:
-rd 11
-usa
-bm cc
-aom enabled
218 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Parameters for ’-bm cc’ configuration:
-cd
-v v1
Parameters for ’-v v1’ configuration:
-gf
-gsa
-lpa
Parameters for ’-v v2’ configuration:
-t
system:mm[1]> ldapcfg -aom enabled
OK
system:mm[1]>
220 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 49. led command (continued)
Function What it does Command Valid targets
Display LED state for Displays the state of all LEDs on led -l -T system:blade[x]
blade server and all the specified blade server and its
sub-components subcomponents. Possible return where x is the blade
values are: server number.
v on
v off
v blink
Turn off information Turns off the information LED, that led -info off -T system
LED is on the BladeCenter unit and -T system:blade[x]
some components, for the specified This command can only
command target be run by users who have -T system:ncc[x] (for
one or more of the BladeCenter HT units
following command only)
authorities:
v Supervisor -T system:mux[x] (for
v Chassis account BladeCenter HT units
management (for only)
BladeCenter unit, -T system:mt[x]
network clock module,
multiplexer expansion where x is the blade
module, or media tray) server, network clock
v Chassis log module, multiplexer
management (for expansion module, or
BladeCenter unit, media tray number.
network clock module,
multiplexer expansion
module, or media tray)
v Chassis administration
(for BladeCenter unit,
network clock module,
multiplexer expansion
module, or media tray)
v Chassis configuration
(for BladeCenter unit,
network clock module,
multiplexer expansion
module, or media tray)
v Blade administration
(for blade server)
v Blade configuration (for
blade server)
v Blade remote presence
(for blade server)
See “Commands and user
authority” on page 8 for
additional information.
222 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 49. led command (continued)
Function What it does Command Valid targets
Turn on location LED Turns on the location LED, that is led -loc on -d time -T system
for specified period of on the BladeCenter unit and some
time blade servers, for a specified period where time is the number
of time before turning it off of seconds the location
automatically. LED will remain lit.
Example: To display the failure LED status for the blade server in bay 1, while the
BladeCenter HT unit is set as the persistent command environment, at the system>
prompt, type
led -T system:blade[1]
To display status of the front-panel LEDs for the blade server in bay 1, while the
BladeCenter HT unit is set as the persistent command environment, at the system>
prompt, type
led -T blade[1]
To display status of all LEDs for the blade server in bay 1, while the BladeCenter
HT unit is set as the persistent command environment, at the system> prompt,
type
led -l -T blade[1]
The following example shows the information that is returned from these
commands:
system> led -T blade[1]
hs21_345678
Error: off
Information: off
KVM: off
MT: off
Location: blink
system> led -T blade[1] -l
Component Label State Location
Processor1 CPU1 Off System board
Processor2 CPU2 Off System board
Blade1 Fault Off Front panel
Blade2 Information Off Front panel
Blade3 Location Blink Front panel
Blade4 Power On Front panel
KVM Off Front panel
Blade5 Media Tray Off Front panel
224 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
list (system physical configuration) command
This command displays a list of devices present within the command target. It can
be used to determine how many management modules are installed in the
BladeCenter unit and which management module is set as primary.
Table 50. list (system physical configuration) command
Function What it does Command Valid targets
View command target Displays the current command list Any installed device.
target. If a management-module
bay is the current command target,
it will be identified as primary or
standby (redundant).
View system Displays the tree structure of list -l depth Any installed device.
configuration tree devices present in the BladeCenter
unit, starting at the command where depth is
target level. If management-module v all or a for full tree
bays are part of the tree, they will display, starting at the
be identified as primary or standby command target level
(redundant). For components that v 1 to display the current
have been assigned a name, this command target
name will be displayed next to the v 2 displays the content of
component bay number. the current command
target plus one level
below it
Example: To display a list of devices installed in the BladeCenter unit, while the
BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
list -l a
(This is the command syntax that can be used to determine the primary
management module.)
The following example shows the information that is returned when the command
is run on an advanced management module:
system> list -l a
system
mm[1] primary
mm[2] standby
power[1]
power[2]
power[3]
power[4]
blower[1]
blower[2]
switch[1]
switch[2]
switch[3]
switch[4]
blade[1] Accounting
sp
cpu[1]
cpu[2]
blade[2] HR
sp
cpu[1]
cpu[2]
blade[3] Development
sp
Note: The BladeCenter S unit supports one management module. The list
command for this unit does not refer to primary and standby management
modules.
226 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
mcad command
This command configures and displays the auto-discovery setting for the
BladeCenter unit management channel.
Note: See the BladeCenter Advanced Management Module User's Guide for additional
information about management channel auto discovery.
Table 51. mcad command
Function What it does Command Valid targets
Display management Displays the auto-discovery setting mcad -T system:mm[x]
channel auto-discovery for the BladeCenter unit
status for BladeCenter management channel. Valid states where x is the primary
unit include: management-module
v Enabled bay number.
v Disabled
Enable / disable Enable or disable management mcad -e state -T system:mm[x]
management channel channel auto-discovery for the
auto-discovery for BladeCenter unit. where state is enabled or where x is the primary
BladeCenter unit disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
To enable management channel auto-discovery for the BladeCenter unit, while the
BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
mcad -T mm[1] -e enabled
The following example shows the information that is returned from these
commands:
system> mcad -T mm[1]
-e disabled
system> mcad -T mm[1] -e enabled
OK
system>
Example: To view the list of modules installed in all blade servers, along with their
activity and VPD information, while the BladeCenter unit is set as the default
command target, at the system> prompt, type
modactlog
The following example shows the information that is returned from this command:
system> modactlog
Bay Name FRU Number FRU Serial No Manuf. ID Action Timestamp
--- ----------------------------- ------------ ------------- --------- ------- -------------------
14 Fibre Channel Expansion Card 59P6624 J1RJH3CY18N SLRM Added 15:51:18 02/09/2007
11 cKVM card 13N0842 YK328064418F IBM Added 15:51:07 02/09/2007
system>
Note: The BladeCenter S unit will also display information about the Direct Serial
Attach Module and the storage modules.
228 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
monalerts command
This command displays and configures alerts that are monitored by the advanced
management module.
230 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state for Enables or disables monitoring of monalerts -ccsm state -T system:mm[x]
chassis or system chassis or system management
management critical critical alerts. where state is enabled or where x is the primary
alerts disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -ccd state -T system:mm[x]
cooling device critical cooling device critical alerts.
alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -cpm state -T system:mm[x]
power module critical power module critical alerts.
alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
232 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state for Enables or disables monitoring of monalerts -wstg state -T system:mm[x]
storage-module warning storage-module warning alerts.
alerts where state is enabled or where x is the primary
disabled. management-module
(BladeCenter S units bay number.
only) This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -wcsm state -T system:mm[x]
chassis or system chassis or system management
management warning warning alerts. where state is enabled or where x is the primary
alerts disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -wel state -T system:mm[x]
event log warning alerts event log warning alerts.
where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
234 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state for Enables or disables monitoring of monalerts -ib state -T system:mm[x]
blade device blade device informational alerts.
informational alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -iiom state -T system:mm[x]
I/O-module I/O-module informational alerts.
informational alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -istg state -T system:mm[x]
storage-module storage-module informational
informational alerts alerts. where state is enabled or where x is the primary
disabled. management-module
(BladeCenter S units bay number.
only) This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
236 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state for Enables or disables monitoring of monalerts -iel state -T system:mm[x]
event log informational event log informational alerts.
alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -inc state -T system:mm[x]
network change network change informational
informational alerts alerts. where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set monitoring state for Enables or disables monitoring of monalerts -iua state -T system:mm[x]
user activity user activity informational alerts.
informational alerts where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example: To enable monitoring of all critical alerts and event log warning alerts
and disable monitoring of all informational alerts, while management module 1 is
set as the persistent command environment, at the system:mm[1]> prompt, type
monalerts -ca enabled -wel enabled -ia disabled
The following example shows the information that is returned from this command:
system:mm[1]> monalerts -ca enabled -wel enabled -ia disabled
OK
system:mm[1]>
238 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
mt (media tray) command
This command sets and displays the blade server that is in control of the
BladeCenter unit shared media tray.
Table 54. mt command
Function What it does Command Valid targets
Display media tray Displays the number of the blade mt -T system
owner server that has media tray
ownership and the global local and
remote media tray switching states
for all blade servers. A blade server
that occupies more than one blade
bay is identified by the lowest bay
number that it occupies. A return
value of 0 indicates that no owner
is set.
Set media tray owner Sets a blade server as the media mt -b blade_server -T system
tray owner.
where blade_server is the
blade bay that identifies
the blade server. A blade
server that occupies more
than one blade bay is
identified by the lowest
bay number that it
occupies. A setting of 0
sets no owner.
Example:
To set the media tray owner to the blade server in blade bay 1, while management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
mt -T system -b 1
To display the media tray owner and the global local and remote media tray
switching states for all blade servers, while management module 1 is set as the
persistent command environment, at the system:mm[1]> prompt, type
mt -T system
The following example shows the information that is returned from these two
commands:
system:mm[1]> mt -T system -b 1
OK
system:mm[1]> mt -T system
-b 1
-local enabled
-remote enabled
system:mm[1]>
240 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
nat command
This command sets and displays the network address table (NAT) settings for the
specified I/O module.
Notes:
1. If the nat command is directed to an I/O module that does not support the
network address table, the "NAT configuration is not supported on this I/O
module" message is returned.
2. When setting values for an empty row in the network address table, all options
must be specified together using a single command.
Table 55. nat command
Function What it does Command Valid targets
Display I/O-module Displays the network port settings nat -T system:switch[x]
network protocol for the specified I/O module.
settings Returned values include those in where x is the
Table 56 on page 244. I/O-module bay
number.
Reset I/O-module Resets all network address table nat -reset -T system:switch[x]
network protocol settings for the specified I/O
settings module to the default values. This command can only where x is the
Default values are in Table 56 on be run by users who have I/O-module bay
page 244. one or more of the number.
following command
You must activate any changes to authorities:
the network protocol settings v Supervisor
before they take effect. v I/O module
configuration
See “Commands and user
authority” on page 8 for
additional information.
Activate I/O-module Activates all network port settings nat -activate -T system:switch[x]
network protocol for the specified I/O module,
settings putting them into effect. This command can only where x is the
be run by users who have I/O-module bay
one or more of the number.
following command
authorities:
v Supervisor
v I/O module
configuration
See “Commands and user
authority” on page 8 for
additional information.
242 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 55. nat command (continued)
Function What it does Command Valid targets
Set internal port number Sets the internal port number for nat -index -ip -T system:switch[x]
for row in NAT table the specified row in the NAT table port_number
for the specified I/O module. where x is the
where: I/O-module bay
v index is a number from number.
1 to 10 that corresponds
to a row in the NAT
table.
v port_number is between
1 and 65534, inclusive.
Example:
To display network protocol settings for the I/O module in I/O-module bay 3,
while I/O-module bay 3 is set as the persistent command environment, at the
system:switch[3]> prompt, type
nat
The following example shows the information that is returned from this command:
system:switch[3]> nat
Index Protocol Name Protocol ID Internal Port External Port Enabled
1 HTTP TCP 80 1080 enabled
2 TELNET TCP 23 1023 enabled
3 HTTPS TCP 43 1043 enabled
4 SSH TCP 22 1022 enabled
5 SNMP UDP 161 1161 enabled
system:switch[3]>
244 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ntp (network time protocol) command
This command configures and displays the management-module network time
protocol (NTP) settings.
Table 57. ntp command
Function What it does Command Valid targets
Display management Displays the NTP settings for the ntp -T system:mm[x]
module NTP settings specified I/O module. Possible
return values are: where x is the primary
v -en state (enabled, disabled) management-module
v -i ipaddress/hostname (IP address bay number.
or hostname of the NTP server)
v -f update_frequency (NTP update
frequency, in minutes)
v -v3en state (enabled, disabled)
v -v3 key_info (NTP v3
authentication entry)
Enable / disable NTP Enables or disables NTP for the ntp -en state -T system:mm[x]
management-module.
where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
NTP server IP address or Checks syntax and sets the IP ntp -i ipaddress/hostname -T system:mm[x]
hostname - set address or hostname of the NTP
server. where ipaddress/hostname is where x is the primary
the IP address or management-module
hostname of the NTP bay number.
server.
246 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 57. ntp command (continued)
Function What it does Command Valid targets
NTP clock- synchronize Synchronizes the ntp -synch -T system:mm[x]
management-module clock with the
NTP server. (You must configure a This command can only where x is the primary
valid NTP server before you can be run by users who have management-module
synchronize.) one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
To display NTP settings for the management module, while management module 2
is set as the persistent command environment, at the system:mm[2]> prompt, type
ntp
The following example shows the information that is returned from this command:
system:mm[2]> ntp
-en enabled
-i timeserver
-f 5
-v3en disabled
-v3 Not configured
NTP is disabled.
system:mm[2]>
248 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 58. ping command (continued)
Function What it does Command Valid targets
Ping I/O-module IP Pings the specified IP address of an ping -i index -T system:switch[x]
address I/O module to test communication.
where index is the index where x is the
number for the I/O-module bay
I/O-module IP address to number.
ping. Use the ping -i
command, with no
arguments, to list available
IP addresses and their
index numbers.
Example: To display list of IP addresses for the I/O module in bay 1, while the
BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
ping -i -T switch[1]
To ping the first IP address of the I/O module in bay 1 using an index number,
while the BladeCenter unit is set as the persistent command environment, at the
system> prompt, type
ping -i 1 -T switch[1]
To ping the first IP address of the I/O module in bay 1 using an IP address, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
ping -i 10.13.3.171
250 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
pmpolicy command
This command displays and sets the power management policies for the
BladeCenter unit.
Table 59. pmpolicy command
Function What it does Command Valid targets
Display power Displays the current power pmpolicy -T system
management policy management policy for all
domains.
Display power Displays both the current and pmpolicy domain -T system
management policy for a available power management
BladeCenter S unit policies for a BladeCenter S unit, where domain is pd
that has a single power domain.
Display power Displays both the current and pmpolicy domain -T system
management policy for available power management
domain policies for the specified power where domain is:
domain in a BladeCenter unit that v pd1 (power domain 1)
supports two power domains. v pd2 (power domain 2)
Set power management Set power management policy for pmpolicy domain -pm policy -T system
policy for domain specified power domain.
where domain is:
v pd1 (power domain 1)
v pd2 (power domain 2)
where policy is:
v acred (ac power source
redundancy policy -
BladeCenter S units
only)
v acredov (ac power
source redundancy
policy, with blade
throttling - BladeCenter
S units only)
v redwoperf (power
module redundancy, no
oversubscription)
v redwperf (power
module redundancy
with power throttling)
v nonred (no power
management policy)
To view the current policy and the available policies for a power domain 1, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
pmpolicy pd1
Power Domain 1
--------------
NOTE:
Power Supply Failure Limit: This is the maximum number of power supplies
that can fail while still guaranteeing the
operation of the domain in the selected policy.
Your Estimated Utilization: The estimated utilization is based on the maximum
power limit allowed in this policy and the current
aggregated power in use of all components in the
domain.
system>
252 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
portcfg command
This command configures and displays the settings for the advanced
management-module serial port.
Table 60. portcfg command
Function What it does Command Valid targets
Display Displays the current configuration portcfg -com1 -T system:mm[x]
management-module of the management-module serial
serial port configuration port. Possible return values are: where x is the primary
v -b baud_rate management-module
v -p parity bay number.
v -s stop_bits
Set management-module Checks syntax and sets the baud portcfg -com1 -b -T system:mm[x]
serial port baud rate (communications) rate of the baud_rate
management-module serial port. where x is the primary
where baud_rate is 2400, management-module
4800, 9600, 19200, 38400, bay number.
or 57600.
Example:
To set the baud rate for the management-module serial port to 9600, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
portcfg -com1 -b 9600
The following example shows the information that is returned from these two
commands:
system:mm[1]> portcfg -com1
-b 2400
-p none
-s 1
system:mm[1]> portcfg -com1 -b 9600
These configuration changes will become active after the next reset of the MM.
system:mm[1]>
254 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ports command
This command sets and displays the network port configuration settings for the
advanced management module.
Note: Changes to the -ftpdp, -ftpe, -ftpp, -httpp, -httpsp, -rpp, -smashse,
-smashsp, -smashte, -smashtp, -snmp1ae, -snmp3ae, -snmpap, -snmpte, -snmptp,
-sshe, -sshp, -tcme, -telnete, -telnetp, -telnett, or -tftpp settings become active
immediately. Changes to the remaining settings become active after the next reset
of the advanced management module.
Table 61. ports command
Function What it does Command Valid targets
Display network port Displays the network port settings ports -T system:mm[x]
settings for the management module.
Returned values are: where x is the primary
v -ftpp FTP_prt_num management-module
v -ftpdp FTP_data_prt_num bay number.
v -httpp HTTP_prt_num
v -httpsp HTTPS_prt_num
v -rpp rpp_prt_num
v -slpp SLP_prt_num
v -smashsp
secSMASH_SSH_prt_num
v -smashtp SMASH_telnet_prt_num
v -snmpap SNMP_agent_prt_num
v -snmptp SNMP_traps_prt_num
v -sshp SSH_prt_num
v -stcmp secure_tcmp
v -tcmp TCP_cmd_md_port
v -telnetp _Telnet_prt_num
v -tftpp TFTP_prt_num
v -ftpe FTP_state
v -httpse HTTPS_prt_state
v -kvme KVM_state
v -ntpe NTP_state
v -rde rd_state
v -rdoce rdoc_state
v -slpe SLP_state.
v -smashse sec_SMASH_SSH_state
v -smashte SMASH_telnet_state
v -snmp1ae SNMPv1_agent_state
v -snmp3ae SNMPv3_agent_state
v -snmpte SNMP_traps_state
v -sshe SSH_prt_state
v -stcme secure_TCP_cmd_mode
v -tcme TCP_cmd_mode_state
v -telnete Telnet_prt_state-
v -tftpe TFTP_state
v -ftpt FTP_timeout
v -tcmt TCP_cmd_mode_timeout
v -telnett Telnet_prt_timeout
Display open Displays the management module ports -open -T system:mm[x]
management module ports that are currently open.
ports where x is the primary
management-module
bay number.
256 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Set HTTP port number Sets the port number for the ports -httpp -T system:mm[x]
management module HTTP port. HTTP_prt_num
where x is the primary
where HTTP_prt_num is management-module
from 1 to 65535, inclusive. bay number.
If you enter a value
outside this range, an
error will be displayed.
258 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Set SNMP agent port Sets the port number for the ports -snmpap -T system:mm[x]
number management module SNMP agent SNMP_agent_prt_num
port. where x is the primary
where management-module
SNMP_agent_prt_num is bay number.
from 1 to 65535, inclusive.
If you enter a value
outside this range, an
error will be displayed.
260 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Set Telnet port number Sets the port number for the ports -telnetp -T system:mm[x]
management module Telnet port. Telnet_prt_num
where x is the primary
where Telnet_prt_num is management-module
from 1 to 65535, inclusive. bay number.
If you enter a value
outside this range, an
error will be displayed.
262 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disable RDE Enables or disables remote disk for ports -rde state -T system:mm[x]
the management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable RDOCE Enables or disables remote disk on ports -rdoce state -T system:mm[x]
card for the management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disables SLP Enables or disables SLP for the ports -slpe state -T system:mm[x]
management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
264 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disable Enables or disables the SNMPv3 ports -snmp3ae state -T system:mm[x]
SNMPv3 agent agent for the management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable SNMP Enables or disables the SNMP traps ports -snmpte state -T system:mm[x]
traps for the management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable SSH Enables or disables the ports -sshe state -T system:mm[x]
port management module SSH port.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
266 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Set number of secure Turns the secure TCP command ports -stcme port_mode -T system:mm[x]
TCP command mode mode on or off, or sets the
connections maximum number of connections. where port_mode is on (1 where x is the primary
Notes: connection), off (no management-module
v On a write operation, the connections), or a number bay number.
maximum number of between 0 and 20,
connections can be set explicitly inclusive, that indicates
(0-20), or it can be turned on (1 the maximum number of
connection) or off (0 TCP session connections.
connections).
v On a read operation, off means 0 This command can only
connections, and on means 1 or be run by users who have
more connections. one or more of the
v The total session count of TCM following command
and STCM is limited to 20. authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable Telnet Enables or disables the ports -telnete state -T system:mm[x]
port management module Telnet port.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable TFTP Enables or disables TFTP for the ports -tftpe state -T system:mm[x]
management module.
where state is on or off. where x is the primary
management-module
This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
268 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Display network port Displays the network port settings ports -T system:switch[x]
settings for I/O module for the I/O module. These settings
can include: where x is the
v cable compatibility I/O-module bay
v cable length number.
v cable type
v data rate
v label
v port index
v port media
v port width
v protocol
v speed
v speed setting
v available speeds
v state
v state setting
v type
v vendor
Note: Other device specific values
might be returned.
Enable or disable port Enables or disables specified port ports -port_index -state -T system:switch[x]
for I/O module on specified I/O module. state
where x is the I/O
where module bay number.
v port_index is from 1 to
65535, inclusive.
v state is on or off.
Example:
To disable FTP for the management module, while management module 1 is set as
the persistent command environment, at the system:mm[1]> prompt, type
ports -ftpe off
The following example shows the information that is returned from these two
commands:
system:mm[1]> ports
-ftpp 21
-ftpdp 20
-httpp 80
-httpsp 443
-rpp 3900
-slpp 427
-smashsp 50022
-smashtp 50023
-snmpap 161
-snmptp 162
-sshp 22
270 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
-stcmp 6091
-tcmp 6090
-telnetp 23
-tftpp 69
-ftpe on
-httpse off
-kvme on
-ntpe off
-rde off
-rdoce on
-slpe on
-smashse on
-smashte on
-snmp1ae on
-snmp3ae on
-snmpte on
-sshe off
-stcme off
-tcme off
-telnete on
-tftpe off
-tcmt 0
-telnett 10000
-ftpt 300
system:mm[1]> ports -ftpe off
Changes to -sshe, -sshp, -smashse, -smashte, -smashsp, -telnete, -telnetp,
-telnett, -smashtp, -snmpte, -tcme, -tcmp, -tcmt, -stcme, -stcmp, -rpp,
-httpp,-httpse, -httpsp, -ftpe or -tftpe will become active immediately.
OK
system>
272 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 62. power command (continued)
Function What it does Command Valid targets
Shutdown and power Shuts down the operating system power -softoff -T system:blade[x]
off blade server and turns off the specified blade
server. This command can only where x is the blade
be run by users who have server number.
one or more of the
following command
authorities:
v Supervisor
v Blade administration
See “Commands and user
authority” on page 8 for
additional information.
Power cycle Cycles power for the specified power -cycle -T system:blade[x]
blade server or I/O module. If the -T system:switch[x]
blade server or I/O module is off, This command can only
it will turn on. If the blade server be run by users who have where x is the blade
or I/O module is on, it will turn one or more of the server or I/O-module
off and then turn on. following command bay number.
authorities:
v Supervisor
v Blade administration
(for blade server)
v I/O module
administration (for I/O
module)
See “Commands and user
authority” on page 8 for
additional information.
Power cycle to command Cycles power for the specified power -cycle -c -T system:blade[x]
console blade server. If the blade server is
off, it opens a command console This command can only where x is the blade
with an SOL session when it is be run by users who have server bay number.
turned on. If the blade server is on, one or more of the
it will turn off and then turn on. following command
authorities:
v Supervisor
v Blade administration
and blade remote
presence
See “Commands and user
authority” on page 8 for
additional information.
Display power state Displays the current power state power -state -T system:blade[x]
for the specified blade server or -T system:switch[x]
I/O module. Possible return values
are off, on, standby, or hibernate. where x is the blade
server or I/O-module
bay number.
274 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 62. power command (continued)
Function What it does Command Valid targets
Enable / disable local Enables local power control for the power -local state -T system:blade[x]
power control for blade specified blade server.
server where state is enabled or where x is the blade
disabled. server bay number.
276 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example:
To display the power state for the blade server in blade bay 5, while this blade
server is set as the persistent command environment, at the system:blade[5]>
prompt, type
power -state
To turn on the blade server in blade bay 5, while this blade server is set as the
persistent command environment, at the system:blade[5]> prompt, type
power -on
To display the power state for the blade server in blade bay 5 again, while this
blade server is set as the persistent command environment, at the
system:blade[5]> prompt, type
power -state
The following example shows the information that is returned from these three
commands:
system:blade[5]> power -state
Off
system:blade[5]> power -on
OK
system:blade[5]> power -state
On
system:blade[5]>
278 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To display volume information for local storage on the advanced
management module in bay 1, while this management module is set as the
persistent command environment, at the system:mm[1]> prompt, type
rdoc
The following example shows the information that is returned from this command:
system:mm[1]> rdoc
Volume 0
Health: good
Volume Size: 73108480 (Bytes)
Free Size: 69120000 (Bytes)
system:mm[1]>
Configurations are saved to the BladeCenter unit chassis or to a file using the
“write command” on page 401.
Table 64. read command
Function What it does Command Valid targets
Display Displays the automatic read -T system:mm[x]
management-module configuration setting (-auto
automatic configuration command option) of the where x is the primary
setting management module. management-module
bay number.
Restore Restores the management-module read -config chassis -T system:mm[x]
management-module configuration from an image that
configuration from was previously saved to the This command can only where x is the primary
BladeCenter unit BladeCenter unit midplane. be run by users who have management-module
midplane one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Restore Restores the management-module read -config file -l -T system:mm[x]
management-module configuration from an image that filename -i ip_address
configuration from file was previously saved to a file where x is the primary
(no encryption) while data encryption was not where: management-module
enabled for the BladeCenter unit. v filename is the name of bay number.
the configuration file.
v ip_address is the IPv4 or
IPv6 IP address of the
TFTP server where the
configuration file is
located.
280 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 64. read command (continued)
Function What it does Command Valid targets
Restore Restores the management-module read -config file -l -T system:mm[x]
management-module configuration from an image that filename -i ip_address -p
configuration from file was previously saved to a file passphrase where x is the primary
(encryption) while data encryption was enabled management-module
for the BladeCenter unit. where: bay number.
Note: When a configuration file v filename is the name of
was created with a pass-phrase the configuration file.
(encryption enabled), if this v ip_address is the IPv4 or
configuration file is restored on the IPv6 IP address of the
same management module, the TFTP server where the
pass-phrase entered during configuration file is
restoration is ignored. located.
v "passphrase" is the
quote-delimited
pass-phrase that was
used to save the
original configuration
file. Maximum
pass-phrase length is
1600 characters.
Example:
The following example shows the information that is returned from this command:
system:mm[1]> read -config chassis
OK
Configuration restore from the chassis was successful
Restart the MM for the new settings to take effect
system:mm[1]>
282 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
remotechassis command
This command displays and manages the list of BladeCenter units that the
management module discovers on the network.
Note: The advanced management module that runs the remotechassis command is
also included in all lists.
Table 65. remotechassis command
Function What it does Command Valid targets
Display complete list Displays a list of all BladeCenter remotechassis -T system:mm[x]
units that the management module
discovers on the network. The list where x is the primary
includes the following information management-module
about each BladeCenter unit: bay number.
v Name
v IP address
v Status
v Firmware level
v Type
v Serial number
v FRU number
v Chassis serial number
v Chassis FRU number
v Chassis machine-type model
(MTM)
v Chassis UUID
Display list grouped by Displays a list of names for remotechassis -health -T system:mm[x]
health status BladeCenter units that the
management module discovers on where x is the primary
the network. The list is grouped by management-module
health status. bay number.
Display list filtered by Displays a list of BladeCenter units remotechassis -ip -T system:mm[x]
IP address that the management module ip_address
discovers on the network, filtered where x is the primary
by the specified IP address. The list where ip_address is an IP management-module
includes the following information address pattern that uses bay number.
about each BladeCenter unit: the asterisk (*) as a
v Name wildcard (for example;
v IP address 201.47.123.*).
v Status
v Firmware level
v Type
v Serial number
v FRU number
v Chassis serial number
v Chassis FRU number
v Chassis machine-type model
(MTM)
v Chassis UUID
Example:
To list all BladeCenter units on the network with a name starting with
"WebServer", while management module 1, that does not support IPv6, is set as the
persistent command environment, at the system:mm[1]> prompt, type
remotechassis -name WebServer*
The following example shows the information that is returned from this command:
system:mm[1]> remotechassis -name WebServer*
Running chassis discovery...
------------------------------------------------
Name: WebServer001
IP: 145.48.204.212
Status: normal
Firmware: BPET25L,CNETMNUS.PKT,01-08-07,37,1
Type: management-module
Serial: 0J1M9E585630
FRU: 25R5777
Chassis Serial: 23A2343
Chassis FRU: 25R5780R5780
Chassis MTM: 885222Z
Chassis UUID: 4E349451FA8011D9B10C89E0183AD13D
------------------------------------------------
Name: WebServer002
IP: 145.48.204.222
Status: normal
Firmware: BPET25L,CNETMNUS.PKT,01-08-07,37,1
Type: management-module
Serial: 0J1M9E585656
FRU: 25R5777
Chassis Serial: 23A2356
Chassis FRU: 25R5780R5780
284 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chassis MTM: 885222Z
Chassis UUID: 4E325951FA8011D9B86C89E0183AD02D
------------------------------------------------
system:mm[1]>
To list all BladeCenter units on the network with a name starting with "SYSTEM*",
while management module 1, that supports IPv6, is set as the persistent command
environment, at the system:mm[1]> prompt, type
remotechassis -name SYSTEM*
The following example shows the information that is returned from this command:
system:mm[1]> remotechassis -name SYSTEM*
Running chassis discovery...
------------------------------------------------
Name: SYSTEM
IP: 10.13.1.190
IPv6: 2002:1013::211:25ff:fec3:227c
2001:1013::211:25ff:fec3:227c
2000:1013::211:25ff:fec3:227c
fe80::211:25ff:fec3:227c
2000:1013::a1be:a348:7672:2def
2000:1013::1:191
Status: critical
Firmware: BPET002,CNETMNUS.PKT,02-17-10,1
Type: management-module
Serial: YK118165A117
FRU: 39Y9661
Chassis Serial: KQWPLB9
Chassis FRU: 44X2302
Chassis MTM: 8852HC1
Chassis UUID: E13112E1829448E29999DA2066681D89
------------------------------------------------
Name: SYSTEM
IP: 10.13.1.30
IPv6: 2000:1013::fc58:325c:c8b4:9c4c
2000:1013::214:5eff:fed0:2e1c
2000:1013::1:30
fe80::5652:ff:fe69:d763
2002:1013::211:25ff:fec3:8cfa
2001:1013::211:25ff:fec3:8cfa
2000:1013::211:25ff:fec3:8cfa
fe80::211:25ff:fec3:8cfa
Status: attention
Firmware: BPET54A,CNETMNUS.PKT,02-17-10,84
Type: management-module-telco
Serial: YK118269Y115
FRU: 39Y9661
Chassis Serial: 23A0052
Chassis FRU: 42C3673
Chassis MTM: 87501RZ
Chassis UUID: B5BAEC01A10B11DB9F3BC1BE8FFF3B3C
------------------------------------------------
system:mm[1]>
286 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 66. reset command (continued)
Function What it does Command Valid targets
Reset blade server to Opens a command console with an reset -c -T system:blade[x]
command console SOL session when the specified
blade server is reset. This command can only where x is the blade
be run by users who have server bay number.
one or more of the
following command
authorities:
v Supervisor
v Blade administration
and blade remote
presence
See “Commands and user
authority” on page 8 for
additional information.
Reset with failover Resets the specified command reset -f -T system:mm[x]
target, enabling failover if a
redundant (stanfdby) component This command can only -T system:mux[x] (for
for the command target is present. be run by users who have advanced management
one or more of the modules in
An error message is displayed if following command BladeCenter HT units
you try to failover a management authorities: only)
module when a standby v Supervisor
management module is not v Chassis administration where x is the primary
installed or if the firmware in the management-module
See “Commands and user bay or multiplexer
one of the management modules is
authority” on page 8 for expansion module
updating.
additional information. number.
Note: This option does not apply
to the BladeCenter S unit.
Reset management Resets the primary management reset -force -T system:mm[x]
module with forced module with failover to the
failover standby management module. This command can only where x is the primary
be run by users who have management-module
An error message is displayed if one or more of the bay number.
you try to force failover for a following command
management module when a authorities:
standby management module is not v Supervisor
installed or if the firmware in the v Chassis administration
primary management module is
See “Commands and user
updating.
authority” on page 8 for
Note: This option does not apply
additional information.
to the BladeCenter S unit.
Reset I/O module with Performs an immediate reset and reset -std -T system:switch[x]
standard diagnostics restart of the specified device,
running standard diagnostics on This command can only where x is the
the I/O module after it restarts. be run by users who have I/O-module bay
one or more of the number.
Running the reset -std command following command
gives the same result as running authorities:
the reset command on a I/O v Supervisor
module. v I/O module
administration
See “Commands and user
authority” on page 8 for
additional information.
288 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 66. reset command (continued)
Function What it does Command Valid targets
Restart blade server and Performs an immediate reset and reset -clr -T system:blade[x]
clear NVRAM restart of the specified blade server.
Command results depend on the This command can only where x is the blade
blade server model that is be run by users who have server bay number.
specified: one or more of the
v For a JS12 or JS22 blade server, following command
this option is not available. authorities:
v For a JS20 blade server, the v Supervisor
command performs an v Blade administration
immediate reset and restart of and blade remote
the specified JS20 blade server presence
and clears all settings stored in See “Commands and user
non-volatile memory (NVRAM). authority” on page 8 for
v For all other blade servers, the additional information.
command performs an
immediate reset and restart of
the specified blade server.
Restart blade server and Performs an immediate reset and reset -dg -T system:blade[x]
run diagnostics restart of the specified blade server.
Command results depend on the This command can only where x is the blade
blade server model that is be run by users who have server bay number.
specified: one or more of the
v For a JS12 or JS22 blade server, following command
this option is not available. authorities:
v For a JS20 blade server, the v Supervisor
command performs an v Blade administration
immediate reset and restart of and blade remote
the specified JS20 blade server presence
and runs diagnostics. See “Commands and user
v For all other blade servers, the authority” on page 8 for
command performs an additional information.
immediate reset and restart of
the specified blade server.
Restart blade server and Performs an immediate reset and reset -ddg -T system:blade[x]
run diagnostics using restart of the specified blade server.
default boot sequence Command results depend on the This command can only where x is the blade
blade server model that is be run by users who have server bay number.
specified: one or more of the
v For a JS12 or JS22 blade server, following command
this option is not available. authorities:
v For a JS20 blade server, the v Supervisor
command performs an v Blade administration
immediate reset and restart of and blade remote
the specified JS20 blade server presence
and runs diagnostics using the See “Commands and user
default boot sequence configured authority” on page 8 for
for the blade server. additional information.
v For all other blade servers, the
command performs an
immediate reset and restart of
the specified blade server.
Example: To reset the service processor on the blade server in blade bay 5, while
the BladeCenter unit is set as the persistent command environment, at the system>
prompt, type
reset
290 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
scale command
This command sets and displays the partition control and configuration settings for
multiple blade servers or nodes in a scalable complex, for blade servers installed in
the BladeCenter unit that support this feature.
Note:
v The scale command will execute only on blade servers that support scalable
complexes.
v All blade servers in a scalable complex must be at the same firmware level.
When scripting firmware updates for blade servers in a scalable complex, make
sure that the update commands are included for each node in the complex.
Table 67. scale command
Function What it does Command Valid targets
Display all scalable Displays all scalable complex scale -T system
complex information information for the BladeCenter
unit.
Display information for Displays information for the scale -compid complex_id -T system
specific scalable complex specified scalable complex.
Note: where complex_id is a
v The complex_id is found by unique complex identifier
running the scale command (hexadecimal string of
with no options. four alphanumeric
v The -compid command option is characters), assigned by
required for only blade-server the blade complex.
systems that can have multiple
scalable complexes defined in the
same BladeCenter unit. This
option does not need to be
specified for stand-alone systems.
Display information for Displays information for a specific scale -node node_id -T system
specific node in a node in the scalable complex. -compid complex_id
scalable complex Note:
v The complex_id and node_id are where :
found by running the scale v node_id is the checksum
command with no options. or blade server bay
v The -compid command option is number, of the node.
required for only blade-server v complex_id is a unique
systems that can have multiple complex identifier
scalable complexes defined in the (hexadecimal string of
same BladeCenter unit. This four alphanumeric
option does not need to be characters), assigned by
specified for stand-alone systems. the blade complex.
Display information for Displays information for a specific scale -compid complex_id -T system
specific partition in a node in the scalable complex. -partition partition_id
scalable complex Note:
v The complex_id and partition_id where :
are found by running the scale v complex_id is a unique
command with no options. complex identifier
v The -compid command option is (hexadecimal string of
required for only blade-server four alphanumeric
systems that can have multiple characters), assigned by
scalable complexes defined in the the blade complex.
same BladeCenter unit. This v partition_id is a partition
option does not need to be identifier, assigned by
specified for stand-alone systems. the blade complex.
292 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 67. scale command (continued)
Function What it does Command Valid targets
Create stand-alone Creates stand-alone partitions for scale -create id_x,id_y -T system
partition in scalable specified blade servers or nodes in -compid complex_id
complex the scalable complex. Single blade
servers set up as a stand-alone where:
partition will perform consistently v id_x and id_y are
if they are installed in another checksums or blade
BladeCenter unit. server bay numbers,
Note: separated by commas,
v Creating a partition with nodes that identify the node
(blade servers) that are enabled where the partition is to
for Blade Open Fabric Manager be created. The list can
(BOFM) might cause loss of contain one or more
ports configured for Open Fabric comma-separated
Manager. values. Both checksums
v The comma-separated-value and bay numbers can
format of this command is be used in the same list.
primarily used to create v complex_id is a unique
stand-alone partitions, since complex identifier
these systems are not contiguous (hexadecimal string of
like blade-server systems. For four alphanumeric
blade-server systems, the characters), assigned by
command can accept a the blade complex.
comma-separated-value list of
blade server bay numbers, but This command can only
these bay numbers must be be run by users who have
contiguous. one or more of the
v The checksums, blade server bay following command
numbers and complex_id are authorities:
found by running the scale v Supervisor
command with no options. v Blade administration
v The namespace for a node See “Commands and user
checksum and blade server bay authority” on page 8 for
number should not overlap. additional information.
v The -compid command option is
required for only blade-server
systems that can have multiple
scalable complexes defined in the
same BladeCenter unit. This
option does not need to be
specified for stand-alone systems.
294 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 67. scale command (continued)
Function What it does Command Valid targets
Delete partition from Deletes a specific partition in the scale -delete -compid -T system
scalable complex scalable complex. complex_id -partid
Note: partition_id
v A partition must be powered off
to delete it. where :
v The complex_id and partition_id v complex_id is a unique
are found by running the scale complex identifier
command with no options. (hexadecimal string of
v The -compid command option is four alphanumeric
required for only blade-server characters), assigned by
systems that can have multiple the blade complex.
scalable complexes defined in the v partition_id is a partition
same BladeCenter unit. This identifier, assigned by
option does not need to be the blade complex.
specified for stand-alone systems.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Blade administration
See “Commands and user
authority” on page 8 for
additional information.
Set partition mode to Sets the mode for a specific scale -mode standalone -T system
stand alone partition in the scalable complex to -compid complex_id
standalone. A partition set to -partid partition_id
stand-alone mode operates as a
single blade server system. Single where :
blade servers set up as a v complex_id is a unique
stand-alone partition will perform complex identifier
consistently if they are installed in (hexadecimal string of
another BladeCenter unit. four alphanumeric
Note: characters), assigned by
v A partition must be powered off the blade complex.
to change its mode. v partition_id is a partition
v The complex_id and partition_id identifier, assigned by
are found by running the scale the blade complex.
command with no options.
v The -compid command option is This command can only
required for only blade-server be run by users who have
systems that can have multiple one or more of the
scalable complexes defined in the following command
same BladeCenter unit. This authorities:
option does not need to be v Supervisor
specified for stand-alone systems. v Blade administration
See “Commands and user
authority” on page 8 for
additional information.
296 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 67. scale command (continued)
Function What it does Command Valid targets
Power off partition in Turns off a specific partition in the scale -off -compid -T system
scalable complex scalable complex. complex_id -partid
Note: partition_id
v The complex_id and partition_id
are found by running the scale where :
command with no options. v complex_id is a unique
v The -compid command option is complex identifier
required for only blade-server (hexadecimal string of
systems that can have multiple four alphanumeric
scalable complexes defined in the characters), assigned by
same BladeCenter unit. This the blade complex.
option does not need to be v partition_id is a partition
specified for stand-alone systems. identifier, assigned by
the blade complex.
The following example shows the information that is returned from these
commands:
system> scale
Partition ID: 1
Assigned Nodes:
---------------
Bay: 2
Name: HX5 SDV #3
Processors/Memory: 2 Intel Xeon/4 DIMMs 2GB
Logical Node ID: 0
Status: powered on
Mode: partition
Primary: Yes
Bay: 3
Name: HX5 SDV #4
Processors/Memory: 2 Intel Xeon/4 DIMMs 2GB
Logical Node ID: 1
Status: powered on
Mode: partition
Primary: No
298 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sddump command
This command initiates a dump of service data from blade servers that support
this function.
Table 68. sddump command
Function What it does Command Valid targets
Dump service data Dumps service data of the specified sddump -init type -T system:blade[x]
type from the specified blade
server target. where type is: where x is the blade
Note: Data dumps can be initiated, v sd for a service data server bay number.
but are not collected, from the dump.
advanced management module. v sp for a service
processor data dump.
v pf for a platform data
dump.
v pt for a partition data
dump.
The following example shows the information that is returned from this command:
system:blade[2]> sddump -init sp
OK
system:blade[2]>
300 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sdemail command
This command sends an email with the service information to the specified
recipients.
Table 69. sdemail command
Function What it does Command Valid targets
Send service information Send an email with service sdemail -subj "subject" -T system:mm[x]
using email to specified information to the specified -to address
recipients recipients. You assign a subject and where x is the primary
an email address. When you run where: management module
this command, it attaches the v "subject" is a bay number.
service log to the message. quote-delimited text
string up to 119
characters in length.
v address is the recipients
email address. Multiple
addresses separated
with a comma can be
entered (119 characters
maximum).
Example:
302 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
security command
This command enables and displays the state of the data encryption feature for
sensitive information stored in the advanced management module, such as
passwords and keys.
Once enabled, the security feature can not be disabled without resetting all
management module settings to their default configuration.
Table 70. security command
Function What it does Command Valid targets
Display management Displays the security setting for security -T system:mm[x]
module security setting management module data
encryption (on or off). where x is the primary
management-module
bay number.
Enable data encryption Enables data encryption for the security -e -T system:mm[x]
for management module management module.
This command can only where x is the primary
Attention: If you enable data be run by users who have management-module
encryption, you can not disable it one or more of the bay number.
without resetting the management following command
module to the default authorities:
configuration. v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
To enable data encryption for the management module, while management module
1 is set as the persistent command environment, at the system:mm[1]> prompt, type
security -e
To display the data encryption setting for the management module, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
security
The following example shows the information that is returned from these two
commands:
system:mm[1]> security -e
OK
system:mm[1]> security
-e on
system:mm[1]>
Example:
To enable technician debug of the advanced management module with a USB key,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
service -enable
304 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following example shows the information that is returned from these two
commands:
system:mm[1]> service -enable
OK
system:mm[1]> service
Debug with USB key: Enabled
system:mm[1]>
Example:
To force a shutdown for the blade server in blade bay 5, while this blade server is
set as the persistent command environment, at the system:blade[5]> prompt, type
shutdown -f
The following example shows the information that is returned from this command:
system:blade[5]> shutdown -f
OK
system:blade[5]>
306 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
slp command
This command sets and displays the service location protocol (SLP) settings for the
management module.
Table 73. slp command
Function What it does Command Valid targets
Display Displays the SLP settings for the slp -T system:mm[x]
management-module primary management module.
SLP settings Returned values are: where x is the primary
v -t address_type management-module
v -i multicast_addr bay number.
Set management-module Sets the SLP address type for the slp -t address_type -T system:mm[x]
SLP address type primary management module.
where address_type is where x is the primary
multicast or broadcast. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set management-module Sets the SLP multicast address for slp -i multicast_addr -T system:mm[x]
SLP multicast address the primary management module.
where multicast_addr is the where x is the primary
multicast IP address. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
To set the SLP address type of the advanced management module to multicast,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
slp -t multicast
308 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
smtp command
This command configures and displays the management-module SMTP settings.
Table 74. smtp command
Function What it does Command Valid targets
Display SMTP server Displays the SMTP server host smtp -T system:mm[x]
host name or IP address name or IP address.
where x is the primary
management-module
bay number.
Server host name or IP Checks syntax and sets the server smtp -s -T system:mm[x]
address - set host name or IP address. hostname/ip_address
where x is the primary
where hostname/ip_address management-module
is the host name or IP bay number.
address of the server.
Example:
To set the SMTP server host name to us.ibm.com, while management module 1 is
set as the persistent command environment, at the system:mm[1]> prompt, type
smtp -s us.ibm.com
310 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following example shows the information that is returned from these two
commands:
system:mm[1]> smtp -s us.ibm.com
OK
system:mm[1]> smtp
-s us.ibm.com
system:mm[1]>
312 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 1 Sets the name of community 1. snmp -c1 name -T system:mm[x]
name - set
where name is a descriptive where x is the primary
name of community 1. management-module
v Arguments containing bay number.
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
314 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP Community 1, Sets the access type for community snmp –ca1 set -c1i1 -T system:mm[x]
first host name - set 1 to SET. 0.0.0.0
access to SET v With the access type of where x is the primary
(wildcard) SET, anyone can query management-module
the management bay number.
information base (MIB)
and set MIB values.
Using 0.0.0.0 IP address
with SET access allows
open access to the
management module for
write (SET) operations. A
0.0.0.0 address cannot be
a trap receiver.
v Arguments containing
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
316 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 1 Checks syntax and sets the second snmp -c1i2 -T system:mm[x]
second host name or IP host name or IP address of hostname/ip_address
address - set community 1. where x is the primary
where hostname/ip_address is management-module
the second host name or IP bay number.
address of community 1.
v Arguments containing
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
318 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 2 Sets the name of community 2. snmp -c2 name -T system:mm[x]
name - set
where name is a descriptive where x is the primary
name of community 2. management-module
v Arguments containing bay number.
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
320 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 2 Checks syntax and sets the third snmp -c2i3 -T system:mm[x]
third host name or IP host name or IP address of hostname/ip_address
address - set community 2. where x is the primary
where hostname/ip_address is management-module
the third host name or IP bay number.
address of community 2.
v Arguments containing
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
322 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 3 Checks syntax and sets the second snmp -c3i2 -T system:mm[x]
second host name or IP host name or IP address of hostname/ip_address
address - set community 3. where x is the primary
where hostname/ip_address is management-module
the second host name or IP bay number.
address of community 3.
v Arguments containing
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
324 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP contact name - Sets the contact name. snmp -cn contact_name -T system:mm[x]
set
where contact_name is the where x is the primary
name of the party to be management-module
contacted when SNMP bay number.
traps an event.
v Arguments containing
spaces must be enclosed
in quotation marks. No
leading or trailing spaces
are allowed in
arguments.
v If this argument is not
specified, the snmp
command clears this
option.
v You can also clear this
option by assigning an
empty string as its value.
To enable the SNMP agent and SNMP traps, while advanced management module
1 is set as the persistent command environment, at the system:mm[1]> prompt, type
snmp -a -on -t -on
The following example shows the information that is returned from these two
commands:
system:mm[1]> snmp
-a Enabled
-a3 Enabled
-t Enabled
-l Raleigh,NC
-cn Mr. Smith
-c1 public
-c1i1 9.44.146.157
-c1i2 9.44.147.24
-c1i3 9.49.165.217
-ca1 set
-c2 private
-c2i1 9.42.226.4
-c2i2
-c2i3
-ca2 get
-c3 test
326 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
-c3i1 9.44.247.64
-c3i2
-c3i3
-ca3 getsystem:mm[1]> snmp -a -on -t -on
system:mm[1]>
328 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 76. sol (serial over LAN) command (continued)
Function What it does Command Valid targets
SOL retry count - set Sets the SOL retry count to the sol -c value -T system:mm[x]
input value.
where value is from 0 to 7, where x is the primary
inclusive. If you enter a management-module
value of 0, no retries will bay number.
be attempted. If you enter
a value greater than 7, an
error will be displayed.
330 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 76. sol (serial over LAN) command (continued)
Function What it does Command Valid targets
SOL disable - global Disables SOL globally for the sol -status disabled -T system:mm[x]
BladeCenter unit. The global SOL
disable command does not affect This command can only where x is the primary
the SOL session status for each be run by users who have management-module
blade server. one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis configuration
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
SOL disable - blade Disables SOL for the specified sol -status disabled -T system:blade[x]
server blade server.
This command can only where x is the blade
be run by users who have server bay number.
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
v Blade configuration
See “Commands and user
authority” on page 8 for
additional information.
332 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 76. sol (serial over LAN) command (continued)
Function What it does Command Valid targets
Reset blade server key Sets the key sequence that will sol -r value -T system:mm[x]
sequence - set reset a blade server while a Telnet
session in SOL mode. where value is the key where x is the primary
sequence. In this sequence, management-module
a ^ (the carat symbol) bay number.
indicates a Ctrl that maps
to control-key sequences;
for example:
v ^[ (the carat symbol
followed by a left
bracket) means Esc
v ^M (the carat symbol
followed by a capitol
M) means carriage
return.
Refer to an ASCII-to-key
conversion table for a
complete listing of
control-key sequences.
Example:
To set the SOL accumulate timeout to 25 ms, while management module 1 is set as
the persistent command environment, at the system:mm[1]> prompt, type
sol -t 25
To set the reset blade server key sequence to Esc R Esc r Esc R, while management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
sol -r ^[R^[r^[R
To display the SOL settings for the management module, while the management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
sol
To display the SOL settings for the server blade in the third bay, while blade 3 is
set as the persistent command environment, at the system:blade[3]> prompt, type
sol
334 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sshcfg command
This command sets and displays the SSH status of the management module.
Table 77. sshcfg command
Function What it does Command Valid targets
Display SSH status Displays the SSH status of the sshcfg -T system:mm[x]
management module. Returned
values are: where x is the primary
v -v1 off management-module
bay number.
v -cstatus: state of CLI SSH server
(enabled, disabled)
v CLI SSH port number
v -sstatus: state of SMASH SSH
server (enabled, disabled)
v SMASH SSH port number
v ssh-dss fingerprint
v ssh-rsa fingerprint
v number of SSH public keys
installed
v number of locations available to
store SSH keys
Note: For scripting purposes, the
"-v1 off" state is always displayed.
Display RSA host key Displays RSA host key information sshcfg -hk rsa -T system:mm[x]
information for the management module.
where x is the primary
management-module
bay number.
Display DSA host key Displays DSA host key information sshcfg -hk dsa -T system:mm[x]
information for the management module.
where x is the primary
management-module
bay number.
Generate host key Generates a host key for the sshcfg -hk gen -T system:mm[x]
management module.
This command can only where x is the primary
be run by users who have management-module
one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example:
The following example shows the information that is returned from this command:
system:mm[1]> sshcfg
-v1 off
-cstatus enabled
CLI SSH port 22
-sstatus disabled
SMASH SSH port 50024
ssh-dss 2048 bit fingerprint: 27:ee:bd:a9:27:28:d8:a5:93:03:3d:8e:77:d0:38:2c
ssh-rsa 2048 bit fingerprint: 66:c9:73:4f:18:11:02:10:f3:05:6e:d7:27:05:a5:01
2 SSH public keys installed
10 locations available to store SSH public keys
system:mm[1]>
336 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sslcfg command
This command sets and displays the Secure Sockets Layer (SSL) status of the
advanced management module.
Table 78. sslcfg command
Function What it does Command Valid targets
Display management Displays the SSL status of the sslcfg -T system:mm[x]
module SSL status specified management module.
This status includes information where x is the primary
about SSL certificates. or standby
management-module
bay number.
Set SSL certificate Enables or disables use of an sslcfg -ac state -T system:mm[x]
handling for standby additional SSL certificate for the
management module standby management module. If where state is: where x is the standby
disabled, the standby management v on to use an additional management-module
module uses the same SSL certificate bay number.
certificate as the primary v off to use the same
management module. certificate
Note: An additional SSL certificate
can only be configured when This command can only
management module advanced be run by users who have
failover is set to "swap" and the one or more of the
standby management module has a following command
valid SSL certificate set up. authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Set SSL state for Enables or disables SSL for the sslcfg -server state -T system:mm[x]
management module management module web server.
web server Note: The SSL for the where state is enabled or where x is the primary
management module web server disabled. or standby
can only be enabled if a valid SSL management-module
certificate is set up. This command can only bay number.
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
338 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Generate self-signed Generates a self-signed certificate sslcfg -cert type -c -T system:mm[x]
certificate for the management module web country -sp "state" -cl
server or the LDAP client. "city" -on "org" -hn where x is the primary
hostname -cp "name" -ea or standby
The following values must be set email -ou "org_unit" -s management-module
when generating a self-signed "surname" -gn bay number.
certificate: "given_name" -in "initial"
v Country using the -c command -dq "dn_qualifier"
option.
v State or province using the -sp where the following
command option. required options are:
v City or locality using the -cl v type is:
command option. – server for a
v Organization name using the -on management module
command option. web server certificate.
v Management module host name – client for an LDAP
using the -hn command option. client certificate.
Note: This host name must v country is two-character
match the host name that is used alphabetic code for the
by a web browser to connect to country.
the management module. v "state" is a state or
province name of up to
The following optional values can 60 characters in length.
be set when generating a v "city" is a city or
self-signed certificate: locality name of up to
v Contact person using the -cp 50 characters in length.
command option. v "org" is an organization
v Email address of the contact name of up to 60
person using the -ea command characters in length.
option. v hostname is a valid host
v Unit within a company or name of up to 60
organization using the -ou characters in length.
command option.
v Additional information such as a where the following
surname using the -s command optional options are:
option. v "name" is up to 60
v Additional information such as a characters in length.
given name using the -gn v email is a valid email
command option. address of up to 60
v Additional information such as characters.
initials using the -in command v "org_unit" is up to 60
option. characters.
v Additional information such as a v "surname" is up to 60
distinguished name qualifier characters.
using the -dq command option. v "given_name" is up to 60
characters.
v "initial" is up to 20
characters.
v "dn_qualifier" is up to 60
characters.
(continued on next page)
340 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Generate CSR Generates a certificate signing sslcfg -csr type -c -T system:mm[x]
request (CSR) for the management country -sp "state" -cl
module web server or the LDAP "city" -on "org" -hn where x is the primary
client. hostname -cp "name" -ea or standby
email -ou "org_unit" -s management-module
The following values must be set "surname" -gn bay number.
when generating a CSR: "given_name" -in "initial"
v Country using the -c command -dq "dn_qualifier" -cpwd
option. password -un "un_name"
v State or province using the -sp
command option. where the following
v City or locality using the -cl required options are:
command option. v type is:
v Organization name using the -on – server for a
command option. management module
v Management module host name web server CSR.
using the -hn command option. – client for an LDAP
Note: This host name must client CSR.
match the host name that is used v country is two-character
by a web browser to connect to alphabetic code for the
the management module. country.
v "state" is a state or
The following optional values can province name of up to
be set when generating a CSR: 60 characters in length.
v Contact person using the -cp v "city" is a city or
command option. locality name of up to
v Email address of the contact 50 characters in length.
person using the -ea command v "org" is an organization
option. name of up to 60
v Unit within a company or characters in length.
organization using the -ou v hostname is a valid host
command option. name of up to 60
v Additional information such as a characters in length.
surname using the -s command
option. where the following
v Additional information such as a optional options are:
given name using the -gn v "name" is up to 60
command option. characters in length.
v Additional information such as a v email is a valid email
initials using the -in command address of up to 60
option. characters.
v Additional information such as a v "org_unit" is up to 60
distinguished name qualifier characters.
using the -dq command option. v "surname" is up to 60
v Additional information such as a characters.
CSR password using the -cpwd v "given_name" is up to 60
command option. characters.
342 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Import certificate file Import (upload) the specified sslcfg -upld -cert -l -T system:mm[x]
certificate file. filename -i ipaddress
where x is the primary
The IP address of the TFTP server where: or standby
for uploading an SSL self-signed v filename is a valid management-module
certificate must be set using the -i filename of up to 256 bay number.
command. characters in length
containing any character
The file name for uploading an SSL except the percent sign (
self-signed certificate can be set % ), forward-slash ( / ),
using the -l command. or double-quote ( " ).
v ipaddress is the IPv4 or
IPv6 IP address of the
TFTP server.
344 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Import/download/ Perform the specified operation on sslcfg -tc2 operation -T system:mm[x]
remove trusted trusted certificate 2 for the SSL
certificate 2 client. Valid operations are: where operation is: where x is the primary
v import (upload) v import or standby
v download v download management-module
v remove v remove bay number.
Note: The -tc2 option
The IP address of the TFTP server
must be used with the
for uploading or downloading a
following options:
trusted certificate must be set using
v -i ipaddress
the -i command.
v -l filename
The file name for uploading or
downloading a trusted certificate where:
can be set using the -l command. v ipaddress is the IPv4 or
IPv6 IP address of the
TFTP server.
v filename is a valid
filename of up to 256
characters in length
containing any character
except the percent sign (
% ), forward-slash ( / ),
or double-quote ( " ).
Example: To view SSL information for the management module in bay 1, while
this management module is set as the persistent command environment, at the
system:mm[1]> prompt, type
sslcfg
The following example shows the information that is returned from this command:
system:mm[1]> sslcfg
-server disabled
-client disabled
SSL Server Certificate status:
A CA-signed certificate is installed
SSL Client Certificate status:
No certificate has been generated
SSL Client Trusted Certificate status:
Trusted Certificate 1: Not available
Trusted Certificate 2: Not available
Trusted Certificate 3: Not available
system:mm[1]>
346 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
syslog command
This command manages how the advanced management module handles
transmission of event log messages to networked syslog event collectors.
Table 79. syslog command
Function What it does Command Valid targets
Display syslog Displays the syslog event log syslog -T system:mm[x]
configuration transmission configuration of the
advanced management module. where x is the primary
management-module
bay number.
Set syslog filter level Set severity filtering levels for syslog -sev level -T system:mm[x]
syslog event log transmission.
where level is: where x is the primary
v i selects error, warning, management-module
and informational logs bay number.
v w selects error and
warning logs
v e selects error logs
348 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 79. syslog command (continued)
Function What it does Command Valid targets
syslog event log Sets the port number for syslog syslog -p1 port -T system:mm[x]
collector 1 port number - event collector 1.
set where port is the collector where x is the primary
1 port number from 1 to management-module
65535, inclusive. If you bay number.
enter a value outside this
range, an error will be
displayed.
Example: To view the syslog event log transmission configuration of the primary
advanced management module in bay 1, while this management module is set as
the persistent command environment, at the system:mm[1]> prompt, type
syslog
The following example shows the information that is returned from this command:
system:mm[1]> syslog
-sev 1
-coll1 enabled
-coll2 disabled
-i1 253.245.45.1
-i2
-p1 514
-p2 514
system:mm[1]>
350 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
tcpcmdmode command
This command displays and changes the timeout of the TCP command-mode
sessions that are used by IBM Systems Director software for out-of-band
communication with the management module. This command is also used to
enable or disable the TCP command-mode sessions.
Table 80. tcpcmdmode command
Function What it does Command Valid targets
Display TCP Displays the secure and non-secure tcpcmdmode -T system:mm[x]
command-mode session TCP command-mode session status
status and timeout (maximum number of sessions) and where x is the primary
timeout. management-module
bay number.
Set TCP command-mode Sets the secure and non-secure TCP tcpcmdmode -t timeout -T system:mm[x]
session timeout command-mode session timeout
value. where timeout is from 0 where x is the primary
seconds (no timeout) to management-module
4294967295 seconds, bay number.
inclusive. If you enter a
value outside this range,
an error will be displayed.
352 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To enable a maximum of three TCP command-mode sessions for the
primary management module, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
tcpcmdmode -status 3
To enable a maximum of five secure TCP command-mode sessions for the primary
management module, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
tcpcmdmode -sstatus 5
To set the TCP command-mode session timeout for the primary management
module to 6 minutes, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
tcpcmdmode -t 360
To display the TCP command-mode session status and timeout for the primary
management module, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
tcpcmdmode
The following example shows the information that is returned from these
commands:
system:mm[1]> tcpcmdmode -status 3
OK
system:mm[1]> tcpcmdmode -sstatus 5
OK
system:mm[1]> tcpcmdmode -t 360
OK
system:mm[1]> tcpcmdmode
-status 3 connections
-sstatus 5 connections
-t 360 seconds
system:mm[1]>
Example: To set the command-line session timeout for the primary management
module to 6 minutes, while management module 1 is set as the persistent
command environment, at the system:mm[1]> prompt, type
telnetcfg -t 360
The following example shows the information that is returned from these two
commands:
system:mm[1]> telnetcfg -t 360
OK
system:mm[1]> telnetcfg
-t 360
system:mm[1]>
354 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
temps command
This command displays actual temperatures and temperature threshold values for
BladeCenter components.
Table 82. temps command
Function What it does Command Valid targets
Display temperature Displays the current temperature temps -T system:mm[x]
values and temperature threshold settings -T system:blade[x]
for the specified component:
-T system:mt
v The management module target
displays the management where x is the primary
module ambient temperature. management-module
v The blade server target displays or blade server bay
the temperature values for number.
components in the specified
blade server, such as
microprocessors and expansion
modules.
v The media tray target displays
values for the temperature sensor
in the media tray.
Example: To view the current temperature and temperature thresholds for the
blade server in bay 3, while this blade server is set as the persistent command
environment, at the system:blade[3]> prompt, type
temps
The following example shows the information that is returned from this command:
system:blade[3]> temps
Hard Warning
Comp Value Warning Shutdown Reset
---- ----- ------- -------- -------
CPU1 38.00 85.00 95.00 78.00
CPU2 35.00 85.00 95.00 78.00
BEM ----- ----- ----- -----
system:blade[3]>
356 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 83. trespass command (continued)
Function What it does Command Valid targets
Set management module Sets trespass feature to default trespass -twd -T system:mm[x]
trespass feature to values:
default values This command can only where x is the primary
v -twe: off
be run by users who have management-module
v -tw (warning message): one or more of the bay number.
WARNING! This computer following command
system and network is PRIVATE authorities:
AND PROPRIETARY and may v Supervisor
only be accessed by authorized v Chassis configuration
users. Unauthorized use of this
computer system or network is See “Commands and user
strictly prohibited and may be authority” on page 8 for
subject to criminal prosecution, additional information.
employee discipline up to and
including discharge, or the
termination of vendor/service
contracts. The owner, or its
agents , may monitor any
activity or communication on the
computer system or network.
The owner, or its agents, may
retrieve any information stored
within the computer system or
network. By accessing and using
this computer system or
network, you are consenting to
such monitoring and information
retrieval for law enforcement and
other purposes. Users should
have no expectation of privacy as
to any communication on or
information stored within the
computer system or network,
including information stored
locally or remotely on a hard
drive or other media in use with
this computer system or
network.
Example:
To set the trespass feature message to 'Authorized Access only', while management
module 1 is set as the persistent command environment, at the system:mm[1]>
prompt, type
trespass -tw "Authorized Access only"
358 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
uicfg command
This command displays and configures the management module user interface
settings.
Table 84. uicfg command
Function What it does Command Valid targets
Display management Displays the user interface settings uicfg -T system:mm[x]
module user interface for the management module.
settings Returned values indicate enabled where x is the primary
or disabled status for the following management-module
interfaces: bay number.
v -cli
v -snmp
v -tcm (TCP command mode)
v -stcm (secure TCP command
mode)
v -web (web interface)
Enable / disable Enables or disables the uicfg -cli state -T system:mm[x]
command-line interface management module
command-line interface (using where state is enabled or where x is the primary
Telnet or SSH). disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable Enables or disables SNMPv1 and uicfg -snmp state -T system:mm[x]
SNMPv1 and SNMPv3 SNMPv3 connections to the
management module. where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
360 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 84. uicfg command (continued)
Function What it does Command Valid targets
Set number of secure Enable or disable the secure TCP uicfg -stcm port_mode -T system:mm[x]
TCP command mode command mode, or sets the
connections maximum number of connections where port_mode is where x is the primary
explicitly. enabled (1 connection), management-module
Notes: disabled (no connections), bay number.
or a number between 0
v On a write operation, the
and 20, inclusive, that
maximum number of
indicates the maximum
connections can be set explicitly
number of secure TCP
(0-20), or it can be enabled (1
session connections.
connection) or disabled (0
connections). This command can only
v On a read operation, disabled be run by users who have
means 0 connections, and one or more of the
enabled means 1 or more following command
connections. authorities:
v The total session count of TCM v Supervisor
and STCM is limited to 20. v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Enable / disable web Enables or disables the uicfg -web state -T system:mm[x]
interface management module web interface.
where state is enabled or where x is the primary
disabled. management-module
bay number.
This command can only
be run by users who have
one or more of the
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Example: To disable Secure TCP command mode for the management module,
while management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
uicfg -stcm disabled
To display the user interface configuration for the management module, while
management module 1 is set as the persistent command environment, at the
system:mm[1]> prompt, type
uicfg
362 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update (update firmware) command
This command updates firmware using the uniform resource locator (URL) of a
TFTP, FTP, HTTP, or HTTPS server and displays information about firmware
installed in BladeCenter components.
Important:
v Some cluster solutions require specific code levels or coordinated code updates.
If the device is part of a cluster solution, verify that the latest level of code is
supported for the cluster solution before you update the code.
v Scalable complexes in a BladeCenter unit require a consistent firmware level on
all blade servers in a complex. When scripting firmware updates for blade
servers in a scalable complex, make sure that the update commands are included
for each node in the complex.
Table 85. update (update firmware) command
Function What it does Command Valid targets
Display firmware Displays attributes of the firmware update -a -T system:mm[x]
attributes installed in the command target.
-T system:blade[x]:sp
Return values are:
v Firmware type -T system:switch[x]
v Build ID
v Filename where x is the primary
v Release date management-module
v Revision level number, standby
management-module
Notes: number, blade server
v When the command target is the bay number, or I/O
primary management module, module bay number.
this command will return the
values for the currently active
firmware and for the pending
firmware, that will become active
after the next management
module reboot.
v For standby advanced
management modules, the
returned value will also indicate
if a firmware update is in
progress and the percentage that
is complete.
v For I/O modules that support it,
this command will also display
firmware image information.
364 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update firmware Update firmware for the command update -u U_R_L -v -T system:mm[x]
(verbose) target, showing details of the
where U_R_L is fully -T system:blade[x]:sp
firmware download and flash
operations. The detailed qualified uniform resource -T system:switch[x]
information is not shown until the locator of a tftp, ftp, http,
update is complete, which might or https server where the where x is the primary
take several minutes. firmware update image is management-module,
Important: Command authority located. blade server bay
definitions might change between number, or
firmware versions. Make sure that This command can only I/O-module bay
the command authority level set for be run by users who have number.
each user is correct after updating one or more of the
management-module firmware. following command
Notes: authorities:
v Updating to older firmware v Supervisor
levels may cause loss of certain v Chassis administration
functionality (for management
v The JS22 or JS12 blade server module)
firmware is too large to be v Blade administration
updated using this command. (for blade server)
See the User's Guide for your v I/O module
JS22 or JS12 blade server for administration (for I/O
information about updating module)
firmware. See “Commands and user
authority” on page 8 for
additional information.
Update I/O module Directly update I/O module update -u U_R_L -img -T system:switch[x]
firmware firmware image. img_index
Note: Only some I/O modules where x is the
have this capability. where: I/O-module bay
v U_R_L is fully qualified number.
uniform resource locator
of a tftp, ftp, http, or
https server where the
firmware update image
is located.
v img_index is the image
index you are updating.
Use the update -a
command to list
available images and
their index numbers.
366 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update and activate I/O Directly update I/O module and update -u U_R_L -img -T system:switch[x]
module firmware activate the firmware image. img_index -activate
Notes: img_index where x is the
v Only some I/O modules have I/O-module bay
this capability. where: number.
v The activate option can be used v U_R_L is fully qualified
with the other options. You can uniform resource locator
flash first, then activate the of a tftp, ftp, http, or
specified index. https server where the
v The image index you activate firmware update image
can be different from the one is located.
you update. v img_index is the image
index you are
activating. Use the
update -a command to
list available images
and their index
numbers.
368 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update I/O module Directly update I/O module update -i ip_address -l -T system:switch[x]
firmware firmware image. filelocation -img img_index
Note: Only some I/O modules where x is the I/O
(Obsolete command. See have this capability. where: (switch) module bay
Note following table.) v ip_address is the IPv4 or number.
IPv6 IP address of the
TFTP server.
v filelocation is the location
of the firmware update
file.
v img_index is the image
index you are updating.
Use the update -a
command to list
available images and
their index numbers.
370 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update and activate I/O Directly update I/O module and update -i ip_address -l -T system:switch[x]
module firmware activate the firmware image. filelocation -img img_index
Notes: -activate img_index where x is the I/O
(Obsolete command. See v Only some I/O modules have (switch) module bay
Note following table.) this capability. where: number.
v The activate option can be used v ip_address is the IPv4 or
with the other options. You can IPv6 IP address of the
flash first, then activate the TFTP server.
specified index. v filelocation is the location
v The image index you activate of the firmware update
can be different from the one file.
you update. v img_index is the image
index you are
activating. Use the
update -a command to
list available images
and their index
numbers.
Note: The -i and -l options for the update command have been replaced by the
-u command option. While the -i and -l options will remain active for a few
releases before being removed, users are encouraged to transition to the -u option
as soon as possible.
To accomplish this transition, the IP address and file location of the firmware
update file or image, specified by the arguments to the -i and -l options, must be
replaced by the -u option followed by an argument that specifies the fully
qualified uniform resource locator (URL) of a tftp, ftp, http, or https server where
the firmware update file or image is located.
The new firmware will become active after the next reset of the MM.
Rebooting AMM...
372 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
uplink (management module failover) command
This command displays and configures the management-module uplink failover
feature. If the external network interface of the primary management module fails,
this feature forces a failover to the standby management module, if one is installed.
374 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 86. uplink command (continued)
Function What it does Command Valid targets
Set IPv6 IP address to Sets the IPv6 IP address of the uplink -ip6 ip_address -T system
check logical network device that the management -T system:mm[x]
uplink module accesses to check its logical where ip_address is a valid
network link. IPv6 IP address. You must where x is the primary
enter a non-zero IP management-module
address, in IPv6 format, bay number.
before you can enable
logical uplink failover.
The following example shows the information that is returned from these
commands:
system:mm[1]> uplink -ep enabled
OK
system:mm[1]> uplink
Failover on network uplink loss is enabled for physical detection
Uplink delay for physical detection: 60 seconds
376 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
users command
This command displays and configures user accounts, also called user profiles, of
the primary management module.
378 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Disable user account Disable the specified users -user_number -T system:mm[x]
management-module user account. -disable
where x is the primary
where user_number is a management-module
number from 1 to 12 that bay number.
corresponds to the user
number assigned in the
"Display all user profiles"
list.
380 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Create user profile Create the specified users -user_number -T system:mm[x]
management-module user profile.
-n user_name -p where x is the primary
All fields must be specified when user_password -a management-module
creating a user profile for the user_authority -cn bay number.
BladeCenter T management context_name -ap
module. auth_protocol -pp
privacy_protocol -ppw
For management modules other privacy_pwd -at access_type
than those installed in a -i ip_addr/hostname -ms
BladeCenter T unit, only the max_sessions
following user-profile fields are
required: where:
v -user_number v user_number is a number
v -n user_name from 1 to 12 that
v -a user_authority corresponds to an
v -p user_password unused user number in
the "Display all user
profiles" list.
v user_name is an
alphanumeric string up
to 15 characters in
length that can include
periods ( . ) and
underscores ( _ ). Each
of the 12 user names
must be unique.
v user_password can be
blank or an
alphanumeric string up
to 15 characters in
length that can include
periods ( . ) and
underscores ( _ ), and
must include at least
one alphabetic and one
non-alphabetic
character.
v user_authority is one of
the following:
– operator (read-only)
– rbs (see Set user
authority level for
more information)
382 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set user name Sets a user name in the specified users -user_number -n -T system:mm[x]
management-module user profile. user_name
where x is the primary
where: management-module
v user_number is a number bay number.
from 1 to 12 that
corresponds to the user
number assigned in the
"Display all user
profiles" list.
v user_name is a
alphanumeric string up
to 15 characters in
length that can include
periods ( . ) and
underscores ( _ ). Each
of the 12 user names
must be unique.
384 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Change user password Changes the user password in the users -user_number -op -T system:mm[x]
specified management-module user old_password -p
profile. new_password where x is the primary
Note: Users can change their own management-module
password even if they do not have where: bay number.
authority to manage accounts. The v user_number is a number
-op option is only used when from 1 to 12 that
changing your own password corresponds to the user
number assigned in the
"Display all user
profiles" list.
v old_password is the
current password for
the specified user.
v new_password can be
blank or an
alphanumeric string up
to 15 characters in
length that can include
periods ( . ) and
underscores ( _ ), and
must include at least
one alphabetic and one
non-alphabetic
character.
386 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set user authority level Notes: The levels can also include
v The LDAP authority levels are one or more of the
(continued) following authority levels
not supported by the
management-module web when using LDAP.
interface. v brpv (Blade Remote
Presence View Video)
v To use the LDAP authority
v brpk (Blade Remote
levels, make sure that the version
Presence KVM)
of LDAP security used by the
v brpr (Blade Remote
management module is set to v2
Presence Remote Drive
(enhanced role-based security
Read)
model). See “ldapcfg command”
v crpru (Blade Remote
on page 210 for information.
Presence Remote Drive
Read or Write)
v rps (Remote Presence
Supervisor)
388 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set SNMPv3 user Sets the SNMPv3 authentication users -user_number -ap -T system:mm[x]
authentication protocol protocol to be used for the auth_protocol
specified management-module user where x is the primary
profile. where: management-module
v user_number is a number bay number.
from 1 to 12 that
corresponds to the user
number assigned in the
"Display all user
profiles" list.
v auth_protocol is:
– sha
– md5
– none
390 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set IP address or Sets the IP address or hostname users -user_number -i -T system:mm[x]
hostname for SNMPv3 that will receive SNMPv3 traps for ip_addr/hostname
trap receiver the specified management-module where x is the primary
user profile. where: management-module
v user_number is a number bay number.
from 1 to 12 that
corresponds to the user
number assigned in the
"Display all user
profiles" list.
v ip_addr/hostname is a
valid static IP address
or an alphanumeric
hostname string up to
63 characters in length.
392 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Remove SSH public key Removes an SSH public key for the users -user_number -pk -T system:mm[x]
specified user. -key_index -remove
Note: The -pk and -remove options v user_number is a number where x is the primary
must be used exclusive of all other from 1 to 12 that management-module
users command options. corresponds to the user bay number.
number assigned in the
"Display all user
profiles" list.
v key_index identifies the
key number from 1 to
12 to remove. If the
-key_index is "all", then
all keys for the user are
removed.
394 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Replace SSH public key Replaces an existing SSH public users -user_number -pk -T system:mm[x]
key. -key_index -upld -i
ip_addr/hostname -l where x is the primary
filename management-module
v user_number is a number bay number.
from 1 to 12 that
corresponds to the user
number assigned in the
"Display all user
profiles" list.
v key_index identifies the
key number from 1 to
12 to replace.
v ip_addr/hostname is a
valid static IPv4 or IPv6
IP address or an
alphanumeric hostname
string up to 63
characters in length of
the TFTP server.
v filename is the filename
of the key file. Keys
must be in OpenSSH
format.
396 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Connect to SSH public Accept connections from SSH users -user_number -pk -T system:mm[x]
key public key host. -key_index -af from="list"
v user_number is a number where x is the primary
from 1 to 12 that management-module
corresponds to the user bay number.
number assigned in the
"Display all user
profiles" list.
v key_index identifies the
key number from 1 to
12 to connect.
v "list" is a
comma-separate list of
hostnames and IP
addresses. The list is an
alphanumeric string up
to 511 characters in
length that can include
alphanumeric
characters, commas,
asterisks, question
marks, exclamation
points, periods, and
hyphens. The string
must be enclosed in
double-quotes.
Example: To create user number 3 with a user name of user3 who has supervisor
rights to all BladeCenter components, while management module 1 is set as the
persistent command environment, at the system:mm[1]> prompt, type
users -3 -n user3 -p passw0rd -a rbs:super:c1|b1-b14|s1-s4 -cn joe -ap md5 -pp des
-ppw passw0rd -at get -I 192.168.70.129
Note: The entry beginning with users -3 -n... is shown with a line break after
-pp des. When this command is entered, the entire entry must all be on one line.
To display all users, while management module 1 is set as the persistent command
environment, at the system:mm[1]> prompt, type
users
The following example shows the information that is returned from these
commands:
Note: The entry beginning with users -3 -n... is shown with a line break after
-a rbs:super:c1|b1-b14|s1-s4. When this command is entered, the entire entry
must all be on one line.
system:mm[1]> users -3 -n user3 -p passw0rd -a rbs:super:c1|b1-b14|s1-s4
-cn joe -ap md5 -pp des -ppw passw0rd -at get -I 192.168.70.129
OK
system:mm[1]> users
0 active session(s)
Password compliant
Account active
398 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Role:cam
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14
Chassis:1
Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user
2. kprevent
0 active session(s)
Password compliant
Account active
Role:supervisor
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14
Chassis:1
Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user
3. johnh
0 active session(s)
Password compliant
Account active
Role:supervisor
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14
Chassis:1
Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user
4. toms
1 active session(s)
Password compliant
Account active
Role:supervisor
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14
Chassis:1
Modules:1|2|3|4|5|6|7|8|9|10
Number of SSH public keys installed for this user: 3
5. <not used>
6. <not used>
7. <not used>
8. <not used>
9. <not used>
10. <not used>
11. <not used>
12. <not used>
system:mm[1]>
Example: To view the current voltage and voltage thresholds for the blade server
in bay 3, while this blade server is set as the persistent command environment, at
the system:blade[3]> prompt, type
volts
The following example shows the information that is returned from this command:
system:blade[3]> volts
Source Value Warning
----------- ------- ----------------
1.8V Sense +1.79 (+1.61,+1.97)
1.8VSB Sense +1.83 (+1.61,+1.97)
12V Sense +12.33 (+10.79,+13.21)
12VSB Sense +12.30 (+10.74,+13.19)
3.3V Sense +3.31 (+2.96,+3.62)
5V Sense +5.06 (+4.39,+5.48)
system:blade[3]>
400 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
write command
This command saves the management-module configuration to the chassis of the
BladeCenter unit or to a file.
Table 89. write command
Function What it does Command Valid targets
Save Saves an image of the write -config chassis -T system:mm[x]
management-module management-module configuration
configuration to chassis to the BladeCenter unit chassis. This command can only where x is the primary
be run by users who have management-module
one or more of the bay number.
following command
authorities:
v Supervisor
v Chassis configuration
See “Commands and user
authority” on page 8 for
additional information.
Save Saves an image of the write -config file -l -T system:mm[x]
management-module management-module configuration filename -i ip_address
configuration to file (no to a file while data encryption is where x is the primary
encryption) not enabled for the BladeCenter where: management-module
unit. v filename is the name of bay number.
the configuration file.
v ip_address is the IPv4 or
IPv6 IP address of the
TFTP server where the
configuration file is
located.
Note: If the -l filename
option is not specified, the
default filename of
asm.cfg is used.
Example:
The following example shows the information that is returned from this command:
system:mm[1]> write -config chassis
OK
Configuration settings were successfully saved to the chassis
system:mm[1]>
402 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
zonecfg command
This command sets and displays the serial attached SCSI (SAS) device information
for BladeCenter components that is stored in I/O modules that support this
feature.
Table 90. zonecfg command
Function What it does Command Valid targets
Display SAS zone list Displays a list of SAS device zones zonecfg -T system:switch[x]
and their information that is stored
in the specified I/O module. where x is the
I/O-module bay
number.
Activate SAS zone - Activates a SAS zone, selected by zonecfg -activate zone -T system:switch[x]
single SAS switch index number, for the specified
SAS switch module. where zone is the index where x is the
Note: If the I/O module is not in number for a valid zone. I/O-module bay
an operating condition that allows Use the zonecfg number.
a zone to be activated, the command, with no
command returns an advisory options, to list valid zones
message. and their index numbers.
Note: If you install both RAID SAS (RSS) and Non-RAID SAS (NSS) mass storage
devices, you can only power on and manage the zone configuration for one at a
time.
Example: To view the list of SAS zones stored in the I/O module in bay 1, while
this I/O module is set as the persistent command environment, at the
system:switch[1]> prompt, type
zonecfg
To activate SAS zone 5 for the I/O module in bay 1, while this I/O module is set
as the persistent command environment, at the system:switch[1]> prompt, type
zonecfg –activate 5
The following example shows the information that is returned from these
commands:
system:switch[1]> zonecfg
Index: 3
Name: Name3
Description string for zone config 3
Status: Inactive
Type: Predefined
Date: <mm>
Index: 5
Name: Name5
Description string for zone config 5
Status: Inactive
Type: Configurable
Date: <mm>
Index: 2
Name: Name2
Description string for zone config 2
Status: Inactive
Type: Configurable
Date: <mm>
Index: 24
Name: Name24
Description string for zone config 24
Status: Active
Type: Configurable
Date: <mm>
system:switch[1]> zonecfg
Index: 3
Name: Name3
Description string for zone config 3
Status: Inactive
Type: Predefined
Date: <mm>
Index: 5
404 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Name: Name5
Description string for zone config 5
Status: Pending
Type: Configurable
Date: <mm>
Index: 2
Name: Name2
Description string for zone config 2
Status: Inactive
Type: Configurable
Date: <mm>
Index: 24
Name: Name24
Description string for zone config 24
Status: Active
Type: Configurable
Date: <mm>
system:switch[1]> zonecfg –activate 5
OK
system:switch[1]>
408 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
v “uplink command errors” on page 467
v “users command errors” on page 468
v “volts command errors” on page 472
v “write command errors” on page 472
v “zonecfg command errors” on page 473
Common errors
This topic lists error messages that apply to all commands.
Each command that has unique errors will also have a list of command-specific
error messages.
Table 91. Common errors
Error message Definition
Alarm panel card is not present in this slot. The user tries to issue a command to an empty alarm
panel card slot.
Backplane Mux card is not present in this slot. The user tries to issue a command to an empty
backplane mux card slot.
Command cannot be issued to this target. Type env - h The user tries to issue a command to a target that does
for help on changing targets. not support that command.
Command line contains extraneous arguments. Extra command arguments were entered.
Duplicate option: option A user tries to enter the same command option in a
single command multiple times. For example, dns -i
where option identifies the command option that was 192.168.70.29 -i
entered more than once.
Each option can only be used once per command. A user tries to enter the same command option in a
single command multiple times. For example, env -T
system:blade[4] -T system:blade[5].
Error: Command not recognized. Type 'help' to get a list A user tries to enter a command that does not exist.
of supported commands.
Error reading data for the option - option An error occurs while the management module is
reading data of a option.
where option identifies the command option that is
returning an error.
Error writing data for the option option An error occurs while the management module is
writing a command option value.
where option identifies the command option that is
returning an error.
Firmware update is in progress. Try again later. Firmware update is in progress.
Illegal option: option An illegal short command option is entered.
where:
v range identifies the range limits
v option identifies the command option
v argument identifies the integer that is out of range
Internal error. An internal error occurs.
where:
v option identifies the command option
v argument identifies the invalid argument
Invalid option. An invalid command option is entered.
Invalid option argument for option: argument An invalid argument for a command option is entered.
where:
v option identifies the command option
v argument identifies the invalid argument
Invalid option for this target: option A user tries to issue a command with an invalid option
for the target.
where option identifies the option that is invalid.
Invalid parameter. Input must be numeric. A user tries to enter a non-numeric argument.
Invalid syntax. Type command - h for help. A user tries to enter a command that is not syntactically
correct.
where command identifies the command that is returning
an error.
Invalid target path. A user tries to issue a command to a target that is not
valid.
Long option option requires an argument A long command option is entered without a required
argument.
where option identifies the long command option that is
missing an argument.
Missing option name A dash (-) is entered without a command option name.
Network Clock card is not present in this slot. The user tries to issue a command to an empty network
card slot.
Read/write command error. An error occurs while the management module is
executing the command.
Short option option requires an argument A short command option is entered without a required
argument.
where option identifies the short command option that is
missing an argument.
Syntax error. Type command -h for help. A user tries to enter a command improperly.
410 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 91. Common errors (continued)
Error message Definition
The target slot is out of range. The user tries to issue a command to a target which is
out of range for that target.
There is no blade present in that bay. The user tries to issue a command to an empty blade
bay.
There is no blower present in that bay. The user tries to issue a command to an empty chassis
cooling unit bay.
There is no management module present in that bay. The user tries to issue a command to an empty
management module bay.
There is no power source present in that bay. The user tries to issue a command to an empty power
module bay.
There is no switch present in that bay. The user tries to issue a command to an empty I/O
module bay.
Unknown long option: option A user tries to enter a long option that is not valid for
the command.
where option identifies the command option that is
unknown.
Unknown option: option An unknown option is used.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 92. accseccfg command errors
Error message Definition
'Password required' is currently disabled. A user without a password tries to change the security
level to -high. User must have a password to perform
this action.
'Password required' is currently enabled. A user without a password tries to change the security
level to -legacy. User must have a password to perform
this action.
Reading account security level failed. An error occurs while the management module is
reading the security level.
Setting account defaults to high level failed. An error occurs while the management module is setting
the security level to -high.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 93. advfailover command errors
Error message Definition
Operation failed. An error occurs while the management module is
processing the command.
Operation not allowed, since the standby MM is not The user tries to enable advanced failover when there is
present. no standby management module installed in the
BladeCenter unit.
412 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 93. advfailover command errors (continued)
Error message Definition
Unknown option: option The user tries to enter an illegal command option.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 94. alarm command errors
Error message Definition
A duplicate option is found in the requested command. A duplicate argument is entered.
Alarm Description must be provided for setting an The user tries to set an alarm without providing an
alarm. alarm description.
Alarm ID must be from 1 to 255. An invalid alarm ID is entered.
Category must be from 1 to 255. An invalid category argument is entered.
Generator ID must be from 1 to 255. An invalid generator ID is entered.
Generator ID must be provided. A generator information ID is provided without a
generator ID.
Module ID must be from 1 to 255. An invalid module ID is entered.
No active alarm. No active alarm is found for the command target.
No matching alarm. No matching alarm is found for the command target.
Reading system health summary failed. An error occurs while the management module is getting
the system health summary.
Severity level must be provided for setting an alarm. The user tries to set an alarm without specifying the
severity level.
Software Generator ID must be from 1 to 255. The user tries to enter an invalid generator information.
The entered Alarm Key is not in proper format. The user tries to enter an invalid alarm key.
Unable to acknowledge the requested alarm. An error occurs while the management module is
acknowledging an alarm.
Unable to clear the requested alarm. An error occurs while the management module is
clearing an alarm.
Unable to set the requested alarm. An error occurs while the management module is setting
an alarm.
There are no unique errors for the alertcfg command. See “Common errors” on
page 409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 95. alertentries command errors
Error message Definition
-test must be used exclusive of other options. The user tries to issue a command with the -test option
at the same time as the other options.
An entry cannot be modified and deleted in the same A user tries to modify an entry and delete it in the same
command. command.
Arguments containing spaces must be enclosed in A user tries to enter a string containing spaces that has
quotation marks. an opening quotation mark without a closing quotation
mark.
Enabling the application alert failed. An error occurs while the management module is
enabling the application alert.
Generating test alert failed. An error occurs while the management module is
generating a test alert.
Invalid input. Angle brackets are not allowed in the A user tries to enter a string parameter containing < or >
name field. for the -n (name) command option.
Invalid option. An invalid command option is entered. This includes
numeric options for the alert recipient that are not from 1
through 12.
Invalid parameter. Input must be numeric. A user tries to enter a parameter value containing
non-numeric characters for a command option requiring
numeric input.
Restoring previous configured value for the application An error occurs while the management module is
alert failed. restoring previous configured value for the application
alert.
Syntax error. -e can only be used in conjunction with the A user tries to enter an invalid email address for the -e
email argument. command option.
Syntax error. -i can only be used in conjunction with the A user tries to enter an invalid IP address for the -i
director argument. command option.
Syntax error. Type alertentries -h for help. An alert entry number is entered without the leading
dash ( - ).
The name must be less than 32 characters long. A user tries to enter too many characters in an input
field.
When creating a new entry, all options are required. A required command option is missing when creating a
user.
414 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
autoftp command errors
This topic lists errors for the autoftp command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 96. autoftp command errors
Error message Definition
Autoftp is disabled, -i, -p, -u and -pw options are A user tries to enter -i, -p, -u, or -pw options when the
invalid. FTP/TFTP mode is set to disabled.
Invalid FTP/TFTP address. A user tries to enter an FTP or TFTP address that is not
valid.
Invalid input. Address must be less than 64 characters. A user tries to enter an address that is 64 or more
characters long.
Invalid input. Password must be less than 64 characters. A user tries to enter a password that is 64 or more
characters long.
Invalid input. Userid must be less than 64 characters. A user tries to enter a user id that is 64 or more
characters long.
Password must be enclosed in quotation marks. A user tries to enter a password without quotation
Displayed when the argument of option -p is not marks.
quote_delimited.
Read autoftp configuration failed. The management module was unable to read the autoftp
configuration.
Read autoftp mode failed. The management module was unable to read the autoftp
mode status.
The mode is tftp, -u and -pw options are invalid. A user tries to enter a user name or password when the
mode is set to TFTP.
User Name must be enclosed in quotation marks. A user tries to enter a user name without quotation
marks.
When disabling autoftp, the -i, -p, -u and -pw options A user tries to enter -i, -p, -u, or -pw options when
are invalid. setting the FTP/TFTP mode to disabled in the same
command.
When setting -m to tftp, the -u and -pw options are A user tries to enter a user name or password when
invalid. setting the FTP/TFTP mode to TFTP in the same
command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 97. baydata command errors
Error message Definition
Error writing bay data to blade bay bayNum. An internal error occurs while the user is changing bay
data for the specified blade server.
where bayNum is the blade bay number.
Invalid blade bay number The command has an invalid bay number.
Notes:
1. The BOFM command displays parsing errors and duplicate addresses that
point to flaws in the comma-separated values (csv) configuration database file.
The BladeCenter Open Fabric Manager is not a standard management module
feature; it is offered and documented separately. See the BladeCenter Open Fabric
Manager Installation and Users Guide for more detailed information.
2. If the number of advanced management module TCP command mode
connections is zero, or if all available TCP command mode connections are in
use, a connection failure message is generated by the BOFM feature. Make sure
that the advanced management module TCP command mode connection limit
is positive and that no more than the available number of connections are in
use. See the BladeCenter Open Fabric Manager Installation and Users Guide for
additional information.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 98. bofm command errors
Error message Definition
Applying new configuration on MM failed. An error occurs while the advanced management
module is applying the BOFM configuration.
Confirming configuration change failed. An error occurs while the advanced management
module is confirming a configuration change.
File transfer failed. An error occurs while transferring a file during file
upload.
Getting BOFM status failed. An error occurs while the advanced management
module is getting BOFM status.
Getting duplicates failed. An error occurs while the advanced management
module is getting duplicates.
Getting parsing errors failed. An error occurs while the advanced management
module is getting parsing errors.
-i and -l are both required to upload a BOFM A user issues a command to apply BOFM configuration
configuration file. to the advanced management module without both -i
and -l options.
416 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 98. bofm command errors (continued)
Error message Definition
Login failed. Login fails while the management module is applying
the BOFM configuration to the advanced management
module.
Parsing errors. An error occurs while the advanced management
module is parsing the BOFM status.
Resetting BOFM configuration on MM failed. An error occurs while the advanced management
module is resetting the BOFM configuration.
Retrieving the file from TFTP server failed. An error occurs while the advanced management
module is retrieving the configuration file from a TFTP
server.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced management
module is uploading a file.
There are no unique errors for the boot command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 99. bootmode command errors
Error message Definition
Boot mode not supported on blade[x] The command is directed to a blade server that does not
support the bootmode feature.
where x is the number of the blade-server bay.
Error retrieving the boot mode of this blade. The management module is unable read the boot mode
of the blade server.
Set the blade boot mode to option failed The management module is unable to set the blade
server boot mode to the specified value.
where option is the selected boot mode.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 100. bootseq command errors
Error message Definition
Error writing boot sequence. An error occurs while the management module is
processing the command.
First device cannot be set to 'nodev'. The user tries to set the first boot device to 'nodev'.
Invalid device for this blade or chassis. The user tries to set a boot device to an invalid choice.
No duplicate settings are allowed. The user tries to set multiple slots in the boot sequence
to the same device.
Second device cannot be set to 'nodev' when third or The user tries to set the second boot device to 'nodev'.
fourth device is set.
Third device cannot be set to 'nodev' when fourth device The user tries to set the third boot device to 'nodev'.
is set.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 101. buildidcfg command errors
Error message Definition
-create must be used exclusive of other options. A user tries to create the blade firmware build ID list
while using another command option. The -create
command option must be run alone.
Adding an entry failed. Please check for duplicates or an An error occurs while adding an entry to the blade
invalid format. firmware build ID list.
Build ID must be enclosed in quotation marks. A user tries to enter a blade firmware build ID without
quotation marks.
Build revision must be enclosed in quotation marks. A user tries to enter a blade firmware build revision
without quotation marks.
Error creating the initial build ID list. An error occurs while creating the blade firmware build
ID list.
Error removing all the build ID entries. An error occurs while removing all blade firmware build
ID list entries.
Error removing build ID entry identifier. An error occurs while removing a blade firmware build
ID list entry.
where the identifier identifies the build ID entry specified.
Importing list failed. Check for duplicates or an invalid An error occurs during blade firmware build ID list
format on line line_number import.
418 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 101. buildidcfg command errors (continued)
Error message Definition
Manufacturer must be enclosed in quotation marks. A user tries to enter a manufacturer name without
quotation marks.
Modifying entry identifier failed. Please check for A user tries to modify an blade firmware build ID list
duplicates or an invalid format. entry with duplicate or wrong information.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 102. chconfig command errors
Error message Definition
Address must be enclosed in quotation marks. A user tries to enter an address that is not enclosed in
quotation marks
City must be enclosed in quotation marks. A user tries to enter a city name that is not enclosed in
quotation marks
IBM Support Center: invalid input. Please input 2 A user tries to enter a country code that is not valid.
characters ISO country code for the IBM Support Center.
Contact Company must be enclosed in quotation marks. A user tries to enter a company name that is not
enclosed in quotation marks
Contact Name must be enclosed in quotation marks. A user tries to enter a contact name that is not enclosed
in quotation marks
Email must be enclosed in quotation marks. A user tries to enter an email that is not enclosed in
quotation marks
Email: invalid input. Please make sure your input is not A user tries to enter an email with a length that is not
empty and within 30 characters. valid
Error to enable/disable Service Agent. An error occurs while the advanced management
module is enabling or disabling the service agent.
Error to enable Service Agent. You have not set all of the A user tries to issue a command to enable a service agent
required contact Information fields yet. that does not have the required contact information set.
HTTP Proxy is disabled now, you can not change proxy A user tries to change proxy settings when the HTTP
settings, please enable http proxy first. proxy is disabled.
Invalid HTTP Proxy location. A user tries to enter a proxy address that is not a valid
IP address or hostname
Invalid input. -loc should be less than 64 characters. A user tries to enter a proxy address that is 64 or more
characters long.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 103. chlog command errors
Error message Definition
-f must be used exclusive of other options. The user tries to use the -f option at the same time as
other options.
-s must be used exclusive of other options. The user tries to use the -s option at the same time as
other options.
A call home event with index number was not found. The management module was unable to find a specified
call-home event activity log entry.
where number is the decimal number that specifies the
serviceable activity log entry that the user is attempting
to acknowledge or unacknowledge.
Error reading data for Terms and Conditions. An error occurs while the management module is
reading the terms and conditions information.
Fail to read Service Advisor Activity Log The management module was unable to read the
call-home event activity log.
Invalid syntax. Type 'chlog -h' for help. A user fails to specify the parameter for the call-home
activity log entry that they are attempting to
acknowledge or unacknowledge.
420 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 103. chlog command errors (continued)
Error message Definition
Terms and Conditions not accepted yet. The user attempts to view the call-home event activity
log but has not yet accepted the Terms and Conditions.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 104. chmanual command errors
Error message Definition
-test must be used exclusive of other options The user attempts to run this command with other
options in addition to -test.
Error generating a manual Call Home This command fails when the user attempts the manual
call home operation.
Error generating a test Call Home This command fails when the user attempts the test call
home operation.
Invalid syntax. Type 'chmanual -h' for help. The user attempts to use this command but uses
improper syntax.
Problem description must be enclosed in quotation The user attempts to run this command when the
marks problem description is not enclosed in quotation marks.
Test Call Home should be operated on SYSTEM target The user attempts to use this command when the
command is not targeted on ‘system’ for test call home.
Terms and Conditions not accepted yet. The user attempts to use this command but has not yet
accepted the Terms and Conditions.
The Service Agent is disabled now, please enable it The user attempts to use this command before the
before calling 'chmanual' service advisor is enabled.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 105. cin command errors
Error message Definition
-id cannot be the same as the blade management VLAN A user tries to enter a command with a VLAN ID which
ID. Please try again. is the same as the VLAN ID of the blade management.
-ip cannot be multicast. Please try again. A user issues a command with an IP address which is
the same as the IP address of the multicast.
-ip cannot be the same as the management module IP A user tries to enter a command with an IP address
address. Please try again which is the same as the IP address of the advanced
management module.
An error occurred while changing CIN global status An error occurs while user is changing CIN global status
setting setting.
An error occurred while clearing CIN entry An error occurs while the user is clearing a CIN entry.
422 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
clear command errors
This topic lists error messages for the clear command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 106. clear command errors
Error message Definition
Firmware update is in progress. Try again later. The user tries to reset the management module to its
default configuration during a firmware update. The
error message displays and the management-module
configuration does not reset.
Internal error resetting to defaults. An error occurs while the management module is
resetting the management module to its default
configuration. The error message displays and the
management-module configuration does not reset.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 107. clearlog command errors
Error message Definition
Error clearing the event log. An error occurs while the management module is
clearing the event log.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 108. clock command errors
Error message Definition
GMT+2:00 requires one of the following dst values: off, The user tries to change the Greenwich mean-time
ee, gtb, egt, or fle (GMT) offset to +2:00 without adjusting the DST setting.
GMT+10:00 requires one of the following dst values: off, The user tries to change the GMT offset to +10:00
ea, tas, or vlad without adjusting the DST setting.
GMToffset requires one of the following dst values: off, The user tries to change the GMT offset to -9, -8, -7, -6,
uc, other or -5 without adjusting the DST setting.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 109. config command errors
Error message Definition
Arguments containing spaces must be enclosed in The user tries to enter an advanced management module
quotation marks. Contact or Location without ending double quotes.
Contact must be enclosed in quotation marks. The user tries to enter an advanced management module
Contact without enclosing it in double quotes.
Invalid input. Contact may not contain angle brackets. The user tries to enter an advanced management module
Contact containing angle brackets ("<" and ">").
Invalid input. Location may not contain angle brackets. The user tries to enter an advanced management module
Location containing angle brackets ("<" and ">").
Invalid input. Name must be less than 16 characters. The user tries to enter a name that is more than 15
characters in length.
Invalid input. Name may not contain angle brackets. The user tries to enter a blade server name that contains
angle brackets: "<" or ">".
Invalid input. Only alphanumeric characters, The user tries to enter a name for the advanced
underscores, hyphens, pound signs, and periods are management module that is not valid.
allowed.
Invalid input. -sn should have exactly seven The user tries to enter a serial number that is not exactly
alphanumeric characters. seven alphanumeric characters.
424 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 109. config command errors (continued)
Error message Definition
Invalid input. -tm should have exactly seven The user tries to enter a type or model name that is not
alphanumeric characters. exactly seven alphanumeric characters.
Invalid input. -uuid should have exactly 32 hex digits. The user tries to enter a universally unique ID that is not
exactly 32 hex digits.
Location must be enclosed in quotation marks. The user tries to enter an advanced management module
Location without enclosing it in double quotes.
Reading SNMPv1/SNMPv3 status failed. An internal errors occurs while the advanced
management module is reading the SNMPv1/v3status.
System location and contact must be defined when The user tries to undefine the system location or contact
SNMPv1 or SNMPv3 agent is enabled. information while an SNMPv1 or SNMPv3 agent is
enabled.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 110. console command errors
Error message Definition
A SOL session socket was not available. The command-line interface fails to establish an SOL
connection to a blade server.
Error entering console mode. An error occurs while the management module is trying
to establish an SOL connection.
Global SOL is not enabled SOL is not enabled globally.
Internal Error An error occurs while the management module is
processing the command.
SOL is not ready The blade server is not available, or when a socket
needed to establish a connection to the blade server is
not available.
SOL on blade is not enabled SOL is not enabled on the blade server where the user is
trying to start an SOL session.
SOL session is already active The user cannot start an SOL session with a blade server
because an SOL session with that blade server is already
in progress.
The maximum number of sessions to this blade has been The blade server has no available sessions for a user to
reached. connect to.
Unknown error occurred while attempting to connect. An unknown error occurs when connecting to a blade
server.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 111. dhcpinfo command errors
Error message Definition
Advanced failover must be enabled before viewing the A user tries to view the configuration of the standby
standby MM's DHCPv6 config. management module when advanced failover is
disabled.
Command cannot be issued to this type of Blade. Type A user issues the dhcpinfo command to a blade server
env –h for help on changing targets. that does not support IPv6.
DHCPv6 information is not available. DHCPv6 is enabled, but the command target is not
receiving any DHCPv6 settings.
DHCPv6 is disabled The DHCPv6 assigned configuration can not be retrieved
because DHCPv6 is disabled.
IPv6 is disabled The DHCPv6 assigned config can not be retrieved
because IPv6 is disabled.
This management network interface is not installed. A user issues the dhcpinfo command to a blade server
that does not support a management network interface.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 112. displaylog command errors
Error message Definition
(There are no more entries in the event log.) There are no more event log entries to display.
-f and -a cannot be used at the same time. The user tries to use the -f and -a options in the same
command.
-l and -i options must be used exclusive of the other The user tries to issue a command with the -l and -i
options. options at the same time as other options.
-lse option must be used exclusive of the other options The user tries to set the -lse option at the same time as
other options.
Both -l and -i options must be provided to save event The user tries to issue a command to save the event log
log. without -l and -i provided.
Cannot open file: filename An error occurs while the management module is trying
to open a file.
where filename is the name of the file that was entered
when the error occurred.
Duplicate date filter: filter The user tries to use duplicate date filters.
where filter is N or C.
426 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 112. displaylog command errors (continued)
Error message Definition
Duplicate severity filter: filter The user tries to use duplicate severity filters.
where:
v filename is the name of the log file
v ip_address is the IP address of the TFTP server
Reading log entries failed. An error occurs while the management module is
reading log entries.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 113. displaysd command errors
Error message Definition
-save and -i must both be specified when saving the A user tries to save the service data without specifying
service data. both the file name and IP address of the TFTP server.
Can not get the SRC's detail information. The advanced management module fails to get the SRC
detail information.
Error retrieving blade type. The advanced management module fails to read the
blade server type.
Error transferring file. An unspecified TFTP error occurs.
No additional information for this SRC. The advanced management module tries to get the detail
information of a SRC which does not have detail
information.
Read/write command error. An error occurs while the management module is
processing the command.
The format of the received data is wrong. The advanced management module receives wrongly
formatted data.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 114. dns command errors
Error message Definition
-on and -off cannot both be used in the same command. A user tries to enable and disable DNS in the same
command.
At least one address is required to enable DNS. A user tries to enable DNS without configuring at least
one address.
DNS State Can not be determined. An error occurs while the management module is
reading the DNS state.
Input length is greater than the maximum characters A user tries to enter too many characters in an input
allowed. field.
Invalid ip address A user tries to set an invalid IP address.
IPv6 configuration changes will not take effect until IPv6 A user attempts to configure the IPv6 DNS settings while
is enabled. IPv6 is disabled.
Reading status of DNS failed. An error occurs while the management module is
reading the DNS state.
Reading status of interface failed. An error occurs while the management module is
reading the status of an interface.
There are no unique errors for the env command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 115. ethoverusb command errors
Error message Definition
Blade SP's command interface on Ethernet-over-USB is The command is directed to a blade server that does not
not supported on blade blade_number support Ethernet-over-USB.
428 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
eventinfo command errors
This topic lists errors for the eventinfo command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 116. eventinfo command errors
Error message Definition
Error reading eventinfo. An error occurs when reading event information.
Invalid event ID. A user attempts to enter an invalid event ID.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 117. events command errors
Error message Definition
-add and -rm should be used exclusively of each other. A user attempts to issue a command with both options
-add and -rm.
Call Home Exclusion List has reached its maximum size A user attempts to add an entry while Call Home
of max entries. No more events can be added to the list. Exclusion List has reached its maximum size.
There are no unique errors for the exit command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 118. feature command errors
Error message Definition
-add option requires -key option The user tries to add a feature license without specifying
the feature license key.
-key option must contain 7 alphanumeric characters An invalid value was entered for the -key option.
Apply operation timed out Applying a license file times out..
Error applying license file. Applying a license file fails.
Error getting errors. An error occurs while retrieving errors when applying a
license file.
Error getting status. An error occurs while getting status when applying or
retrieving a license file.
Error parsing license file. An error occurs while applying or retrieving a license
file.
Error retrieving license file. The license file fails to retrieve.
Error transferring license file. The license file fails to transfer.
Failed to apply license to chassis ip_address An error occurs while applying a license file.
430 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 118. feature command errors (continued)
Error message Definition
Failed to validate chassis serial number An error occur occurs while the advanced management
module is validating the BladeCenter unit serial number.
Make sure that the serial number is correct and retry the
command.
Internal error. An error occurs while retrieving a license file.
Internal error. Something was wrong with the file. An error occurs while applying a license file.
Invalid error data returned Error data is not valid.
Invalid license key An error occur occurs while the advanced management
module is validating the feature license key. Make sure
that the license key is correct and retry the command.
line number: CSV read error. An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error.
line number: File open error. An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error.
line number: Incomplete line. An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error.
line number: Invalid IP. An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error.
line number: Line too long. An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error.
line number: Unknown error: code An error occurs while applying a license file. Error
location in license file is specified in the error message.
where number indicates the line in the license file that is
in error and code indicates the type of error.
Remove license failed An error occur occurs while the advanced management
module is removing a feature license.
Unknown error for chassis ip_address Error type is unknown.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 119. files command errors
Error message Definition
%, /, and \" are not allowed in the filename. The user tries to enter a filename that is invalid.
Directory does not exist. The user tries to enter a directory that does not exist.
Error deleting file filename An error occurs while the management module is trying
to delete a file.
where filename is the name of the file that was entered
for deletion.
Error deleting file filename The user tries to delete a directory or delete a file that
does not exist.
where filename is the name of the file that was entered
for deletion.
Error reading file list. An error occurs while the management module is
reading the directory file list.
Error reading file system space. An error occurs while the management module is
reading the file system space.
Error reading first file in dir directory. An error occurs while the management module is
reading the first file in the directory.
where directory is the name of the directory that was
entered.
File index out of sequence. An error occurs while the management module is
reading the index.
File list exhausted. An error occurs while the management module is
reading the file list.
File not found. The specified file is not found.
Filename must be less than 256 characters The user tries to enter a filename that is longer than 256
characters.
General, unknown error. A command is rejected for unknown reasons.
Invalid command sent. The user tries to enter an invalid command.
Invalid directory, filename. The user tries to enter an invalid directory and filename.
Invalid file or directory name. The user tries to enter an invalid directory or filename.
The directory name must be less than 256 characters. A user tries to enter a directory name that is more than
256 characters in length.
Unknown caller id. The caller ID is not recognized.
Unknown command. The user tries to enter a command that is not recognized.
Unknown directory path. The user tries to enter a directory path that is not
recognized.
432 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
fuelg command errors
This topic lists error messages for the fuelg command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 120. fuelg command errors
Error message Definition
-am cannot be enabled while -e is set to nebs. The user attempts to enable the acoustic mode while the
environment is set to nebs.
-ps and -dps cannot be enabled at the same time. The user attempts to enable -ps and idps at the same
time.
A power module failure in domain domain_number can A power module fails and the domain in which it is
result in an immediate shutdown. installed loses redundancy. The BladeCenter unit might
turn itself off, based on the power management
where domain_number identifies the power domain. configuration.
Blade blade_number is not allowed to power on because There is insufficient power available in the power
of insufficient power. domain to turn on this blade server.
434 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 120. fuelg command errors (continued)
Error message Definition
Getting power management policy for domain An error occurs while the management module is
domain_number failed reading the power management policy of specified
domain.
where domain_number is the number of the domain that
was entered.
Getting power state of bladeblade_number failed. An error occurs while the management module is
reading the power state of specified blade server.
where blade_number identifies the blade server.
Getting power values for blowernumber failed. An error occurs while the management module is
reading the power values of specified chassis cooling
where the number identifies the location of the unit.
component.
Getting power values for DSSnumber failed. An error occurs while the management module is
reading the power values of specified DSS.
where the number represents the specified DSS.
Getting power values for MMnumber failed. An error occurs while the management module is
reading the power values of specified management
where the number identifies the location of the module.
component.
Getting power values for NCnumber failed. An error occurs while the management module is
reading the power values of specified network clock
where the number represents the specified NC. module.
Getting power values for switchnumber failed. An error occurs while the management module is
reading the power values of specified I/O module.
where the number represents the specified I/O module.
Getting power values of midplane within domain failed. An error occurs while the management module is
reading the power values of midplane within domain.
Getting power values of mtnumber within domain failed. An error occurs while the management module is
reading the power values within domain of specified
where the number represents the specified mt. media tray.
Getting power values of muxnumber within domain An error occurs while the management module is
failed. reading the power values within domain of specified
mux.
where the number represents the specified mux.
Getting power values of PM Cooling Device number An error occurs while the management module is
failed reading the power values of specified power module
cooling device.
where the number represents the specified PM cooling
device.
Getting power values of Telco alarm panel within An error occurs while the management module is
domain failed. reading the power values of Telco alarm panel within
domain.
Getting status of domain domain_number failed An error occurs while the management module is
reading the status of specified domain.
where domain_number identifies the power domain.
Getting the power control setting on blade failed. An error occurs while the management module is
reading the power control setting on blade server.
Invalid option for this blade: option The user attempts to issue a command with an option
which is invalid for the targeted blade server.
where option identifies the unacceptable option.
Maximum CPU Speed not available. An error occurs while the management module is
reading maximum CPU Speed.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 121. groups command errors
Error message Definition
When creating a new group, a group name and authority A user tries to create a new group without specifying a
level must be specified. group name or authority level.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 122. health command errors
Error message Definition
Getting system health summary failed. An error occurs while the management module is
reading the system health summary.
436 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
help command errors
This topic lists errors for the help command.
There are no unique errors for the help command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
There are no unique errors for the history command. See “Common errors” on
page 409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 123. identify command errors
Error message Definition
-d can only be used on the system target. The user tries to issue a command with the -d option to
a target other than system.
-d can only be used with the -s on. The user tries to issue a command with the -d option
without -s on setting.
Delay value must be less than max The user input for option -d exceeds the maximum.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 124. ifconfig command errors
Error message Definition
-em cannot be reconfigured while Stacking Mode is The user tries to issue a command with the -em option
enabled on the AMM. while Stacking Mode is enabled on the advanced
management module.
-ep cannot be reconfigured while Stacking Mode is The user tries to issue a command with the -ep option
enabled on the AMM. while Stacking Mode is enabled on the advanced
management module.
-ipv6static, -dhcp6, and -sa6 can't all be disabled. A user attempts to issue a command that disables
-ipv6static, -dhcp6, and -sa6 at the same time.
-option is not supported by this type of I/O Module. The user tries to issue a command with an option -ir, -gr,
or -sr which is not supported by the targeted I/O
where option is ir, gr, or sr. module.
-pip cannot be reconfigured while Stacking Mode is The user tries to issue a command with the -pip option
enabled on the AMM. while Stacking Mode is enabled on the advanced
management module.
-up and -down can not be both used in same line. The user tries to issue a command with both the -up and
-down options.
Cannot apply network configuration. Blade in An error occurs while the management module is setting
configuration phase. the network configuration.
Configuration not supported on this I/O Module type. The user tries to issue a command for the configuration
which is not supported by targeted I/O module type.
Configuration not supported on this switch type. The user tries to issue a command to an unsupported
I/O module type.
Error converting the i6 address from string to bytes. An error occurs while converting the i6 address from a
string to bytes.
Enabling/Disabling new IP configuration failed. An error occurs while the management module is
enabling or disabling the new IP configuration.
438 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 124. ifconfig command errors (continued)
Error message Definition
Error reading gateway address. An error occurs while the management module is
reading the gateway address of a network interface (eth0
or eth1).
Error reading IP Address. An error occurs while the management module is
reading the IP address of the integrated system
management processor on a blade server, or while
reading the IP address of a network interface (eth0 or
eth1).
Error reading data for Link-local address. An error occurs while the management module is
reading data for the link-local address.
Error reading data for Link-local address prefix length. An error occurs while the management module is
reading data for the link-local address prefix length.
Error reading data for Stateless auto-config IP Addresses. An error occurs while the management module is
reading the stateless auto-configuration IP address.
Error reading the burned-in MAC address. An error occurs while the management module is
reading the burned-in MAC address of a network
interface (eth0 or eth1).
Error reading the data rate. An error occurs while the management module is
reading the data rate setting of a network interface (eth0
or eth1).
Error reading the DHCP configuration. An error occurs while the management module is
reading the DHCP setting of a network interface (eth0).
Error reading the duplex setting. An error occurs while the management module is
reading the duplex setting of a network interface (eth0 or
eth1).
Error reading the hostname. An error occurs while the management module is
reading the host name of a network interface (eth0).
Error reading the locally administered MAC address. An error occurs while the management module is
reading the locally administered MAC address of a
network interface (eth0 or eth1).
Error reading the maximum transmission unit. An error occurs while the management module is
reading the maximum transmission unit (MTU) setting of
a network interface (eth0 or eth1).
Error reading the subnet mask. An error occurs while the management module is
reading the subnet mask of a network interface (eth0 or
eth1).
Error writing IP Address. An error occurs while the management module is setting
the IP address of the integrated system management
processor on a blade server.
Getting blade cKVM status for blade blade_number failed. An error occurs while the management module is
reading the cKVM status of targeted blade.
where blade_number identifies the blade server.
Getting interface status failed. An error occurs while the management module is
reading the interface status.
I/O Module is in Stacking Mode and cannot change its The user tries to issue a command to change the
Gateway configuration. Gateway configuration with the I/O Module in Stacking
Mode.
I/O Module is in Stacking Mode and cannot change its The user tries to issue a command to change the IP
IP configuration. configuration with the I/O Module in Stacking Mode.
where:
v option identifies the command option
v hostname identifies the invalid hostname argument
Invalid hostname arg for option: hostname. Length has to The user tries to enter a hostname longer than 63
be < 64 characters characters.
where:
v option identifies the command option
v hostname identifies the invalid hostname argument
Invalid hostname arg for option: hostname. Only The user tries to enter an hostname that contains invalid
alphanumeric chars and._- allowed characters. Valid characters that can be used in a
hostname are letters, numbers, periods ( . ), dashes ( - ),
where: and underscores ( _ ).
v option identifies the command option
v hostname identifies the invalid hostname argument
Invalid ip address. Displays for one of the following errors:
v A user tries to set the IP address of system:blade[1]:sp
to an invalid IP address.
v A user tries to set an IP address whose last part is
greater than 255 (the maximum number of blade
servers).
v A user tries to enter an invalid IP address for the -i
(static IP address) command option.
Invalid IP arg for option: ip_address. Each byte has to be The user tries to enter an IP address that is out of range.
in the range (0-255) IP addresses must follow the standard format:
xxx.xxx.xxx.xxx, where each xxx is a number from 0 to
where: 255.
v option identifies the command option
v ip_address identifies the invalid IP address argument
Invalid IP arg for option: ip_address. Enter 4 bytes The user tries to enter an IP address that is too long. IP
separated by 3 dots addresses must follow the standard format:
xxx.xxx.xxx.xxx, where each xxx is a number from 0 to
where: 255.
v option identifies the command option
v ip_address identifies the invalid IP address argument
Invalid IP arg for option: ip_address. Too few bytes The user tries to enter an IP address with too few bytes.
IP addresses must follow the standard format:
where: xxx.xxx.xxx.xxx, where each xxx is a number from 0 to
v option identifies the command option 255.
v ip_address identifies the invalid IP address argument
Invalid IP arg for option: ip_address. Too many bytes The user tries to enter an IP address with too many
bytes. IP addresses must follow the standard format:
where: xxx.xxx.xxx.xxx, where each xxx is a number from 0 to
v option identifies the command option 255.
v ip_address identifies the invalid IP address argument
Invalid mac address. The user tries to enter an invalid MAC address.
440 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 124. ifconfig command errors (continued)
Error message Definition
Invalid MAC arg for option: address. Invalid syntax The user tries to enter an invalid MAC address.
where:
v option identifies the command option
v address identifies the invalid MAC address argument
Invalid MAC arg for option: address. Multicast addresses The user tries to enter a multicast address.
not allowed
where:
v option identifies the command option
v address identifies the invalid MAC address argument
Invalid MAC arg for option: address. Too few bytes The user tries to enter a MAC address with too few
bytes.
where:
v option identifies the command option
v address identifies the invalid MAC address argument
Invalid MAC arg for option: address. Too many bytes The user tries to enter a MAC address with too many
bytes.
where:
v option identifies the command option
v address identifies the invalid MAC address argument
Invalid option for ethernet interface. A user tries to change a static property of eth1
(hostname, DHCP, data rate, duplex).
Invalid parameter. The locally administered MAC The user tries to set the locally administered MAC
address cannot be a multicast address. address to a multicast address.
Invalid parameter. The MTU must be between 60 and The user tries to enter an MTU outside the valid range.
1500, inclusive.
Invalid parameter. Valid values for -c are dhcp, static, or A user tries to enter an invalid parameter for the -c
dthens. (Ethernet configuration method) command option.
Invalid parameter. Valid values for -d are auto, half, and The user tries to enter an invalid parameter with the -d
full. option.
Invalid parameter. Valid values for -r are auto, 10, and The user tries to enter an invalid parameter with the -r
100. option.
Invalid subnet mask. The user tries to enter an invalid subnet mask.
Maybe blade network configuration is still in discovery An error occurs while the management module is
phase. Please check and try again. reading the blade network configuration.
Option: -bsmp is not supported any more. The user tries to direct the command to the -bsmp
command target that is no longer supported.
Please check blade health status and try again. An error occurs while the management module is
reading the blade health status.
The target must be system:blade[1]:sp for this command A user tries to issue the ifconfig -i ip address -T
system:blade[x]:sp to a blade server other than blade[1].
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 125. info command errors
Error message Definition
Device not found No VPD is available for the targeted device.
Getting blade H8 firmware VPD data of blade An error occurs while the management module is
blade_number failed. reading the blade H8 firmware VPD data of the targeted
blade server.
where blade_number identifies the blade server.
Getting compact flash cards information failed. An error occurs while the management module is
reading the compact flash cards information.
Getting firmware version of cKVM bay_number failed. An error occurs while the management module is
reading the firmware version of targeted cKVM.
where the bay_number specifies the cKVM.
Getting firmware's VPD data of type failed. An error occurs while the management module is
reading the firmware's VPD data of targeted type.
Getting name of blade blade_number failed. An error occurs while the management module is
reading the name of the targeted blade server.
where blade_number identifies the blade server.
Getting name of mm bay_number failed. An error occurs while the management module is
reading the name of the targeted management module.
where the bay_number specifies the management module.
Reload Firmware VPD failed. An error occurs while the management module is
reloading the firmware VPD.
Reload Hardware VPD failed. An error occurs while the management module is
reloading the hardware VPD.
Reload all failed. An error occurs while the management module is
reloading all VPD and MAC addresses.
Reload MAC address failed. An error occurs while the management module is
reloading the MAC address.
Reload WWN failed. An error occurs while the management module is
reloading WWN.
Status: Unable to read status. An error occurs while the management module is
reading the firmware update status.
Unable to read firmware VPD. An error occurs while the management module is
reading the firmware VPD.
Unable to read hardware VPD. An error occurs while the management module is
reading the hardware VPD.
Unknown device type. The command is targeted to an unknown device type.
442 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
iocomp command errors
This topic lists errors for the iocomp command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 126. iocomp command errors
Error message Definition
Error reading I/O Compatibility Detail for blade An error occurs while the management module is
blade_number reading I/O compatibility for targeted blade server.
where
v the bay_number identifies the I/O module
v sw_width identifies the invalid width
I/O Compatibility Detail or blade blade_number: An error occurs while the management module is getting
unknown the width of the targeted blade server.
There are no unique errors for the kvm command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 127. ldapcfg command errors
Error message Definition
A Client DN password is configured, client DN must be The user tries to issue a command to remove the client
configured too. DN setting with the client DN password configured.
AMM target name is limited to 63 characters. A user tries to set an advanced management module
target name that is longer than 63 characters.
Argument of option -arguments must be enclosed in The user tries to issue a command with arguments for
quotation marks. the options that are not enclosed in quotation marks.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 128. led command errors
Error message Definition
-d can only be used with the -loc on. A user tries to issue a command to set the -d while the
-loc setting is off.
Delay value must be less than max. User input for the option -d exceeds the maximum.
444 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 128. led command errors (continued)
Error message Definition
The chassis location LED cannot be turned off at this A user issues a command to turn off the chassis location
time because one or more blades have their location LED LED under conditions when this is not allowed.
active.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 129. list command errors
Error message Definition
The level must be non-zero. The user tries to enter a level of depth for tree-structure
display of 0.
There are no unique errors for the mcad command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 130. modactlog command errors
Error message Definition
Unable to read the Module Activity Log. No module activity log is found in the database.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 131. monalerts command errors
Error message Definition
-option must be used exclusive of its sub-options. A user tries to issue a command with the -ca, -wa, or -ia
option at the same time as its sub-options.
where option is -ca, -wa, or -ia.
Invalid syntax. -ec is only allowed to be enabled. A user tries to disable -ec (legacy alerts).
Note: If -ec is disabled, monalertsleg should be used. A user tries to issue a monalerts command with the -ec
disabled setting.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
mt command errors
This topic lists errors for the mt command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 133. mt command errors
Error message Definition
Remote media tray switching must be enabled to change A user tries to issue a command to change the media
the media tray owner. tray owner while media tray switching is not enabled.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 134. nat command errors
Error message Definition
Adding code authority failed. A user tries to add code authority.
External port: Valid range is 1000 through 65534. The user tries to set the external port number to a value
outside of its valid range.
I/O Module is in protected mode and cannot be restored The user tries to restore the default configuration of an
to its default configuration. I/O module while it is in protected mode.
I/O Module is in Protected Mode and cannot change its The user tries to change the configuration of an I/O
NAT configuration. module while it is in protected mode.
Internal port: Valid range is 1 through 65534. The user tries to set the internal port number to a value
outside of its valid range.
NAT configuration is not supported on this IO module. The user tries to direct a nat command to an I/O module
that does not support the network address table.
The first two rules' protocol names cannot be changed. The user tries to change the protocol names for HTTP or
Telnet.
446 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 134. nat command errors (continued)
Error message Definition
When creating a new rule, all fields must be specified. The user does not specify all the fields when attempting
to make a new rule.
Invalid input. '-pn' must be less than maximum_number The user tries to enter a protocol name with a string
characters. length of more than the maximum allowed.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 135. ntp command errors
Error message Definition
Invalid value passed to -en flag. Valid values are The user input for the -en option is invalid.
enable/disable
Please set NTP server name or IP address before The user tries to enable NTP before setting the server
enabling NTP name or IP address.
Please set NTP server name or IP address before The user tries to synchronize the clock before setting the
synchronizing the clock NTP server name or IP address.
Please set NTP update frequency before enabling NTP The user tries to enable NTP before setting the update
frequency.
Please set NTP v3 authentication entry before enabling The user tries to enable NTP authentication before
NTP authentication configuring the v3 authentication.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 136. ping command errors
Error message Definition
Error reading IP address of switch bay_number An error occurs while the management module is getting
the current IP address of the targeted switch.
where the bay_number designates the I/O module.
Error reading I/O Module's capabilities. An error occurs while the management module is
reading the I/O Module's capabilities.
Error reading I/O Module's second ip configuration. An error occurs while the management module is
reading the I/O Module's second ip configuration.
Error reading second IP address of I/O Module An error occurs while the management module is
bay_number reading the second IP address of the I/O Module
specified.
where the bay_number identifies the I/O module.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 137. pmpolicy command errors
Error message Definition
Error getting number of domains. An error occurs while the advanced management
module is getting the number of domains.
Getting current policy failed. An error occurs while the advanced management
module is getting the current policy for a domain.
Getting valid policies failed. An error occurs while the advanced management
module is getting the valid policies for power
management.
There are no unique errors for the portcfg command. See “Common errors” on
page 409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 138. ports command errors
Error message Definition
A certificate must first be in place before SSL can be The user tries to enable SSL before setting up a valid SSL
enabled. certificate.
An SSH server key must first be in place before SSH can The user tries to enable SSH before setting up a valid
be enabled. SSH server key.
Duplicate port number entered. The user tries to enter a command with a port number
that is already in use.
Enabling SNMPv1 failed The SNMPv1 configuration does not meet required
criteria.
Enabling SNMPv3 failed The SNMPv3 configuration does not meet required
criteria.
Error: A community is configured without an IP address Attempted to configure community without an IP
or host name. Please use ‘snmp' command for snmp address or host name.
configuration.
448 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 138. ports command errors (continued)
Error message Definition
Error: A duplicate community name is configured. Please Attempted to configure a community name that was
use ‘snmp' command for snmp configuration. already defined.
Error: At least one configured community is required to Attempted to enable SNMPv1 without configuring at
enable SNMPv1. Please use ‘snmp' command for snmp least one community.
configuration.
Error: IP address of 0.0.0.0, 0::0 is allowed only when the IP address of 0.0.0.0 or 0::0 is allowed only when the first
first community is configed as Get or Set access type. community is configured as a GET or SET access type.
Please use ‘snmp' command for snmp configuration.
Error: System contact must be defined to enable Attempted to enable SNMPv1 without defining a system
SNMPv1. Please use ‘snmp' command for snmp contact.
configuration.
Error: System location must be defined to enable Attempted to enable SNMPv1 without defining a system
SNMPv1. Please use ‘snmp' command for snmp location.
configuration.
Error: System contact must be defined to enable Attempted to enable SNMPv3 without defining a system
SNMPv3. Please use ‘snmp' command for snmp contact.
configuration.
Error: System location must be defined to enable Attempted to enable SNMPv3 without defining a system
SNMPv3. Please use ‘snmp' command for snmp location.
configuration.
Error sanity checking of SNMP configuration. An error occurs while the management module is
checking the SNMP configuration.
Invalid parameter. The timeout must be between 0 and The user tries to enter a timeout that is outside of the
4294967295 seconds. valid range.
Maximum connections can not exceed 20. A user attempts to configure more than 20 connections.
No valid server certificate is in place for Secure TCP A user tries to change the state of stcm without a valid
Command Mode. Use the sslcfg command to generate a certificate in place.
certificate.
Port number out of range. A user tries to enter a port number that is outside of the
valid range.
Resetting all ports to default values failed. An error occurs while the management module is
resetting all ports to their default values.
Secure SMASH CLP cannot be enabled without a valid The user tries to enable the secure SMASH CLP before
SSH server key in place. setting up a valid SSH server key.
The -prior option has been deprecated. Please use the The user tries to enter a command with a deprecated
-rpp option instead. option, such as -kvmp, -rdp, -rdocp, or -sdsp.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 139. power command errors
Error message Definition
Invalid POST results. The POST results are not valid.
Not supported by this type of I/O module. Type env -h The user attempts to apply the -fp option to an I/O
for help on changing targets. module that does not support this option.
POST results could not be read. An error occurs during POST.
POST results not complete: hex_code The POST results are not available. See the
documentation that comes with the device that failed to
where the hex_code value varies based on the problem respond correctly to the power command for information
that was encountered. about the hex_code value.
Powering on/off blade failed. An error occurs while powering the blade server on or
off.
Powering on/off I/O Module failed. An error occurs while the management module is
powering the I/O module on or off.
Powering on/off network clock failed. An error occurs while the management module is
powering the network clock on or off.
Powering on/off Telco Alarm Panel failed. An error occurs while the management module is
powering the Telco Alarm Panel on or off.
Resetting blade failed. An error occurs while the management module is
resetting the blade server.
Shutting down OS and powering off blade failed. An error occurs while the management module is
shutting down the operating system and powering off
the blade server.
The I/O Module is powering off. The user tries to power on, power off, or restart a RAID
SAS module which is in the process of powering off.
(BladeCenter S only)
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 140. rdoc command errors
Error message Definition
Error getting rdoc status information. An error occurred while retrieving status information.
Internal error. Please try again. The command failed to execute.
450 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
read command errors
This topic lists error messages for the read command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 141. read command errors
Error message Definition
Both the -i and -l options must be specified with the The user does not specify both the -i and -l options when
-config file. restoring configuration from a file.
Configuration restore from the chassis failed: i2c bus An error occurs while the management module is
read error. restoring the management module configuration from the
BladeCenter unit midplane due to an i2c read error.
Configuration restore from the chassis failed: operation An error occurs while the management module is
not supported. restoring the management module configuration from the
BladeCenter unit midplane due to a failed system check.
Configuration restore from the chassis failed: NVRAM An error occurs while the management module is
compression error. restoring the management module configuration from the
BladeCenter unit midplane due to an EEPROM
compression error.
Configuration restore from the chassis failed: An error occurs while the management module is
unsupported midplane data format. restoring the management module configuration from the
BladeCenter unit midplane due to an unsupported
EEPROM format.
Could not retrieve encryption data from the The user tries to enter a passphrase that does not match
configuration file successfully. the one that was used to create the backup configuration
file.
Error writing autoread flag. An error occurs while the management module is
writing autoread flag.
File transfer failed. An error occurs while transferring a file during file
upload.
Firmware update is in progress. Try again later. The user tries to restore the management module
configuration from the BladeCenter unit midplane while
the management module firmware is updating.
Please make sure you enter the correct passphrase for The user tries to enter a passphrase that does not match
this configuration file. the one that was used to create the backup configuration
file.
Resource allocation failure! Memory allocation failed for An error occurs while the management module is
configuration read. allocating memory.
The -auto option can only be used with the -config The user tries to set the -auto option when restoring the
chassis. configuration from a file.
The -config option and a config source is required. The user tries to issue a command to read configuration
from a file without specifying both the -config option
and config source.
The -config option is required. The user does not include a required -config option for
the command.
The -i, -l, and -p options can only be used with the The user tries to specify a TFTP server and a
-config file. configuration file when restoring the configuration from
the BladeCenter unit midplane.
The passphrase is greater than 1600 characters. The user tries to input a passphrase that exceeds the
maximum length.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 142. remotechassis command errors
Error message Definition
Clearing the internal discovered list of MM's failed. An error occurs while the management module is
clearing the internal discovered list of management
modules.
Discovery cannot be run until SLP has been enabled. The user tries to discover other BladeCenter units on the
network when SLP is disabled.
Error running discovery. An error occurs while the management module is
running discovery.
Getting last discovery time failed. An error occurs while the management module is
reading last discovery time.
Getting the first entry of the internal discovered list of An error occurs while the management module is
MM's failed. reading the first entry of the internal discovered list of
management modules.
Getting the internal discovered list of MM's failed. An error occurs while the management module is
reading the internal discovered list of management
modules.
Unable to read SLP settings. An error occurs while the management module is
reading SLP settings.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 143. reset command errors
Error message Definition
An error occurred while disabling failover. An error occurs while the management module is
disabling failover.
An error occurred while enabling failover. An error occurs while the management module is
enabling failover.
452 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 143. reset command errors (continued)
Error message Definition
Firmware update is in progress. Try again later. The user tries to reset the management module during a
firmware update. The error message displays and the
management module does not reset.
Rebooting blade failed. An error occurs while the management module is
rebooting the blade server.
Resetting and running standard/extended/full An error occurs while the management module is
diagnostics for I/O module failed. resetting and running diagnostics for the I/O module.
Resetting I/O module failed. An error occurs while the management module is
resetting the I/O module.
There is no backup management module installed. A user tries to enable failover on a management-module
reset and there is no standby management module.
Resetting blade blade_number with NMI not supported. A user tries to reset a blade server that does not support
non-maskable interrupts (NMI).
where the blade_number identifies the blade server.
Resetting blade blade_number with NMI failed. An error occurs while the management module is
resetting a blade server with NMI.
where the blade_number identifies the blade server.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 144. scale command errors
Error message Definition
Auto-create partition failed: error_detail An error occurs while creating a partition.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 145. sddump command errors
Error message Definition
Initiate data collection of type type not supported on The management module is unable to collect the
blade[x] requested data from the specified blade server.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 146. sdemail command errors
Error message Definition
-to must be specified. A user tries to send a service data email message without
specifying the recipient.
Error sending service data email. An error occurs when the management module tries to
send a service data email message.
Invalid email address. A user tries to enter an email address that is not valid.
Invalid input. Email address must be less than 120 A user tries to enter an email address that is 120 or more
characters. characters long.
Invalid syntax. Please type 'sdemail -h' for help. A user enters the sdemail command without specifying
the required options.
Subject must be enclosed in quotation marks. A user tries to send a service data email message with a
subject option that is not enclosed in quotation marks.
454 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
security command errors
This topic lists errors for the security command.
There are no unique errors for the security command. See “Common errors” on
page 409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 147. service command errors
Error message Definition
Getting status of debug with USB key failed. An error occurs while the management module is
reading the status of debug with a USB key.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 148. shutdown command errors
Error message Definition
Invalid option. This command must have the -f option. The user tries to issue a command without the -f option.
There are no unique errors for the slp command. See “Common errors” on page
409 for a list of error messages that apply to all commands.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 149. smtp command errors
Error message Definition
Getting SMTP server host name or IP address failed. An error occurs while the management module is
reading the SMTP server host name or IP address.
Input length is greater than the maximum characters A user tries to enter too many characters in an input
allowed. field.
Invalid host name or ip address. A user tries to set the SMTP host name or IP address to
an invalid value.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 150. snmp command errors
Error message Definition
Arguments containing spaces must be enclosed in A user tries to enter a string containing spaces that has
quotation marks an opening quotation mark without a closing quotation
mark.
At least one configured community is required to enable A user tries to enable SNMP without configuring at least
SNMP. one community name.
Config failed. IP address of 0.0.0.0 is allowed only for the A user tries to set an IP address of 0.0.0.0 for something
first host name in the first community. other than the first host name of the first community.
Config failed. IP address of 0.0.0.0 is allowed only when A user tries to set an IP address of 0.0.0.0 for the first
the first community is configured as Get access type. host name of the first community when the first
community is not configured with the Get access type.
Config failed. You defined a community without an IP A user tries to define a community without specifying an
address or host name. IP address or host name.
Config failed. You defined a duplicate community name. A user tries to define a two communities with the same
name.
Enabling/Disabling snmp interface failed. An error occurs while the management module is
enabling or disabling an snmp interface.
Enabling/Disabling snmp traps failed. An error occurs while the management module is
enabling or disabling the snmp traps.
Enabling/Disabling SNMPv3 Agent failed. An error occurs while the management module is
enabling or disabling the SNMPv3 Agent.
Input length is greater than the maximum characters A user tries to enter too many characters in an input
allowed. field.
Invalid community name. A user tries to set a community name to an invalid
value.
Invalid host name or ip address. A user tries to set the SNMP host name or IP address to
an invalid value.
Setting access type of type for SNMPv3 failed An error occurs while the management module is setting
access type for an SNMPv3.
where type is the type of SNMPv3 access desired.
Setting location/contact of the SNMP agent failed. An error occurs while the management module is setting
the location or contact of the SNMP agent.
456 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sol command errors
This topic lists error messages for the sol command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 151. sol command errors
Error message Definition
An error occurred while disabling SOL globally. An error occurs while the management module is
disabling SOL globally.
An error occurred while disabling SOL on that blade. An error occurs while the management module is
disabling SOL on a blade server.
An error occurred while enabling SOL globally. An error occurs while the management module is
enabling SOL globally.
An error occurred while enabling SOL on that blade. An error occurs while the management module is
enabling SOL on a blade server.
An error occurred while reading the global SOL status. An error occurs while the management module is
reading the global SOL status.
An error occurred while reading the SOL accumulate An error occurs while the management module is
timeout. reading the SOL accumulate timeout.
An error occurred while reading the SOL retry count. An error occurs while the management module is
reading the SOL retry count.
An error occurred while reading the SOL retry interval. An error occurs while the management module is
reading the SOL retry interval.
An error occurred while reading the SOL send threshold. An error occurs while the management module is
reading the SOL send threshold.
An error occurred while reading the SOL session status An error occurs while the management module is
on that blade. reading the SOL session status on a blade server.
An error occurred while reading the SOL VLAN ID. An error occurs while the management module is
reading the SOL VLAN ID.
An error occurred while setting the SOL accumulate An error occurs while the management module is setting
timeout. the SOL accumulate timeout.
An error occurred while setting the SOL blade reset An error occurs while the management module is
sequence. processing the command.
An error occurred while setting the SOL escape An error occurs while the management module is
sequence. processing the command.
An error occurred while setting the SOL retry count. An error occurs while the management module is setting
the SOL retry count.
An error occurred while setting the SOL retry interval. An error occurs while the management module is setting
the SOL retry interval.
An error occurred while setting the SOL send threshold. An error occurs while the management module is setting
the SOL send threshold.
An error occurred while setting the SOL vlan id. An error occurs while the management module is
processing the command.
Checking if this blade supports SOL failed. An error occurs while the management module is
checking if the selected blade supports SOL.
Invalid arg for -status. Must be on or off. A user tries to enter an invalid argument for the -status
command option.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 152. sshcfg command errors
Error message Definition
Getting CLI SSH port failed. An error occurs while the management module is
reading the CLI SSH port.
Getting DSA host key failed. An error occurs while the management module is
reading the DSA host key.
Getting host key size failed. An error occurs while the management module is
reading the host key size.
Getting installed key status failed. An error occurs while the management module is
reading the installed key status.
Getting number of SSH public keys installed failed. An error occurs while the management module is
reading the number of SSH public keys installed.
Getting SMASH SSH port failed. An error occurs while the management module is
reading the SMASH SSH port.
When displaying host keys, -hk must be used by itself. The user tries to issue a command to display the host
keys with option -hk.
458 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sslcfg command errors
This topic lists errors for the sslcfg command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 153. sslcfg command errors
Error message Definition
-dnld must be used with the -cert/-csr (server, client) as A user tries to issue a download certificate or certificate
well as -i and optionally -l signing request command without the -cert or -csr, and -i
options.
-i must be provided to download a trusted certificate. A user tries to issue a downloading trusted certificate
command without the -i option.
-upld must be used with the -cert (server, client) as well A user tries to issue an import certificate command
as -i and -l without the -cert, -l and -i options.
Cannot open file: filename An error occurs while the management module is trying
to open a file.
where filename is the name of the file that was entered
for opening.
Cert generation for server/client failed An error occurs while the management module is
generating a certificate for the server or client.
where server/client specifies whether the certificate was
being generated for a server or client.
CLI map failed error = error An error occurs while the management module is
mapping the file to memory.
where error specifies error.
Converting DER back to X509 format failed. An error occurs while the management module is
converting DER back to X509 format.
CSR generation for server/client failed An error occurs while the management module is
generating a certificate signing request for a server or
where server/client specifies whether the certificate client.
signing request was being generated for a server or
client.
Downloading Cert/CSR to tftp server argument is failed An error occurs while the management module is
downloading a certificate or certificate signing request to
where: the tftp server for the SSL server or client.
v Cert/CSR specifies whether the user tried to download
a certificate or certificate signing request.
v argument identifies the IP address of the tftp server
Error: unknown application An error occurs because an unknown certificate type is
referred to.
Exporting Cert/CSR failed An error occurs while the management module is
exporting a certificate or certificate signing request.
where Cert/CSR specifies whether the user tried to export
a certificate or certificate signing request.
File transfer failed. An error occurs while transferring a file during file
upload.
Getting filename from tfpt server argument failed An error occurs while the management module is getting
a file from the tftp server.
where:
v filename identifies the name of the requested file
v argument identifies the IP address of the tftp server
460 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 153. sslcfg command errors (continued)
Error message Definition
No tcindex available. A user tries to issue a command to remove or download
a nonexistent trusted certificate.
where index is the number of the selected trusted
certificate.
No valid client certificate is in place. Type 'sslcfg -h' for A user tries to issue a command to enable the SSL client
syntax help of the SSLclient Certificate generation without a valid client certificate in place.
command.
No valid server certificate is in place. Type 'sslcfg -h' for A user tries to issue a command to enable the SSL server
syntax help of the SSL server Certificate generation without a valid server certificate in place.
command.
No valid trusted certificate is in place. Type 'sslcfg -h' for A user tries to issue a command to enable the SSL client
syntax help of the SSL trusted Certificate importing without a valid trusted certificate in place.
command.
Putting filename to tfpt server ip_address failed. An error occurs while the management module is
putting a file to the tftp server.
where:
v filename identifies the command option
v ip_address identifies the IP address of the tftp server
Update Failed, there was a problem retrieving the file. An error occurs while the advanced management
module is uploading a file.
Writing X509 format certificate to file failed. An error occurs while the management module is
writing the X509 format certificate to File.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 154. syslog command errors
Error message Definition
Input length is greater than the maximum characters A user tries to enter too many characters for an input
allowed. field.
Invalid host name or ip address. A user tries to enter an invalid hostname or ip address.
Port number out of range. A user tries to enter an invalid port number.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 155. tcpcmdmode command errors
Error message Definition
Error changing TCP command mode connection. An error occurs while the management module is
changing the TCP command mode Connection.
Error disabling tcpcmdmode. An error occurs while the management module is
disabling the TCP command mode.
Error enabling TCP command mode. An error occurs while the management module is
enabling the TCP command mode.
Invalid parameter. Input must be numeric. A user tries to enter a parameter value for the -t
(timeout) command option containing non-numeric
characters. For example, tcpcmdmode -t 200m.
Invalid parameter. The timeout must be between 0 and A user tries to enter a parameter value for the -t
4294967295 seconds. (timeout) command option that is outside of the valid
range.
Maximum connections can not exceed maximum A user attempted to configure more connections than the
maximum number of connections supported.
where maximum designates the total number of permitted
connections.
No valid server certificate is in place for Secure TCP The user issues a command to enable the Secure TCP
Command Mode. Use the sslcfg command to generate a Command Mode when a valid server certificate is not in
certificate. place.
The total number of secure and legacy connections of A user attempted to configure more TCP Command
TCP Command Mode cannot exceed maximum Mode connections than the maximum number of secure
and legacy connections supported.
where maximum designates the total number of permitted
connections.
Warning: Communication with IBM Director via Secure A user has disabled the Secure TCP command mode.
TCP Command Mode has been disabled.
Warning: Communication with IBM Director via TCP A user has disabled the TCP command mode.
Command Mode has been disabled.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 156. telnetcfg command errors
Error message Definition
Invalid parameter. Input must be numeric. A user tries to enter a Telnet timeout value containing
non-numeric characters. For example, telnetcfg -t 200w.
Invalid parameter. The telnet timeout range must be less The user tries to enter a timeout value greater than
than 4294967295. 4294967295 seconds.
462 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 156. telnetcfg command errors (continued)
Error message Definition
Invalid parameter. The timeout must be between 0 and A user tries to enter a Telnet timeout value that is out of
4294967295 seconds. range.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 157. temps command errors
Error message Definition
Blade blade_number: Too many SDRs found. A database error occurs when too many SDRs are found.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 158. threshold command errors
Error message Definition
A duplicate option is found in the requested command. The user tries to enter a duplicate argument.
Invalid threshold value. The user tries to enter an invalid threshold value.
Unable to query the threshold request. An error occurs during the query threshold request.
Unable to set the requested threshold. An error occurs during the set threshold request.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 159. trespass command errors
Error message Definition
twe must be enabled to modify the trespassing warning. The user tries to issue a command to modify the
trespassing warning without the -twe enabled setting.
The trespassing warning must be quote-delimited. The user tries to enter a trespassing warning that is not
enclosed in double-quotation marks.
The trespassing warning is greater than 1600 characters. The user tries to enter a trespassing warning that is
longer than 1600 characters.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 160. uicfg command errors
Error message Definition
Enabling SNMPv1/v3 failed. The SNMPv1/v3 configuration does not meet required
criteria. Possible configuration errors include:
v A community is configured without an IP address or
host name.
v A duplicate community name is configured.
v At least one configured community is required to
enable SNMPv1.
v IP address of 0.0.0.0 is allowed only for the first host
name in the first community.
v IP address of 0.0.0.0 is allowed only when the first
community is configured as GET or SET access type.
v System contact must be defined to enable
SNMPv1/v3.
v System location must be defined to enable
SNMPv1/v3.
Error sanity checking of SNMP configuration. An error occurs while the management module is
sanity-checking the SNMP configuration.
Maximum connections can not exceed maximum A user has attempted to configure more connections than
the maximum number of connections supported.
where maximum designates the total number of permitted
connections.
No valid server certificate is in place for Secure TCP The user issues a command to configure the Secure TCP
Command Mode. Use the sslcfg command to generate a Command Mode when a valid server certificate is not in
certificate. place
Reading telnet/ssh/snmpv1/snmpv3 status failed. An error occurs while the management module is
reading the telnet, ssh, snmpv1, or snmpv3 status.
The total number of secure and legacy connections of A user attempted to configure more TCP Command
TCP Command Mode cannot exceed maximum Mode connections than the maximum number of secure
and legacy connections supported.
where maximum designates the total number of permitted
connections.
Warning: Communication with IBM Director via Secure A user has disabled the Secure TCP command mode.
TCP Command Mode has been disabled.
Warning: Communication with IBM Director via TCP A user has disabled the TCP command mode.
Command Mode has been disabled.
464 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update command errors
This topic lists error messages for the update command.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 161. update command errors
Error message Definition
-r must be used with -u to update firmware to AMM and A user tries to enter a command with the -r option to
automatically reboot AMM if firmware update succeeds. update firmware to a primary advanced management
module, but fails to include the -u option.
Cannot perform this command right now. The agent is A user tries to enter a command while the agent is not
not active. active.
Disabling failover failed. An error occurs while the management module is
turning off the automatic failover feature.
Error reading information for firmware image An error occurs while the management module is
index.maximum reading information for a specified firmware image.
466 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 161. update command errors (continued)
Error message Definition
Unable to read I/O Module VPD bay bay_number name. The command specifies an empty I/O-module bay or an
error occurs when reading the VPD.
where the bay_number and name identify the I/O module
by location and name.
Unable to read MM VPD bay bay_number name. The command specifies an empty management module
bay or an error occurs when reading the VPD.
where the bay_number and name identify the management
module by location and name.
Unable to read VPD for Blade blade_number name. An error occurs while the management module is
reading the VPD of the targeted blade server.
where the blade_number and name identify the blade
server by location and name.
Unknown device type. The command is targeted to an unknown device type.
Update error. Invalid destination. A user tries to issue a command to a target that is not
valid.
Update Failed, there was a problem retrieving the file. The management module was unable to complete the
update because it was unable to retrieve the file from the
TFTP server.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 162. uplink command errors
Error message Definition
-ip must be a valid IP address before enabling -el A user tries to issue a command to enable the -el without
a valid -ip setting.
A non-zero IP address must be set before enabling -el. A user tries to enable -el while both -ip and -ip6 are zero.
At least one IP address must be non-zero when -el is A user tries to set both -ip and -ip6 to zero while -el is
enabled. enabled.
Error converting the IPv6 address from string to bytes. An error occurs while converting the IPv6 address from
a string to bytes.
Getting status of failver on Lose/Logical of Physical Link An error occurs while the management module is
failed. reading status of failver on Lose/Logical of Physical
Link.
Invalid uplink delay value. A user tries to enter a delay value that is less than 1 or
greater than 255. For example, uplink -del 0.
No option argument for option A user tries to enter a command option without its
required argument.
where option is the command option for which no
argument was specified.
The option argument for option is out of the valid range The user input for an option is out of the range.
(between 1 and 2880 minutes).
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 163. users command errors
Error message Definition
-af contains invalid characters. Only alphanumeric, The user input for the -af option is invalid.
comma, asterisk, question mark, hyphen, period, and
exclamation point characters are valid.
-af must start with from=. The user input for the -af option is invalid.
-cm is greater than 255 characters. The user input for the -cm option exceeds the maximum.
-cm must be quote-delimited. The user input for the -cm option is not quote-delimited.
An entry cannot be modified and deleted in the same A user tries to simultaneously modify and delete a user
command. in the same command.
Arguments containing spaces must be enclosed in A user tries to enter a context name containing spaces
quotation marks. that does not have opening and closing quotation marks.
Deleting user failed. An error occurs while the management module is
deleting an user.
Error converting RBS permissions. An error occurs while the management module is
converting permissions data to the role-based security
(RBS) format.
Error creating user. An error occurs while the management module is
creating a user.
Error creating user: The authentication protocol cannot The user tries to issue a command to create a user with
be none because the security settings require passwords. no authentication protocol when the security settings
require passwords.
Error reading certificate details. An error occurs while the management module is
reading certificate details.
Error reading key. An error occurs while the management module is
reading the key.
Error setting the access type. An error occurs while the management module is setting
the access type.
Error setting the authentication protocol. An error occurs while the management module is setting
the authentication protocol.
Error setting the authority level. An error occurs while the management module is setting
the authority level.
Error setting the context name. An error occurs while the management module is setting
the context name.
Error setting the hostname/IP address. An error occurs while the management module is setting
the hostname or IP address.
468 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 163. users command errors (continued)
Error message Definition
Error setting the password. An error occurs while the management module is setting
the password.
Error setting the password. The new password is not The user tries to issue a command to set the new
compliant. password which is not compliant.
Error setting the privacy password. An error occurs while the management module is setting
the privacy password.
Error setting the privacy protocol. An error occurs while the management module is setting
the privacy protocol.
Error setting the username. An error occurs while the management module is setting
the username.
Error transferring file. An error occurs while the management module is
transferring file.
File transfer failed. An error occurs while transferring a file during file
upload.
Getting a summary of all keys of user index failed. An error occurs while the management module is
reading a summary of all keys of the targeted user.
where the index value varies based on the problem that
was encountered.
Getting authority level of user index failed. An error occurs while the management module is
reading authority level of the targeted user.
where the index value varies based on the problem that
was encountered.
Getting role-based security level of user index failed. An error occurs while the management module is
reading role-based security level of the targeted user.
where the index value varies based on the problem that
was encountered.
Incorrect login permission option: permission A user tries to specify an invalid login permission for the
-a command option.
where the permission value varies based on the problem
that was encountered.
Invalid argument. Valid arguments for -at are read, write, A user tries to set an invalid argument for the -at
and traps. command option.
Invalid argument. Valid choices are des or <none>. A user tries to set an invalid argument for the -pp
command option.
Invalid argument. Valid choices are md5, sha, or <none>. A user tries to set an invalid argument for the -ap
command option.
Invalid authority level. This error message indicates one of the following errors:
v A user tries to set an authority level that is invalid.
v A user tries to set a custom authority level without
specifying any customization information.
Invalid device number (first number must be smaller): A user specifies an invalid device range while trying to
device_A-device_B. create or modify a user.
470 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 163. users command errors (continued)
Error message Definition
Syntax error. Multiple -cn options found. A user tries to enter the -cn option flag in a single
command multiple times.
Syntax error. Multiple -i options found. A user tries to enter the -i option flag in a single
command multiple times.
Syntax error. Multiple -n options found. A user tries to enter the -n option flag in a single
command multiple times.
Syntax error. Multiple -p options found. A user tries to enter the -p option flag in a single
command multiple times.
Syntax error. Multiple -pp options found. A user tries to enter the -pp option flag in a single
command multiple times.
Syntax error. Multiple -ppw options found. A user tries to enter the -ppw option flag in a single
command multiple times.
Syntax error. Type users -h for help. A user tries to set an invalid value for a command
option.
The context name must be less than 32 characters long. A user tries to set a context name that is longer than 31
characters.
The -i and -l options must both be specified when using The user tries to issue a -upld command without -i and
-upld. -l.
The accept_from_string must be quote-delimited. The user input for the -af option is not quote-delimited.
The key is greater than 6000 bytes. The user input for the key exceeds the maximum.
The password must be at least 5 characters long, but no The user tries to enter a password that is too short or too
more than 15 characters long. long.
The password must contain at least one alphabetic and The user tries to enter a password that does not have at
one non-alphabetic character. least one alphabetic and one non-alphabetic character.
The privacy password must also be set when setting the Displays if the user tries to set the privacy protocol to
privacy protocol. des without a specifying a privacy password (-ppw
command option).
The privacy password must be less than 32 characters A user tries to set a privacy password that is longer than
long. 31 characters.
The user index must be different than that of the current The user tries to issue a command to delete the account
user. of current user.
The username cannot be longer than 15 characters. A user tries to set a user name that is longer than 15
characters.
There was a problem retrieving the file. An error occurs while the management module is
retrieving the file.
Unable to change password. The minimum password The user tries to issue a command to change a password
change interval has not expired. Please try again later. while the minimum password change interval has not
expired.
Unable to read the complex password requirement. An error occurs while the management module is
reading the complex password requirement.
Unable to read the password required setting. An error occurs while the management module is
reading the password required setting.
Unexpected error: Unable to change password. An error occurs while the management module is
changing the password.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced management
module is uploading a file.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 164. volts command errors
Error message Definition
Getting power state of blade blade_number failed. An error occurs while the management module is
reading the power state of the targeted blade server.
where blade_number identifies the blade server.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 165. write command errors
Error message Definition
Failed to save configuration settings to the chassis. An error occurs while the management module is saving
the management module configuration to the
BladeCenter unit midplane.
Firmware update is in progress. Try again later. A user tries to save the management module
configuration to the BladeCenter unit midplane while the
management module firmware is updating.
Getting security status failed. An error occurs while the management module is
reading the security status.
The -config option is required. The user does not include a required -config option for
the command.
The -i, -l, and -p options can only be used with the The user tries to specify a TFTP server and a
-config file. configuration file when saving the configuration to the
BladeCenter unit midplane.
The -i option is required with the -config file. A user tries to use the -i option with the -config chassis
option.
The -p option is required when encryption is enabled. The user tries to issue a command without the -p option
while encryption is enabled.
Error creating file in memory. The management module is unable to create the
configuration file.
Error locking file. The management module is unable to lock the
configuration file.
472 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 165. write command errors (continued)
Error message Definition
Error opening file. The management module is unable to open the
configuration file.
Error transferring file. The management module is unable to transfer the
configuration file.
Error generating file. The management module is unable to generate the
configuration file.
Error allocating memory for file. The management module is unable to allocate memory
for the configuration file.
The passphrase is greater than 1600 characters. The user input for the passphrase exceeds the maximum
permitted length.
The passphrase must be quote-delimited. The user input for the passphrase is not quote-delimited.
See “Common errors” on page 409 for a list of error messages that apply to all
commands.
Table 166. zonecfg command errors
Error message Definition
Activating zone configuration xxx on I/O module yyy The management module is unable activate the specified
failed. zone configuration on the specified I/O module.
Getting current active zone number failed. An error occurs while the management module is
reading the current active zone number.
Getting specified configuration of switch slot failed. An error occurs while the management module is
reading the specified configuration of the targeted I/O
where slot identifies the targeted I/O module. module.
Getting zone configuration failed. An error occurs while the management module is
reading the zone configuration.
Invalid slot number for this command. The I/O module is not in slot 3 or 4.
The index must be 32 or less. The configuration index is bigger than 32.
Zone configuration not supported on this switch type. The user tries to use this command on a non-SAS switch
module.
The I/O Module is currently not powered on or in a The user tries to show or activate a zone configuration
fault state. for an RSS or NSS which is in the power-off state and a
fault state.
Error retrieving data for I/O module bay_number. An error occurs while the management module is
reading the data for the specified I/O module.
where bay_number identifies the targeted I/O module.
Use this information to obtain additional information about IBM and IBM
products, determine what to do if you experience a problem with your IBM system
or optional device, and determine whom to call for service, if it is necessary.
If you believe that you require IBM to perform warranty service on your IBM
product, the IBM service technicians will be able to assist you more efficiently if
you prepare before you call.
v Check for updated firmware and operating-system device drivers for your IBM
product. The IBM Warranty terms and conditions state that you, the owner of
the IBM product, are responsible for maintaining and updating all software and
firmware for the product (unless it is covered by an additional maintenance
contract). Your IBM service technician will request that you upgrade your
software and firmware if the problem has a documented solution within a
software upgrade.
You can obtain the latest downloads for your IBM product from
http://www.ibm.com/systems/support/supportsite.wss/
docdisplay?brandind=5000008&lndocid=MIGR-63017 .
v If you have installed new hardware or software in your environment, check
http://www.ibm.com/servers/eserver/serverproven/compat/us/eserver.html to
make sure that the hardware and software is supported by your IBM product.
v Use the troubleshooting information in your system documentation, and use the
diagnostic tools that come with your IBM product. Information about diagnostic
tools is in the Problem Determination and Service Guide on the IBM Documentation
CD that comes with your product.
v Go to http://www.ibm.com/systems/support/ to check for information to help
you solve the problem.
v Gather the following information to provide to IBM service. This data will help
IBM service quickly provide a solution to your problem and ensure that you
receive the level of service for which you might have contracted.
– Hardware and Software Maintenance agreement contract numbers, if
applicable
– Machine type number (IBM 4-digit machine identifier)
– Model number
– Serial number
– Current system UEFI (or BIOS) and firmware levels
– Other pertinent information such as error messages and logs
v Go to http://www.ibm.com/support/electronic/portal/ to submit an Electronic
Service Request. Submitting an Electronic Service Request will start the process
You can find the most up-to-date information for BladeCenter products at
http://publib.boulder.ibm.com/infocenter/bladectr/documentation/index.jsp.
You can find the most up-to-date product information for BladeCenter products at
http://publib.boulder.ibm.com/infocenter/bladectr/documentation/index.jsp.
For information about which products are supported by Support Line in your
country or region, see http://publib.boulder.ibm.com/infocenter/bladectr/
documentation/index.jsp.
For more information about Support Line and other IBM services, see
http://www.ibm.com/services/us/index.wss or see http://www.ibm.com/
planetwide/ for support telephone numbers. In the U.S. and Canada, call
1-800-IBM-SERV (1-800-426-7378).
476 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
In the U.S. and Canada, hardware service and support is available 24 hours a day,
7 days a week. In the U.K., these services are available Monday through Friday,
from 9 a.m. to 6 p.m.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corporation in the United States, other countries,
or both. If these and other IBM trademarked terms are marked on their first
occurrence in this information with a trademark symbol (® or ™), these symbols
indicate U.S. registered or common law trademarks owned by IBM at the time this
information was published. Such trademarks may also be registered or common
law trademarks in other countries.
Intel, Intel Xeon, Itanium, and Pentium are trademarks or registered trademarks of
Intel Corporation or its subsidiaries in the United States and other countries.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc., in
the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Important notes
Processor speed indicates the internal clock speed of the microprocessor; other
factors also affect application performance.
CD or DVD drive speed is the variable read rate. Actual speeds vary and are often
less than the possible maximum.
When referring to processor storage, real and virtual storage, or channel volume,
KB stands for 1024 bytes, MB stands for 1,048,576 bytes, and GB stands for
1,073,741,824 bytes.
Maximum internal hard disk drive capacities assume the replacement of any
standard hard disk drives and population of all hard disk drive bays with the
largest currently supported drives that are available from IBM.
480 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
IBM makes no representation or warranties regarding non-IBM products and
services that are ServerProven®, including but not limited to the implied warranties
of merchantability and fitness for a particular purpose. These products are offered
and warranted solely by third parties.
Some software might differ from its retail version (if available) and might not
include user manuals or all program functionality.
Particulate contamination
Attention: Airborne particulates (including metal flakes or particles) and reactive
gases acting alone or in combination with other environmental factors such as
humidity or temperature might pose a risk to the device that is described in this
document.
Notices 481
Table 167. Limits for particulates and gases (continued)
Contaminant Limits
1 ASHRAE 52.2-2008 - Method of Testing General Ventilation Air-Cleaning Devices for
Removal Efficiency by Particle Size. Atlanta: American Society of Heating, Refrigerating
and Air-Conditioning Engineers, Inc.
Documentation format
The publications for this product are in Adobe Portable Document Format (PDF)
and should be compliant with accessibility standards. If you experience difficulties
when you use the PDF files and want to request a web-based format or accessible
PDF document for a publication, direct your mail to the following address:
Information Development
IBM Corporation
205/A015
3039 E. Cornwallis Road
P.O. Box 12195
Research Triangle Park, North Carolina 27709-2195
U.S.A.
In the request, be sure to include the publication part number and title.
When you send information to IBM, you grant IBM a nonexclusive right to use or
distribute the information in any way it believes appropriate without incurring any
obligation to you.
Properly shielded and grounded cables and connectors must be used in order to
meet FCC emission limits. IBM is not responsible for any radio or television
interference caused by using other than recommended cables and connectors or by
unauthorized changes or modifications to this equipment. Unauthorized changes
or modifications could void the user's authority to operate the equipment.
482 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
This device complies with Part 15 of the FCC Rules. Operation is subject to the
following two conditions: (1) this device may not cause harmful interference, and
(2) this device must accept any interference received, including interference that
might cause undesired operation.
Responsible manufacturer:
Notices 483
empfohlene Kabel angeschlossen werden. IBM übernimmt keine Verantwortung für
die Einhaltung der Schutzanforderungen, wenn das Produkt ohne Zustimmung der
IBM verändert bzw. wenn Erweiterungskomponenten von Fremdherstellern ohne
Empfehlung der IBM gesteckt/eingebaut werden.
Dieses Gerät ist berechtigt, in Übereinstimmung mit dem Deutschen EMVG das
EG-Konformitätszeichen - CE - zu führen.
Verantwortlich für die Einhaltung der EMV Vorschriften ist der Hersteller:
IBM Deutschland
Technical Regulations, Department M456
IBM-Allee 1, 71137 Ehningen, Germany
Telephone: +49 7032 15-2937
Email: tjahn@de.ibm.com
Generelle Informationen:
Das Gerät erfüllt die Schutzanforderungen nach EN 55024 und EN 55022 Klasse
A.
484 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
This is a Class A product based on the standard of the Voluntary Control Council
for Interference (VCCI). If this equipment is used in a domestic environment, radio
interference may occur, in which case the user may be required to take corrective
actions.
Please note that this equipment has obtained EMC registration for commercial use.
In the event that it has been mistakenly sold or purchased, please exchange it for
equipment certified for home use.
Notices 485
486 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Index
Special characters accseccfg (continued)
options
additional SSL certificate
disable for standby management
! 168 alt 32 module 337
? 166 am 33 enable for standby management
cp, on 33 module 337
ct 33 address
A dc 34 IPv6 initial connection 15
accessibility features for this product 2 de, on 34 link local 15
accessible documentation 482 high 32 address prefix length
account inactivity alert time ia 34 set for blade server 190
set for management module 34 ici 35 set for channel 0 of management
account inactivity disable time id 35 module 180
set for management module 35 legacy 31 set for I/O module 198
account lockout period lf 35 advanced failover settings
set for management module 36 lp 36 disable network interface for standby
account security commands 30 mls 36 management module 40
account security settings pc, on 36 display for management module 40
display for management module 30 pe 37 enable network interface for standby
enable complex password for pi 37 management module and allow IP
management module user pr, on 37 swap during failover 40
authentication 33 rc 38 enable network interface for standby
enable default administration wt 38 management module and prevent IP
password expiration for accseccfg command errors 411 swap during failover 41
management module 34 accseccfg commands 30 advanced management module
enable password change at first login example 38 disable logical uplink failover 374
to management module 36 accumulate timeout enable logical uplink failover 374
enable password required for set for SOL 330 enable physical uplink failover 373
management module 37 acknowledge alarms logical uplink failover delay 374
set management module account alarm ID 46 logical uplink failover IP address 374
inactivity alert time 34 complete alarm key 46 logical uplink failover IPv6 IP
set management module account generator ID 45 address 375
inactivity disable time 35 generator information 45 network interface management
set management module account acknowledge call-home activity log entry commands 66
lockout period 36 management module 94 physical uplink failover delay 373
set management module acoustic mode, disable 153 set logical link loss alert and failover
authentication logging timeout 32 acoustic mode, enable 153 policy 375
set management module CLI activate firmware advfailover 40
inactivity timeout 33 I/O module 367, 371 options
set management module default to switch 367, 371 ip. noswap 41
high 32 activate I/O module SAS zone 403 ip. off 40
set management module default to activate network protocol settings ip. swap 40
legacy 31 I/O module 241 advfailover command 40
set management module maximum activate SAS zone example 41
LDAP sessions for user 36 I/O module 403 advfailover command errors 412
set management module maximum Active Directory group, delete 161 air filter
number of login failures 35 Active Directory group, set authority set notification interval 42
set management module minimum level 160 view notification interval 42
number of different characters for Active Directory group, set name 159 air filter notification 42
password 34 Active Directory groups, display airfilter
set management module password (all) 159 example 42
expiration time 37 Active Directory groups, display management module 42
set management module password (specific) 159 airfilter command
minimum change interval 37 add Call Home events 0, 1, 3, 6 months 42
set management module password management module 140, 141 notification interval 42
reuse cycle 38 add feature license alarm
set management module user management module 144 acknowledge (alarm ID) 46
authentication method 33 add firmware build ID list entry acknowledge (complete alarm
set management module web interface blade server 81 key) 46
inactivity timeout 38 add SSH public key 392 acknowledge (generator ID) 45
accseccfg 30 add SSH public key (specific) 392 acknowledge (generator
information) 45
488 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
alerts (continued) binding method blade server (continued)
enable monitoring for system LDAP 215 reset (clear NVRAM) 289
management warning 233 blade mezzanine reset (enter SMS menu) 290
enable monitoring for user activity command target 133 reset (run diagnostics with boot
informational 237 blade server 185, 186 sequence) 289
exclude service information with add firmware build ID list entry 81 reset (run diagnostics) 289
email alerts 51 all blade servers 78 reset (to console) 72, 287
include service information with email bay data 63 reset (with NMI) 288
alerts 51 boot 72 set address prefix length 190
alerts, display 164 boot (to console) 72 set as KVM owner 208
timestamp 164 collect service data 299 set as media tray owner 239
algorithms, encryption 14 command target 132 set boot mode 74
all information reload 204 config command 111, 114 set boot sequence 76, 78
assistance, getting 475 example 114 set Ethernet channel configuration
attributes, display for firmware 363 create firmware build ID list 80 method 188
Australia Class A statement 483 cycle power 72, 273 set Ethernet channel gateway IP
authentication logging timeout delete all entries from firmware build address (IPv4) 186
set for management module 32 ID list 84 set Ethernet channel gateway/default
authentication method delete entry from firmware build ID route (IPv6) 187
LDAP 215 list 85 set Ethernet channel hostname 189
authority, command 8 dhcpinfo commands 117 set Ethernet channel subnet mask
autoftp disable cKVM 185 (IPv4) 187
options disable DHCPv6 191 set Ethernet channel VLAN ID 188
desc 60 disable Ethernet channel 190 set Ethernet-over-USB setting 137
i 61 disable IPv6 190 set I/O module for blade server
m 61 disable IPv6 stateless management traffic 184
p 61 auto-configuration 191 set IP address (IPv4) 185
pw 61 display all SRC records 124 set IP address (IPv6) 186
u 61 display bay data 63 set name 111
autoftp command errors 415 display boot mode 74 set power capping 154
autoftp commands 60 display boot sequence 75 shutdown 273, 306
example 62 display cKVM status 184 turn off 272, 273
autoftp settings display Ethernet-over-USB turn on 272, 273
call-home 60, 61 setting 137 turn on (to console) 272, 273
automatic configuration setting display firmware build IDs 80 update firmware build ID in firmware
display for management module 280 display management network DHCP build ID list 83
automatic power-on policy configuration 117 update firmware build revision in
set for BladeCenter unit 275 display name 111 firmware build ID list 84
display network configuration update firmware type in firmware
status 184 build ID list 83
B display power state 273
display service data 299
update machine type in firmware
build ID list 82
battery backup unit
display specific SRC record 124 update manufacturer in firmware
command target 134
display temperature 355 build ID list 82
baud rate
display voltage 400 blade server ISMP
set for serial port of management
dump service data 299 set IP address (IPv4) 191
module 253
enable cKVM 185 blade server module
bay data
enable DHCPv6 configuration 191 display activity 228
blade server 63
enable dynamic power optimizer 155 display information 228
clear bay data 63
enable dynamic power optimizer, blade server power information display
clear bay data for specific bay 64
extended 156 (overview) 149
display bay data 63
enable Ethernet channel 189 blade server, display power
display bay data for specific bay 63
enable IPv6 190 trending 151, 152
set bay data 64
enable IPv6 stateless blade servers
set data definition to specific blade
auto-configuration 191 disable multiple video sessions 192
server 65
enable local power control 275 enable multiple video sessions 192
baydata 63
enable power capping 154 BladeCenter Open Fabric Manager
options
enable power management 154 BladeCenter units 66
b bay_num 63
enable power saver mode 155 I/O modules 66
b bay_num -clear 64
enable Wake on LAN 274 management module 66, 67, 68, 69,
b bay_num -data
export firmware build ID list 86 70, 71
"data_definition" 65
get service data 299 network interface management
clear 63
import firmware build ID list 85 commands 66
data "data_definition" 64
power off 272, 273 NIC allocation 66
baydata command errors 415
power on 272, 273 BladeCenter S 150
baydata commands 63
power on (to console) 272, 273 display
example 65
reset 72, 286 power management policies 251
Index 489
BladeCenter T specific commands 29 bootmode commands (continued) chassis internal network command
BladeCenter unit example 74 cin 97
command target 132 bootseq 75 chassis internal network
configuring 20 cd 76 configuration 97
disable global cKVM 193 floppy 76 chassis internal network status 102
disable management channel hd0 76 chassis internal network status
auto-discovery 227 hd1 76 command 102
display management channel hd2 76 chconfig 87
auto-discovery status 227 hd3 76 options
display network settings 192 hd4 76 ca 89
display serial number 111 hyper 76 cci 89
display type/model 111 iscsi 76 ce 89
display uuid 111 iscsicrt 76 cn 89
enable global cKVM 193 legacy 76 co 89
enable management channel nodev 76 cph 89
auto-discovery 227 nw 76 cs 89
set automatic power-on policy 275 options cz 89
set VLAN ID 192 all 78 li 87
BladeCenter units uefi 76 loc 91
clear list of discovered 284 usbdisk 76 po 91
display all discovered 283 bootseq command errors 418 ps 91
display filtered by IP address 283 bootseq commands 75 pw 91
display filtered by name 284 example 79 sa 88
display health for all discovered 283 buildidcfg 80 sc 89
blink location LED 169, 222 options u 91
blower ab 81 chconfig command errors 419
command target 134 create 80 chconfig commands 87
blower power information display 149 db 84, 85 example 91
blower temperature display 149 export 86 China Class A electronic emission
blower, display power trending 151, 152 import 85 statement 485
BMC ub, ft 83 chlog 93
command target 133 ub, id 83 options
bofm ub, mfg 82 ack 94
options ub, mt 82 f 93
l , i 66 ub, rev 84 s 93
l , i, d 67 buildidcfg command errors 418 chlog command errors 420
l , i, d on 68 buildidcfg commands 80 chlog commands 93
l , i, p off 70 example 86 example 94
l , i, p on 69 built-in commands 27 chmanual
l , i, v 71 options
bofm command desc 95, 96
example 71
bofm command errors 416
C chmanual command errors 421
chmanual commands 95
call-home
bofm commands 66 example 96
autoftp settings 60, 61
boot 72 cin 97
problem description 95
blade server 72 options
test call home 96
options entry_index -ip ip_address 99
call-home activity log
c 72 entry_index clear 98
acknowledge call-home activity log
p powercycle 72 entry_index en 98
entry for management module 94
p reset 72 entry_index id 99
display for management module 93
boot (to console) global en 97
display FTP/TFTP server entries for
blade server 72 id 100
management module 93
boot command errors 417 vlan_id -ip ip_address 99
display IBM Support entries for
boot commands 72 CIN
management module 93
example 73 turn all index entries on or off 98
unacknowledge call-home activity log
boot mode cin all
entry for management module 94
display for blade server 74 options
capture service information 124
set for blade server 74 clear 97
certificate file (SSL CSR)
boot sequence en state 98
download 342
display for blade server 75 cin command
import 343
set for all blade servers 78 chassis internal network 97
upload 343
set for blade server 76 cin command errors 421
certificate file (SSL self-signed certificate)
bootmode 74 cin commands
download 342
options example 100
import 343
p 74 cin configuration
upload 343
bootmode command errors 417 Specify VLAN ID 100
change command environment 25, 131
bootmode commands 74 CIN configuration 98
change user password 385
490 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
CIN configuration entries 97 clock (continued) commands
CIN configuration entry options (continued) accseccfg 30, 38
create 99 g 107 Active Directory, group
delete 98 t 106 authentication 159
disable 98 clock command errors 423 advfailover 40, 41
enable 98 clock commands 106 airfilter 42
Specify IP address 99 example 110 alarm 43, 49
CIN configuration table clock settings alertcfg 51, 52
display for management module 97 display for management module 106 alertentries 53, 59
CIN index entry collect service data autoftp 60, 62
create 99 blade server 299 baydata 63, 65
Specify IP address 99 command bofm 66, 71
CIN state health 163, 164 boot 72, 73
set for enable or disable 97 system physical configuration 225 bootmode 74
CIN status table entries 102 command authority 8 bootseq 75, 79
cinstatus 102 command environment selecting 6 buildidcfg 80, 86
cinstatus command 102 command history 168 built-in 27
cinstatus commands command redirect 25, 131 chconfig 87, 91
example 102 command syntax 29 chlog 93, 94
cKVM command target 25, 131 chmanual 95, 96
disable for blade server 185 alarm panel 135 cin 100
disable globally for BladeCenter battery backup unit 134 cin command 97
unit 193 blade mezzanine 133 cinstatus 102
enable for blade server 185 blade server 132 cinstatus command 102
enable globally for BladeCenter BladeCenter unit 132 clear 103, 104
unit 193 blower 134 clear management module event
cKVM status BMC 133 log 105
display for blade server 184 disk drive 135 clearlog 105
Class A electronic emission notice 482 high-speed expansion card 133 clock 106, 110
clear I/O module 134 common 27
options I/O-expansion card 133 config 111, 114
cnfg 103 integrated system management configuration 27
clear alarms processor 133 console 115, 116
alarm ID 48 management card 133 dhcpinfo 117, 118
complete alarm key 48 management module 132 discovery 28
generator ID 47 media tray 134 display management module
generator information 47 memory 133 call-home events in events log 93
clear CIN configuration microprocessor 133 display management module event
management module 97 multiplexer expansion module 135 log 119, 123
clear command 103 network clock module 135 displaylog 119, 123
clear command errors 423 power module 134 displaysd 124, 125
clear commands service processor 133 dns 126, 129
example 104 storage expansion unit 133 environment 131, 136
clear event log storage module 135 ethoverusb 137
management module 105 switch module 134 event log, clear for management
clear for management module 97 temporary 7 module 105
clear management module event log view 225 event log, display for management
commands 105 command target selection 6 module 93, 119, 123
example 105 command-line interface eventinfo 138, 139
clearlog enable for management module 359 events 140, 141
l 105 errors 407 examples
clearlog command errors 423 guidelines 5 account security 38
clearlog commands 105 case sensitivity 6 accseccfg 38
example 105 command history 6 advfailover 41
CLI data types 6 alarm 49, 223
exit codes for SSH 20 delimiters 6 alertcfg 52
CLI inactivity timeout help 6 alertentries 59
set for management module 33 options 5 autoftp 62
CLI key sequence output format 6 baydata 65
set for SOL 332 strings 6 blade server name 114
CLI SSH server introduction 1 BladeCenter Open Fabric
disable for management module 336 starting 14 Management 71
enable for management module 336 using 5, 25 bofm 71
clock 106 command-line session configuration boot 73
options display for management module 354 bootmode 74
d 106 command-line timeout bootseq 79
dst 109 set for management module 354 buildidcfg 86
Index 491
commands (continued) commands (continued) commands (continued)
examples (continued) examples (continued) examples (continued)
chconfig 91 management module event log set media tray owner 240
chlog 94 clear 105 set Service Advisor 91
chmanual 96 management module event log set service information 301
cin 100 display 123 shutdown 306
cinstatus 102 management module LDAP slp 307
clear 104 configuration 218 SLP configuration for management
clear management module event management module name 114 module 307
log 105 management module network port smtp 310
clearlog 105 configuration 270 SMTP settings for management
clock 110 management module restore module 310
config 114 configuration 282 snmp 326
configure automated message management module save SNMP settings for management
settings 62 configuration 402 module 326
console 116 management module serial port sol 333
DHCP settings for management settings 254 SSH configuration for management
module 118 management module service 304 module 336
dhcpinfo 118 management module SLP sshcfg 336
display automated message configuration 307 sslcfg 346
settings 62 management module SMTP syntax help 166
display call-home owner 96 settings 310 syslog 350
display KVM owner 209 management module SNMP tcpcmdmode 353
display management module event settings 326 telnetcfg 354
log 123 management module SSH 336 temps 355
display management module management module telnet trespass 357
security 303 configuration 354 uicfg 361
display media tray owner 240 management module uplink update 371
display Service Advisor owner 91 failover 375 uplink 375
display service information mcad 227 user account security 38
owner 301 modactlog 228 user interface configuration 361
displaylog 123 monalerts 238 users 398
displaysd 125 mt 240 volts 400
DNS 129 name for blade server 114 write 402
env 136 name for management zonecfg 404
environment 136 module 114 exit 143
environment redirect 136 nat 244 feature 144, 146
Ethernet network settings for network port configuration for files 147
management module 200 management module 270 fuelg 149, 156
ethoverusb 137 network protocol configuration for group authentication, Active
eventinfo 139 I/O module 244 Directory 159
events 141 ntp 247 groups 159, 162
exit 143 ping 249 help 166
feature 146 pmpolicy 252 history 168
files 147 portcfg 254 identify 169, 170
fuelg 156 ports 270 ifconfig 171, 200
groups 162 power 277 info 203, 205
health 164 rdoc 279 iocomp 206
help 166 read 282 kvm 208, 209
history 168 remotechassis 284 ldapcfg 210, 218
I/O management 71 reset 290 led 220, 223
I/O module network protocol restore configuration for LED 29
configuration 244 management module 282 list 225
identify 170 save configuration for management module event log 28
ifconfig 200 management module 402 management module failover 373,
info 205 scale 298 375
iocomp 206 sddump 300 mcad 227
kvm 209 sdemail 301 memory 29
LDAP configuration for security 303 modactlog 228
management module 218 Serial Over LAN 333 monalerts 229, 238
ldapcfg 218 serial port settings for monalertsleg 229
list 225 management module 254 mt 239, 240
management module DHCP service 304 nat 241, 244
settings 118 set call-home 96 ntp 245, 247
management module DNS 129 set KVM owner 209 ping 248, 249
management module Ethernet set management module pmpolicy 251, 252
network settings 200 security 303 portcfg 253, 254
492 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
commands (continued) config (continued) contact information, Service Advisor
ports 255, 270 options (continued)
power 272, 277 contact 112, 113, 114 phone number 89
power control 29 loc 112 postal code 89
power management 29 name 111 state 89
power management policy 251 config command 111 street address 89
rdoc 278, 279 example 114 contact name
read 280, 282 config command errors 424 display for management module 111
remotechassis 283, 284 configuration set for management module 112, 113,
reset 286, 290 disable automatic for management 114
reset command 29 module 282 contamination, particulate and
restore configuration 29 enable automatic for management gaseous 481
save configuration 29 module 281 create alert recipient 54
scale 291, 298 save for management module (to create CIN configuration entry 99
sddump 299, 300 chassis) 401 create CIN index entry 99
sdemail 301 view for management module 225 create firmware build ID list
security 303 view tree for system 225 blade server 80
Serial Over LAN 328, 333 configuration (encryption) create override SOL session 115
service 304 save for management module (to create partition
session command 29 file) 402 scalable complex 294
shutdown 306 configuration (no encryption) create partition (automatically)
slp 307 save for management module (to scalable complex 292
smtp 309, 310 file) 401 create SOL session 115
snmp 312, 326 configuration commands 27 persistent console 115
SOL 328, 333 configuration from file (encryption) create stand-alone partition
sshcfg 335, 336 restore for management module 281 scalable complex 293
sslcfg 337, 346 configuration from file (no encryption) create stand-alone partition
syslog 347, 350 restore for management module 280 (automatically)
system management command 29 configuration from midplane scalable complex 292
tcpcmdmode 351, 353 restore for management module 280 create user 381
telnet configuration 354 configuration information critical alerts
telnetcfg 354 display for network card 184 disable monitoring for all 229
temps 355 configuration method disable monitoring for blade
trespass 356, 357 set for channel 0 of management device 230
uicfg 359, 361 module 176 disable monitoring for chassis 231
update 363, 371 set for channel of blade server 188 disable monitoring for cooling
uplink 373, 375 configure LDAP command device 231
user interface configuration 359, 361 example 218 disable monitoring for I/O
users 377, 398 configure network ports command module 230
volts 400 example 270 disable monitoring for power
write 401, 402 configure network protocols command module 231
zonecfg 403, 404 example 244 disable monitoring for storage
comment SSH public key 398 configure SLP command module 230
common commands 27 example 307 disable monitoring for system
common errors 409 confirm password management 231
communicating with IBM Systems LDAP distinguished name 216 enable monitoring for all 229
Director 351 connect to SSH public key 397 enable monitoring for blade
communication console 115 device 230
out-of-band 351 create override SOL session 115 enable monitoring for chassis 231
test I/O-module IP address 249 create SOL session 115 enable monitoring for cooling
test IP address 248 non-persistent session 115 device 231
test IP address (I/O-module) 249 options enable monitoring for I/O
communication rate l 115 module 230
set for serial port of management o 115 enable monitoring for power
module 253 persistent console 115 module 231
compatibility console command 115 enable monitoring for storage
I/O module console command errors 425 module 230
display details for blade console commands enable monitoring for system
server 206 example 116 management 231
display details for I/O contact information CSR
module 206 Service Advisor 89 generate for LDAP client 341
display for all components 206 contact information, Service Advisor generate for management module web
component and reloading city 89 server 341
information 203 company 89 CSR (SSL)
component information display 203 contact name 89 download certificate file 342
config 111 country 89 import certificate file 343
email address 89 upload certificate file 343
Index 493
cycle power disable (continued) disable (continued)
blade server 72, 273 logging of login events from same IP SSL for management module web
I/O module 273 address 35 server 337
switch module 273 monitoring for all critical alerts 229 syslog event log transmission for
monitoring for all informational collector 1 347
alerts 234 syslog event log transmission for
D monitoring for all warning alerts 232
monitoring for blade device critical
collector 2 348
TCP command mode 351
data encryption
alerts 230 disable automatic configuration
display management module
monitoring for blade device management module 282
setting 303
informational alerts 235 disable CIN configuration entry 98
enable for management module 303
monitoring for blade device warning disable cKVM
data rate
alerts 232 blade server 185
set for channel 0 of management
monitoring for chassis critical disable DHCPv6
module 177
alerts 231 blade server 191
set for channel 1 of management
monitoring for chassis informational I/O module 198
module 182
alerts 236 management module 180
date
monitoring for chassis warning disable Ethernet channel
display for management module 106
alerts 233 blade server 190
set for management module 106
monitoring for cooling device critical disable Ethernet channel 1
daylight-savings time mode
alerts 231 management module 184
set for management module 109
monitoring for cooling device disable global cKVM
daylight-savings time setting
informational alerts 238 BladeCenter unit 193
display for management module 106
monitoring for cooling device warning disable IPv6
default IP address 15
alerts 234 blade server 190
delete Active Directory group 161
monitoring for event log informational I/O module 197
delete alert recipient 53
alerts 237 management module 179
delete all entries from firmware build ID
monitoring for event log warning disable IPv6 stateless auto-configuration
list
alerts 233 blade server 191
blade server 84
monitoring for I/O module critical I/O module 198
delete all partitions
alerts 230 management module 180
scalable complex 294
monitoring for I/O module disable logical uplink failover
delete CIN configuration 98
informational alerts 235 advanced management module 374
delete entry from firmware build ID list
monitoring for I/O module warning management module (advanced) 374
blade server 85
alerts 232 disable management channel
delete file
monitoring for inventory change auto-discovery
management module 147
informational alerts 236 BladeCenter unit 227
delete partition
monitoring for network change disable multiple video sessions
scalable complex 295
informational alerts 237 blade servers 192
delete user 378
monitoring for power module critical disable NAT table
DHCP configuration
alerts 231 I/O module 244
display for I/O module 117
monitoring for power module disable NEBS environment mode 153
DHCP settings for management module
informational alerts 238 disable network interface
commands
monitoring for power module management module (standby) 40
example 118
warning alerts 234 disable power domain acoustic
dhcpinfo 117
monitoring for power state mode 153
options
informational alerts 236 disable SOL
eth0 117
monitoring for storage module critical global 331
dhcpinfo command errors 426
alerts 230 disable static IPv6 configuration
dhcpinfo commands 117
monitoring for storage module I/O module 197
example 118
informational alerts 235 management module 179
DHCPv6
monitoring for storage module disable technician debug
disable for blade server 191
warning alerts 233 management module 304
disable for I/O module 198
monitoring for system management disable user 379
disable for management module 180
critical alerts 231 discovered BladeCenter units
enable for blade server 191
monitoring for system management clear list 284
enable for I/O module 198
informational alerts 236 display all 283
enable for management module 180
monitoring for system management display filtered by IP address 283
disable
warning alerts 233 display filtered by name 284
additional SSL certificate for standby
monitoring for user activity display health for all 283
management module 337
informational alerts 237 discovery commands 28
blade server Ethernet channel VLAN
secure TCP command mode 352 disk drive 135
ID 189
Service Advisor 88 display
BladeCenter unit VLAN ID 192
SMASH SSH server for management alert state 229
CLI SSH server for management
module 336 clock settings, management
module 336
SSL for LDAP client 338 module 106
enhanced legacy alert categories 229
date, management module 106
494 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
display (continued) display command-line session display I/O module power
daylight-savings time setting, configuration information 149
management module 106 management module 354 display I/O module SAS zone
GMT offset, management display component information 203 information 404
module 106 display configuration information display I/O module SAS zone list 403
management channel path network card 184 display IBM Support call-home activity
information 204 display contact name log
power management policy management module 111 management module 93
all domains 251 display DHCP configuration display information
BladeCenter S 251 I/O module 117 blade server module 228
specified power domain 251 display DNS configuration display IP addresses
TCP command-mode session management module 126 I/O module 248
status 351 display DSA host key information display KVM owner 208
TCP command-mode session management module 335 display LDAP settings
timeout 351 display entries of CIN status table 102 management module 210
time, management module 106 display Ethernet channel 0 configuration display LED state
display (reset counter) event log management module (primary) 171 blower fault 220
management module 119 management module (standby) 172 external port link status 220
display active users 377 display Ethernet channel 0 DHCP fanpack fault 220
display activity configuration fault 220
blade server module 228 management module 117 for blade server and all
display advanced failover settings display Ethernet channel 1 configuration sub-components 221
management module 40 management module (primary) 181 for blade server front panel 220
display alarms display Ethernet-over-USB setting safe-to-remove 220
alarm ID 44 blade server 137 display licenses
all 43 display event description management module 144
complete alarm key 44 management module 138 display location
generator ID 43 display event log management module 111
generator information 44 management module 119 display log entries with call-home events
power 43 display event log entries filtered by date management module 119
display alert properties (all management module 120 display log entries with Event ID
recipients) 53 display event log entries filtered by management module 119
display alert properties (single severity level display management channel
recipient) 53 management module 120 auto-discovery status
display alerts 164 display event log entries filtered by BladeCenter unit 227
timestamp 164 source display management module account
display all Active Directory groups 159 management module 120, 121 security settings 30
display all BladeCenter units on display event user action display management module data
network 283 management module 138, 139 encryption setting 303
display all event log entries display events list display management module event log
management module 119 management module 140 commands 119
display all event log filters display failover configuration example 123
management module 119 management module 373 display management module
display all information display features security 303
scalable complex 291 management module 144 display management module status 124
display all users 377 display file list display management network DHCP
display automatic configuration setting management module 147 configuration
management module 280 display firmware attributes 363 blade server 117
display blade server power information display firmware build IDs display media tray owner 239
overview 149 blade server 80 display media tray temperature 149
display blade server SRC record display free space display name
(specific) 124 management module 140, 147 blade server 111
display blade server SRC records display FTP/TFTP server call-home management module 111
(all) 124 activity log display network configuration status
display blower power information 149 management module 93 blade server 184
display blower temperature 149 display global remote alert settings display network port settings
display boot mode management module 51 management module 255
blade server 74 display health for BladeCenter units on switch 269
display call-home activity log network 283 display network protocol settings
management module 93 display health status 163, 164 I/O module 241
display call-home event management timestamp 164 display network settings
module event log entries 93 display health status (tree) 163 BladeCenter unit 192
display CIN configuration table 97 display I/O module compatibility I/O module 193
display cKVM status all components 206 display node information
blade server 184 display I/O module compatibility details scalable complex 291
blade server 206 display NTP configuration
I/O module 206 management module 245
Index 495
display open ports display telnet configuration dns (continued)
management module 255 management module 354 options (continued)
display partition information display temperature i1 127
scalable complex 291 blade server 355 i2 127
display POST status management module 355 i3 127
I/O module 276 media tray 355 i61 128
switch module 276 display trespass feature status i62 128
display power domain information management module 356 i63 128
details 150 display type/model on 126
display power domain information BladeCenter unit 111 p 129
overview 149 display uplink configuration DNS
display power state management module 373 enable for management module 126
blade server 273 display user interface settings dns command errors 428
I/O module 273 management module 359 dns commands 126
switch module 273 display uuid example 129
display power trending (blade BladeCenter unit 111 DNS configuration
server) 151, 152 display various LED states display for management module 126
display power trending (blower) 151, LED states 220 DNS first IPv4 IP address
152 display voltage set for management module 127
display power trending (I/O blade server 400 DNS first IPv6 IP address
module) 151, 152 management module 400 set for management module 128
display power trending (media tray) 152 displaylog 119 DNS second IPv4 IP address
display power trending (power display log entries with call-home set for management module 127
domain) 151, 152 events 119 DNS second IPv6 IP address
display power trending (system) 151, display log entries with Event ID 119 set for management module 128
152 display state of -lse option 122 DNS server priority
display RSA host key information filter log entries by call-home events set for management module 129
management module 335 flag 122 DNS third IPv4 IP address
display SAS zone information options set for management module 127
I/O module 404 -lse 122 DNS third IPv6 IP address
display SAS zone list a 119 set for management module 128
I/O module 403 c 119 documentation
display serial number ch 122 using 476
BladeCenter unit 111 date 120 documentation format 482
display serial port configuration e 119 Domain Catalog discovery
management module 253 f 119 set search domain 211
display Service Advisor 87 filters 119 domain name
display service data i 122 set for channel 0 of management
blade server 299 i, l 122 module 179
display service data command 124 l 122 set for management module LDAP
display service information 124 l, i 122 server 211
display service setting lse 122 download 344, 345, 346
management module 304 sev 120 download certificate file
display single user 378 src 120, 121 SSL CSR 342
display SLP settings displaylog command errors 426 SSL self-signed certificate 342
management module 307 displaylog commands 119 download SSH public key 396
display SMTP server host name example 123 DSA host key information
management module 309 displaysd 124 display for management module 335
display SMTP server IP address options dump service data
management module 309 i 124 blade server 299
display SNMP configuration i, save 124 duplex mode
management module 312 mmstat 124 set for channel 0 of management
display specific Active Directory save 124 module 177
groups 159 save, i 124 set for channel 1 of management
display specific complex information src 124 module 182
scalable complex 291 displaysd command errors 427 dynamic DNS
display SSH public key 391 displaysd commands 124 enable for management module 126
display SSH status example 125 dynamic power optimizer, enable for
management module 335 distinguished name blade server 155
display state LDAP client 216 dynamic power optimizer, extended ,
location LED 169 distinguished name password enable for blade server 156
display state of -lse option LDAP client 216
management module 122 distinguished name password (confirm)
Display status of first five CIN
entries 102
LDAP client 216
dns 126
E
electronic emission Class A notice 482
display syslog configuration options
Electronic emission notices 482
management module 347 -ddns 126
496 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
email alerts enable (continued) enable IPv6 stateless auto-configuration
exclude service information 51 monitoring for system management (continued)
include service information 51 informational alerts 236 I/O module 198
enable monitoring for system management management module 180
additional SSL certificate for standby warning alerts 233 enable local KVM switching
management module 337 monitoring for user activity globally 208
blade server Ethernet channel VLAN informational alerts 237 enable local media tray switching
ID 189 secure TCP command mode 352 globally 239
BladeCenter unit VLAN ID 192 Service Advisor 88 enable local power control
CLI SSH server for management SMASH SSH server for management blade server 275
module 336 module 336 globally 274
enhanced legacy alert categories 229 SSL for LDAP client 338 enable logical uplink failover
monitoring for all critical alerts 229 SSL for management module web advanced management module 374
monitoring for all informational server 337 management module (advanced) 374
alerts 234 syslog event log transmission for enable management channel
monitoring for all warning alerts 232 collector 1 347 auto-discovery
monitoring for blade device critical syslog event log transmission for BladeCenter unit 227
alerts 230 collector 2 348 enable monitoring of event log state
monitoring for blade device TCP command mode 352 management module 122
informational alerts 235 enable automatic configuration enable multiple video sessions
monitoring for blade device warning management module 281 blade servers 192
alerts 232 enable CIN configuration entry 98 enable NAT table
monitoring for chassis critical enable cKVM I/O module 244
alerts 231 blade server 185 enable NEBS environment mode 153
monitoring for chassis informational enable command-line interface enable network interface and allow IP
alerts 236 management module 359 swap
monitoring for chassis warning enable complex password for management module (standby) 40
alerts 233 management module user enable network interface and prevent IP
monitoring for cooling device critical authentication 33 swap
alerts 231 enable data encryption management module (standby) 41
monitoring for cooling device management module 303 enable NTP
informational alerts 238 enable default administration password management module 245, 262
monitoring for cooling device warning expiration for management module 34 enable password change at first login to
alerts 234 enable DHCPv6 management module 36
monitoring for event log informational blade server 191 enable password required for
alerts 237 I/O module 198 management module 37
monitoring for event log warning management module 180 enable physical uplink failover
alerts 233 enable DNS advanced management module 373
monitoring for I/O module critical management module 126 management module (advanced) 373
alerts 230 enable dynamic DNS enable port
monitoring for I/O module management module 126 switch 269
informational alerts 235 enable dynamic power optimizer for enable power capping for blade
monitoring for I/O module warning blade server 155 server 154
alerts 232 enable dynamic power optimizer, enable power domain acoustic
monitoring for inventory change extended, for blade server 156 mode 153
informational alerts 236 enable Ethernet channel enable power management for blade
monitoring for logging of login events blade server 189 server 154, 155
from same IP address 35 enable Ethernet channel 1 enable power saver mode for blade
monitoring for network change management module 183 server 155
informational alerts 237 enable external management enable protected mode
monitoring for power module critical I/O module 196 I/O module 197
alerts 231 enable external ports enable RDE
monitoring for power module I/O module 196 management module 263
informational alerts 238 enable fast POST enable RDOCE
monitoring for power module I/O module 275, 276 management module 263
warning alerts 234 enable FTP enable remote media tray switching
monitoring for power state management module 261 globally 240
informational alerts 236 enable global cKVM enable secure SMASH over SSH
monitoring for storage module critical BladeCenter unit 193 management module 264
alerts 230 enable HTTPS port enable secure TCP command mode
monitoring for storage module management module 262 management module 266, 360
informational alerts 235 enable IPv6 enable security
monitoring for storage module blade server 190 management module 303
warning alerts 233 I/O module 197 enable SLP
monitoring for system management management module 179 management module 263
critical alerts 231 enable IPv6 stateless auto-configuration enable SMASH over Telnet
blade server 191 management module 264
Index 497
enable SNMP agent env (continued) errors (continued)
management module (SNMPv1) 312 options (continued) exit command 430
management module (SNMPv3) 312 system (management feature command 430
enable SNMP traps module) 132 files command 432
management module 265, 312 tap 135 fuelg command 433
enable SNMPv1 env command errors 428 groups command 436
management module 359 env commands health command 436
enable SNMPv1 agent example 136 help command 437
management module 264 environment history command 437
enable SNMPv3 alarm panel 135 identify command 437
management module 359 blade mezzanine 133 ifconfig command 438
enable SNMPv3 agent blade server 132 info command 442
management module 265 BladeCenter unit 132 iocomp command 443
enable SOL blower 134 kvm command 443
global 330 BMC 133 ldapcfg command 443
enable SSH port disk drive 135 led command 444
management module 265 high-speed expansion card 133 list command 445
enable static IPv6 configuration I/O module 134 mcad command 445
I/O module 197 I/O-expansion card 133 modactlog command 445
management module 179 integrated system management monalerts command 445
enable TCP command mode processor 133 monalertsleg command 446
management module 266, 360 management card 133 mt command 446
enable technician debug management module 132 nat command 446
management module 304 media tray 134 ntp command 447
enable Telnet port memory 133 ping command 447
management module 267 microprocessor 133 pmpolicy command 448
enable TFTP multiplexer expansion module 135 portcfg command 448
management module 267 network clock module 135 ports command 448
enable trespass feature power module 134 power command 450
management module 356 service processor 133 rdoc command 450
enable user 379 storage expansion unit 133 read command 451
enable V3 authentication for NTP storage module 135 remotechassis command 452
management module 246 switch module 134 reset command 452
enable Wake on LAN environment commands 131 scale command 453
blade server 274 example 136 sddump command 454
globally 274 errors sdemail command 454
enable web interface accseccfg command 411 security command 455
management module 361 advfailover command 412 service command 455
encryption algorithms 14 alarm command 413 shutdown command 455
end session 143 alertcfg command 414 slp command 455
ending an SOL session 23, 115 alertentries command 414 smtp command 455
enhanced legacy alert categories autoftp command 415 snmp command 456
disable 229 baydata command 415 sol command 457
enable 229 bofm command 416 sshcfg command 458
entries of the CIN status table boot command 417 sslcfg command 459
display for management module 102 bootmode command 417 syslog command 461
env 132, 133 bootseq command 418 tcpcmdmode command 462
options buildidcfg command 418 telnetcfg command 462
bbu 134 chconfig command 419 temps command 463
be 133 chlog command 420 thres command 463
blade 132 chmanual command 421 trespass command 463
blower 134 cin command 421 uicfg command 464
ckvm 133 clear command 423 update command 465
cpu 133 clearlog command 423 uplink command 467
disk 135 clock command 423 users command 468
exp 133 command-line interface 407 volts command 472
hsec 133 common 409 write command 472
mgmtcrd 133 config command 424 zonecfg command 473
mt 134 console command 425 Ethernet
mux 135 dhcpinfo command 426 configuring remote connection 21
ncc 135 displaylog command 426 Ethernet channel
power 134 displaysd command 427 disable for blade server 190
sb 133 dns command 428 enable for blade server 189
sp 133 env command 428 Ethernet channel 0 address prefix length
storage 135 ethoverusb command 428 set for management module 180
switch 134 eventinfo command 429
events command 429
498 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Ethernet channel 0 configuration Ethernet channel gateway IP address events commands 140
display for management module (IPv4) example 141
(primary) 171 set for blade server 186 exit 143
display for management module Ethernet channel gateway/default route exit codes (CLI)
(standby) 172 (IPv6) Secure Shell server 20
Ethernet channel 0 configuration method set for blade server 187 exit command 143
set for management module 176 Ethernet channel hostname exit command errors 430
Ethernet channel 0 data rate set for blade server 189 exit commands
set for management module 177 Ethernet channel static IP address (IPv4) example 143
Ethernet channel 0 DHCP configuration set for blade server 185 export datacenter feature licenses
display for management module 117 Ethernet channel static IP address (IPv6) management module 145
Ethernet channel 0 domain name set for blade server 186 export firmware build ID list
set for management module 179 Ethernet channel subnet mask (IPv4) blade server 86
Ethernet channel 0 duplex mode set for blade server 187 external management
set for management module 177 Ethernet channel VLAN ID enable for I/O module 196
Ethernet channel 0 gateway IP address set for blade server 188 external ports
(IPv4) Ethernet network settings for enable for I/O module 196
set for management module 174 management module commands
Ethernet channel 0 gateway/default route example 200
(IPv6)
set for management module 174
Ethernet-over-USB setting
display for blade server 137
F
failover configuration
Ethernet channel 0 hostname set for blade server 137
display for management module 373
set for management module 175 ethoverusb 137
fast POST
set for standby management options
enable for I/O module 275, 276
module 176 s 137
FCC Class A notice 482
Ethernet channel 0 MAC address ethoverusb command errors 428
feature 144
set for management module 178 ethoverusb commands 137
options
set for standby management example 137
-add 144
module 178 European Union EMC Directive
-apply 145
Ethernet channel 0 MTU conformance statement 483
-remove 144
set for management module 177 event description
-retrieve 145
Ethernet channel 0 static IP address display 138
feature command errors 430
(IPv4) event log
feature commands 144
set for management module 173 clear for management module 105
example 146
set for standby management display (reset counter) for
feature license
module 173 management module 119
add for management module 144
Ethernet channel 0 static IP address display all entries for management
remove from management
(IPv6) module 119
module 144
set for management module 173 display all filters for management
feature licenses
set for standby management module 119
export for datacenter 145
module 174 display entries for management
import from datacenter 145
Ethernet channel 0 subnet mask (IPv4) module, filtered by date 120
features
set for management module 175 display entries for management
display for management module 144
Ethernet channel 1 module, filtered by severity
files 147
disable for management module 184 level 120
options
enable for management module 183 display entries for management
d 147
Ethernet channel 1 configuration module, filtered by source 120, 121
files command errors 432
display for management module display for management module 119
files commands 147
(primary) 181 enable monitoring of state 122
example 147
Ethernet channel 1 data rate save to TFTP server 122
filter alert type 56
set for management module 182 event log, clear for management module
filter log entries by call-home events flag
Ethernet channel 1 duplex mode commands 105
management module 122
set for management module 182 event log, display for call-home event
firmware
Ethernet channel 1 gateway IP address management module entries 93
display attributes 363
(IPv4) event log, display for management
update 364, 368
set for management module 181 module commands 119
I/O module 365, 366, 367, 369,
Ethernet channel 1 MAC address event user action
370, 371
set for management module 183 display 138, 139
switch 365, 366, 367, 369, 370, 371
Ethernet channel 1 MTU eventinfo 138, 139
verbose 366, 370
set for management module 183 eventinfo command errors 429
update (verbose) 365, 368
Ethernet channel 1 static IP address eventinfo commands 138
firmware build ID
(IPv4) example 139
update in firmware build ID list 83
set for management module 181 events 140
firmware build ID list
Ethernet channel 1 subnet mask (IPv4) options
add entry for blade server 81
set for management module 182 -add 140
create for blade server 80
Ethernet channel configuration method -rm 141
delete all entries 84
set for blade server 188 events command errors 429
delete entry 85
Index 499
firmware build ID list (continued) generate health (continued)
export for blade server 86 CSR (LDAP client) 341 display for all BladeCenter units on
import for blade server 85 CSR (management module web network 283
update firmware build ID for blade server) 341 display status 163
server 83 self-signed certificate (LDAP display status (tree) 163
update firmware build revision for client) 339 display status and alerts 164
blade server 84 self-signed certificate (management display status and alerts with
update firmware type for blade module web server) 339 timestamp 164
server 83 generate host key options
update machine type for blade management module 335 f 164
server 82 generate syslog test message l 163
update manufacturer for blade management module 350 t 164
server 82 generate test alert 58 health command 163, 164
firmware build IDs Germany Class A statement 483 example 164
display for blade server 80 get service data health command errors 436
firmware build revision blade server 299 help 25, 166
update in firmware build ID list 84 getting help 476 getting 475
firmware requirements 2 global help command 166
firmware type enable local KVM switching 208 help command errors 437
update in firmware build ID list 83 enable local media tray help commands
firmware update 363 switching 239 example 166
flash location LED 169, 222 enable local power control 274 help, World Wide Web 476
forest name enable remote media tray high-speed expansion card
set for Global Catalog discovery 211 switching 240 command target 133
set for management module LDAP enable Wake on LAN 274 history 168
server 211 Global Catalog discovery history command 168
FTP set forest name 211 history command errors 437
enable for management module 261 global disable history commands
FTP data port number SOL 331 example 168
set for management module 256 global enable host key
FTP port number SOL 330 generate for management
set for management module 256 GMT offset module 335
FTP timeout display for management module 106 host name
set for management module 268 set for management module 107 set for blade server 189
fuelg 149, 150 group filter set for channel 0 of management
options LDAP 217 module 175
am 153 group LDAP authentication, management set for channel 0 of standby
dps 155 module 159 management module 176
e 153 group search attribute HTTP port number
fpop 156 LDAP 217 set for management module 257
int 152 groups 159 HTTP proxy setup
pcap 154 options Service Advisor 91
pm 151 a 160 HTTPS port
pme 154, 155 clear 161 enable for management module 262
pt 151, 152 n 159 HTTPS port number
tt 152 groups command 159 set for management module 257
fuelg command errors 433 groups command errors 436
fuelg commands 149 groups commands
example 156 example 162
guidelines
I
I/O module
case sensitivity 6
activate network protocol
G command history 6
data types 6
settings 241
gaseous contamination 481 activate SAS zone 403
delimiters 6
gateway IP address (IPv4) BladeCenter Open Fabric
help 6
set for channel 0 of management Manager 66
options 5
module 174 bofm 66, 67, 68, 69, 70, 71
output format 6
set for channel 1 of management bofm commands 66
overview of 5
module 181 command target 134
strings 6
set for channel of blade server 186 cycle power 273
set for I/O module 194, 199 dhcpinfo commands 117
gateway IP address (IPv6) disable DHCPv6 198
set for I/O module 195 H disable IPv6 197
gateway/default route (IPv6) hardware requirements 2 disable IPv6 stateless
set for channel 0 of management hardware service and support telephone auto-configuration 198
module 174 numbers 476 disable NAT table 244
set for channel of blade server 187 health 163 disable static IPv6 configuration 197
display DHCP configuration 117
500 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
I/O module (continued) identify (continued) ifconfig (continued)
display IP addresses 248 options options (continued)
display network protocol s 169 i 191, 194, 199
settings 241 s, d 169 i6 194
display network settings 193 identify command 169 ipv6 197
display POST status 276 identify command errors 437 ipv6static 197
display power state 273 identify commands ir 199
display SAS zone information 404 example 170 maxv 192
display SAS zone list 403 ifconfig 184, 192, 193 p6 198
enable DHCPv6 configuration 198 options pip 195
enable external management 196 ckvm 185 pm, enabled 197
enable external ports 196 ckvm, enabled 193 s 196, 200
enable fast POST 275, 276 dhcp6 198 sa6 198
enable IPv6 197 em, enabled 196 v 192
enable IPv6 stateless ep, enabled 196 ve 192
auto-configuration 198 eth0 171 ifconfig command errors 438
enable NAT table 244 eth0, c 176 ifconfig commands 171
enable protected mode 197 eth0, d 177 example 200
enable static IPv6 configuration 197 eth0, dhcp6 180 import 344, 345, 346
I/O management commands 66 eth0, dn 179 import certificate file
keep new IP address configuration eth0, g 174 SSL CSR 343
after reset 195 eth0, g6 174 SSL self-signed certificate 343
nat command 241, 244 eth0, i 173 import datacenter feature licenses
example 244 eth0, i6 173 management module 145
power off 272 eth0, ipv6 179 import firmware build ID list
power on 272, 273 eth0, ipv6static 179 blade server 85
reset 286 eth0, l 178 important notices 480
reset (extended diagnostics) 288 eth0, m 177 Industry Canada Class A emission
reset (full diagnostics) 288 eth0, n 175 compliance statement 483
reset (standard diagnostics) 287 eth0, o 172 info 203
reset configuration 103 eth0, o, i 173 options
reset network protocol settings 241 eth0, o, i6 174 path 204
revert to old IP address configuration eth0, o, l 178 reload, all 204
after reset 195 eth0, o, n 176 reload, fw 204
set address prefix length 198 eth0, p6 180 reload, hw 204
set gateway IP address (IPv4) 194 eth0, r 177 reload, mac 204
set gateway IP address (IPv6) 195 eth0, s 175 reload, wwn 204
set IP address (IPv4) 194 eth0, sa6 180 info command 203
set IP address (IPv6) 194 eth1 181 info command errors 442
set NAT external port number 243 eth1, d 182 info commands
set NAT internal port number 243 eth1, down 184 example 205
set NAT protocol ID 242 eth1, g 181 information
set NAT protocol name 242 eth1, i 181 display for specific scalable
set RAID IP address (IPv4) 199 eth1, iom 184 complex 291
set subnet mask (IPv4) 196 eth1, l 183 information (all)
turn off 272 eth1, m 183 display for scalable complex 291
turn on 273 eth1, r 182 information about components and
I/O module compatibility eth1, s 182 reloading components 203
display details for blade server 206 eth1, up 183 information center 476
display details for I/O module 206 ethx 184 information display, blade server power
display for all components 206 ethx, c 188 (overview) 149
I/O module for blade server ethx, dhcp6 191 information display, blower power 149
management traffic ethx, down 190 information display, component 203
set for blade server 184 ethx, g 186 information display, I/O module
I/O module power information ethx, g6 187 power 149
display 149 ethx, i 185 information display, power domain
I/O module, display power ethx, i6 186 (detailed) 150
trending 151, 152 ethx, ipv6 190 information display, power domain
I/O-expansion card ethx, n 189 (overview) 149
command target 133 ethx, p6 190 information LED
I/O-module IP address ethx, s 187 turn off 221
ping 249 ethx, sa6 191 information reload, all 204
test communication 249 ethx, up 189 information reload, firmware 204
IBM Systems Director ethx, v 188 information reload, hardware 204
communication 351 ethx, ve 189 information reload, MAC addresses 204
IBM Taiwan product service 477 g 194, 199 information reload, WWN 204
identify 169 g6 195
Index 501
informational alerts IP address (IPv4) (continued) kvm command errors 443
disable monitoring for all 234 set for management module 173 kvm commands 208
disable monitoring for blade set for standby management example 209
device 235 module 173 KVM port
disable monitoring for chassis 236 IP address (IPv6) set state for management
disable monitoring for cooling set for blade server 186 module 262
device 238 set for I/O module 194
disable monitoring for event log 237 set for management module 173
disable monitoring for I/O
module 235
set for standby management
module 174
L
LDAP client
disable monitoring for inventory IP address configuration
generate CSR 341
change 236 keep new after reset 195
generate self-signed certificate 339
disable monitoring for network revert to old after reset 195
LDAP client distinguished name
change 237 IP address, default 15
set for management module 216
disable monitoring for power IP addresses
LDAP client distinguished name
module 238 display for I/O module 248
password
disable monitoring for power IPv6
set for management module 216
state 236 disable for blade server 190
LDAP client distinguished name
disable monitoring for storage disable for I/O module 197
password (confirm)
module 235 disable for management module 179
set for management module 216
disable monitoring for system enable for blade server 190
LDAP group filter
management 236 enable for I/O module 197
set for management module 217
disable monitoring for user enable for management module 179
LDAP group search attribute
activity 237 IPv6 configuration (static)
set for management module 217
enable monitoring for all 234 disable for I/O module 197
LDAP login permission attribute
enable monitoring for blade disable for management module 179
set for management module 218
device 235 enable for I/O module 197
LDAP name
enable monitoring for chassis 236 enable for management module 179
set for management module 210
enable monitoring for cooling IPv6 stateless auto-configuration
LDAP root distinguished name
device 238 disable for blade server 191
set for management module 214
enable monitoring for event log 237 disable for I/O module 198
LDAP security version
enable monitoring for I/O disable for management module 180
set for management module 210
module 235 enable for blade server 191
LDAP server (first) host name
enable monitoring for inventory enable for I/O module 198
set for management module 212
change 236 enable for management module 180
LDAP server (first) IP address
enable monitoring for network ISMP
set for management module 212
change 237 reset 286
LDAP server (first) port number
enable monitoring for power
set for management module 213
module 238
LDAP server (fourth) host name
enable monitoring for power
state 236
J set for management module 213
Japan VCCI Class A statement 484 LDAP server (fourth) IP address
enable monitoring for storage
Japan Voluntary Control Council for set for management module 213
module 235
Interference Class A statement 484 LDAP server (fourth) port number
enable monitoring for system
JS20 blade server commands set for management module 214
management 236
reset (clear NVRAM) 289 LDAP server (second) host name
enable monitoring for user
reset (run diagnostics with boot set for management module 212
activity 237
sequence) 289 LDAP server (second) IP address
integrated system management processor
reset (run diagnostics) 289 set for management module 212
command target 133
reset (with NMI) 288 LDAP server (second) port number
iocomp 206
JSxx blade server commands set for management module 213
iocomp command errors 443
reset (enter SMS menu) 290 LDAP server (third) host name
iocomp commands 206
set for management module 212
example 206
LDAP server (third) IP address
IP address
CIN configuration entry 99 K set for management module 212
LDAP server (third) port number
CIN index entry 99 keep new IP address configuration after
set for management module 214
display BladeCenter units on network reset
LDAP server authentication method
filtered by 283 I/O module 195
set for management module 215
ping 248 Korea Communications Commission
LDAP server binding method
test communication 248 statement 485
set for management module 215
IP address (I/O-module) kvm 208
LDAP server discovery method
ping 249 options
set for management module 211
test communication 249 b 208
LDAP server domain name
IP address (IPv4) local 208
set for management module 211
set for blade server 185 KVM
LDAP server forest name
set for blade server ISMP 191 display owner 208
set for management module 211
set for I/O module 194 set owner 208
502 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
LDAP settings light location LED (BladeCenter unit) management module (continued)
display for management module 210 time period 169 accseccfg commands 30, 38
LDAP UID search attribute link local address 15 acknowledge call-home activity log
set for management module 215 list 225 entry 94
ldapcfg 210 options add Call Home events 140, 141
options l 225 add feature license 144
aom 215 list command add SSH public key 392
bm 215 example 225 add SSH public key (specific) 392
cd 216 list command errors 445 advfailover command 40, 41
cp 216 local KVM switching example 41
dn 211 enable globally 208 airfilter 42
fn 211 local media tray switching autoftp commands 60, 62
gf 217 enable globally 239 bay data 63
gsa 217 local power control bofm 66, 67, 68, 69, 70, 71
i1 212 enable for blade server 275 bofm commands 66, 71
i2 212 enable globally 274 cabling 12
i3 212 location change user password 385
i4 213 display for management module 111 chconfig commands 87, 91
lpa 218 set for management module 112 chmanual commands 95, 96
p 216 location LED cin commands 97
p1 213 blink 169, 222 cinstatus commands 102
p2 213 display state 169 clear CIN configuration entries 97
p3 214 flash 169, 222 clear event log 105
p4 214 light 169, 222 clear event log commands
rd 214 time period 223 example 105
server 211 light (BladeCenter unit) command target 132
t 210 time period 169 command-line session
usa 215 turn off 169, 222 configuration 354
v 210 location LED control 169 command-line timeout 354
ldapcfg command 210 logging comment SSH public key 398
example 218 disable for logging of login events config command 111, 114
ldapcfg command errors 443 from same IP address 35 example 114
led 220 enable for logging of login events configuring 21
options from same IP address 35 connect to SSH public key 397
e 220 logical link loss alert and failover policy create alert recipient 54
info 220 set for advanced management create user 381
info off 221 module 375 default IP address 15
l 220, 221 set for management module delete Active Directory group 161
loc 220, 222 (advanced) 375 delete alert recipient 53
loc, d 223 login permission attribute delete CIN configuration 98
r 220 LDAP 218 delete file 147
LED (information) delete user 378
turn off 221 DHCP settings commands
LED (location), control 169
led command 220
M example 118
dhcpinfo commands 117, 118
MAC address
led command errors 444 direct connection 13
set for channel 0 of management
led commands disable automatic configuration 282
module 178
example 223 disable CIN configuration entry 98
set for channel 0 of standby
LED commands 29 disable CLI SSH server 336
management module 178
LED state disable DHCPv6 180
set for channel 1 of management
display (blade server front disable Ethernet channel 1 184
module 183
panel) 220 disable IPv6 179
machine type
display (external port link disable IPv6 stateless
update in firmware build ID list 82
status) 220 auto-configuration 180
manage alert recipients 53
display (fault) 220 disable network interface for
management card
display (for blade server and all standby 40
command target 133
sub-components) 221 disable SMASH SSH server 336
management channel auto-discovery
display (safe-to-remove) 220 disable static IPv6 configuration 179
disable for BladeCenter unit 227
display (state for blower fault disable technician debug 304
enable for BladeCenter unit 227
LED) 220 disable user 379
management channel auto-discovery
display (state for fanpack fault display (reset counter) event log 119
status
LED) 220 display account security settings 30
display for BladeCenter unit 227
display various LED states 220 display active users 377
management channel path information
licenses display advanced failover settings 40
display 204
display for management module 144 display alert properties (all
management module
light location LED 169, 222 recipients) 53
account security commands 30, 66
time period 223
accseccfg 30
Index 503
management module (continued) management module (continued) management module (continued)
display alert properties (single display SSH public key 391 enable user 379
recipient) 53 display SSH status 335 enable V3 authentication for
display all Active Directory display state of -lse option 122 NTP 246
groups 159 display status 124 enable web interface 361
display all event log entries 119 Display status of first five CIN Ethernet network settings commands
display all event log filters 119 entries 102 example 200
display all users 377 display syslog configuration 347 export datacenter feature
display automatic configuration display temperature 355 licenses 145
setting 280 display time 106 failover configuration 373
display call-home activity log 93 display trespass feature status 356 filter alert type 56
display CIN configuration table 97 display user interface settings 359 filter log entries by call-home events
display clock settings 106 display voltage 400 flag 122
display contact name 111 display volume information 278 generate host key 335
display date 106 dns commands 126, 129 generate syslog test message 350
display daylight-savings time example 129 IBM Systems Director
setting 106 download SSH public key 396 communication 351
display DNS configuration 126 enable automatic configuration 281 ifconfig commands 171, 200
display DSA host key enable CIN configuration entry 98 import datacenter feature
information 335 enable CLI SSH server 336 licenses 145
display entries of CIN status enable command-line interface 359 kvm commands 208, 209
table 102 enable complex password 33 ldapcfg command 210, 218
display Ethernet channel 0 DHCP enable data encryption 303 example 218
configuration 117 enable default administration map image 278
display event description 138 password expiration 34 mcad commands 227
display event log 119 enable DHCPv6 configuration 180 mount volume 278
display event log commands enable DNS 126 mt commands 239, 240
example 123 enable dynamic DNS 126 network connection 13
display event log entries filtered by enable Ethernet channel 1 183 portcfg commands 253, 254
date 120 enable FTP 261 ports command 255, 270
display event log entries filtered by enable HTTPS port 262 example 270
severity level 120 enable IPv6 179 read CIN status table entries 102
display event log entries filtered by enable IPv6 stateless read command 280, 282
source 120, 121 auto-configuration 180 example 282
display event user action 138, 139 enable monitoring of event log remotechassis command 283, 284
display events list 140 state 122 example 284
display features 144 enable network interface for standby remove feature license 144
display file list 147 and allow IP swap 40 remove SSH public key 393
display free space 140, 147 enable network interface for standby replace SSH public key 395
display FTP/TFTP server call-home and prevent IP swap 41 reset (failover) 287
activity log 93 enable NTP 245, 262 reset (force failover) 287
display global remote alert enable password change at first reset (primary) 286
settings 51 login 36 reset (standby) 286
display GMT offset 106 enable password required 37 reset configuration (keep logs) 103
display IBM Support call-home enable RDE 263 reset network port settings 256
activity log 93 enable RDOCE 263 restore configuration from file
display LDAP settings 210 enable secure SMASH over SSH 264 (encryption) 281
display licenses 144 enable secure TCP command restore configuration from file (no
display location 111 mode 266, 360 encryption) 280
display log entries with call-home enable security 303 restore configuration from
events 119 enable SLP 263 midplane 280
display log entries with Event ID 119 enable SMASH over Telnet 264 save configuration to chassis 401
display name 111 enable SMASH SSH server 336 save configuration to file
display network port settings 255 enable SNMP agent (SNMPv1) 312 (encryption) 402
display NTP configuration 245 enable SNMP agent (SNMPv3) 312 save configuration to file (no
display open ports 255 enable SNMP traps 265, 312 encryption) 401
display RSA host key enable SNMPv1 359 save event log to TFTP server 122
information 335 enable SNMPv1 agent 264 sdemail commands 301
display serial port configuration 253 enable SNMPv3 359 security commands 30, 303
display service setting 304 enable SNMPv3 agent 265 serial connection 14, 17
display single user 378 enable SSH port 265 serial port settings commands
display SLP settings 307 enable static IPv6 configuration 179 example 254
display SMTP server host name 309 enable TCP command mode 266, 360 service command
display SMTP server IP address 309 enable technician debug 304 example 304
display SNMP configuration 312 enable Telnet port 267 service commands 304
display specific Active Directory enable TFTP 267 set account inactivity alert time 34
groups 159 enable trespass feature 356 set account inactivity disable time 35
504 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
management module (continued) management module (continued) management module (continued)
set account lockout period 36 set fourth LDAP server host set secure TCP command mode port
set account security default to name 213 number 260
high 32 set fourth LDAP server IP set serial port baud rate 253
set account security default to address 213 set serial port communication
legacy 31 set fourth LDAP server port rate 253
set Active Directory group authority number 214 set serial port parity 253
level 160 set FTP data port number 256 set serial port stop bits 254
set Active Directory group name 159 set FTP port number 256 set server host name 309
set alert notification method 57 set FTP timeout 268 set server IP address 309
set alert recipient email address 57 set GMT offset 107 set SLP address type 307
set alert recipient name 55 set hostname for alerts 58 set SLP multicast address 307
set alert recipient status 56 set HTTP port number 257 set SLP port number 258
set alert type 56 set HTTPS port number 257 set SMASH Telnet port number 258
set authentication logging timeout 32 set IP address (IPv4) 173 set SMTP e-mail server domain
set CIN state for global enable or set IP address (IPv6) 173 name 310
disable 97 set IP address for alerts 58 set SNMP agent port number 259
set CLI inactivity timeout 33 set LDAP client distinguished set SNMP community 1 first host
set contact name 112, 113, 114 name 216 name 314
set date 106 set LDAP client distinguished name set SNMP community 1 first host
set daylight-savings time mode 109 password 216 name - get 316
set DNS first IPv4 IP address 127 set LDAP client distinguished name set SNMP community 1 first host
set DNS first IPv6 IP address 128 password (confirm) 216 name to set 315
set DNS second IPv4 IP address 127 set LDAP group filter 217 set SNMP community 1 IP address
set DNS second IPv6 IP address 128 set LDAP group search attribute 217 (first host) 314
set DNS server priority 129 set LDAP login permission set SNMP community 1 IP address
set DNS third IPv4 IP address 127 attribute 218 (first host) to get 316
set DNS third IPv6 IP address 128 set LDAP name 210 set SNMP community 1 IP address
set Ethernet channel 0 address prefix set LDAP root distinguished (first host) to set 315
length 180 name 214 set SNMP community 1 IP address
set Ethernet channel 0 configuration set LDAP security version 210 (second host) 317
method 176 set LDAP server binding method 215 set SNMP community 1 IP address
set Ethernet channel 0 data rate 177 set LDAP server discovery (third host) 318
set Ethernet channel 0 domain method 211 set SNMP community 1 name 313
name 179 set LDAP server domain name 211 set SNMP community 1 second host
set Ethernet channel 0 duplex set LDAP server for authentication name 317
mode 177 only 215 set SNMP community 1 third host
set Ethernet channel 0 gateway IP set LDAP server forest name 211 name 318
address (IPv4) 174 set LDAP UID search attribute 215 set SNMP community 1 view type
set Ethernet channel 0 set location 112 (SNMPv3) 318
gateway/default route (IPv6) 174 set maximum LDAP sessions for set SNMP community 2 first host
set Ethernet channel 0 hostname 175 user 36 name 319
set Ethernet channel 0 MAC set maximum number of login set SNMP community 2 IP address
address 178 failures 35 (first host) 319
set Ethernet channel 0 MTU 177 set maximum number of simultaneous set SNMP community 2 IP address
set Ethernet channel 0 static IP sessions for user 388 (second host) 320
address (IPv4) 173 set minimum number of different set SNMP community 2 IP address
set Ethernet channel 0 static IP characters for password 34 (third host) 321
address (IPv6) 173 set name 111 set SNMP community 2 name 319
set Ethernet channel 0 subnet mask set NTP server hostname 245 set SNMP community 2 second host
(IPv4) 175 set NTP server IP address 245 name 320
set Ethernet channel 1 data rate 182 set NTP server key 246 set SNMP community 2 third host
set Ethernet channel 1 duplex set NTP update frequency 246 name 321
mode 182 set password expiration time 37 set SNMP community 2 view type
set Ethernet channel 1 gateway IP set password minimum change (SNMPv3) 321
address (IPv4) 181 interval 37 set SNMP community 3 first host
set Ethernet channel 1 MAC set password reuse cycle 38 name 322
address 183 set privacy password (SNMPv3) 390 set SNMP community 3 IP address
set Ethernet channel 1 MTU 183 set Remote Presence port (first host) 322
set Ethernet channel 1 static IP number 257 set SNMP community 3 IP address
address (IPv4) 181 set second LDAP server host (second host) 323
set Ethernet channel 1 subnet mask name 212 set SNMP community 3 IP address
(IPv4) 182 set second LDAP server IP (third host) 324
set first LDAP server host name 212 address 212 set SNMP community 3 name 322
set first LDAP server IP address 212 set second LDAP server port set SNMP community 3 second host
set first LDAP server port number 213 name 323
number 213
Index 505
management module (continued) management module (continued) management network DHCP
set SNMP community 3 third host telnet timeout 354 configuration
name 324 terminate user session 377 display for blade server 117
set SNMP community 3 view type trespass command 356, 357 management-module firmware 2
(SNMPv3) 324 example 357 manufacturer
set SNMP contact name 325 turn secure TCP command mode on update in firmware build ID list 82
set SNMP location 326 or off 267, 361 map image
set SNMP traps port number 259 turn TCP command mode on or advanced management module
set SSH port number 260 off 266, 360 volume 278
set state for KVM port 262 unacknowledge call-home activity log maximum LDAP sessions for user
set syslog event log collector 1 IP entry 94 set for management module 36
address 348 unlock user 380 maximum number of login failures
set syslog event log collector 1 port unmount volume 278 set for management module 35
number 349 uplink configuration 373 mcad 227
set syslog event log collector 2 IP upload SSH public key 394 options
address 348 view configuration 225 e 227
set syslog event log collector 2 port view power management policy 252 mcad command errors 445
number 349 write command 401, 402 mcad commands 227
set syslog filter level 347 example 402 example 227
set TCP command mode port management module (advanced) media tray
number 260 disable logical uplink failover 374 command target 134
set TCP command-mode timeout 268 enable logical uplink failover 374 display owner 239
set Telnet port number 261 enable physical uplink failover 373 display temperature 355
set Telnet port timeout 268 logical uplink failover delay 374 set owner 239
set TFTP port number 261 logical uplink failover IP address 374 media tray temperature display 149
set third LDAP server host name 212 logical uplink failover IPv6 IP media tray, display power trending 152
set third LDAP server IP address 212 address 375 memory
set third LDAP server port physical uplink failover delay 373 command target 133
number 214 set logical link loss alert and failover memory commands 29
set time 106 policy 375 microprocessor
set trespass feature message 356 management module (primary) command target 133
set trespass feature to default 357 display Ethernet channel 0 minimum number of different characters
set tsyslog event log collector 1 host configuration 171 for password
name 348 display Ethernet channel 1 set for management module 34
set tsyslog event log collector 2 host configuration 181 modactlog 228
name 348 reset 286 modactlog command errors 445
set user access type (SNMPv3) 390 management module (standby) modactlog commands 228
set user authentication method 33 display Ethernet channel 0 example 228
set user authentication protocol configuration 172 module (blade server)
(SNMPv3) 389 reset 286 display activity 228
set user authority level 386 set Ethernet channel 0 hostname 176 display information 228
set user context name (SNMPv3) 388 set Ethernet channel 0 MAC monalerts 229
set user hostname (SNMPv3 address 178 options
traps) 391 set Ethernet channel 0 static IP ca 229
set user IP address (SNMPv3 address (IPv4) 173 cb 230
traps) 391 set Ethernet channel 0 static IP ccd 231
set user name 383 address (IPv6) 174 ccsm 231
set user password 384 set IP address (IPv4) 173 ciom 230, 233, 235
set user privacy protocol set IP address (IPv6) 174 cpm 231
(SNMPv3) 389 management module air filter ec 229
set web interface inactivity command 42 ia 234
timeout 38 management module event log ib 235
slp command 307 commands 28 icd 238
example 307 management module failover icsm 236
smtp commands 309, 310 commands 373 iel 237
SMTP settings commands management module telnet configuration iinv 236
example 310 commands iiom 235
snmp commands 312, 326 example 354 inc 237
SNMP settings commands management module uplink failover ipm 238
example 326 commands ipon 236
SSH connection 18 example 375 iua 237
sshcfg command 335, 336 management module web server wa 232
example 336 generate CSR 341 wb 232
SSL certificate status 337 generate self-signed certificate 339 wcd 234
SSL status 337 management module, group LDAP wcsm 233
synchronize with NTP server 247 authentication 159 wel 233
telnet configuration 354 management module, user accounts 377 wiom 232
506 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
monalerts (continued) monitoring (continued) MTU
options (continued) enable for all informational set for channel 0 of management
wpm 234 alerts 234 module 177
monalerts command errors 445 enable for all warning alerts 232 set for channel 1 of management
monalerts commands 229 enable for blade device critical module 183
example 238 alerts 230 multiple video sessions
monalertsleg command errors 446 enable for blade device informational disable for blade servers 192
monalertsleg commands 229 alerts 235 enable for blade servers 192
monitoring enable for blade device warning multiplexer expansion module
disable for all critical alerts 229 alerts 232 command target 135
disable for all informational enable for chassis critical alerts 231 reset (failover) 287
alerts 234 enable for chassis informational
disable for all warning alerts 232 alerts 236
disable for blade device critical
alerts 230
enable for chassis warning alerts 233
enable for cooling device critical
N
name
disable for blade device informational alerts 231
display BladeCenter units on network
alerts 235 enable for cooling device
filtered by 284
disable for blade device warning informational alerts 238
display for blade server 111
alerts 232 enable for cooling device warning
display for management module 111
disable for chassis critical alerts 231 alerts 234
set for blade server 111
disable for chassis informational enable for event log informational
set for management module 111
alerts 236 alerts 237
name (contact)
disable for chassis warning alerts 233 enable for event log warning
set for management module 112, 113,
disable for cooling device critical alerts 233
114
alerts 231 enable for I/O module critical
nat 241
disable for cooling device alerts 230
options
informational alerts 238 enable for I/O module informational
activate 241
disable for cooling device warning alerts 235
en 244
alerts 234 enable for I/O module warning
ep 243
disable for event log informational alerts 232
ip 243
alerts 237 enable for inventory change
pi 242
disable for event log warning informational alerts 236
pn 242
alerts 233 enable for network change
reset 241
disable for I/O module critical informational alerts 237
nat command 241
alerts 230 enable for power module critical
example 244
disable for I/O module informational alerts 231
nat command errors 446
alerts 235 enable for power module
NAT external port number
disable for I/O module warning informational alerts 238
set for I/O module 243
alerts 232 enable for power module warning
NAT internal port number
disable for inventory change alerts 234
set for I/O module 243
informational alerts 236 enable for power state informational
NAT protocol ID
disable for network change alerts 236
set for I/O module 242
informational alerts 237 enable for storage module critical
NAT protocol name
disable for power module critical alerts 230
set for I/O module 242
alerts 231 enable for storage module
NAT table
disable for power module informational alerts 235
disable for I/O module 244
informational alerts 238 enable for storage module warning
enable for I/O module 244
disable for power module warning alerts 233
NEBS, disable 153
alerts 234 enable for system management critical
network card
disable for power state informational alerts 231
display configuration
alerts 236 enable for system management
information 184
disable for storage module critical informational alerts 236
network clock module
alerts 230 enable for system management
command target 135
disable for storage module warning alerts 233
power off 272
informational alerts 235 enable for user activity informational
power on 272
disable for storage module warning alerts 237
turn off 272
alerts 233 mount volume
turn on 272
disable for system management advanced management module 278
network configuration status
critical alerts 231 mt 239
display for blade server 184
disable for system management options
network interface
informational alerts 236 b 239
disable for standby management
disable for system management local 239
module 40
warning alerts 233 remote 240
enable for standby management
disable for user activity informational mt command errors 446
module and allow IP swap during
alerts 237 mt commands 239
failover 40
enable for all critical alerts 229 example 240
Index 507
network interface (continued)
enable for standby management
P ports (continued)
options
module and prevent IP swap during parity -kvme, state 262
failover 41 set for serial port of management ftpdp 256
network port settings module 253 ftpe, on 261
display for management module 255 particulate contamination 481 ftpp 256
display for switch 269 partition ftpt 268
reset for management module 256 create for scalable complex 294 httpp 257
network protocol settings delete all from scalable complex 294 httpse, on 262
activate for I/O module 241 delete from scalable complex 295 httpsp 257
display for I/O module 241 power cycle in scalable complex 297 ntpe, on 262
reset for I/O module 241 power off in scalable complex 297 open 255
network settings power on in scalable complex 296 rde, on 263
display for BladeCenter unit 192 partition (automatic) rdoce, on 263
display for I/O module 193 create for scalable complex 292 reset 256
New Zealand Class A statement 483 partition information rpp 257
node information display for scalable complex 291 slpe , on 263
display for scalable complex 291 partition mode slpp 258
notes, important 480 set to partition for scalable smashse, on 264
notices 479 complex 296 smashte, on 264
electronic emission 482 set to stand alone for scalable smashtp 258
FCC, Class A 482 complex 295 snmp1ae, on 264
notification method, set for alerts 57 password snmp3ae, on 265
ntp 245 change for user 385 snmpap 259
options LDAP distinguished name 216 snmpte, on 265
en, enabled 245 password (confirm) snmptp 259
f 246 LDAP distinguished name 216 sshe, on 265
i 245 password expiration time sshp 260
synch 247 set for management module 37 stcme, on 266
v3 246 password minimum change interval stcme, port mode 267
v3en, enabled 246 set for management module 37 stcmp 260
NTP password reuse cycle tcme, on 266
enable for management module 245, set for management module 38 tcme, port mode 266
262 path information tcmp 260
ntp command 245 display for management channel 204 tcmt 268
example 247 People's Republic of China Class A telnete, on 267
ntp command errors 447 electronic emission statement 485 telnetp 261
NTP configuration persistent command environment telnett 268
display for management module 245 override 7 tftpe, on 267
NTP server persistent command target 6 tftpp 261
synchronize management module ping switch 269, 270
clock 247 I/O-module IP address 249 ports (open)
NTP server hostname IP address 248 display for management module 255
set for management module 245 IP address (I/O-module) 249 ports command 255
NTP server IP address r 248, 249 example 270
set for management module 245 ping command errors 447 ports command errors 448
NTP server key ping commands 248 POST status
set for management module 246 example 249 display for I/O module 276
NTP update frequency pmpolicy 251 display for switch module 276
set for management module 246 options power
pd 251 options
pdx 251 ap 275
view for management module 252
O pmpolicy command
cycle 273
cycle, c 273
online documentation 1 example 252 fp 275, 276
open ports pmpolicy command errors 448 local 274, 275
display for management module 255 polling interval, set for power off 272
options trending 152 on 272
a 102 portcfg on, c 272
f 102 options softoff 273
out-of-band communication, IBM Systems com1 253 state 273
Director 351 com1, b 253 state, post 276
override persistent command com1, p 253 wol 274
environment 7 com1, s 254 power capping, enable for blade
portcfg command errors 448 server 154
portcfg commands 253 power capping, set for blade server 154
example 254 power command errors 450
ports 255
508 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
power commands 272 problem description remove feature license
example 277 call-home 95 management module 144
power control commands 29 email 301 remove SSH public key 393
power cycle partition service information 301 replace SSH public key 395
scalable complex 297 product service, IBM Taiwan 477 required, firmware 2
power domain protected mode required, hardware 2
disable acoustic mode 153 enable for I/O module 197 reset 286
disable NEBS environment mode 153 blade server 72, 286
enable acoustic mode 153 I/O module 286
enable NEBS environment mode 153
power domain information display
R ISMP 286
management module (primary) 286
RAID controller
(detailed) 150 management module (standby) 286
set gateway IP address (IPv4) 199
power domain information display options
set subnet mask (IPv4) 200
(overview) 149 c 287
RAID IP address (IPv4)
power domain redundancy loss policy, clr 289
set for I/O module 199
set 151 ddg 289
RDE
power domain, display power dg 289
enable for management module 263
trending 151, 152 exd 288
rdoc 278
power management commands 29 f 287
options
power management policy force 287
map 278
display full 288
mount 278
all 251 sft 288
unmount 278
BladeCenter S policies 251 sms 290
rdoc command errors 450
specified power domain standby 286
rdoc commands 278
policies 251 std 287
example 279
set service processor 286
RDOCE
for specified power domain 251 switch module 286
enable for management module 263
power management, enable for blade reset (clear NVRAM)
read 280
server 154, 155 blade server 289
options
power module reset (enter SMS menu)
config 280
command target 134 blade server 290
config, auto, off 282
power off reset (extended diagnostics)
config, auto, on 281
alarm panel module 272 I/O module 288
config, l , i 280
blade server 272, 273 switch module 288
config, l , i, p 281
I/O module 272 reset (failover)
read CIN configuration status table
network clock module 272 management module 287
entries 102
switch module 272, 273 multiplexer expansion module 287
read CIN status table entries for
power off partition reset (force failover)
management module 102
scalable complex 297 management module 287
read command 280
power on reset (full diagnostics)
example 282
alarm panel module 272 I/O module 288
read command errors 451
blade server 272, 273 switch module 288
redirect command 25, 131
I/O module 272, 273 reset (run diagnostics with boot
redundancy loss policy, power domain
network clock module 272 sequence)
(set) 151
switch module 272, 273 blade server 289
reload all information 204
power on (to console) reset (run diagnostics)
reload firmware information 204
blade server 272, 273 blade server 289
reload hardware information 204
power on partition reset (standard diagnostics)
reload MAC address information 204
scalable complex 296 I/O module 287
reload MAC addresses information 204
power polling interval, set 152 switch module 287
reload WNN information 204
power saver mode, enable for blade reset (to console)
remote alert
server 155 blade server 72, 287
set retry interval 51
power state reset (with NMI)
set retry limit 52
display for blade server 273 blade server 288
remote media tray switching
display for I/O module 273 reset blase server key sequence
enable globally 240
display for switch module 273 set for SOL 333
Remote Presence port number
power trending, display (blade reset command 29
set for management module 257
server) 151, 152 reset command errors 452
remotechassis 283
power trending, display (blower) 151, reset commands 286
options
152 example 290
clear 284
power trending, display (I/O reset configuration
health 283
module) 151, 152 I/O module 103
ip 283
power trending, display (power switch module 103
name 284
domain) 151, 152 reset configuration (keep logs)
remotechassis command 283
power trending, display (system) 151, management module 103
example 284
152 reset default configuration 103
remotechassis command errors 452
primary management module 7
remove 344, 345, 346
Index 509
reset network port settings scalable complex (continued) security (continued)
management module 256 delete partition 295 display management module account
reset network protocol settings display all information 291 settings 30
I/O module 241 display node information 291 display management module
responding to thermal events 153 display partition information 291 setting 303
restore configuration display specific complex enable complex password for
management module (from file with information 291 management module user
encryption) 281 power cycle partition 297 authentication 33
management module (from file with power off partition 297 enable default administration
no encryption) 280 power on partition 296 password expiration for
management module (from set partition mode to partition 296 management module 34
midplane) 280 set partition mode to stand alone 295 enable for management module 303
restore configuration commands 29 scale 291 enable password change at first login
restore management module options to management module 36
configuration command auto 292 enable password required for
example 282 compid 291 management module 37
retry count compid, partition 291 options
set for SOL 329 create 293, 294 e 303
retry interval cycle 297 set management module account
set for remote alerts 51 delete 294, 295 default to high 32
set for SOL 328 mode 295, 296 set management module account
retry limit node 291 default to legacy 31
set for remote alerts 52 off 297 set management module account
retry number on 296 inactivity alert time 34
set for remote alerts 51 scale command errors 453 set management module account
revert to old IP address configuration scale commands 291 inactivity disable time 35
after reset example 298 set management module account
I/O module 195 sddump lockout period 36
RSA host key information options set management module
display for management module 335 coll 299 authentication logging timeout 32
Russia Class A electromagnetic init 299 set management module CLI
interference statement 485 sddump command errors 454 inactivity timeout 33
Russia Electromagnetic Interference (EMI) sddump commands 299 set management module maximum
Class A statement 485 example 300 LDAP sessions for user 36
sdemail set management module maximum
options number of login failures 35
S subj 301
to 301
set management module minimum
number of different characters for
SAS system
sdemail command errors 454 password 34
set gateway IP address (IPv4) 199
sdemail commands 301 set management module password
set subnet mask (IPv4) 200
example 301 expiration time 37
SAS zone
search domain set management module password
activate for I/O module 403
set for Domain Catalog minimum change interval 37
SAS zone information
discovery 211 set management module password
display for I/O module 404
secure command-line interface 14 reuse cycle 38
SAS zone list
Secure Shell connection clients 14 set management module user
display for I/O module 403
secure shell server authentication method 33
save configuration commands 29
disabling 19 set management module web interface
save configuration to chassis
Secure Shell server inactivity timeout 38
management module 401
exit codes (CLI) 20 security command errors 455
save configuration to file (encryption)
using 18 security commands 303
management module 402
secure SMASH account security 30
save configuration to file (no encryption)
enabling 19 example 303
management module 401
secure SMASH over SSH selecting command environment 6
save event log to TFTP server
enable for management module 264 selecting command target 6
management module 122
secure TCP command mode self-signed certificate
save management module configuration
disable 352 generate for LDAP client 339
command
enable 352 generate for management module web
example 402
enable for management module 266, server 339
save service information
360 self-signed certificate (SSL)
save to TFTP server 124
set number of sessions 352 download certificate file 342
scalable complex
turn secure TCP command mode on import certificate file 343
create partition 294
or off for the management upload certificate file 343
create partition (automatically) 292
module 267, 361 send threshold
create stand-alone partition 293
secure TCP command mode port number set for SOL 329
create stand-alone partition
set for management module 260 Serial Over LAN 22
(automatically) 292
security 14, 303 Serial Over LAN commands 328
delete all partitions 294
510 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Serial Over LAN commands (continued) set (continued) set Ethernet channel 0 MAC address
example 333 time, management module 106 (continued)
serial port baud rate set accumulate timeout standby management module 178
set for management module 253 SOL 330 set Ethernet channel 0 MTU
serial port communication rate set Active Directory group authority management module 177
set for management module 253 level 160 set Ethernet channel 0 static IP address
serial port configuration set Active Directory group name 159 (IPv4)
display for management module 253 set address prefix length management module 173
serial port parity blade server 190 standby management module 173
set for management module 253 I/O module 198 set Ethernet channel 0 static IP address
serial port settings for management set alarm 49 (IPv6)
module commands set alert notification method 57 management module 173
example 254 set alert recipient email address 57 standby management module 174
serial port stop bits set alert recipient name 55 set Ethernet channel 0 subnet mask (IPv4)
set for management module 254 set alert recipient status 56 management module 175
server host name set alert type 56 set Ethernet channel 1 data rate
set for management module 309 set automatic power-on policy management module 182
server IP address BladeCenter unit 275 set Ethernet channel 1 duplex mode
set for management module 309 set boot mode management module 182
service 304 blade server 74 set Ethernet channel 1 gateway IP
options set CIN state for disable address (IPv4)
disable 304 management module 97 management module 181
enable 304 set CIN state for enable set Ethernet channel 1 MAC address
Service Advisor management module 97 management module 183
contact information 89 set CLI key sequence set Ethernet channel 1 MTU
disable 88 SOL 332 management module 183
display owner 87 set command-line timeout set Ethernet channel 1 static IP address
enable 88 management module 354 (IPv4)
HTTP proxy setup 91 set contact name management module 181
service and support management module 112, 113, 114 set Ethernet channel 1 subnet mask (IPv4)
before you call 475 set DNS first IPv4 IP address management module 182
hardware 476 management module 127 set Ethernet channel configuration
software 476 set DNS first IPv6 IP address method
service command management module 128 blade server 188
example 304 set DNS second IPv4 IP address set Ethernet channel gateway IP address
service command errors 455 management module 127 (IPv4)
service commands 304 set DNS second IPv6 IP address blade server 186
service data management module 128 set Ethernet channel gateway/default
collect for blade server 299 set DNS server priority route (IPv6)
display command 124 management module 129 blade server 187
display for blade server 299 set DNS third IPv4 IP address set Ethernet channel hostname
dump from blade server 299 management module 127 blade server 189
get for blade server 299 set DNS third IPv6 IP address set Ethernet channel static IP address
service information management module 128 (IPv4)
capture 124 set Ethernet channel 0 address prefix blade server 185
display 124 length set Ethernet channel static IP address
email 301 management module 180 (IPv6)
exclude from email alerts 51 set Ethernet channel 0 configuration blade server 186
include with email alerts 51 method set Ethernet channel subnet mask (IPv4)
problem description 301 management module 176 blade server 187
save to TFTP server 124 set Ethernet channel 0 data rate set Ethernet channel VLAN ID
service processor management module 177 blade server 188
command target 133 set Ethernet channel 0 domain name set Ethernet-over-USB setting
reset 286 management module 179 blade server 137
service setting set Ethernet channel 0 duplex mode set first LDAP server host name
display for management module 304 management module 177 management module 212
session command 29 set Ethernet channel 0 gateway IP set first LDAP server IP address
set address (IPv4) management module 212
date, management module 106 management module 174 set first LDAP server port number
daylight-savings time mode, set Ethernet channel 0 gateway/default management module 213
management module 109 route (IPv6) set fourth LDAP server host name
GMT offset, management management module 174 management module 213
module 107 set Ethernet channel 0 hostname set fourth LDAP server IP address
power management policy management module 175 management module 213
specified power domain 251 standby management module 176 set fourth LDAP server port number
TCP command-mode session set Ethernet channel 0 MAC address management module 214
timeout 351 management module 178
Index 511
set FTP data port number set logical link loss alert and failover set number of sessions
management module 256 policy secure TCP command mode 352
set FTP port number advanced management module 375 TCP command mode 352
management module 256 management module (advanced) 375 set partition mode to partition
set FTP timeout set logical uplink failover delay scalable complex 296
management module 268 advanced management module 374 set partition mode to stand alone
set gateway IP address (IPv4) management module (advanced) 374 scalable complex 295
I/O module 194 set logical uplink failover IP address set physical uplink failover delay
RAID controller 199 advanced management module 374 advanced management module 373
SAS system 199 management module (advanced) 374 management module (advanced) 373
set gateway IP address (IPv6) set logical uplink failover IPv6 IP address set port speed
I/O module 195 advanced management module 375 switch 270
set hostname for alerts 58 management module (advanced) 375 set power capping for blade server 154
set HTTP port number set management module account set power domain redundancy loss
management module 257 inactivity alert time 34 policy 151
set HTTPS port number set management module account set power polling interval 152
management module 257 inactivity disable time 35 set privacy password (SNMPv3) 390
set I/O module for blade server set management module account lockout set Remote Presence port number
management traffic period 36 management module 257
blade server 184 set management module account security set reset blase server key sequence
set IP address (IPv4) default SOL 333
blade server 185 high 32 set retry count
blade server ISMP 191 legacy 31 SOL 329
I/O module 194 set management module authentication set retry interval 51
management module 173 logging timeout 32 SOL 328
standby management module 173 set management module CLI inactivity set retry limit
set IP address (IPv6) timeout 33 remote alerts 52
blade server 186 set management module maximum set retry number 51
I/O module 194 LDAP sessions for user 36 remote alerts 51
management module 173 set management module maximum set SAS controller IP address (IPv4)
standby management module 174 number of login failures 35 I/O module 199
set IP address for alerts 58 set management module minimum set second LDAP server host name
set KVM owner 208 number of different characters for management module 212
set LDAP client distinguished name password 34 set second LDAP server IP address
management module 216 set management module password management module 212
set LDAP client distinguished name expiration time 37 set second LDAP server port number
password set management module password management module 213
management module 216 minimum change interval 37 set secure TCP command mode port
set LDAP client distinguished name set management module password reuse number
password (confirm) cycle 38 management module 260
management module 216 set management module user set send threshold
set LDAP group filter authentication method 33 SOL 329
management module 217 set management module web interface set serial port baud rate
set LDAP group search attribute inactivity timeout 38 management module 253
management module 217 set maximum number of simultaneous set serial port communication rate
set LDAP login permission attribute sessions for user 388 management module 253
management module 218 set media tray owner 239 set serial port parity
set LDAP name set name management module 253
management module 210 blade server 111 set serial port stop bits
set LDAP security version management module 111 management module 254
management module 210 set NAT external port number set server host name
set LDAP server binding method I/O module 243 management module 309
management module 215 set NAT internal port number set server IP address
set LDAP server discovery method I/O module 243 management module 309
management module 211 set NAT protocol ID set SLP address type
set LDAP server domain name I/O module 242 management module 307
management module 211 set NAT protocol name set SLP multicast address
set LDAP server for authentication only I/O module 242 management module 307
management module 215 set NTP server hostname set SLP port number
set LDAP server forest name management module 245 management module 258
management module 211 set NTP server IP address set SMASH Telnet port number
set LDAP server root distinguished name management module 245 management module 258
management module 214 set NTP server key set SMTP e-mail server domain name
set LDAP UID search attribute management module 246 management module 310
management module 215 set NTP update frequency set SNMP agent port number
set location management module 246 management module 259
management module 112
512 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
set SNMP community 1 first host name set SNMP community 3 second host set user hostname (SNMPv3 traps) 391
management module 314 name set user IP address (SNMPv3 traps) 391
set SNMP community 1 first host name management module 323 set user name 383
-get set SNMP community 3 third host name set user password 384
management module 316 management module 324 set user privacy protocol (SNMPv3) 389
set SNMP community 1 first host name set SNMP community 3 view type set VLAN ID
to set (SNMPv3) BladeCenter unit 192
management module 315 management module 324 shutdown
set SNMP community 1 IP address (first set SNMP contact name blade server 273, 306
host) management module 325 options
management module 314 set SNMP location f 306
set SNMP community 1 IP address (first management module 326 shutdown command errors 455
host) to get set SNMP traps port number shutdown commands 306
management module 316 management module 259 example 306
set SNMP community 1 IP address (first set SSH port number simultaneous sessions
host) to set management module 260 set maximum number for user 388
management module 315 set state for KVM port slp 307
set SNMP community 1 IP address management module 262 options
(second host) set static IP address (IPv4) i 307
management module 317 blade server ISMP 191 t 307
set SNMP community 1 IP address (third set subnet mask (IPv4) SLP
host) I/O module 196 enable for management module 263
management module 318 RAID controller 200 SLP address type
set SNMP community 1 name SAS system 200 set for management module 307
management module 313 set syslog event log collector 1 host name slp command 307
set SNMP community 1 second host management module 348 example 307
name set syslog event log collector 1 IP address slp command errors 455
management module 317 management module 348 SLP multicast address
set SNMP community 1 third host name set syslog event log collector 1 port set for management module 307
management module 318 number SLP port number
set SNMP community 1 view type management module 349 set for management module 258
(SNMPv3) set syslog event log collector 2 host name SLP settings
management module 318 management module 348 display for management module 307
set SNMP community 2 first host name set syslog event log collector 2 IP address SMASH (secure) over SSH
management module 319 management module 348 enable for management module 264
set SNMP community 2 IP address (first set syslog event log collector 2 port SMASH CLP
host) number enabling 19
management module 319 management module 349 SMASH over Telnet
set SNMP community 2 IP address set syslog filter level enable for management module 264
(second host) management module 347 SMASH SSH server
management module 320 set TCP command mode port number disable for management module 336
set SNMP community 2 IP address (third management module 260 enable for management module 336
host) set TCP command-mode timeout SMASH Telnet port number
management module 321 management module 268 set for management module 258
set SNMP community 2 name set Telnet port number smtp 309
management module 319 management module 261 options
set SNMP community 2 second host set Telnet port timeout d 310
name management module 268 s 309
management module 320 set telnet timeout smtp command errors 455
set SNMP community 2 third host name management module 354 smtp commands 309
management module 321 set TFTP port number example 310
set SNMP community 2 view type management module 261 SMTP e-mail server domain name
(SNMPv3) set third LDAP server host name set for management module 310
management module 321 management module 212 SMTP server host name
set SNMP community 3 first host name set third LDAP server IP address display for management module 309
management module 322 management module 212 SMTP server IP address
set SNMP community 3 IP address (first set third LDAP server port number display for management module 309
host) management module 214 SMTP settings for management module
management module 322 set trespass feature message commands
set SNMP community 3 IP address management module 356 example 310
(second host) set trespass feature to default snmp 312
management module 323 management module 357 options
set SNMP community 3 IP address (third set user access type (SNMPv3) 390 -ca1 get -c1i1 0.0.0.0 316
host) set user authentication protocol -ca1 set -c1i1 0.0.0.0 315
management module 324 (SNMPv3) 389 a, on 312
set SNMP community 3 name set user authority level 386 a3, on 312
management module 322 set user context name (SNMPv3) 388 c1 313
Index 513
snmp (continued) SNMP community 2 IP address (first SNMPv3 (continued)
options (continued) host) user context name 388
c1i1 314 set for management module 319 user privacy protocol 389
c1i2 317 SNMP community 2 IP address (second SNMPv3 agent
c1i3 318 host) enable for management module 265
c2 319 set for management module 320 software service and support telephone
c2i1 319 SNMP community 2 IP address (third numbers 476
c2i2 320 host) sol 328
c2i3 321 set for management module 321 options
c3 322 SNMP community 2 name c 329
c3i1 322 set for management module 319 e 332
c3i2 323 SNMP community 2 second host name i 328
c3i3 324 set for management module 320 r 333
ca1 318 SNMP community 2 third host name s 329
ca2 321 set for management module 321 status 330, 331
ca3 324 SNMP community 2 view type t 330
cn 325 set for management module SOL 22, 23, 115
l 326 (SNMPv3) 321 global disable 331
t, on 312 SNMP community 3 first host name global enable 330
SNMP agent set for management module 322 set accumulate timeout 330
enable for management module SNMP community 3 IP address (first set CLI key sequence 332
(SNMPv1) host) set reset blase server key
SNMPv1 312 set for management module 322 sequence 333
enable for management module SNMP community 3 IP address (second set retry count 329
(SNMPv3) host) set retry interval 328
SNMPv3 312 set for management module 323 set send threshold 329
SNMP agent port number SNMP community 3 IP address (third status 328
set for management module 259 host) sol command errors 457
snmp command errors 456 set for management module 324 sol commands
snmp commands 312 SNMP community 3 name example 333
example 326 set for management module 322 SOL commands 328
SNMP community 1 first host name SNMP community 3 second host name SOL session
set for management module 314 set for management module 323 ending 23, 115
set to get for management SNMP community 3 third host name starting 22
module 316 set for management module 324 Specify IP address
SNMP community 1 first host name to SNMP community 3 view type CIN configuration entry 99
set set for management module Specify VLAN ID
set for management module 315 (SNMPv3) 324 CIN configuration 100
SNMP community 1 IP address (first SNMP configuration SRC record
host) display for management module 312 display specific for blade server 124
set for management module 314 SNMP contact name SRC records
SNMP community 1 IP address (first set for management module 325 display all for blade server 124
host) to get SNMP location SSH
set to get for management set for management module 326 disabling 19
module 316 SNMP settings for management module SSH clients 14
SNMP community 1 IP address (first commands SSH connection 18
host) to set example 326 SSH port
set for management module 315 SNMP traps enable for management module 265
SNMP community 1 IP address (second disable for management module 312 SSH port number
host) enable for management module 265, set for management module 260
set for management module 317 312 SSH public key add 392
SNMP community 1 IP address (third SNMP traps port number SSH public key add (specific) 392
host) set for management module 259 SSH public key comment 398
set for management module 318 SNMPv1 SSH public key connection 397
SNMP community 1 name enable for management module 359 SSH public key display 391
set for management module 313 SNMPv1 agent SSH public key download 396
SNMP community 1 second host name enable for management module 264 SSH public key remove 393
set for management module 317 SNMPv3 SSH public key replace 395
SNMP community 1 third host name community 1 view type 318 SSH public key upload 394
set for management module 318 community 2 view type 321 SSH status
SNMP community 1 view type community 3 view type 324 display for management module 335
set for management module enable for management module 359 sshcfg 335
(SNMPv3) 318 privacy password 390 options
SNMP community 2 first host name trap receiver IP address or cstatus 336
set for management module 319 hostname 391 hk, dsa 335
user access type 390 hk, gen 335
user authentication protocol 389 hk, rsa 335
514 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sshcfg (continued) sslcfg (continued) subnet mask (IPv4)
options (continued) options (continued) set for channel 0 of management
sstatus 336 l 342, 343, 344, 345, 346 module 175
sshcfg command 335 on 339, 341 set for channel 1 of management
example 336 ou 339, 341 module 182
sshcfg command errors 458 s 339, 341 set for channel of blade server 187
SSL server 337 set for I/O module 196
disable for LDAP client 338 sp 339, 341 set for RAID controller 200
enable for LDAP client 338 tc1 344 set for SAS system 200
SSL certificate (additional) tc2 345 switch
disable for standby management tc3 346 display network port settings 269
module 337 un 341 enable port 269
enable for standby management upld 343 set port speed 270
module 337 sslcfg command errors 459 switch module
SSL certificate status sslcfg commands 337 command target 134
management module 337 example 346 cycle power 273
SSL CSR stand-alone partition display POST status 276
download certificate file 342 create for scalable complex 293 display power state 273
import certificate file 343 stand-alone partition (automatic) power off 272, 273
upload certificate file 343 create for scalable complex 292 power on 272, 273
SSL for LDAP client standby management module reset 286
disable 338 disable additional SSL certificate 337 reset (extended diagnostics) 288
enable 338 enable additional SSL certificate 337 reset (full diagnostics) 288
SSL for management module web server set Ethernet channel 0 hostname 176 reset (standard diagnostics) 287
disable 337 set Ethernet channel 0 MAC reset configuration 103
enable 337 address 178 turn off 272, 273
SSL for web server set Ethernet channel 0 static IP turn on 272, 273
disable for management module 337 address (IPv4) 173 synchronize clock with NTP server
enable for management module 337 set Ethernet channel 0 static IP management module 247
SSL self-signed certificate address (IPv6) 174 syntax help 166
download certificate file 342 set IP address (IPv4) 173 syntax help commands
import certificate file 343 set IP address (IPv6) 174 example 166
upload certificate file 343 standby management modules 7 syslog 347
SSL status starting a session using SSH 18 options
management module 337 starting a session using Telnet 16 coll1 347
SSL trusted certificate 1 344 starting an SOL session 22 coll2 348
download 344 starting command-line interface 14 i1 348
import 344 static IP address (IPv4) i2 348
remove 344 set for blade server ISMP 191 p1 349
upload 344 set for channel 0 of management p2 349
SSL trusted certificate 2 345 module 173 sev 347
download 345 set for channel 0 of standby test 350
import 345 management module 173 syslog command errors 461
remove 345 set for channel 1 of management syslog commands 347
upload 345 module 181 example 350
SSL trusted certificate 3 346 set for channel of blade server 185 syslog configuration
download 346 static IP address (IPv6) display for management module 347
import 346 set for channel 0 of management syslog event log collector 1 host name
remove 346 module 173 set for management module 348
upload 346 set for channel 0 of standby syslog event log collector 1 IP address
sslcfg 337 management module 174 set for management module 348
options set for channel of blade server 186 syslog event log collector 1 port number
ac 337 static IPv6 configuration set for management module 349
c 339, 341 disable for I/O module 197 syslog event log collector 2 host name
cert 339 disable for management module 179 set for management module 348
cl 339, 341 enable for I/O module 197 syslog event log collector 2 IP address
client 338 enable for management module 179 set for management module 348
cp 339, 341 status syslog event log collector 2 port number
cpwd 341 display for management module 124 set for management module 349
csr 341 SOL 328 syslog event log transmission for collector
dnld 342 stop bits 1
dq 339, 341 set for serial port of management disable 347
ea 339, 341 module 254 disable for management module 347
gn 339, 341 storage expansion unit enable 347
hn 339, 341 command target 133 enable for management module 347
i 342, 343, 344, 345, 346 storage module
in 339, 341 command target 135
Index 515
syslog event log transmission for collector telnetcfg 354 trusted certificate 2 (SSL) (continued)
2 options upload 345
disable 348 t 354 trusted certificate 3 (SSL)
disable for management module 348 telnetcfg command errors 462 download 346
enable 348 telnetcfg commands 354 import 346
enable for management module 348 example 354 remove 346
syslog filter level temperature upload 346
set for management module 347 display for blade server 355 turn all CIN index entries on or off 98
syslog test message display for management module 355 turn off
generate for management display for media tray 355 alarm panel module 272
module 350 temperature display, blower 149 blade server 272, 273
system temperature display, media tray 149 I/O module 272
view configuration tree 225 temporary command target 7 network clock module 272
system management command 29 temps 355 switch module 272, 273
system physical configuration temps command errors 463 turn off LED
command 225 temps commands 355 information 221
system power management policy example 355 turn off location LED 169, 222
command 251 terminate 377 turn on
system, display power trending 151, 152 terminate session 143 alarm panel module 272
terminate user session blade server 272, 273
management module 377 I/O module 272, 273
T test alert
generate 58
network clock module 272
switch module 272, 273
Taiwan Class A compliance
test call home turn on (to console)
statement 485
call-home 96 blade server 272, 273
target 25, 131
test communication turn secure TCP command mode on or
TCP command mode
I/O-module IP address 249 off
disable 351
IP address 248 management module 267, 361
enable 352
IP address (I/O-module) 249 turn TCP command mode on or off
enable for management module 266,
TFTP management module 266, 360
360
enable for management module 267
set number of sessions 352
TFTP port number
turn TCP command mode on or off
for the management module 266,
set for management module 261
thermal event response 153
U
360 uicfg 359
thermal trending, display (blower) 152
TCP command mode port number options
thermal trending, display (media
set for management module 260 cli, enabled 359
tray) 152
TCP command-mode session status snmp, enabled 359
thres command errors 463
display 351 stcm, enabled 360
time
TCP command-mode session timeout stcm, port mode 361
display for management module 106
display 351 tcm, enabled 360
set for management module 106
set 351 tcm, port mode 360
trademarks 480
TCP command-mode timeout web, enabled 361
trespass 356
set for management module 268 uicfg command errors 464
options
tcpcmdmode 351 uicfg commands 359
tw 356
options example 361
twd 357
status, 0 351, 352 unacknowledge call-home activity log
twe 356
status, 1 to 20 352 entry
trespass command 356
t 351 management module 94
example 357
tcpcmdmode command errors 462 United States electronic emission Class A
trespass command errors 463
tcpcmdmode commands 351 notice 482
trespass feature
example 353 United States FCC Class A notice 482
enable for management module 356
technician debug unlock user 380
trespass feature default
disable for management module 304 unmount volume
set for management module 357
enable for management module 304 advanced management module 278
trespass feature message
Telco environment 153 update
set for management module 356
telnet configuration options
trespass feature status
display for management module 354 a 363
display for management module 356
telnet configuration commands 354 activate 366
trusted certificate 1 (SSL)
Telnet connection 14, 16 i, l 368
download 344
Telnet port i, l, img 369, 370
import 344
enable for management module 267 i, l, img, activate 370, 371
remove 344
Telnet port number i, n 368
upload 344
set for management module 261 u 364
trusted certificate 2 (SSL)
Telnet port timeout u, img 365, 366
download 345
set for management module 268 u, img, activate 367
import 345
telnet timeout u, r 364
remove 345
set for management module 354 u, v 365
516 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update command 363 uplink failover IP address (logical) users, set authority level 386
update command errors 465 (continued) users, set context name (SNMPv3) 388
update commands set for management module users, set hostname (SNMPv3 traps) 391
example 371 (advanced) 374 users, set IP address (SNMPv3
update firmware 363, 364, 368 uplink failover IPv6 IP address (logical) traps) 391
I/O module 365, 366, 367, 369, 370, set for advanced management users, set maximum number of
371 module 375 simultaneous sessions 388
switch 365, 366, 367, 369, 370, 371 set for management module users, set name 383
verbose 366, 370 (advanced) 375 users, set password 384
update firmware (verbose) 365, 368 upload 344, 345, 346 users, set privacy password
update firmware build ID in firmware upload certificate file (SNMPv3) 390
build ID list SSL CSR 343 users, set privacy protocol
blade server 83 SSL self-signed certificate 343 (SNMPv3) 389
update firmware build revision in upload SSH public key 394 users, unlock 380
firmware build ID list user authentication method using
blade server 84 enable complex password 33 Secure Shell server 18
update firmware type in firmware build set for management module 33 using the command-line interface 5
ID list user interface configuration 359
blade server 83 example 361
update machine type in firmware build
ID list
user interface settings
display for management module 359
V
V3 authentication for NTP
blade server 82 user session 377
enable for management module 246
update manufacturer in firmware build users 377
view command target 225
ID list options
VLAN ID
blade server 82 1 through 12 378
CIN configuration 100
uplink 373 a 386
disable for blade server Ethernet
options ap 389
channel 189
alert 375 at 390
disable for BladeCenter unit 192
dls 374 clear 378
enable for blade server Ethernet
dps 373 cn 388
channel 189
el, enabled 374 create (n, p, a, cn, ap, pp, ppw, at,
enable for BladeCenter unit 192
ep, enabled 373 i) 381
set for BladeCenter unit 192
ip 374 curr 377
set for channel of blade server 188
ip6 375 disable 379
voltage
uplink command errors 467 enable 379
display for blade server 400
uplink commands 373 i 391
display for management module 400
example 375 ms 388
volts 400
uplink configuration n 383
volts command errors 472
display for management module 373 op 385
volts commands 400
uplink failover (logical) p 384
example 400
disable for advanced management pk, add 392
volume information
module 374 pk, af 397
display for management module 278
disable for management module pk, cm 398
(advanced) 374 pk, dnld 396
enable for advanced management pk, e 391
module 374 pk, remove 393 W
enable for management module pk, upld 394, 395 Wake on LAN
(advanced) 374 pp 389 enable for blade server 274
uplink failover (physical) ppw 390 enable globally 274
enable for advanced management ts 377 warning alerts
module 373 unlock 380 disable monitoring for all 232
enable for management module users command 377 disable monitoring for blade
(advanced) 373 users command errors 468 device 232
uplink failover delay (logical) users commands disable monitoring for chassis 233
set for advanced management example 398 disable monitoring for cooling
module 374 users, change password 385 device 234
set for management module users, create 381 disable monitoring for event log 233
(advanced) 374 users, delete 378 disable monitoring for I/O
uplink failover delay (physical) users, disable 379 module 232
set for advanced management users, display (active) 377 disable monitoring for power
module 373 users, display (all) 377 module 234
set for management module users, display (single) 378 disable monitoring for storage
(advanced) 373 users, enable 379 module 233
uplink failover IP address (logical) users, management module 377 disable monitoring for system
set for advanced management users, set access type (SNMPv3) 390 management 233
module 374 users, set authentication protocol enable monitoring for all 232
(SNMPv3) 389
Index 517
warning alerts (continued)
enable monitoring for blade
device 232
enable monitoring for chassis 233
enable monitoring for cooling
device 234
enable monitoring for event log 233
enable monitoring for I/O
module 232
enable monitoring for power
module 234
enable monitoring for storage
module 233
enable monitoring for system
management 233
web interface
enable for management module 361
web interface inactivity timeout
set for management module 38
WNN information reload 204
write
options
config 401
config, l ,i 401, 402
write command 401
example 402
write command errors 472
Z
zonecfg 403
options
activate 403
view 404
zonecfg command errors 473
zonecfg commands 403
example 404
518 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Printed in USA