ibm blade console
TRANSCRIPT
BladeCenter Advanced Management ModuleBladeCenter T Advanced Management Module
Command-Line Interface Reference Guide
���
BladeCenter Advanced Management ModuleBladeCenter T Advanced Management Module
Command-Line Interface Reference Guide
���
Note: Before using this information and the product it supports, read the general information in “Getting help andtechnical assistance,” on page 475, “Notices” on page 479, the Warranty Information document, and the Safety Information andEnvironmental Notices and User Guide documents on the IBM Documentation CD.
Twenty-second Edition (February 2011)
© Copyright IBM Corporation 2011.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
Contents
Chapter 1. Introduction . . . . . . . . 1Before you begin . . . . . . . . . . . . . 2Accessibility features for the BladeCentermanagement module . . . . . . . . . . . 2
Chapter 2. Using the command-lineinterface . . . . . . . . . . . . . . 5Command-line interface guidelines . . . . . . . 5Selecting the command target. . . . . . . . . 6Commands and user authority . . . . . . . . 8Cabling the management module . . . . . . . 12
Networked connection. . . . . . . . . . 13Direct connection . . . . . . . . . . . 13Serial connection . . . . . . . . . . . 14
Starting the command-line interface . . . . . . 14IPv6 addressing for initial connection. . . . . 15Telnet connection . . . . . . . . . . . 16Serial connection . . . . . . . . . . . 17Secure Shell (SSH) connection . . . . . . . 18
BladeCenter unit configuration . . . . . . . . 20Configuring the management module . . . . . 21Starting an SOL session . . . . . . . . . . 22Ending an SOL session . . . . . . . . . . 23
Chapter 3. Command reference . . . . 25Alphabetic command list . . . . . . . . . . 25Command list by function . . . . . . . . . 27Command syntax . . . . . . . . . . . . 29
accseccfg command. . . . . . . . . . . 30advfailover command . . . . . . . . . . 40airfilter command (BladeCenter S only) . . . . 42alarm command (BladeCenter T and HT only). . 43alertcfg command . . . . . . . . . . . 51alertentries command . . . . . . . . . . 53autoftp command . . . . . . . . . . . 60baydata command . . . . . . . . . . . 63bofm command . . . . . . . . . . . . 66boot command . . . . . . . . . . . . 72bootmode command . . . . . . . . . . 74bootseq command . . . . . . . . . . . 75buildidcfg command . . . . . . . . . . 80chconfig command . . . . . . . . . . . 87chlog command . . . . . . . . . . . . 93chmanual command . . . . . . . . . . 95cin command . . . . . . . . . . . . . 97cinstatus command . . . . . . . . . . 102clear command . . . . . . . . . . . . 103clearlog command . . . . . . . . . . . 105clock command. . . . . . . . . . . . 106config command . . . . . . . . . . . 111console command . . . . . . . . . . . 115dhcpinfo command . . . . . . . . . . 117displaylog command . . . . . . . . . . 119displaysd command . . . . . . . . . . 124dns command . . . . . . . . . . . . 126
env (environment) command . . . . . . . 131ethoverusb command. . . . . . . . . . 137eventinfo command . . . . . . . . . . 138events command . . . . . . . . . . . 140exit command . . . . . . . . . . . . 143feature command . . . . . . . . . . . 144files command . . . . . . . . . . . . 147fuelg command. . . . . . . . . . . . 149groups command . . . . . . . . . . . 159health command . . . . . . . . . . . 163help command . . . . . . . . . . . . 166history command . . . . . . . . . . . 168identify (location LED) command . . . . . 169ifconfig command . . . . . . . . . . . 171info (configuration information) command . . 203iocomp command . . . . . . . . . . . 206kvm (keyboard, video, mouse) command . . . 208ldapcfg command . . . . . . . . . . . 210led command . . . . . . . . . . . . 220list (system physical configuration) command 225mcad command . . . . . . . . . . . 227modactlog command . . . . . . . . . . 228monalerts command . . . . . . . . . . 229mt (media tray) command . . . . . . . . 239nat command . . . . . . . . . . . . 241ntp (network time protocol) command . . . . 245ping command . . . . . . . . . . . . 248pmpolicy command . . . . . . . . . . 251portcfg command . . . . . . . . . . . 253ports command. . . . . . . . . . . . 255power command . . . . . . . . . . . 272rdoc command . . . . . . . . . . . . 278read command . . . . . . . . . . . . 280remotechassis command . . . . . . . . . 283reset command . . . . . . . . . . . . 286scale command . . . . . . . . . . . . 291sddump command . . . . . . . . . . 299sdemail command . . . . . . . . . . . 301security command. . . . . . . . . . . 303service command . . . . . . . . . . . 304shutdown command . . . . . . . . . . 306slp command . . . . . . . . . . . . 307smtp command. . . . . . . . . . . . 309snmp command . . . . . . . . . . . 312sol (serial over LAN) command . . . . . . 328sshcfg command . . . . . . . . . . . 335sslcfg command . . . . . . . . . . . 337syslog command . . . . . . . . . . . 347tcpcmdmode command . . . . . . . . . 351telnetcfg (Telnet configuration) command . . . 354temps command . . . . . . . . . . . 355trespass command. . . . . . . . . . . 356uicfg command. . . . . . . . . . . . 359update (update firmware) command . . . . 363uplink (management module failover) command 373users command . . . . . . . . . . . 377
© Copyright IBM Corp. 2011 iii
volts command . . . . . . . . . . . . 400write command . . . . . . . . . . . 401zonecfg command . . . . . . . . . . . 403
Chapter 4. Error messages . . . . . 407Common errors . . . . . . . . . . . . 409accseccfg command errors . . . . . . . . . 411advfailover command errors . . . . . . . . 412alarm command errors . . . . . . . . . . 413alertcfg command errors. . . . . . . . . . 414alertentries command errors . . . . . . . . 414autoftp command errors . . . . . . . . . . 415baydata command errors . . . . . . . . . 415bofm command errors . . . . . . . . . . 416boot command errors. . . . . . . . . . . 417bootmode command errors . . . . . . . . . 417bootseq command errors . . . . . . . . . 418buildidcfg command errors . . . . . . . . . 418chconfig command errors . . . . . . . . . 419chlog command errors . . . . . . . . . . 420chmanual command errors . . . . . . . . . 421cin command errors . . . . . . . . . . . 421clear command errors . . . . . . . . . . 423clearlog command errors . . . . . . . . . 423clock command errors . . . . . . . . . . 423config command errors . . . . . . . . . . 424console command errors. . . . . . . . . . 425dhcpinfo command errors . . . . . . . . . 426displaylog command errors. . . . . . . . . 426displaysd command errors . . . . . . . . . 427dns command errors . . . . . . . . . . . 428env command errors . . . . . . . . . . . 428ethoverusb command errors . . . . . . . . 428eventinfo command errors . . . . . . . . . 429events command errors . . . . . . . . . . 429exit command errors . . . . . . . . . . . 430feature command errors . . . . . . . . . . 430files command errors . . . . . . . . . . . 432fuelg command errors . . . . . . . . . . 433groups command errors . . . . . . . . . . 436health command errors . . . . . . . . . . 436help command errors. . . . . . . . . . . 437history command errors . . . . . . . . . . 437identify command errors . . . . . . . . . 437ifconfig command errors . . . . . . . . . 438info command errors . . . . . . . . . . . 442iocomp command errors. . . . . . . . . . 443kvm command errors. . . . . . . . . . . 443ldapcfg command errors. . . . . . . . . . 443led command errors . . . . . . . . . . . 444list command errors . . . . . . . . . . . 445mcad command errors . . . . . . . . . . 445modactlog command errors . . . . . . . . 445monalerts command errors . . . . . . . . . 445monalertsleg command errors . . . . . . . . 446mt command errors . . . . . . . . . . . 446nat command errors . . . . . . . . . . . 446ntp command errors . . . . . . . . . . . 447ping command errors . . . . . . . . . . 447pmpolicy command errors . . . . . . . . . 448portcfg command errors . . . . . . . . . . 448
ports command errors . . . . . . . . . . 448power command errors . . . . . . . . . . 450rdoc command errors. . . . . . . . . . . 450read command errors. . . . . . . . . . . 451remotechassis command errors . . . . . . . 452reset command errors . . . . . . . . . . 452scale command errors . . . . . . . . . . 453sddump command errors . . . . . . . . . 454sdemail command errors . . . . . . . . . 454security command errors . . . . . . . . . 455service command errors . . . . . . . . . . 455shutdown command errors . . . . . . . . . 455slp command errors . . . . . . . . . . . 455smtp command errors . . . . . . . . . . 455snmp command errors . . . . . . . . . . 456sol command errors . . . . . . . . . . . 457sshcfg command errors . . . . . . . . . . 458sslcfg command errors . . . . . . . . . . 459syslog command errors . . . . . . . . . . 461tcpcmdmode command errors . . . . . . . . 462telnetcfg command errors . . . . . . . . . 462temps command errors . . . . . . . . . . 463thres command errors . . . . . . . . . . 463trespass command errors . . . . . . . . . 463uicfg command errors . . . . . . . . . . 464update command errors . . . . . . . . . . 465uplink command errors . . . . . . . . . . 467users command errors . . . . . . . . . . 468volts command errors . . . . . . . . . . 472write command errors . . . . . . . . . . 472zonecfg command errors . . . . . . . . . 473
Appendix. Getting help and technicalassistance. . . . . . . . . . . . . 475Before you call . . . . . . . . . . . . . 475Using the documentation . . . . . . . . . 476Getting help and information from the World WideWeb . . . . . . . . . . . . . . . . 476Software service and support . . . . . . . . 476Hardware service and support . . . . . . . 476IBM Taiwan product service . . . . . . . . 477
Notices . . . . . . . . . . . . . . 479Trademarks . . . . . . . . . . . . . . 479Important notes . . . . . . . . . . . . 480Particulate contamination . . . . . . . . . 481Documentation format . . . . . . . . . . 482Electronic emission notices . . . . . . . . . 482
Federal Communications Commission (FCC)statement. . . . . . . . . . . . . . 482Industry Canada Class A emission compliancestatement. . . . . . . . . . . . . . 483Avis de conformité à la réglementationd'Industrie Canada . . . . . . . . . . 483Australia and New Zealand Class A statement 483European Union EMC Directive conformancestatement. . . . . . . . . . . . . . 483Germany Class A statement . . . . . . . 483Japan VCCI Class A statement. . . . . . . 484
iv IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Korea Communications Commission (KCC)statement. . . . . . . . . . . . . . 485Russia Electromagnetic Interference (EMI) ClassA statement . . . . . . . . . . . . . 485People's Republic of China Class A electronicemission statement . . . . . . . . . . 485
Taiwan Class A compliance statement . . . . 485
Index . . . . . . . . . . . . . . . 487
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 managementmodule command-line interface. Information about the command-line interface formanagement modules other than the advanced management module is in aseparate document.
The IBM® BladeCenter® advanced management-module command-line interface(CLI) provides direct access to BladeCenter management functions as an alternativeto using the web-based user interface. Using the command-line interface, you canissue commands to control the power and configuration of the managementmodule and other components that are in a BladeCenter unit.
All IBM BladeCenter units are referred to throughout this document as theBladeCenter unit. All management modules are referred to throughout thisdocument as the management module. Unless otherwise noted, all commands canbe 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 command-line interface also provides access to the text-console commandprompt on each blade server through a serial over LAN (SOL) connection. See theIBM BladeCenter Serial Over LAN Setup Guide for information about SOL and setupinstructions.
You access the management-module CLI by establishing a Telnet connection to theIP address of the management module or through a Secure Shell (SSH) connection.You can initiate connections from the client system by using standard remotecommunication software; no special programs are required. Users are authenticatedby the management module before they can issue commands. You enter commandsone at a time; however, you can use command scripting to enter multiplecommands. The interface does not support keyboard shortcuts, except for thespecial key sequence, Esc (, that terminates an SOL session.
The most recent versions of all BladeCenter documentation are available fromhttp://www.ibm.com/systems/support/.
IBM Redbooks publications are developed and published by the IBM InternationalTechnical Support Organization (ITSO). The ITSO develops and delivers skills,technical know-how, and materials to IBM technical professionals, BusinessPartners, clients, and the marketplace in general. For IBM Redbooks publicationsfor your BladeCenter, go to http://www.redbooks.ibm.com/portals/bladecenter.
© Copyright IBM Corp. 2011 1
Before you beginThe following hardware and software is required for the command-line interface:
Hardware:
No special hardware is required to use the management-modulecommand-line interface.
To use the SOL feature, an Ethernet I/O module that supports SOL mustbe installed in I/O-module bay 1. You can use the console command tocontrol a blade server through SOL only on blade server types that supportSOL functionality and have an integrated service processor firmware levelof version 1.00 or later. See the IBM BladeCenter Serial Over LAN SetupGuide for information.
Firmware:
Make sure that you are using the latest versions of device drivers,firmware, and BIOS code for your blade server, management module, andother BladeCenter components. Go to http://www.ibm.com/systems/support/ for the latest information about upgrading the device drivers,firmware, and BIOS code for BladeCenter components. The latestinstructions are in the documentation that comes with the updates.
The management-module CLI is supported by BladeCentermanagement-module firmware level version 1.08 or later. All versions ofBladeCenter T management-module firmware and advanced managementmodule firmware support the command-line interface. The SOL feature hasadditional firmware requirements. See the IBM BladeCenter Serial Over LANSetup Guide for information.
Accessibility features for the BladeCenter management moduleAccessibility features help users who have a disability, such as restricted mobilityor limited vision, to use information technology products successfully.
Accessibility features
Accessibility for the BladeCenter management module interface is providedthrough the command-line interface. The remote control video feed is notaccessible to a screen reader.
The BladeCenter Information Center is accessibility-enabled. The accessibilityfeatures of the information center include:v Keyboard-only operationv Interfaces that are commonly used by screen readers. (The Java access bridge
must be installed to make Java applets available to the JAWS screen reader.)v The attachment of alternative input and output devices
Keyboard navigation
This product uses standard Microsoft® Windows® navigation keys.
Related accessibility information
You can view the publications for IBM BladeCenter in Adobe® Portable DocumentFormat (PDF) using the Adobe Acrobat® Reader. The PDFs are provided on a CD
2 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
that is packaged with the product, or you can access them through the IBMBladeCenter Information Center.
IBM and accessibility
See the IBM Human Ability and Accessibility Center for more information aboutthe 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.
The IBM management-module command-line interface (CLI) provides a convenientmethod for entering commands that manage and monitor BladeCentercomponents. This chapter contains the following information about using thecommand-line interface:v “Command-line interface guidelines”v “Selecting the command target” on page 6v “Commands and user authority” on page 8v “Cabling the management module” on page 12v “Starting the command-line interface” on page 14v “BladeCenter unit configuration” on page 20v “Configuring the management module” on page 21v “Starting an SOL session” on page 22v “Ending an SOL session” on page 23
See Chapter 3, “Command reference,” on page 25 for detailed information aboutcommands that are used to monitor and control BladeCenter components.Command-line interface error messages are in Chapter 4, “Error messages,” onpage 407. See the IBM BladeCenter Serial Over LAN Setup Guide for SOL setupinstructions and the documentation for your operating system for informationabout commands that you can enter through an SOL connection.
Command-line interface guidelinesThis topic gives general guidelines for using the BladeCenter command-lineinterface.
All commands have the following basic structure:
command -option parameter
Some commands do not require options and some command options do notrequire parameters. You can add multiple options to a command on one line toavoid repeating the same command. Options that display a value and options thatset a value must not be used together in the same command. The followingexamples illustrate valid command option syntax:v commandv command -option_setv command -option_set parameterv command -option1_set parameter -option2_set parameter
The information for each option is returned in the order in which it was enteredand is displayed on separate lines.
© Copyright IBM Corp. 2011 5
Observe the following general guidelines when you use the command-lineinterface:v Case sensitivity
All commands, command options, and predefined command option parametersare case sensitive.
Note: If you receive a Command not found error, make sure that you are typingthe command in the correct case. For a list of valid commands, type help or ?.
v Data typesThe 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 toany command displays its syntax.
v You can use the Up Arrow and Down Arrow keys in the command-line interfaceto access the last eight commands that you entered.
Selecting the command targetThis topic describes command targets and the persistent command environment.
You can use the command-line interface to target commands to the managementmodule or to other devices in the BladeCenter unit. The command-line promptindicates the persistent command environment: the environment in whichcommands are entered unless they are otherwise redirected. When a command-lineinterface session is started, the persistent command environment is system; thisindicates that commands are being directed to the BladeCenter unit.
Command targets are specified hierarchically, as shown in the followingillustration. This illustration shows command targets for all management moduleand BladeCenter unit types.
6 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
You can change the persistent command environment for the remainder of acommand-line interface session by using the env command (see “env(environment) command” on page 131). When you list the target as a commandattribute by using the -T option, you change the target environment for thecommand that you are entering, temporarily overriding the persistent commandenvironment. You can specify target environments by using the full path name orby using a partial path name that is based on the persistent commandenvironment. Full path names always begin with "system". The levels in a pathname 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 commandenvironment is set to the blade server in blade server bay 3.
Most management-module commands must be directed to the primarymanagement module. If only one management module is installed in theBladeCenter unit, it always acts as the primary management module. Eithermanagement module can function as the primary management module; however,only one management module can be primary at one time. You can determine
BladeCenterunit
system
Power module
power[x]where x = 1 to n
Media tray
mt[x]where x = 1 to 2
Blade server
blade[x]where x = 1 to n
Managementmodule
mm[x]where x = 1 to 2
I/O module(switch module)
switch[x]where x = 1 to n
Blower
blower[x]where x = 1 to n
Alarm panelmodule
tap (BladeCenter HTonly)
Multiplexerexpansion module
mux[x]where x = 1 to 2(BladeCenter HTonly)
Network clockmodule
ncc[x]where x = 1 to 2(BladeCenter HTonly)Storage module
storage[x]where x = 1 to n(BladeCenter S only)
Integrated systemmanagement
processor(service
processor)
sp
Microprocessor
cpu[x]where x = 1 to n
Memory
memory[x
]where x = 1 to n(AMM only)
Management card
mgmtcrd(AMM only)
Storageexpansion unit
be[x]where x = 1 to n
High-speedexpansion card
hsdc (not AMM)hsec[x] (AMM only)where x = 1 to n
Concurrent KVMfeature card
ckvm (AMM only)
Double-widthblade servermezzanine
sb (AMM only)
I/O expansion card
dtr[x] (not AMM)exp[x] (AMM only)where x = 1 to n
Battery BackupUnit
bbu[x]where x = 1 to n(BladeCenter S only)
Disk Drive
disk[x]where x = 1 to n
only)(BladeCenter S
High-speedexpansion card
hsec[x]
(AMM only)where x = 1 to n
I/O expansioncard
exp[x]
(AMM only)where x = 1 to n
Chapter 2. Using the command-line interface 7
which management module is acting as the primary management module by usingthe list command (see “list (system physical configuration) command” on page225).
Commands and user authorityThis topic lists command-line interface commands and the user authority levelsneeded to run them.
Some commands in the command-line interface can be executed only by users whoare assigned a required level of authority. Users with Supervisor commandauthority can execute all commands. Commands that display information do notrequire any special command authority; however, users can be assigned restrictedread-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 requiredauthority 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 ofthe commands do not require any special command authority.
v If a command requires only one command authority at a time, each of theapplicable command authorities is indicated by a dot (v). If a command requiresa combination of two or more command authorities, the applicable commandauthorities are indicate by L or ‡. For example, the boot -c command isavailable to a user with the Supervisor command authority and to a user withboth the Blade Administration and Blade Remote Presence command authorities.
Important: Command authority definitions might change between firmwareversions. Make sure that the command authority level for each user is correct afteryou update the management-module firmware.
Notes:
1. LDAP (lightweight directory access protocol) authority levels are not supportedby management modules other than the advanced management module.
2. LDAP authority levels are not supported by the management-module webinterface.
3. To use the LDAP authority levels, you must make sure that the version ofLDAP security that is used by the management module is set to v2 (enhancedrole-based security model). See “ldapcfg command” on page 210 forinformation.
8 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 1. Command authority relationships
Command
Authority
Su
per
viso
r
Ch
assi
sA
ccou
nt
Man
agem
ent
Ch
assi
sL
ogM
anag
emen
t
Ch
assi
sA
dm
inis
trat
ion
Ch
assi
sC
onfi
gura
tion
Bla
de
Ad
min
istr
atio
n
Bla
de
Con
figu
rati
on
Bla
de
Rem
ote
Pre
sen
ce
I/O
Mod
ule
Ad
min
istr
atio
n
I/O
Mod
ule
Con
figu
rati
on
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(blade server)
v v
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(blade server)
v v
config(management module orBladeCenter unit)
v v
console v v
displaylog -lse v v
dns v v
Chapter 2. Using the command-line interface 9
Table 1. Command authority relationships (continued)
Command
Authority
Su
per
viso
r
Ch
assi
sA
ccou
nt
Man
agem
ent
Ch
assi
sL
ogM
anag
emen
t
Ch
assi
sA
dm
inis
trat
ion
Ch
assi
sC
onfi
gura
tion
Bla
de
Ad
min
istr
atio
n
Bla
de
Con
figu
rati
on
Bla
de
Rem
ote
Pre
sen
ce
I/O
Mod
ule
Ad
min
istr
atio
n
I/O
Mod
ule
Con
figu
rati
on
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,management module, andsystem targets)
v v
ifconfig (I/O module target) v v
ifconfig -pip (I/O moduletarget)
v v v
kvm -b v v
kvm -local v v
ldapcfg v v
led -info, -d, -loc(system target)
v v v v v
led -info, -loc(blade server target)
v v v v
mcad v v
monalerts v v
mt -b v v
mt -local, -remote v v
nat v v
ntp v v
ping -i(see Note 1)
v v v
pmpolicy v v
portcfg v v
ports v v
10 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 1. Command authority relationships (continued)
Command
Authority
Su
per
viso
r
Ch
assi
sA
ccou
nt
Man
agem
ent
Ch
assi
sL
ogM
anag
emen
t
Ch
assi
sA
dm
inis
trat
ion
Ch
assi
sC
onfi
gura
tion
Bla
de
Ad
min
istr
atio
n
Bla
de
Con
figu
rati
on
Bla
de
Rem
ote
Pre
sen
ce
I/O
Mod
ule
Ad
min
istr
atio
n
I/O
Mod
ule
Con
figu
rati
on
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(global)
v v
power -fp(I/O module)
v v
rdoc v v
read v v
reset(blade server or ISMP)
v v
reset(I/O module)
v v
reset(management module)
v v
reset -c, -clr, -dg, -ddg, -sft,(blade server)
v L L
reset -sms(blade server)
v v
reset -exd, -full, -std(I/O module)
v v
reset -f, -standby, -force(management module)
v v
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
Chapter 2. Using the command-line interface 11
Table 1. Command authority relationships (continued)
Command
Authority
Su
per
viso
r
Ch
assi
sA
ccou
nt
Man
agem
ent
Ch
assi
sL
ogM
anag
emen
t
Ch
assi
sA
dm
inis
trat
ion
Ch
assi
sC
onfi
gura
tion
Bla
de
Ad
min
istr
atio
n
Bla
de
Con
figu
rati
on
Bla
de
Rem
ote
Pre
sen
ce
I/O
Mod
ule
Ad
min
istr
atio
n
I/O
Mod
ule
Con
figu
rati
on
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 ModuleAdministration, I/O Module Configuration, or I/O Module Operator authoritycan execute the ping -i command option with no arguments or ping a specificIP address that is identified using its index number.
Cabling the management moduleThis topic describes how to cable the management module.
You must connect a client system to the management module to configure andmanage operation of the BladeCenter unit. All management modules support aremote management and console (Ethernet) connection. The advanced managementmodule also supports connection through the serial management port.
You can manage the BladeCenter unit by using by using the command-lineinterface that you access through Telnet or through the serial management port.You can also use the graphical user interface that is provided by themanagement-module web interface to manage the BladeCenter unit and bladeservers that support KVM. To make management connections to blade servers thatdo not support KVM, use an SOL session through the management-modulecommand-line interface.
12 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
To access the management-module command-line interface, you need the followingequipment and information:v A system with Ethernet or serial connection capability. To facilitate connections
at multiple locations, you can use a notebook computer.v The management-module MAC address (listed on the label on the management
module).v For networked connection to the management module, you need a standard
Ethernet cable and a local Ethernet network port (facility connection).v For direct connection of a system to the advanced management-module remote
management and console (Ethernet) connector, you can use either a standardEthernet cable or an Ethernet crossover cable.
v For serial connection of a system to the advanced management-module serialconnector, you need a serial cable. See the Installation Guide for yourmanagement module for cabling information and instructions.
For information about accessing the management-module web interface, see theBladeCenter Advanced Management Module User’s Guide.
The following topics describe how to cable to the management module to performinitial configuration of the BladeCenter unit. See the Installation Guide for yourmanagement module for specific cabling instructions.
Networked connectionThis topic describes how to connect the management module to a network.
Connect one end of a Category 5 or higher Ethernet cable to the remotemanagement and console (Ethernet) connector of the management module.Connect the other end of the Ethernet cable to the facility network.
Direct connectionThis topic tells you how to connect a client computer directly to the managementmodule.
Connect one end of a Category 5 or higher Ethernet cable or a Category 5 orhigher Ethernet crossover cable to the remote management and console (Ethernet)connector of the management module. Connect the other end of the cable to theEthernet connector on the client system.
Note: An advanced management module can perform an automatic mediadependent interface (MDI) crossover, eliminating the need for crossover cables orcross-wired (MDIX) ports. You might have to use a crossover cable to connect yoursystem to the advanced management module if the network interface card in theclient system is very old.
Chapter 2. Using the command-line interface 13
Serial connectionYou can connect a serial cable to the advanced management module.
Connect one end of a serial cable to the serial connector on the managementmodule. Connect the other end of the serial cable to the serial connector on theclient system. See the Installation Guide for your management module for cablinginformation and instructions.
Starting the command-line interfaceAccess the management-module command-line interface from a client system byestablishing a Telnet connection to the IP address of the management module or byestablishing a Secure Shell (SSH) connection.
For the advanced management module, you can also access the command-lineinterface using a serial connection. You can establish up to 20 separate Telnet,serial, or SSH sessions to the BladeCenter management module, giving you theability to have 20 command-line interface sessions active at the same time.
Although a remote network administrator can access the management-modulecommand-line interface through Telnet, this method does not provide a secureconnection. As a secure alternative to using Telnet to access the command-lineinterface, use a serial or SSH connection. SSH ensures that all data that is sent overthe network is encrypted and secure.
The following SSH clients are available. Although some SSH clients have beentested, 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 SSHclient of Red Hat Linux 8.0 Professional was used to test the command-lineinterface.
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.
Algorithm SSH version 2.0 clients
Public key exchange Diffie-Hellman-group 1-sha-1
Host key type DSA - 2048-bit
Bulk cipher algorithms 3-des-cbc or blowfish-cbc
MAC algorithms Hmac-sha1
14 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following topics describe how to connect your system to the managementmodule to perform initial configuration of the BladeCenter unit. The managementmodule has the following default settings:
Note: The advanced management module does not have a fixed static IPv6 IPaddress by default. For initial access to the advanced management module in anIPv6 environment, users can either use the IPv4 IP address or the IPv6 link-localaddress. See “IPv6 addressing for initial connection” for information aboutdetermining IPv6 addressing for initial connection.v IPv4 IP address: 192.168.70.125 (primary and secondary management module)v IPv4 Subnet: 255.255.255.0v 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 beconfigured 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, youmust change the Internet protocol properties on the system that you areconnecting.
Note: For advanced management modules, the available password options dependon the password options that are configured for the BladeCenter unit.
IPv6 addressing for initial connectionWhen using IPv6 addressing, the only way to initially connect to the advancedmanagement module is by using the IPv6 link-local address.
The link-local address is a unique IPv6 address for the advanced managementmodule that is automatically generated based on its MAC address. It is of theform: FE80::3BA7:94FF:FE07:CBD0.
The link-local address for the advanced management module can be determined inone 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 theifconfig command (see “ifconfig command” on page 171 for information).
v If you are able to log in to the management module web interface using IPv4addressing, the link-local address can be viewed in the Primary ManagementModule, IPv6 section of the MM Control → Network Interfaces page (see theBladeCenter Advanced Management Module User's Guide for information).
If the advanced management module does not have a label listing the link-localaddress and you are unable to access the advanced management module usingIPv4, 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 readsMMxxxxxxxxxxxx, 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. Forexample,39-A7-94-FF-FE-07-CB-D0
Chapter 2. Using the command-line interface 15
3. Convert the two hexadecimal digits at the left end of the string to binary. Forexample,v 39-A7-94-FF-FE-07-CB-D0
v 00111001-A7-94-FF-FE-07-CB-D0
4. Invert the value for bit 7 of the binary string. For example,v 00111001-A7-94-FF-FE-07-CB-D0
v 00111011-A7-94-FF-FE-07-CB-D0
5. Convert the binary digits at the left end of the string back to hexadecimal. Forexample,v 00111011-A7-94-FF-FE-07-CB-D0
v 3B-A7-94-FF-FE-07-CB-D0
6. Combine the hexadecimal digit pairs into 4-digit groups. For example,v 3B-A7-94-FF-FE-07-CB-D0
v 3BA7-94FF-FE07-CBD0
7. Replace dash (-) separators with colon (:) separators. For example,v 3BA7-94FF-FE07-CBD0
v 3BA7:94FF:FE07:CBD0
8. Add FE80:: to the left of the string. For example,FE80::3BA7:94FF:FE07:CBD0
For a MAC address of 39-A7-94-07-CB-D0, the link-local address used for initialIPv6 access is FE80::3BA7:94FF:FE07:CBD0.
Telnet connectionThis topic tells you how to establish a Telnet session with the managementmodule.
To log on to the management module by using Telnet, complete the followingsteps:1. From a command-line prompt on the network-management workstation, type
telnet ip_address (where ip_address is the management module IP address),and press Enter. For the first connection to the management module, use thedefault IP address of the management module; if a new IP address has beenassigned to the management module, use that one instead.
Note: The factory-defined static IPv4 IP address is 192.168.70.125, the defaultIPv4 subnet address is 255.255.255.0, and the default host name isMMxxxxxxxxxxxx, where xxxxxxxxxxxx is the burned-in MAC address. TheMAC address is on a label on the management module, below the IP resetbutton. See “IPv6 addressing for initial connection” on page 15 for informationabout determining IPv6 addressing for initial connection.
2. At the login prompt, type the management-module user ID. At the passwordprompt, type the management-module password. The user ID and passwordare case sensitive and are the same as those that are used formanagement-module web access. The default management-module user nameis USERID, and the default password is PASSW0RD (note the number zero, notthe letter O, in PASSW0RD).
The CLI command prompt is displayed. You can now enter commands for themanagement module.
16 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Serial connectionYou can set up a serial connection with 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 themanagement module. The default management-module serial port settings areas follows:v Baud rate (BPS): 57600v Data bits: 8v Parity: no parityv Stop bits: 1v Flow control: none
2. If any of the serial port settings for the client system were changed, reset themanagement module (see the Installation Guide for your management modulefor instructions).
3. At the login prompt, type the management-module user ID. At the passwordprompt, type the management-module password. The user ID and passwordare case sensitive and are the same as those that are used formanagement-module web access. The default management-module user nameis USERID, and the default password is PASSW0RD (note the number zero, notthe letter O, in PASSW0RD).
The CLI command prompt is displayed. You can now enter commands for themanagement module.
Chapter 2. Using the command-line interface 17
Secure Shell (SSH) connectionThis topic tell you how to establish a Secure Shell (SSH) connection with themanagement 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 forinstructions.
3. Start an SSH session to the management module, using the SSH client of yourchoice. For example, if you are using the cygwin client, from a commandprompt on the network-management workstation, type ssh ip_address (whereip_address is the management module IP address), and press Enter. For the firstconnection to the management module, use the default IP address of themanagement module; if a new IP address has been assigned to themanagement module, use that one instead.
Note: The factory-defined static IPv4 IP address is 192.168.70.125, the defaultIPv4 subnet address is 255.255.255.0, and the default host name isMMxxxxxxxxxxxx, where xxxxxxxxxxxx is the burned-in MAC address. TheMAC address is on a label on the management module, below the IP resetbutton. See “IPv6 addressing for initial connection” on page 15 for informationabout determining IPv6 addressing for initial connection.
4. Type the management-module user ID when you are prompted. At thepassword prompt, type the management-module password. The user ID andpassword are case sensitive and are the same as those that are used formanagement-module web access. The default management-module user nameis USERID, and the default password is PASSW0RD (note the number zero, notthe letter O, in PASSW0RD).
The CLI command prompt is displayed. You can now enter commands for themanagement module.
Using the Secure Shell serverThis topic tells you how to use the management module Secure Shell server.
The following SSH clients are available. Although some SSH clients have beentested, 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 theclient that is included in Red Hat Linux version 7.3, to start an interactivecommand-line Secure Shell session to a management module with network address192.168.70.2, type a command similar to the following example:
ssh -x -l USERID 192.168.70.2
where -x indicates no X Window System forwarding and -l indicates that thesession is to use the login ID USERID.
18 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The advanced management module supports non-interactive Secure Shell sessions.This is most useful when it is combined with public key authentication. Use thiscapability to issue a single CLI command by adding the command to the end ofthe ssh command. For example, to get a list of the current users of the advancedmanagement module type
ssh -l USERID 192.168.70.2 users -T mm[1] -curr
If the CLI command requires special characters such as quotation marks, you mustescape them so that they are not consumed by the command shell on your clientsystem. For example, to set a new trespass warning, type a command similar to thefollowing example:
ssh -l USERID 192.168.70.2 trespass -T mm[1] -tw \"New WARNING\"
To start a Serial over LAN text redirection session to a blade server, the process issimilar, but in this case you must specify that the Secure Shell server session uses apseudo-terminal (PTY) to get the correct output formatting and keystrokehandling. In the following example, which starts a Serial over LAN session to theblade server in slot 2, the -t SSH client option specifies that a PTY is to beallocated.
ssh -t -l USERID 192.168.70.1 console -T blade[2]
Using SMASHYou can use the System Management Architecture for Server Hardware CommandLine Protocol (SMASH CLP) for the advanced management module. See the IBMSMASH Proxy Installation and User's Guide for more information.
To start an interactive SMASH CLP session by using an SSH client such asOpenSSH client with an advanced management module with networking address192.168.70.2, type a command similar to the following example:
ssh -p 50022 -l USERID 192.168.70.2
where -p 50022 specifes TCP port 50022, the default port number for SecureSMASH on the advanced management module, and -l USERID specifies one of the12 local account login IDs.
The advanced management module supports non-interactive Secure SMASHsessions. This is most useful when it is combined with public key authentication.Use this capability to issue a single SMASH CLP command. To start anon-interactive SMASH session, you must specify that the Secure SMASH serveruses a pseudo-terminal (PTY). If you fail to specify a PTY for the session the InputRedirection not Supported error message is displayed. For example, to get a listof the SMASH-addressable entities, type a command similar to the followingexample:
ssh -t -p 50022 -l USERID 192.168.70.2 show /modular1
where -t specifies that a PTY is required for the session and show /modular1 is theSMASH 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, youmust specify the correct TCP port number. By default, the port that is assigned tothe SMASH protocol is 50023.
Chapter 2. Using the command-line interface 19
SSH CLI exit codesThe SSH CLI commands return exit codes.
All CLI commands that are run in an SSH client single-command environmentprovide exit codes to indicate their outcomes. The following table shows exit codesthat are supported; other exit codes are reserved for future use.
Table 2. SSH CLI exit codes
NameValue(decimal) Description
EX_OK 0 Successful command execution.
EX_USAGE 64 Command-line usage error: syntax error, wrong command argumentsor 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, CLIdisabled, or the data returned by a command has an unexpected value.
EX_SOFTWARE 70 Internal software error. Check the management-module event log forother error indications.
EX_TEMPFAIL 75 The command could not perform a write operation because the deviceor management module was not in the correct state. Check forconflicting tasks or conditions and try to run the command again.
CLI_ERR_NOT_AUTHORIZED 126 Authorization error: the user does not have sufficient privileges toexecute command.
CLI_ERR_CNF 127 Command not found.
BladeCenter unit configurationYou must configure the BladeCenter unit for command-line interface operation.
The BladeCenter unit automatically detects the modules and blade servers that areinstalled and stores the vital product data (VPD). When the BladeCenter unit isstarted, the management module automatically configures the remote managementport of the management module, so that you can configure and manageBladeCenter components. You configure and manage BladeCenter componentsremotely by using the management-module command-line interface (CLI) or themanagement-module web interface.
To communicate with network resources and with the I/O modules in theBladeCenter unit, you must configure IP addresses for the management moduleand I/O modules. You can configure management-module IP addresses by usingthe web interface or command-line interface. You can configure the I/O modulesthrough the management-module web interface or through an external I/O-moduleport that is enabled through the management module, using a Telnet interface, aserial connection, or a web browser. See the documentation that comes with eachI/O module for information and instructions.
To communicate with the blade servers for functions such as deploying anoperating system or application program over a network, you must also configureat least one external (in-band) port on an Ethernet switch module in I/O-modulebay 1 or 2.
20 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Note: If a pass-thru module is installed in I/O-module bay 1 or 2 (instead of anEthernet I/O module), you must configure the network switch that the pass-thrumodule is connected to; see the documentation that comes with the network switchfor instructions.
Configuring the management moduleYou must configure the management module for command-line interface operation.
You configure only the primary (active) management module. The standby(redundant) management module, if present, receives the configuration and statusinformation automatically from the primary management module when necessary.The configuration information in this topic applies to the primary managementmodule, which might be the only management module in the BladeCenter unit.
If the management module that you installed is a replacement for the onlymanagement module in the BladeCenter unit and you saved the configuration filebefore you replaced the management module, you can apply the savedconfiguration file to the replacement management module. For advancedmanagement modules, see “read command” on page 280 for information aboutapplying a saved configuration file.
For the primary management module to communicate, you must configure the IPaddress for the external Ethernet (remote management) port (eth0) of themanagement module. The initial automatic management module configurationenables a remote console to connect to the management module to configure theport completely and to configure the rest of the BladeCenter unit.
Note: The internal Ethernet ports (eth1) for the advanced management modulecannot be configured.
After you connect the primary management module to the network, the Ethernetport connection is configured in one of the following ways. Either of these actionsenables 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, subnetmask, and DNS server IP address are set automatically. The host name is set tothe management-module MAC address by default, and the domain servercannot change it.
v If the DHCP server does not respond within 2 minutes after the port isconnected, the management module uses the factory-defined static IP addressand default subnet address.
Note: If the management-module DHCP setting is set to try the DHCP serverand then use the static IP address, the management module uses the static IPaddress when the DHCP server is not available during management-modulestartup. When this occurs, the IP address might not be reachable if multiplemanagement modules were started with the same static IP address.
Important: You cannot connect your system to the management module by usingthe factory-defined static IP address and default subnet address until at least 3minutes after management-module startup.
Note: If the IP configuration is assigned by the DHCP server, you can use theMAC address of the management-module network interface to find out what IP
Chapter 2. Using the command-line interface 21
address is assigned.
To configure the management-module Ethernet ports, complete the following steps:1. Connect your system to the management-module command-line interface (see
“Starting the command-line interface” on page 14 for more information).2. Configure the external Ethernet interface (eth0), using the ifconfig command
(see “ifconfig command” on page 171 for instructions).
Notes:
v The internal Ethernet management port on each I/O module provides forcommunication with the management module. You configure this port byconfiguring the IP address for the I/O module (see the BladeCenter AdvancedManagement Module User's Guide and the User's Guide for your I/O moduletype for information and instructions). Some types of I/O modules, such asthe pass-thru module, have no management port. See the documentation thatcomes with each I/O module to determine what else you must configure inthe I/O module.
v For I/O-module communication with a remote management station, such asan IBM® Systems Director management server, through themanagement-module external Ethernet port, the I/O-module internalnetwork interface and the management-module internal and externalinterfaces must be on the same subnet.
v To communicate with the blade servers for functions such as deploying anoperating system or application program, you also must configure at leastone external (in-band) port on an Ethernet I/O module.
Starting an SOL sessionAfter you start a Telnet or SSH session to the BladeCenter management module,you can start an SOL session to any individual blade server that supports SOL.
Note: Serial over LAN (SOL) must be enabled for both the BladeCenter unit andthe 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 SetupGuide for information about setting up and enabling SOL.
Because you can start up to 20 separate web interface, Telnet, serial, or SSHsessions to the BladeCenter management module, simultaneous SOL sessions canbe 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 theblade server in blade bay 6, typeconsole -T system:blade[6]
Note: A blade server assembly that occupies more than one blade server bay isidentified by the lowest bay number that it occupies.
After an SOL session is started, all commands are sent to the blade server that isspecified by the console command until the SOL session is ended, regardless of thepersistent command target that was in effect before the SOL session.
See “sol (serial over LAN) command” on page 328 and the IBM BladeCenter Serialover LAN Setup Guide for information about configuring a blade server for SOL. See
22 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
your operating-system documentation for information about SOL commands thatyou can enter by using the command-line interface.
Ending an SOL sessionTo end an SOL session, press Esc followed by an opening parenthesis.
When the SOL session ends, the command-line interface returns to the persistentcommand target that was in effect before the SOL session. If you want to end theTelnet or SSH command-line session, type exit.
Note: Exiting an SOL session does not stop the flow of serial data.
Chapter 2. Using the command-line interface 23
24 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chapter 3. Command reference
This topic contains command function, usage information, and examples.
Commands in “Command syntax” on page 29 are listed in alphabetic order. Thecommands are also listed in the following two topics:v “Alphabetic command list”v “Command list by function” on page 27
Adding a -h, -help, or ? option to a command displays syntax help for thatcommand. For example, to display help for the environment command, type one ofthe following commands:v env -hv env -helpv env ?
You can target a command to a device other than the one that is set as the defaultby adding a -T option to a command. See “Selecting the command target” on page6 for information.
Alphabetic command list
In alphabetic order, the commands are as follows:v “accseccfg command” on page 30v “advfailover command” on page 40v “airfilter command (BladeCenter S only)” on page 42v “alarm command (BladeCenter T and HT only)” on page 43v “alertcfg command” on page 51v “alertentries command” on page 53v “autoftp command” on page 60v “baydata command” on page 63v “bofm command” on page 66v “boot command” on page 72v “bootmode command” on page 74v “bootseq command” on page 75v “buildidcfg command” on page 80v “chconfig command” on page 87v “chlog command” on page 93v “chmanual command” on page 95v “cin command” on page 97v “cinstatus command” on page 102v “clear command” on page 103v “clearlog command” on page 105v “clock command” on page 106v “config command” on page 111v “console command” on page 115v “dhcpinfo command” on page 117v “displaylog command” on page 119v “displaysd command” on page 124v “dns command” on page 126v “env (environment) command” on page 131v “ethoverusb command” on page 137
© Copyright IBM Corp. 2011 25
v “eventinfo command” on page 138v “events command” on page 140v “exit command” on page 143v “feature command” on page 144v “files command” on page 147v “groups command” on page 159v “fuelg command” on page 149v “health command” on page 163v “help command” on page 166v “history command” on page 168v “identify (location LED) command” on page 169v “ifconfig command” on page 171v “info (configuration information) command” on page 203v “iocomp command” on page 206v “kvm (keyboard, video, mouse) command” on page 208v “ldapcfg command” on page 210v “led command” on page 220v “list (system physical configuration) command” on page 225v “mcad command” on page 227v “modactlog command” on page 228v “monalerts command” on page 229v “mt (media tray) command” on page 239v “nat command” on page 241v “ntp (network time protocol) command” on page 245v “ping command” on page 248v “pmpolicy command” on page 251v “portcfg command” on page 253v “ports command” on page 255v “power command” on page 272v “rdoc command” on page 278v “read command” on page 280v “remotechassis command” on page 283v “reset command” on page 286v “scale command” on page 291v “sddump command” on page 299v “sdemail command” on page 301v “security command” on page 303v “service command” on page 304v “shutdown command” on page 306v “slp command” on page 307v “smtp command” on page 309v “snmp command” on page 312v “sol (serial over LAN) command” on page 328v “sshcfg command” on page 335v “sslcfg command” on page 337v “syslog command” on page 347v “tcpcmdmode command” on page 351v “telnetcfg (Telnet configuration) command” on page 354v “temps command” on page 355v “trespass command” on page 356v “uicfg command” on page 359v “update (update firmware) command” on page 363v “uplink (management module failover) command” on page 373v “users command” on page 377v “volts command” on page 400v “write command” on page 401
26 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
v “zonecfg command” on page 403
Command list by functionBy function, the commands are as follows:v Built-in commands
Use these commands to perform top-level functions within the command-lineinterface:– “env (environment) command” on page 131– “help command” on page 166– “history command” on page 168– “list (system physical configuration) command” on page 225
v Common commands
Use these commands to monitor and control operation of BladeCentercomponents:– “cinstatus command” on page 102– “health command” on page 163– “info (configuration information) command” on page 203– “iocomp command” on page 206– “modactlog command” on page 228– “ping command” on page 248– “temps command” on page 355– “volts command” on page 400
v Configuration commands
Use these commands to view and configure network settings, Ethernetinterfaces, and other functions:– “accseccfg command” on page 30– “advfailover command” on page 40– “alertcfg command” on page 51– “alertentries command” on page 53– “autoftp command” on page 60– “baydata command” on page 63– “bofm command” on page 66– “bootmode command” on page 74– “bootseq command” on page 75– “buildidcfg command” on page 80– “cin command” on page 97– “cinstatus command” on page 102– “clock command” on page 106– “config command” on page 111– “dhcpinfo command” on page 117– “displaysd command” on page 124– “dns command” on page 126– “ethoverusb command” on page 137– “feature command” on page 144– “files command” on page 147– “groups command” on page 159– “health command” on page 163– “ifconfig command” on page 171– “info (configuration information) command” on page 203– “iocomp command” on page 206– “kvm (keyboard, video, mouse) command” on page 208– “ldapcfg command” on page 210– “mcad command” on page 227
Chapter 3. Command reference 27
– “modactlog command” on page 228– “monalerts command” on page 229– “mt (media tray) command” on page 239– “nat command” on page 241– “ntp (network time protocol) command” on page 245– “pmpolicy command” on page 251– “ping command” on page 248– “portcfg command” on page 253– “ports command” on page 255– “read command” on page 280– “rdoc command” on page 278– “remotechassis command” on page 283– “scale command” on page 291– “sddump command” on page 299– “security command” on page 303– “service command” on page 304– “slp command” on page 307– “chconfig command” on page 87– “chmanual command” on page 95– “smtp command” on page 309– “snmp command” on page 312– “sol (serial over LAN) command” on page 328– “sshcfg command” on page 335– “sslcfg command” on page 337– “tcpcmdmode command” on page 351– “telnetcfg (Telnet configuration) command” on page 354– “temps command” on page 355– “trespass command” on page 356– “uicfg command” on page 359– “uplink (management module failover) command” on page 373– “users command” on page 377– “volts command” on page 400– “zonecfg command” on page 403
v Discovery commands
Use these commands to locate other resources on the network:– “ping command” on page 248– “remotechassis command” on page 283
v Event log commands
Use these commands to view and clear primary management-module event logentries:– “clearlog command” on page 105– “displaylog command” on page 119– “eventinfo command” on page 138– “events command” on page 140– “modactlog command” on page 228– “chlog command” on page 93– “syslog command” on page 347
28 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
v LED commands
Use these commands to monitor and control operation of BladeCenter unitLEDs:– “identify (location LED) command” on page 169– “led command” on page 220
v Memory commands
Use these commands to reset the management-module configuration andperform firmware updates:– “clear command” on page 103– “update (update firmware) command” on page 363
v Power-control commands
Use these commands to control operation of the BladeCenter unit, blade servers,and I/O (switch) modules:– “boot command” on page 72– “power command” on page 272– “reset command” on page 286– “shutdown command” on page 306
v Power-management commands
Use these commands to monitor power consumption of the BladeCenter unitand installed components:– “fuelg command” on page 149– “pmpolicy command” on page 251– “volts command” on page 400
v Save and restore configuration commands
Use these commands to save and restore the management-module configuration:– “read command” on page 280– “write command” on page 401
v Session commands
Use these commands to start an SOL connection to the command console of aspecific blade server or to end a command console session:– “console command” on page 115– “exit command” on page 143
v Systems-management commands (BladeCenter T only)
Use these commands to manage alarms for monitored parameters of theBladeCenter T unit:– “alarm command (BladeCenter T and HT only)” on page 43
Command syntaxEach of the following topics describes a command-line interface command and itssyntax. Each command description also includes an example of command use.
Chapter 3. Command reference 29
accseccfg commandThis command displays and configures account security settings for the advancedmanagement module.
Table 3. accseccfg command
Function What it does Command Valid targets
Display account securitysettings
Displays the user account securitysettings for the advancedmanagement module. Returnedvalues:
v Default security settings used(legacy, high, or custom)
v -am: user authentication method(local, ldap, localldap, orldaplocal)
v -alt: authentication loggingtimeout (in seconds)
v -cp: complex password (on, off)
v -ct: CLI inactivity session timeout(in seconds)
v -dc: minimum differentcharacters in the password(when -cp is enabled)
v -de: default administrationpassword expiration (on, off)
v -ia: account inactivity alert timeperiod (in days)
v -ici: log new login events fromsame user (on, off)
v -id: account inactivity disabletime period (in days)
v -lf: maximum login failures
v -lp: lockout period aftermaximum login failures (inminutes)
v -mls: maximum simultaneoususer sessions
v -pc: password change on firstaccess (on, off)
v -pe: password expiration timeperiod (in days)
v -pi: minimum password changeinterval (in hours)
v -pr: password required (on, off)
v -rc: password reuse cycle
v -wt: web inactivity sessiontimeout (in minutes, none, orbased on length of user session)
accseccfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
30 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set account defaults tolegacy level
Sets management-module accountsecurity to a predefined legacy setof default values. Legacy defaultvalues:v -alt: retains set valuev -am: retains set valuev -cp: offv -ct: retains set valuev -dc: 0v -de: offv -ia: 0v -ici: retains set valuev -id: 0v -lf: 5v -lp: 2v -mls: retains set valuev -pc: offv -pe: 0v -pi: 0v -pr: offv -rc: 0v -wt: retains set value
Note:
v The user who is running theaccseccfg -legacy command musthave a password assigned.
v The -legacy option must be runalone and not in conjunctionwith any other accseccfgcommand options.
accseccfg -legacy
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 31
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set account defaults tohigh level
Sets management-module accountsecurity to a predefined high set ofdefault values. High default valuesare:v -am: retains set valuev -cp: onv -ct: retains set valuev -dc: 2v -de: onv -ia: 120v -id: 180v -lf: 5v -lp: 60v -pc: onv -pe: 90v -pi: 24v -pr: onv -rc: 5v -wt: retains set value
Note:
v The user who is running theaccseccfg -high command musthave a password assigned.
v The -high option must be runalone and not in conjunctionwith any other accseccfgcommand options.
accseccfg -high
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set authenticationlogging timeout
Sets a custom value for the amountof time that the managementmodule will not log repeated loginsby the same user.
accseccfg -alt timeout
where timeout is 0, 5, 30,60, 300, 600, 1800, 3600,43200, or 86400 seconds. Ifno value is entered, loginlogging is disabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
32 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set user authenticationmethod
Sets a custom value formanagement module userauthentication method.
accseccfg -am method
where method isv localv ldapv localldapv ldaplocal
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable complexpassword
Enables or disables the complexpassword for management-moduleuser authentication.Note: Enabling the complexpassword also turns on thepassword required (-pr) commandoption.
accseccfg -cp state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set CLI inactivitytimeout
Sets the custom value formanagement-module CLI inactivitysession timeout.
accseccfg -ct timeout
where timeout is from 0 to4,294,967,295 seconds,inclusive.
This command can onlybe run by users who havethe following commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 33
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set minimum number ofdifferent characters forpassword
Sets custom value for the minimumnumber of different characters to beused in a management-modulepassword.Note: The minimum number ofdifferent characters applies onlywhen complex passwords areenabled.
accseccfg -dc number
where number is from 0 to15, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable defaultadministration passwordexpiration
Enables or disables the defaultadministration password expirationfor the management module.
accseccfg -de state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set account inactivityalert time
Sets custom value for managementmodule account inactivity alerttime.Note: The accseccfg -ia value mustbe less than the accseccfg -id value.
accseccfg -ia time
where time is from 0 to365 days, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
34 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set state for logging oflogin events from sameIP address
Enables or disables logging of newlogin events from the same userfrom the same IP address.Note: This value applies only if thevalue set by the -alt commandoption is set to something otherthan 0 or none.
accseccfg -ici state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set account inactivitydisable time
Sets the custom value formanagement-module accountinactivity disable time.Note: The accseccfg -id value mustbe greater than the accseccfg -iavalue.
accseccfg -id time
where time is from 0 to365 days, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set maximum number oflogin failures
Sets the custom value for themaximum number of login failuresbefore the management modulelocks out a user.
accseccfg -lf number
where number is from 0 to10, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 35
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set lockout period Sets the custom value formanagement-module accountlockout period, used when themaximum number of login failuresis exceeded.
accseccfg -lp time
where time is from 0 to2880 minutes, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set maximum LDAPsessions for user
Sets the custom value for themaximum number of simultaneouslogin sessions allowed for a singleLDAP user
accseccfg -mlsmax_sessions
where max_sessions is from0 to 20, inclusive.
This command can onlybe run by users who havethe following commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablepassword change at firstlogin
Enables or disables the mandatorypassword change at firstmanagement-module login.
accseccfg -pc state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
36 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set password expirationtime
Sets custom value for themanagement module passwordexpiration time.
accseccfg -pe time
where time is from 0 to365 days, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set password minimumchange interval
Sets custom value for the minimumamount of time betweenmanagement module passwordchanges.
accseccfg -pi time
where time is from 0 to1440 hours, inclusive, andless than passwordexpiration period whenthat period is greater than0.
This command can onlybe run by users who havethe following commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablepassword required
Enables or disables the passwordrequired for management module.Notes:v The user that is running the
accseccfg -pr command musthave a password assigned.
v Disabling password required alsoturns off the complex password(-cp) command option.
accseccfg -pr state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 37
Table 3. accseccfg command (continued)
Function What it does Command Valid targets
Set password reuse cycle Sets custom value for themanagement module passwordreuse cycle. This setting determineshow many times a password mustbe changed before being reused.
accseccfg -rcnumber_reuses
where number_reuses isfrom 0 to 5, inclusive.
This command can onlybe run by users who havethe following commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set web interfaceinactivity timeout
Sets custom value for managementmodule web interface inactivitysession timeout.
accseccfg -wt timeout
where timeout is 1, 5, 10,15, or 20 minutes, none (notimeout), or user (userpicks timeout each timethey log in to the webinterface).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To set management-module account security to use the high level defaults, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeaccseccfg -high
To display the account security settings for the management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeaccseccfg
38 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following example shows the information that is returned from these twocommands:system:mm[1]> accseccfg -highOKsystem:mm[1]> accseccfg-high-alt 600-am local-cp on-ct 0-dc 2-de on-ia 120-ici on-id 180-lf 5-lp 60-mls 5-pc on-pe 90-pi 24-pr on-rc 5-wt usersystem:mm[1]>
Chapter 3. Command reference 39
advfailover commandThis command displays and configures the advanced failover settings for theadvanced management module.
Table 4. advfailover command
Function What it does Command Valid targets
Display managementmodule advancedfailover settings
Displays the advanced failoversettings for the managementmodule. Possible return values are:
v off - disable network interface forthe standby management module
v swap - enable the standbymanagement module networkinterface and swap IP addressesbetween the two managementmodules during failover
v noswap - enable the standbymanagement module networkinterface and do not swap IPaddresses between the twomanagement modules duringfailover
Note: This command does notapply to the BladeCenter S unit,which supports only a singleadvanced management module.
advfailover -T system:mm[x]
where x is the primarymanagement-modulebay number.
Disable networkinterface for standbymanagement module
Disables the network interface forthe standby management module,preventing failover.
advfailover -ip off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable network interfaceand allow IP addressswap during failover
Enables the network interface forthe standby management moduleand allows the IP addresses toswap between the twomanagement modules duringfailover.
advfailover -ip swap
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
40 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 4. advfailover command (continued)
Function What it does Command Valid targets
Enable network interfaceand prevent IP addressswap during failover
Enables the network interface forthe standby management moduleand prevents the IP addresses fromswapping between the twomanagement modules duringfailover.
advfailover -ip noswap
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To disable the network interface for the standby management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeadvfailover -ip off
To display the management module advanced failover setting, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typeadvfailover
The following example shows the information that is returned from these twocommands:system:mm[1]> advfailover -ip offOKsystem:mm[1]> advfailover-ip offsystem:mm[1]>
Chapter 3. Command reference 41
airfilter command (BladeCenter S only)This command sets the interval for air filter change notifications for a BladeCenterS unit.
Table 5. airfilter (set notification interval) command
Function What it does Command Valid targets
Display air filter changenotification interval
Displays the frequency of thechassis air filter reminder.
airfilter -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set air filter changenotification interval
Configures the frequency of thechassis air filter reminder.Note: The 1 month replacementinterval is recommended forenvironments with a high amountof dust. Replacement every 3months is recommended forenvironments with mediumamounts of dust. Replacementevery 6 months is recommendedfor environments with lowamounts of dust.
airfilter -freq frequency
where frequency is theinterval, in months,between reminders tochange the chassis airfilter. Valid values are 0, 1,3, and 6.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the current notification interval, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typeairfilter
To set the notification interval to three months, while management module 1 is setas the persistent command environment, at the system:mm[1]> prompt, typeairfilter -freq 3
The following example shows the information that is returned when thesecommands are entered:system:mm[1]> airfilter-freq 1system:mm[1]>
system:mm[1]> airfilter -freq 3OKsystem:mm[1]>
42 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
alarm command (BladeCenter T and HT only)This command displays alarm information, acknowledges alarms, and clearsalarms for the specified command target.
Table 6. alarm command
Function What it does Command Valid targets
Display all alarms Display all alerts generated by thetarget component. When directedto the BladeCenter unit, thecommand returns a summary ofalarms for all BladeCentercomponents. When directed to acomponent installed in theBladeCenter unit, the commandreturns a detailed alarm listing forthat component.
Detailed alarm listings include analarm key that can be used toacknowledge or clear an alarm.
alarm -q -T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Display power alarms Display all power related alertsgenerated by the target component.When directed to the BladeCenterunit, the command returns asummary of alarms for allBladeCenter components. Whendirected to a component installedin the BladeCenter unit, thecommand returns a detailed alarmlisting for that component.
Detailed alarm listings include analarm key that can be used toacknowledge or clear an alarm.Note: The -p option can becombined with the -q option toquery power related alarms.
alarm -p -T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Display alarminformation (specifiedby alarm generator ID)
Display information for alarmspecified by the generator ID.
alarm -q -g value
where value is thegenerator ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Chapter 3. Command reference 43
Table 6. alarm command (continued)
Function What it does Command Valid targets
Display alarminformation (specifiedby alarm ID)
Display information for alarmspecified by the alarm ID.
alarm -q -a value
where value is the alarmID.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Display detailed alarminformation (specifiedby generatorinformation)
Display detailed information foralarm specified by the alarmgenerator information. Informationreturned includes the alarmdescription that is shown by themanagement-module web interfaceand other information such as thealarm severity, power source,software indicator, and an alarmkey.
alarm -q -o value
where value is thegenerator information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Display alarminformation (specifiedby complete alarm key)
Display information for alarmspecified by the complete alarmkey.
alarm -q -k m:g:o:a
where m:g:o:a is thecomplete alarm key:v m is the module IDv g is the generator IDv o is the generator
informationv a is the alarm ID
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
44 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 6. alarm command (continued)
Function What it does Command Valid targets
Acknowledge alarm(specified by alarmgenerator ID)
Acknowledge the alarm specifiedby the generator ID.
alarm -r -g value
where value is thegenerator ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Acknowledge alarm(specified by generatorinformation)
Acknowledge the alarm specifiedby the generator information.
alarm -r -o value
where value is thegenerator information.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Chapter 3. Command reference 45
Table 6. alarm command (continued)
Function What it does Command Valid targets
Acknowledge alarm(specified by alarm ID)
Acknowledge the alarm specifiedby the alarm ID.
alarm -r -a value
where value is the alarmID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Acknowledge alarm(specified by completealarm key)
Acknowledge the alarm specifiedby the complete alarm key.
alarm -r -k m:g:o:a
where m:g:o:a is thecomplete alarm key:v m is the module IDv g is the generator IDv o is the generator
informationv a is the alarm ID
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
46 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 6. alarm command (continued)
Function What it does Command Valid targets
Clear alarm (specifiedby alarm generator ID)
Clear the alarm specified by thegenerator ID.
alarm -c -g value
where value is thegenerator ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Clear alarm (specifiedby generatorinformation)
Clear the alarm specified by thegenerator information.
alarm -c -o value
where value is thegenerator information.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Chapter 3. Command reference 47
Table 6. alarm command (continued)
Function What it does Command Valid targets
Clear alarm (specifiedby alarm ID)
Clear the alarm specified by thealarm ID.
alarm -c -a value
where value is the alarmID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Clear alarm (specifiedby complete alarm key)
Clear the alarm specified by thecomplete alarm key.
alarm -c -k m:g:o:a
where m:g:o:a is thecomplete alarm key:v m is the module IDv g is the generator IDv o is the generator
informationv a is the alarm ID
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
48 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 6. alarm command (continued)
Function What it does Command Valid targets
Set alarm Set an alarm for the specifiedtarget, including severity level anddescription.
alarm -s -l level desc
wherev level is the severity
level:– CRT (critical)– MJR (major)– MNR (minor)
v desc is a short textdescription of the alarm
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule, power module,or blower)
v Blade configuration (forblade server)
v I/O moduleconfiguration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Example: To display the alarm status for the BladeCenter T unit, while theBladeCenter T unit is set as the persistent command environment, at the system>prompt, typealarm -q
To display the power alarm status for the BladeCenter T unit, while theBladeCenter T unit is set as the persistent command environment, at the system>prompt, typealarm -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 thesystem> prompt, typealarm -T system:power[2] -q
Chapter 3. Command reference 49
The following example shows the information that is returned from a series ofalarm commands.system> alarm -qAlarms Summary ListModule ACK Severity Power Software=========== === ======== ===== ========mm[1] No Major No Nopower[2] No Critical Yes No
system> alarm -q -pAlarms Summary ListModule ACK Severity Power Software=========== === ======== ===== ========power[2] No Critical Yes No
system> alarm -q -T mm[1]Alarms Detailed ListACK Severity PWR SW Descript Key=== ======= === === ============================================== ============No Major No No (05/21/08, 13:46:11) Insufficient chassis power 255:81:1:2:3No Minor No No (05/21/08, 13:45:26) Event log full 255:81:1:1:1
system>
50 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
alertcfg commandThis command displays and configures the global remote alert settings for theadvanced management module.
Table 7. alertcfg command
Function What it does Command Valid targets
Display global remotealert settings
Displays the global remote alertsettings for the advancedmanagement module.
alertcfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set remote alert retrydelay interval andnumber of retries
Sets the remote alert retry delayinterval and permitted number ofretries.
alertcfg -dr delay -rllimit
where:
v delay is from 0.5minutes to 4.0 minutes,inclusive, in 0.5 minuteincrements. If you entera value less than 0.5minute, the retryinterval will be set to0.5 minute. If you entera value greater than 4.0minutes, the retryinterval will be set to4.0 minutes.
v limit is the remote alertretry limit, ranging from0 to 8.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Include / exclude serviceinformation with emailalerts
Enables or disables inclusion ofservice information with emailalerts.
alertcfg -si state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 51
Table 7. alertcfg command (continued)
Function What it does Command Valid targets
Set remote alert retrylimit
Sets the maximum number of timesthe system will attempt to send aremote alert, if previous attemptswere unsuccessful.
alertcfg -rl value
where value is from 0 to 8,inclusive. If you enter avalue of 0, no retries willbe attempted. If you entera value greater than 8, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the remote alert configuration, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typealertcfg
To set the retry interval to 3.5 minutes, include service information in the alert, andset the remote alert retry limit to 7, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typealertcfg -dr 3.5 -si enabled -rl 7
The following example shows the information that is returned from thesecommands:system:mm[1]> alertcfg-dr 2.0-si disabled-rl 6system:mm[1]> alertcfg -dr 3.5 -si enabled -rl 7OKsystem:mm[1]> alertcfg-dr 3.5-si enabled-rl 7system:mm[1]>
52 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
alertentries commandThis command manages the recipients of alerts generated by the primarymanagement module.
Table 8. alertentries command
Function What it does Command Valid targets
Display alert propertiesfor all recipients
Displays alert properties for allmanagement-module alertrecipients. Returned values for eachalert recipient are:
v recipient name
v notification method (Email overLAN/Systems Directorcomp./SNMP over LAN)
v type of alerts received (Receivescritical alerts only/Receives allalerts/Disabled)
alertentries -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display alert propertiesfor alert recipients
Displays alert properties for thespecified management-module alertrecipient profile. Returned valuesare:
v -status alert_recipient_status(on/off)
v -n alert_recipient_name
v -f alert_type (critical/none)
v -t notification_method(email/director/snmp)
v -e email_address (used for emailnotifications)
v -i static_IP_addr/hostname (usedfor IBM Systems Directornotifications)
alertentries-recip_number
where recip_number is anumber from 1 to 12 thatcorresponds to therecipient number assignedin the "Display alertproperties for allrecipients" list.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Delete alert recipient Delete the specified alert recipient. alertentries-recip_number -del
where recip_number is anumber from 1 to 12 thatcorresponds to therecipient number assignedin the "Display alertproperties for allrecipients" list. It ispossible to delete anempty alert recipient.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 53
Table 8. alertentries command (continued)
Function What it does Command Valid targets
Create alert recipient Create the specified alert recipient.
All fields must be specified whencreating an alert recipient.
alertentries-recip_number -nrecip_name -statusalert_status -f filter_type -tnotification_method -eemail_addr -iip_addr/hostname
where:v recip_number is a
number from 1 to 12that corresponds to anunused recipientnumber in the "Displayalert properties for allrecipients" list.
v recip_name is aalphanumeric string upto 31 characters inlength containing anycharacter, includingspaces, except for anglebrackets ( < and > ). Ifthe string includesspaces it must beenclosed indouble-quotes.
v alert_status is on or offfor receipt of alerts.
v filter_type filters the alerttypes received: critical(receive critical alertsonly) or none (receiveall alerts).
v notification_method isemail, director (IBMSystems Director) orsnmp.– For email, you must
specify an emailaddress (-eargument).
– For director youmust specify an IPaddress (-iargument).
– If snmp is selected,the -e and -iarguments are notneeded.
v email_addr is a validemail address string upto 63 characters inlength.
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
54 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 8. alertentries command (continued)
Function What it does Command Valid targets
Create alert recipient
(continued)
v ip_addr/hostname is avalid static IP addressor an alphanumerichostname string for therecipient that is up to 49characters in length thatcan include periods ( . ),hyphens ( - ), andunderscores ( _ ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
Set alert recipient name Sets a name for the specified alertrecipient.
alertentries-recip_number -n recip_name
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v recip_name is aalphanumeric string upto 31 characters inlength that can includeany character, includingspaces, except for anglebrackets ( < and > ). Ifthe name includesspaces, it must beenclosed indouble-quotes.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 55
Table 8. alertentries command (continued)
Function What it does Command Valid targets
Set alert recipient status Sets status for the specified alertrecipient. The status determines if arecipient will receive alarmnotifications.
alertentries-recip_number -statusalert_status
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v alert_status is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set alert types received Filters the types of alert that arereceived by the specified alertrecipient.
alertentries-recip_number -f filter_type
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v alert_type filters the alerttypes received: critical(receive critical alertsonly) or none (receiveall alerts).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
56 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 8. alertentries command (continued)
Function What it does Command Valid targets
Set alert notificationmethod
Sets the alert notification methodfor the specified alert recipient.
alertentries-recip_number -tnotification_method
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v notification_method is– email– director (IBM
Systems Director)– snmp
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set alert recipient emailaddress
Sets the email address for thespecified alert recipient. This emailaddress is used to send alerts to therecipient via email.
The email address can be set onlyif the alert notification method (-toption) is set to email. The -t and -eoptions can be combined within thesame command.
alertentries-recip_number -eemail_addr
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v email_addr is a validemail address string upto 63 characters inlength.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 57
Table 8. alertentries command (continued)
Function What it does Command Valid targets
Set alert recipient IPaddress or hostname
Sets the IP address or hostnameused to send alert notifications tothe specified alert recipient usingIBM Systems Director.
The IP address or hostname usedto send alert notifications can be setonly if the alert notification method(-t option) is set to director (IBMSystems Director). The -t and -ioptions can be combined within thesame command.
alertentries-recip_number -iip_addr/hostname
where:v recip_number is a
number from 1 to 12that corresponds to therecipient numberassigned in the "Displayalert properties for allrecipients" list.
v ip_addr/hostname is avalid static IP addressor an alphanumerichostname string up to49 characters in lengththat can include periods( . ), hyphens ( - ), andunderscores ( _ ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Generate test alert Generates a test alert to verifycorrect alert response.Notes:v The alertentries -test
command option must be usedalone.
v If autoftp is enabled, sending atest alert will cause the system tosend out service data as well.
alertentries -test
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
58 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To view the configuration for alert recipient 1, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typealertentries -1
To configure alert recipient 2 to receive only critical alert notifications by email,while management module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typealertentries -2 -n test2 -status on -f critical -t email -e [email protected]
To configure alert recipient 3 to receive all alert notifications through IBM SystemsDirector, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typealertentries -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, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typealertentries -4 -n test4 -status on -f none -t snmp
The following example shows the information that is returned from thesecommands:system:mm[1]> alertentries -1-status on-n test1-f critical-t email-e [email protected]:mm[1]> alertentries -2 -n test2 -status on -f critical -t email-e [email protected]:mm[1]> alertentries -3 -n test3 -status on -f none -t director-i 192.168.70.140OKsystem:mm[1]> alertentries -4 -n test4 -status on -f none -t snmpOKsystem:mm[1]>
Chapter 3. Command reference 59
autoftp commandThis command displays and configures the automated FTP/TFTP problem reportsettings for the advanced management module.
Table 9. autoftp command
Function What it does Command Valid targets
Display call-homesettings for autoftp callhome
Displays the Automated FTP/TFTPProblem Report settings that allowthe advanced management moduleto automatically put service dataonto a specified server when a callhome event is detected.
autoftp -T system:mm[x]
where x is the primarymanagement-modulebay number.
60 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 9. autoftp command (continued)
Function What it does Command Valid targets
Configure call-homesettings for autoftp callhome
Configures the AutomatedFTP/TFTP Problem Report settingsthat allow the advancedmanagement module toautomatically put service data ontoa specified server when a call homeevent is detected.Note: The system will wait fivedays before sending duplicateevents if they are leftunacknowledged in the activity log.
autoftp -m mode -iip_address -p port -u“user_name” -pw“password”
where:v mode is one of the
following automatedproblem reportingmodes:– ftp– tftp– disabled
v ip_address is the IPaddress of the FTP orTFTP server
v port is the FTP or TFTPtransmission port, anumber from 1 to 65535,inclusive. If you enter avalue outside this range,an error message will bedisplayed.
v “user_name” is thequote-delimited FTPUser Name forautomated problemreporting (63 charactersmaximum).
v “password” is thequote-delimited FTPpassword for automatedproblem reporting (63characters maximum).
Notes:v For FTP, all fields must
be set.v For TFTP, only -i and -p
are needed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 61
Example:
To view the settings of the automated call-home message feature, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeautoftp
To configure the automated call-home message feature to report call-home eventsusing TFTP to tftp.ibm.com over transmission port 69, while management module1 is set as the persistent command environment, at the system:mm[1]> prompt, typeautoftp -m tftp -i tftp.ibm.com -p 69
The following example shows the information that is returned from thesecommands:system:mm[1]> autoftp-m ftp-i ftp.ibm.com-p 6-u smlitesystem:mm[1]> autoftp -m tftp -i tftp.ibm.com -p 69OKsystem:mm[1]>
62 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
baydata commandThis command allows a user to set, assign, and display informational dataassigned to the blade server bays.
Table 10. baydata command
Function What it does Command Valid targets
Display bay data for allblade servers
Displays blade server bay data forbay number, bay data status, anddefined bay data for all bays.
baydata -T system
Display blade server baydata for a specific bay
Displays the information assignedto the specified blade bay using the-b option.
baydata -b bay_num
where bay_num is thenumber of the specific bayto display. The baynumber must be withinthe scope assigned to theuser.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Clear bay data Clears the blade bay definitionstrings for all bays.
baydata -clear
The bay number must bewithin the scope assignedto the user.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 63
Table 10. baydata command (continued)
Function What it does Command Valid targets
Clear bay data forspecific bay
Clears the blade bay definitionstrings for the specified blade bay.
baydata -b bay_num-clear
where bay_num is thenumber of the specifiedbay to clear of data. Thebay number must bewithin the scope of theuser.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Set bay data Sets blade bay data for all bladeservers within the user's scope.This information can include: dataabout drivers or software, theBladeCenter unit shelf number andIP address, and whether the bladeserver is a master or member in ahigh-availability system.
Note: To apply changes to theBIOS/SMBIOS structure, power-offand power-on the blade server,restart the blade server, or removeand reinstall the blade server.
baydata -data"data_definition"
where "data definition" isthe ASCII string of up to60 characters enclosed indouble quotationmarks–"data definition".The quotation marks arenot stored.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
64 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 10. baydata command (continued)
Function What it does Command Valid targets
Set blade bay datadefinition for specificblade server
Sets blade bay data for thespecified blade server using the -boption.
Note: To apply changes to theBIOS/SMBIOS structure, power-offand power-on the blade server,restart the blade server, or removeand reinstall the blade server.
If the command is issued to aspecific bay, data is written to thatblade server if it is in the user'sscope.
baydata -b bay_num -data"data_definition"
where:v bay_num is the blade
bayv where "data definition" is
the quote-delimitedASCII string of up to 60characters
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example: To view the bay data for all blades, while the management module is setas the persistend command environment, at the system> prompt, typebaydata
The following example shows the information that is returned from this command:system> baydataBay Status Definition1 Unsupported2 No blade present3 No blade present4 No blade present5 No blade present6 No blade present7 No blade present8 No blade present9 No blade present10 No blade present11 No blade present12 No blade present13 No blade present14 No blade presentsystem>
Chapter 3. Command reference 65
bofm commandThis command applies a new BladeCenter Open Fabric Manager (BOFM)configuration to all the specified BladeCenter units, bays, and ports.
Notes:
1. Open Fabric Manager is not a standard management module feature; it isoffered and documented separately. See the BladeCenter Open Fabric ManagerInstallation and Users Guide for more detailed information.
2. If the number of advanced management module TCP command modeconnections is zero, or if all available TCP command mode connections are inuse, a connection failure message is generated by the BOFM feature. Make surethat the advanced management module TCP command mode connection limitis positive and that no more than the available number of connections are inuse. See the BladeCenter Open Fabric Manager Installation and Users Guide foradditional information.
Table 11. bofm command
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays, and ports
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules.
The configuration file is acomma-separated values (CSV) filethat assigns IP addresses and othervalues to BladeCenter units, bays,and ports.
bofm -l filename -iip_address
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
66 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 11. bofm command (continued)
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays and portswhile ignoring duplicatelines in theconfiguration file
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules,even if it encounters duplicatelines in the configuration file.
The configuration file is acomma-separated values (CSV) filethat assigns IP addresses and othervalues to BladeCenter units, bays,and ports.
bofm -l filename -iip_address -d off
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v The -d off optioncauses bofm to ignoreduplicate lines in theconfiguration file.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 67
Table 11. bofm command (continued)
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays, and portsunless there areduplicate lines in theconfiguration file
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules,but halts the operation if itencounters duplicate lines in theconfiguration file.
The configuration file is acomma-separated values (CSV) filethat assigns IP addresses and othervalues to BladeCenter units, bays,and ports.
bofm -l filename -iip_address -d on
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v The -d on option haltsbofm if there areduplicate lines in theconfiguration file.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
68 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 11. bofm command (continued)
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays, and portseven if the bays arepowered on
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules,after checking to make sure thatthe bays are not powered on.
The configuration file is acomma-separated values (CSV) filethat assigns IP addresses and othervalues to BladeCenter units, bays,and ports.
bofm -l filename -iip_address -p on
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v The -p on option haltsthe bofm command ifbays are powered on.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 69
Table 11. bofm command (continued)
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays, and portsunless bays are poweredon
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules,without checking if the bays arepowered on.
The configuration file is acomma-separated values (CSV) filethat assigns IP addresses and othervalues to BladeCenter units, bays,and ports.Note: Do not change the BOFMconfiguration while a blade serveris powered on.
bofm -l filename -iip_address -p off
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v The -p off option forcesBOFM to apply theconfiguration file toblade servers that arepowered on.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
70 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 11. bofm command (continued)
Function What it does Command Valid targets
Apply BOFMconfiguration tospecified BladeCenterunits, bays, and ports(verbose)
Copies a configuration file from aTFTP server to the specifiedmanagement module, which thenconfigures BladeCenter units,blade servers, and I/O modules, aprocess which might take severalminutes. The detailed informationis shown after the update iscomplete.
bofm -l filename -iip_address -v
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
Note: Both the -l filenameoption and the -iip_address option need tobe specified.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To apply a new BOFM configuration file to a set of BladeCenter units and viewdetails of the procedure, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typebofm -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 -vTFTP file upload successful.Starting to apply new BOFM configuration on MMPercent complete: 100%Status: Confirmed configuration change.Percent complete: 100%Status: Configuration applied.Applying new BOFM configuration on MM - Completed.system:mm[1]>
Chapter 3. Command reference 71
boot commandThis command resets blade servers with several different restart options.
Table 12. boot command
Function What it does Command Valid targets
Reset blade server Performs an immediate reset andrestart of the specified blade server.
This command will start a bladeserver that is turned off.
boot
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Reset blade server tocommand console
Resets the specified blade server,causing it to open a commandconsole with an SOL session whenit restarts.
This command will start a bladeserver that is turned off.
boot -c
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Power cycle Cycles power for the specifiedblade server. If the blade server isoff, it will turn on. If the bladeserver is on, it will turn off andthen turn on.
boot -p powercycle
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Reset blade server Performs an immediate reset andrestart of the specified blade server.
This command will start a bladeserver that is turned off.
boot -p reset
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
72 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To boot the blade server in blade bay 3, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typeboot -T system:blade[3]
The following example shows the information that is returned:system:mm[1]> boot -T system:blade[3]OKsystem:mm[1]>
Chapter 3. Command reference 73
bootmode commandThis command sets and displays the boot mode settings for blade servers installedin the BladeCenter unit that support this feature.
Table 13. bootmode command
Function What it does Command Valid targets
Display blade serverboot mode
Displays the boot mode settings ofthe specified blade server.Note: This command will executeonly on blade servers that supportthe bootmode feature.
bootmode -T system:blade[x]
where x is the bladeserver bay number.
Set blade server bootmode
Sets the copy of firmware that thespecified blade server will use toboot:v Temporary: booting from the
temporary copy is recommendedsince it typically contains thelatest enhancements and fixes.
v Permanent: booting from thepermanent copy should be usedonly when booting from thetemporary copy is no longerpossible.
Changes to the boot mode settingtake effect after the next restart ofthe blade server.Note: This command will executeonly on blade servers that supportthe bootmode feature.
bootmode -p mode
where mode is:v temp for temporary
firmware copy.v perm for permanent
firmware copy.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Example: To view the boot mode of the blade server in bay 2, while this bladeserver is set as the persistent command environment, at the system:blade[2]>prompt, typebootmode
To set the boot mode of the blade server in bay 2 to permanent, while this bladeserver is set as the persistent command environment, at the system:blade[2]>prompt, typebootmode -p perm
The following example shows the information that is returned from thesecommands:system:blade[2]> bootmodeactive: temporarypending: Invalid boot mode typesystem:blade[2]> bootmode -p permSet the blade boot mode to permanent succeeded.The setting will become active after the next reboot of the blade.system:blade[2]> bootmodeactive: temporarypending: permanentsystem:blade[2]>
74 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
bootseq commandThis command sets and displays the boot sequence settings for blade serversinstalled in the BladeCenter unit.
Table 14. bootseq command
Function What it does Command Valid targets
Display blade serverboot sequence
Displays the boot sequence of thespecified blade server. Possiblereturn values are:v floppy (diskette drive)v usbdisk (USB device)v iscsi (iSCSI)v iscsicrt (iSCSI critical)v nw (network)v nodev (no device)v hd0 (hard disk drive 0)v hd1 (hard disk drive 1)v hd2 (hard disk drive 2v hd3 (hard disk drive 3)v hd4 (hard disk drive 4)v cd (CD-ROM drive)v usb (media tray)v hyper (hypervisor)v uefi (unified extensible firmware
interface)v legacy (UEFI-specified legacy
sequence)
bootseq -T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 75
Table 14. bootseq command (continued)
Function What it does Command Valid targets
Set boot sequence forblade server
Sets the boot sequence of thespecified blade server.
bootseq devicelist
where devicelist has one ormore of the following bootdevices specified, in orderof preference:v floppy for the diskette
drive(non-POWER-basedblade servers only)
v usbdisk for a USBdevice (not supportedby all blade servers)
v iscsi for iSCSIv iscsicrt for iSCSI
criticalv nw for network - PXEv nodev for no devicev hd0 for hard disk drive
0v hd1 for hard disk drive
1v hd2 for hard disk drive
2v hd3 for hard disk drive
3v hd4 for hard disk drive
4v cd for the CD-ROM
drivev usb for the media tray
(non-POWER-basedblade servers installedin BladeCenter T unitsonly)
v hyper for hypervisor(only for blade serversthat use hypervisorvirtualization)
v uefi for unifiedextensible firmwareinterface (UEFI) (onlyfor blade servers thatsupport this feature)
v legacy for theUEFI-specified legacyboot sequence (only forblade servers thatsupport this feature)
(continued on next page)
-T system:blade[x]
where x is the bladeserver bay number.
76 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 14. bootseq command (continued)
Function What it does Command Valid targets
Set boot sequence forblade server
(continued)
A boot sequence of up tofour boot devices can bespecified. If fewer thanfour devices are specified,the remaining items in thesequence are set to nodev.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
Chapter 3. Command reference 77
Table 14. bootseq command (continued)
Function What it does Command Valid targets
Set boot sequence for allblade servers
Sets the same boot sequence for allblade servers installed in theBladeCenter unit.
bootseq -all devicelist
where devicelist has one ormore of the following bootdevices specified, in orderof preference:v floppy for the diskette
drive(non-POWER-basedblade servers only)
v usbdisk for a USBdevice (not supportedby all blade servers)
v iscsi for iSCSIv iscsicrt for iSCSI
criticalv nw for network - PXEv nodev for no devicev hd0 for hard disk drive
0v hd1 for hard disk drive
1v hd2 for hard disk drive
2v hd3 for hard disk drive
3v hd4 for hard disk drive
4v cd for the CD-ROM
drivev usb for the media tray
(non-POWER-basedblade servers installedin BladeCenter T unitsonly)
v hyper for hypervisor(only for blade serversthat use hypervisorvirtualization)
v uefi for unifiedextensible firmwareinterface (only for bladeservers that support thisfeature)
(continued on next page)
-T system:blade[x]
where x is the bladeserver bay number.
78 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 14. bootseq command (continued)
Function What it does Command Valid targets
Set boot sequence for allblade servers
(continued)
v legacy for theUEFI-specified legacyboot sequence (only forblade servers thatsupport this feature)
A boot sequence of up tofour boot devices can bespecified. If fewer thanfour devices are specified,the remaining items in thesequence are set to nodev.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
Example: To set a boot sequence of diskette drive, CD-ROM drive, and hard diskdrive 0 for the blade server in blade bay 3, while the blade server in blade bay 3 isset as the persistent command environment, at the system:blade[3]> prompt, typebootseq floppy cd hd0
To display the boot sequence for the blade server in blade bay 3, while the bladeserver in blade bay 3 is set as the persistent command environment, at thesystem:blade[3]> prompt, typebootseq
The following example shows the information that is returned from these twocommands:system:blade[3]> bootseq floppy cd hd0OKsystem:blade[3]> bootseqfloppycdhd0nodevsystem:blade[3]>
Chapter 3. Command reference 79
buildidcfg commandThis command creates, displays, and configures the list of firmware build IDs forthe blade servers.
Table 15. buildidcfg command
Function What it does Command Valid targets
Display blade serverfirmware build IDs
Displays list of blade serverfirmware build IDs.Note: The build ID list must bebuilt using the -create commandoption before it can be displayed.
buildidcfg -T system
Create blade serverbuild ID list
Creates an initial firmware build IDlist for all blade servers installed inthe BladeCenter unit.Note: The build ID list containsinformation for only those bladeservers that have VPD which isfully accessible by the advancedmanagement module. Any bladeservers with VPD that isunavailable or failed will beignored and not appear in the list..
buildidcfg -create
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
80 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Add blade server buildID list entry
Adds a new blade server firmwarebuild ID entry to the list.Note: All options must be specifiedwhen adding a new firmware buildID entry. The arguments formanufacturer, machine type,firmware type, and build ID cannotbe blank or unspecified; however,the argument for build revision canbe blank or not set.
buildidcfg -ab -mfgmanufacturer -mtmachine_type -ft type -idbuild_id -rev build_rev
where:v manufacturer is a
manufacturer name, upto 31 characters inlength, enclosed inquotation marks. Themanufacturer name cancontain spaces, but noleading or trailingspaces are allowed.
v machine_type is amachine type, up to 31characters in length,enclosed in quotationmarks. The machinetype can contain spaces,but no leading ortrailing spaces areallowed.
v firmware_type is bios,diags, or bmc.
v build_id is a firmwarebuild ID, up to 31characters in length,enclosed in quotationmarks. The firmwarebuild ID can containspaces, but no leadingor trailing spaces areallowed.
v build_rev is a firmwarebuild revision, up to 31characters in length,enclosed in quotationmarks. The firmwarebuild revision cancontain spaces, but noleading or trailingspaces are allowed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 81
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Update blade serverbuild ID list entry -manufacturer
Update the manufacturer for thespecified blade server firmwarebuild ID entry.Note:v The index number for each entry
in the list is found by runningthe buildidcfg command withno options.
v The argument for manufacturercannot be blank or unspecified.
buildidcfg -ub index-mfg manufacturer
where:v index is the index of the
build ID list entry.v manufacturer is a
manufacturer name, upto 31 characters inlength, enclosed inquotation marks. Themanufacturer name cancontain spaces, but noleading or trailingspaces are allowed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Update blade serverbuild ID list entry -machine type
Update the machine type for thespecified blade server firmwarebuild ID entry.Note:v The index number for each entry
in the list is found by runningthe buildidcfg command withno options.
v The argument for machine typecannot be blank or unspecified.
buildidcfg -ub index -mtmachine_type
where:v index is the index of the
build ID list entry.v machine_type is a
machine type, up to 31characters in length,enclosed in quotationmarks. The machinetype can contain spaces,but no leading ortrailing spaces areallowed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
82 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Update blade serverbuild ID list entry -firmware type
Update the firmware type for thespecified blade server firmwarebuild ID entry.Note:v The index number for each entry
in the list is found by runningthe buildidcfg command withno options.
v The argument for firmware typecannot be blank or unspecified.
buildidcfg -ub index -ftfirmware_type
where:v index is the index of the
build ID list entry.v firmware_type is bios,
diags, or bmc.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Update blade serverbuild ID list entry -firmware build ID
Update the firmware build ID forthe specified blade server firmwarebuild ID entry.Note:v The index number for each entry
in the list is found by runningthe buildidcfg command withno options.
v The argument for build IDcannot be blank or unspecified.
buildidcfg -ub index -idbuild_id
where:v index is the index of the
build ID list entry.v build_id is a firmware
build ID, up to 31characters in length,enclosed in quotationmarks. The firmwarebuild ID can containspaces, but no leadingor trailing spaces areallowed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 83
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Update blade serverbuild ID list entry -firmware build revision
Update the firmware build revisionfor the specified blade serverfirmware build ID entry.Note:v The index number for each entry
in the list is found by runningthe buildidcfg command withno options.
v The argument for the buildrevision can be blank or not set.
buildidcfg -ub index-rev build_rev
where:v index is the index of the
build ID list entry.v build_rev is a firmware
build revision, up to 31characters in length,enclosed in quotationmarks. The firmwarebuild revision cancontain spaces, but noleading or trailingspaces are allowed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Delete all entries fromblade server build IDlist
Delete all blade server firmwarebuild ID entries from the list.
buildidcfg -db all
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
84 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Delete entry from bladeserver build ID list
Delete a specific blade serverfirmware build ID entry from thelist.Note: The index number for eachentry in the list is found byrunning the buildidcfg commandwith no options.
buildidcfg -db index
where index is the indexnumber of a specific buildID list entry to delete.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Import blade serverbuild ID list
Import a firmware build ID listfrom file.
The file name to import mustspecify a qualified location for thebuild ID list image that indicatesthe protocol to be used. Forexample, tftp://192.168.0.1/tmp/buildid.txt.
buildidcfg -importfilename
where filename is aqualified location of up to256 characters in lengththat indicates the protocolto be used (tftp, ftp, ftps,http, or https) andcontains any characterexcept the percent sign (% ) or double-quote ( " ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 85
Table 15. buildidcfg command (continued)
Function What it does Command Valid targets
Export blade serverbuild ID list
Export the current build ID list to aspecified TFTP server.
The build ID list to export mustspecify a qualified location,including an IP address for thebuild ID list image. For example,tftp://192.168.0.1/tmp/buildid.txt.
buildidcfg -exportip_address
where ip_address is aqualified location of up to256 characters in lengththat indicates the TFTPprotocol and a valid filename. It can contain anycharacter except thepercent sign ( % ) ordouble-quote ( " ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administrationv Blade configurationv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example: To create the initial build ID list, while the BladeCenter unit is set as thepersistent command environment, at the system> prompt, typebuildidcfg -create
To view the build ID list, while the BladeCenter unitis set as the persistentcommand environment, at the system> prompt, typebuildidcfg
The following example shows the information that is returned from thesecommands:system> buildidcfg -createOKsystem> buildidcfgIndex Manufacture Machine Type Firmware Type Build ID Revision1 IBM 8853 Blade Sys Mgmt Processor BCBT58A 1.18
2 IBM 8853 Diagnostics BCYT28AUS 1.06
3 IBM 8853 FW/BIOS BCE141AUS 1.17
4 IBM 7971 Blade Sys Mgmt Processor BABT55A 1.32
5 IBM 7971 Diagnostics BAYT37AUS 1.06
6 IBM 7971 FW/BIOS BAE155AUS 1.10
system>
86 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
chconfig commandThis command configures the BladeCenter unit Service Advisor feature.
Table 16. chconfig command
Function What it does Command Valid targets
Display Service Advisorconfiguration
Displays the contact informationfor the Service Advisor feature.Service Advisor resides on youradvanced management module andmonitors your BladeCenter unit forhardware events. Upon detecting ahardware event, Service Advisorcaptures the event, error logs, andservice data, and can automaticallyreport the event to IBM support. Tosend call home event to IBMsupport, you must enable andconfigure Service Advisor. For eachcall home event IBM receives, aservice ticket will opened, and afollow-up call will be made. Thisfeature will generate a message toIBM when events occur in theBladeCenter unit or one of itscomponents that usually can beresolved without additionalproblem determination.Note: The system will wait fivedays before sending duplicateevents if they are leftunacknowledged in the activity log.
chconfig -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display / accept ServiceAdvisor terms andconditions
Displays or accepts the terms of theService Advisor terms andconditions.
chconfig -li license
where license is
v view to view the ServiceAdvisor terms andconditions.
v accept to accept theService Advisor termsand conditions.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 87
Table 16. chconfig command (continued)
Function What it does Command Valid targets
Enable / disable ServiceAdvisor terms andconditions
Enables or disables the call-hometerms and conditions.Notes:v All contact information fields are
required before the ServiceAdvisor can be enabled.
v Call Home will connect to IBMthrough HTTPS and HTTP.HTTP Proxy fields must be set topermit for outbound traffic.
v Service Advisor also needs to setup DNS server address on theadvanced management module.
v Changing the Service Advisorsetting from disabled to enabledwill automatically trigger a testcall home and the ServiceAdvisor Activity Log will recordthis test call home.
chconfig -sa setting -scsupport_center
wherev setting is
– enable to activate theService Advisorterms and conditions.
– disable to suspendthe Service Advisorterms and conditions.
v support_center is the2–character ISO 3166country code of the IBMsupport center location.For example, thecountry code for theUnited States is US.
Notes:v Go to
http://www.iso.org/iso/country_codes/iso_3166_code_lists/ fora complete list ofcountry codes.
v Valid country codesmust refer to countriesthat have IBM supportcenters.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
88 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 16. chconfig command (continued)
Function What it does Command Valid targets
Set contact informationfor Service Advisor
Sets contact information for theService Advisor.
chconfig -co "company"-cn "name" -cph "phone"-ce email -ca "address"-cci "city" -cs state -scsupport_center -cz"postalcode"
where:v "company" is the
quote-delimited contactcompany name, of up to30 characters in length.
v "name" is thequote-delimited contactname, of 1 to 30characters in length.
v "phone" is thequote-delimited contactphone number, of 5 to30 characters in length.
v email is email address ofthe contact person inthe formuserid@hostname (30characters maximum).The userid can bealphanumericcharacters, ".", "-", or "_"but must begin and endwith alphanumericcharacters. Thehostname can bealphanumericcharacters, ".", "-", or "_".It must contain at leasttwo domain items.Every domain itemshould begin and endwith an alphanumericcharacter and the lastdomain item should befrom 2 to 20 alphabeticcharacters.
v "address" is thequote-delimited streetaddress of the machinelocation, of 1 to 30characters in length.
v "city" is thequote-delimited city ofthe machine location, of1 to 30 characters inlength.
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 89
Table 16. chconfig command (continued)
Function What it does Command Valid targets
Set contact informationfor Service Advisor
(continued)
v state is the state of themachine location, of 2to 3 characters inlength.
v "postalcode" is thequote-delimited postalcode of the machinelocation, of 1 to 9alphanumeric charactersin length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
90 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 16. chconfig command (continued)
Function What it does Command Valid targets
Set up HTTP proxy forService Advisor
Sets up HTTP proxy for ServiceAdvisor.
chconfig -ps setting -lochostname -po port -u“username” -pw “password”
where:
v setting is enabled ordisabled
v hostname is the fullyqualified host name orIP address of the HTTPproxy, of 1 to 63characters in length.
v port is the port of theHTTP proxy, a numberfrom 1 to 65535,inclusive.
v “username” is thequote-delimited username, of 1 to 30characters in length.
v “password” is thequote-delimitedpassword of the HTTPproxy, of up to 15characters in length
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To accept the Service Advisor terms and conditions, while management module 1is set as the persistent command environment, at the system:mm[1]> prompt, typechconfig -li accept
To display the current configuration of the Service Advisor, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typechconfig
Chapter 3. Command reference 91
The following example shows the information that is returned from these twocommands:system:mm[1]> chconfig -li acceptOKsystem:mm[1]> chconfig-sa enabled-sc US-ca No 399, Keyuan Rd,-cci Dallas-ce [email protected] bob-co IBM-cph 800-555-1111-cs TX-cz 75210-loc google.cn-po 8080-ps disabled-u User-001system:mm[1]>
92 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
chlog commandThis command is used to display up to five call-home activity log entries and tomark a call-home event entry as acknowledged or unacknowledged.
Table 17. chlog (display call-home activity log) command
Function What it does Command Valid targets
Display call-homeactivity log entries
Displays the last five entries fromthe call-home activity log.Notes:v The entries are displayed in
reverse chronological order (mostrecent call-home entry first).
v The system will wait 5 daysbefore sending duplicate eventsif they are not acknowledged ascorrected in the activity log.
v Call-home events are usuallythose that can be resolvedwithout additional problemdetermination.
chlog -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display FTP/TFTPserver call-home activitylog entries
Displays the last five FTP/TFTPserver entries from the call-homeactivity log.Notes:v The entries are displayed in
reverse chronological order (mostrecent call-home entry first).
v The system will wait 5 daysbefore sending duplicate eventsif they are not acknowledged ascorrected in the activity log.
chlog -f -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display IBM Supportcall-home activity logentries
Displays the last five IBM Supportentries from the call-home activitylog.Notes:v The entries are displayed in
reverse chronological order (mostrecent call-home entry first).
v The system will wait 5 daysbefore sending duplicate eventsif they are not acknowledged ascorrected in the activity log.
v Call-home events are usuallythose that can be resolvedwithout additional problemdetermination.
chlog -s -T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 93
Table 17. chlog (display call-home activity log) command (continued)
Function What it does Command Valid targets
Acknowledge /unacknowledgecall-home activity logentries
Marks the selected call-home eventas acknowledged (yes) orunacknowledged (no) when thecall-home event has been corrected.Note: The system will wait fivedays before sending duplicateevents if they are leftunacknowledged in the activity log.
chlog -index -ack option
where:
v index is the index of thecall-home event entry
v option is yes or no
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To display five call-home activity log entries, while management module1 is set as the persistent command environment, at the system:mm[1]> prompt, typechlog
To mark the call-home event with index number 14 as acknowledged, typechlog -14 -ack yes
The following example shows the information that is returned from these twocommands:system:mm[1]> chlogIndex Ack Send Result Assigned Num Event ID Sev Source
Time Message14 No Success NULL 0x00016802 I CHASSIS06/04/08 09:11:11 Test Call Home generated by USERID.15 No Pending NULL 0x00016802 I CHASSIS06/04/08 09:11:12 Test Call Home generated by USERID.
system:mm[1]>chlog -14 -ack yesOKsystem:mm[1]>
94 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
chmanual commandThis command tests the BladeCenter unit call-home feature setup.
Table 18. chmanual command
Function What it does Command Valid targets
Create call-homeproblem message
Create a call-home problemmessage for a management moduleor blade server.
chmanual -desc"description"
where "description" is aquote-delimited problemdescription of 1 to 100characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 95
Table 18. chmanual command (continued)
Function What it does Command Valid targets
Generate call-home testcall home
Manually generate a test call-homeevent that transmits the samplecall-home problem message.
chmanual -test
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example:
To create a call-home test message, at the system:> prompt, typechmanual -desc "This is a test."
To manually send a test message, while the system is set as the persistentcommand environment, at the system> prompt, typechmanual -test
The following example shows the information that is returned from these twocommands:system> chmanual -desc "This is a test."OKsystem> chmanual -testOKsystem>
96 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
cin commandThis command can be used to view and configure the chassis internal network forup to 14 supported chassis internal network (CIN) configurations, globally, or forspecified entries. You can define a CIN by creating a pool of VLAN (virtual localarea network) ID/IP address pairs, each of which is a CIN entry.
Table 19. cin command
Function What it does Command Valid targets
Display CINconfiguration table
Displays the configuration table forthe chassis internal network.Possible return values are:v Global CIN enabled or disabled
statusv CIN index
– VLAN ID– IP address– index entry enabled or disabled
status
cin -T system
Set global CIN state Sets the global state of CIN toenabled or disabled.
cin -global -en state
where state isv onv off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Clear all CINconfiguration entries
Deletes all CIN configurationentries.
cin all -clear
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 97
Table 19. cin command (continued)
Function What it does Command Valid targets
Turn all index entries onor off
Turns all CIN index entries on oroff.
cin all -en state
where state isv onv off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Delete CINconfiguration entry
Deletes the specified CINconfiguration entry.
cin -entry_index -clear
where entry_index is anumber between 1 and 14(inclusive).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Set CIN configurationentry to enable ordisable
Enables or disables a CINconfiguration entry.
If you enable or disable anon-existent entry, the action isignored and no error message isreturned.
cin -entry_index -en statewhere:v entry_index is a number
between 1 and 14, andv state is
– on– off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
98 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 19. cin command (continued)
Function What it does Command Valid targets
Create a CINconfiguration entry
Creates a CIN index entry.
If the CIN index is currently empty,both -id and -ip must be specified.Note: The VLAN ID must bedifferent from that of the bladeserver management module.
cin -entry_index -id vlan_id-ip ip_address
where:v entry_index is a number
between 1 and 14,v vlan_id is a VLAN ID
number between 3 and4094 (inclusive),
v ip_address is a valid IPaddress.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Specify valid IP addressfor CIN index entry
Specifies the IP address of the CINindex entry. The CIN IP addressmust be a valid IP address. An erroris displayed if the IP address isinvalid.
Note:v If the index is not empty, the IP
address can be specifiedseparately.
v CIN entries cannot have matchingIP addresses unless they are0.0.0.0. and have different VLANIDs.
v If the CIN IP address is 0.0.0.0,the blade server IP address forCIN which is configured in theblade server operating systemcannot be in the same subnet asthat of the advanced managementmodule.
v The IP address cannot bemulti-cast and cannot match theIP address of the managementmodule.
cin -entry_index -ipip_address
where:v entry_index is a number
between 1 and 14v ip_address is a valid IP
address.
You can overwriteparameters of an existingdefinition; for example,cin -1 -ip 0.0.0.0overwrites the currentCIN IP address of the firstcin entry. If the entry doesnot exist, an error isreturned.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 99
Table 19. cin command (continued)
Function What it does Command Valid targets
Specify VLAN ID forCIN entry
Set the VLAN ID for the specifiedCIN entry.
Note:v If the index is not empty, the ID
can be specified separately.v The VLAN ID must be different
from that of the managementmodule.
cin -entry_index -idvlan_id
where:v entry_index is a number
between 1 and 14v vlan_id is a number
between 3 and 4094(inclusive).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management andchassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example:
To view chassis internal network information for the management module, whilethis management module is set at the persistent command environment, at thesystem> prompt, typecin
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 3not used
Index 4not used
Index 5not used
Index 6not used
Index 7not used
100 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Index 8not used
Index 9not used
Index 10not used
Index 11not used
Index 12-id 123-ip 23.1.1.1-en on
Index 13not used
Index 14not usedsystem>
Chapter 3. Command reference 101
cinstatus commandThis command displays a table listing the VLAN ID, the IP address, the MACaddress, and the status of each chassis internal network (CIN) connection.
Table 20. cinstatus command
Function What it does Command Valid targets
Display entries of theCIN status table
Reads entries of the CIN statustable, five at a time. Each entry ofthe table returns:
v CIN VLAN ID
v CIN IP address
v CIN MAC address
v CIN status text
cinstatus -T system
Display status of firstfive CIN entries
Displays the first five entries of theCIN status table.
cinstatus -f -T system
Display entire CINstatus table
Displays all the entries in the CINstatus table.
cinstatus -a -T system
Note: An asterisk * next to an IP address indicates a learned entry.
Example:
To display five entries of the CIN status table, while the BladeCenter unit is set asthe persistent environment, at the system> prompt, typecinstatus
The following example shows the information that is returned from this commandsystem> cinstatus
Note: * next to IP address indicates a learned entry
VLAN IP Address MAC Address Status---- ---------------- ------------------ --------------------
1. 4094 0.0.0.1 Not Operational2. 4094 0.0.0.2 Not Operational3. 4 0.0.0.0 Operational4. 4093 0.0.0.1 Not Operational5. 4094 0.0.0.0 Operational
Last entry reachedsystem>
102 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
clear commandThis command restores the primary management module configuration or an I/O(switch) module configuration to the default settings.
The command must always include the -cnfg or -config option.
Table 21. clear command
Function What it does Command Valid targets
Restore defaultconfiguration of primarymanagement moduleand keep logs
Restores the default configurationof the primary managementmodule, retaining log information;then, resets the managementmodule.
No results are returned from thiscommand because it resets themanagement module.
When you restore themanagement-module configuration,the Ethernet configuration methodis set to a value of dthens. After themanagement module resets, thiscauses the management module totry dhcp configuration and thendefault to the static IPconfiguration, which might causethe management module to remainoffline for longer than normal. Seethe “ifconfig command” on page171 for information.
clear -cnfg
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
and chassisconfiguration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Restore defaultconfiguration of I/Omodule
Restores the configuration of thespecified I/O module to the defaultsettings.
clear -cnfg
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration and I/Omodule configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 103
Example: To restore the primary management-module configuration to defaultsettings and retain log information, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typeclear -cnfg
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 commandThis command clears the management-module audit event log, the system eventlog, or both.
Table 22. clearlog (clear management-module event log) command
Function What it does Command Valid targets
Clearmanagement-moduleevent log
Clears the management-moduleevent log and displays a messageconfirming that the specified eventlog was cleared.
clearlog
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis log
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Clear advancedmanagement-moduleaudit or system eventlog
Clears the management-moduleaudit event log, the system eventlog, or both, and displays amessage confirming that thespecified event log was cleared.Notes:
v Audit log events are created bythe actions of users.
v If the log_type is not specified,this command will clear bothlogs.
v Although system events andaudit events are stored internallyin separate log files, they arepresented to the user as a singlelog that can be filtered.
clearlog -l log_type
where log_type is audit orsystem.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis log
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To clear the management-module audit log, while management module 1is set as the persistent command environment, at the system:mm[1]> prompt, typeclearlog -1 audit
The following example shows the information that is returned:system:mm[1]> clearlog -1 auditOKsystem:mm[1]>
Chapter 3. Command reference 105
clock commandThis command configures and displays the advanced management-module clocksettings.
Table 23. clock command
Function What it does Command Valid targets
Display advancedmanagement moduleclock information
Displays the following informationfor the advanced managementmodule clock:v current date and timev GMT (Greenwich-Mean Time)
offsetv daylight-savings time setting
clock -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set advancedmanagement moduledate
Sets the date for the advancedmanagement module clock.
clock -d date
where date is the currentcalendar date inmm/dd/yyyy format.
The month and day can beinput as single digits. Theyear must be a four-digitnumber between 2000 and2089, inclusive.
This command can only berun by users who have thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set advancedmanagement moduletime
Sets the time for the advancedmanagement module clock.
clock -t time
where time is the currenttime in 24-hour hh:mm:ssformat.
The hours, minutes, andseconds can all be input assingle digits.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
106 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 23. clock command (continued)
Function What it does Command Valid targets
Set advancedmanagement moduleclock GMT offset
Sets the time for the advancedmanagement module clock.
clock -g offset
where offset is a valuebetween +12 and -12, inhours and minutes.Positive offsets are enteredusing the form:GMT+hh:mm, +hh:mm,+hh, hh:mm, or hh; where,the hours and minutes canbe input as single digits.Negative offsets areentered using the form:GMT-hh:mm, -hh:mm, or-hh; where, the hours andminutes can be input assingle digits. Valid offsetsare:v GMT+0:00v GMT+1:00v GMT+2:00v GMT+3:00v GMT+3:30v GMT+4:00v GMT+4:30v GMT+5:00v GMT+5:30v GMT+6:00v GMT+7:00v GMT+8:00v GMT+9:00v GMT+9:30v GMT+10:00v GMT+11:00v GMT+12:00v GMT-12:00v GMT-11:00v GMT-10:00v GMT-9:00v GMT-8:00v GMT-7:00v GMT-6:00v GMT-5:00v GMT-4:00v GMT-3:30v GMT-3:00v GMT-2:00v GMT-1:00
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 107
Table 23. clock command (continued)
Function What it does Command Valid targets
Set advancedmanagement moduleclock GMT offset
(continued)
For some time zones thatuse daylight-savings time(GMT +10, +2, -5, -6, -7, -8,-9), a special value for the-dst option must bespecified to identify thecorrect daylight-savingstime scheme to use in thattime zone.
This command can only berun by users who have thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
108 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 23. clock command (continued)
Function What it does Command Valid targets
Set advancedmanagement moduleclock daylight-savingstime mode
Sets the daylight-savings time modefor the advanced managementmodule clock.
clock -dst dst_mode
where dst_mode is one ofthe following:v offv onv 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 toGMT-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 isnot observed in thefollowing 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, andGMT-10:00.
This command can only berun by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 109
Example: To set the management-module for operation in the US Eastern timezone in compliance with new daylight-savings time rules, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typeclock -g +5 -dst uc
To display the clock information for the primary management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeclock
The following example shows the information that is returned from these twocommands:system:mm[1]> clock -g +5 -dst ucOKsystem:mm[1]> clock10/17/2006 02:27:11 GMT+5:00 dst ucsystem:mm[1]>
110 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
config commandThis command sets and displays the name of the advanced management moduleor blade server and the location and contact name for the advanced managementmodule.
Table 24. config command
Function What it does Command Valid targets
Display name of bladeserver
Displays the name of the specifiedblade server.
config -T system:blade[x]
where x is the bladeserver bay number.
Display name ofmanagement module
Displays the following informationfor the command target:v Namev Locationv Contact name
config -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display identifyinginformation forBladeCenter unit
Displays the following informationfor the command target:v Universally unique identifierv Serial numberv Type/model
config -T system
Set name ofmanagement module orblade server
Sets the name of the primarymanagement module or specifiedblade server.
config -name name
where name is up to 15characters in length.
Blade server names cannotcontain angle brackets ("<"and ">"), and advancedmanagement modulenames can only containalphanumeric characters,hyphens, pound signs,underscores, and periods.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for managementmodule)
v Blade configuration (forblade server)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]
where x is the primarymanagement-moduleor a blade server baynumber.
Chapter 3. Command reference 111
Table 24. config command (continued)
Function What it does Command Valid targets
Set location ofmanagement module
Sets the location of the primaryadvanced management module.
config -loc "location"
where "location" is up to47 characters in lengthand contained withindouble-quotes.
Advanced managementmodule locations cancontain any characterother than "<" and ">".
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set contact name foradvanced managementmodule
Sets the contact name for theprimary advanced managementmodule.
config -contact"contact_name"
where "contact_name" isup to 47 characters inlength and containedwithin double-quotes.
Advanced managementmodule contact names cancontain any characterother than "<" and ">".
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 uniqueidentifier (UUID) forBladeCenter unit
Sets the universally uniqueidentifier for the BladeCenter unit.Notes:
v Change the -uuid value only ifyou are certain it was notprogrammed correctly on thehardware. To prevent disruptingthe operation of IBM SystemsDirector, you should edit thisfield only if the midplane ofyour system has been replacedwith a new midplane that doesnot have this informationprogrammed on it.
v If you change the UUID on anexisting system to a random newvalue, IBM Systems Director willtreat this as a new system,distinct from the one identifiedby the old UUID.
v Changes to the UUID take effectafter the next restart of theadvanced management module.
config -uuid "unique_id"
where "unique_id" is 32hexadecimal digits and iscontained withindouble-quotes.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Set type/model forBladeCenter unit
Sets the type or model designatorfor the BladeCenter unit.Notes:
v Change the -tm value only if youare certain it was notprogrammed correctly on thehardware. To prevent disruptingthe operation of IBM SystemsDirector, you should edit thisfield only if the midplane ofyour system has been replacedwith a new midplane that doesnot have this informationprogrammed on it.
v Changes to the type/model takeeffect after the next restart of theadvanced management module.
config -tm "type_model"
where "type_model" is upto seven characters inlength and containedwithin double-quotes.
Advanced managementmodule type / modeldesignators can containany character other than"<" and ">".
This command can onlybe run by users who havethe following commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 113
Table 24. config command (continued)
Function What it does Command Valid targets
Set serial number forBladeCenter unit
Sets the serial number for theBladeCenter unit.Notes:
v Change the -sn value only if youare certain it was notprogrammed correctly on thehardware. To prevent disruptingthe operation of IBM SystemsDirector, you should edit thisfield only if the midplane ofyour system has been replacedwith a new midplane that doesnot have this informationprogrammed on it.
v Changes to the serial numbertake effect after the next restartof the advanced managementmodule.
config -sn "serial_number"
where "serial_number" isup to seven characters inlength and containedwithin double-quotes.
Advanced managementmodule serial numberscan contain any characterother than "<" and ">".
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example:
To set the management module name to IBM_lab, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typeconfig -name IBM_lab
To display the management module name, location, and contact name, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeconfig
The following example shows the information that is returned from these twocommands:system:mm[1]> config -name IBM_labOKsystem:mm[1]> config-name IBM_lab-contact John_Doe-loc Main_Labsystem:mm[1]>
114 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
console commandThis command sets up a serial over LAN connection to the command console of ablade server.
To end an SOL session, press Esc followed by an open parenthesis:
Esc (
Table 25. console command
Function What it does Command Valid targets
Create SOL session withblade server
Creates an SOL connection to thespecified blade server.Note: The advanced managementmodule supports a persistent SOLconnection that remains intact untilyou escape from the SOL console,or another user uses the overrideoption to take over your SOLconsole. A persistent command, ifdropped, automatically attempts toreconnect.
console
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Create override SOLsession with bladeserver
Creates an SOL connection to thespecified blade server, with theoverride option enabled. Thisenables you to end an existing SOLsession to that blade server andstart a new one.Note: The advanced managementmodule supports combing this isoption with the -l option tooverride an existing session, andnot reconnect if the connectiondrops.
console -o
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Create non-persistentSOL session with bladeserver
Creates an SOL connection to thespecified blade server for userswho do not want to use apersistent session.Note: This option can be combinedwith the -o option to override anexisting session, and not reconnectif the connection drops.
console -l
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 115
Example: To start an SOL connection to the blade server in blade bay 14, while thisblade server is set as the persistent command environment, at the system:mm[x]>prompt, typeconsole -T system:blade[14]
116 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
dhcpinfo commandThis command displays the IP configuration that is assigned by a DHCP server tothe primary management module external network interface, blade servermanagement network interfaces, and I/O module DHCPv6 server.
Note: The dhcpinfo command does not apply to management module channeleth1, which always uses a static IP configuration.
Table 26. dhcpinfo command
Function What it does Command Valid targets
Display Ethernetchannel 0 DHCPconfiguration formanagement module
If the IP configuration formanagement module eth0 isassigned by a DHCP server, theconfiguration that is assigned bythe DHCP server and DHCP serverinformation is displayed. If the IPconfiguration for eth0 is notassigned by a DHCP server, anerror message is displayed. Possibleconfiguration values returned are:v -server dhcp_ip_addressv -n hostnamev -i ip_addressv -g gateway_addressv -s subnet_maskv -d domainnamev -dns1 primary_dns_ip_addressv -dns2 secondary_dns_ip_addressv -dns3 tertiary_dns_ip_1addressv -server6 IPv6_dhcp_ip_addressv -i6 IPv6_addressv -d6 IPv6_domainnamev -dns61
IPv6_primary_dns_ip_addressv -dns62
IPv6_secondary_dns_ip_addressv -dns63
IPv6_tertiary_dns_ip_1address
dhcpinfo -eth0 -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display managementnetwork DHCPconfiguration for bladeserver
If the IPv6 configuration for thespecified blade server managementnetwork Ethernet channel isassigned by a DHCP server, theIPv6 IP address is displayed. If theIP configuration for the specifiedblade server management networkEthernet channel is not assigned bya DHCP server, an error message isdisplayed.
dhcpinfo -ethx
where x is the blade servermanagement networkchannel number todisplay.
-T system:blade[x]
where x is the bladeserver bay number.
Display DHCPconfiguration for I/Omodule
If the IPv6 configuration for thespecified I/O module is assignedby a DHCP server, the IPv6 IPaddress is displayed. If the IPv6configuration for the I/O module isnot assigned by a DHCP server, anerror message is displayed.
dhcpinfo -T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 117
Example: To display the DHCP server assigned network settings that do notsupport IPv6 for Ethernet channel 0, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typedhcpinfo -eth0
The following example shows the information that is returned:system:mm[1]> dhcpinfo -eth0-server 192.168.70.29-n MM00096BCA0C80-i 192.168.70.183-g 192.168.70.29-s 255.255.255.0-d linux-sp.raleigh.ibm.com-dns1 192.168.70.29-dns2 0.0.0.0-dns3 0.0.0.0system:mm[1]>
To display the DHCP server assigned network settings that support IPv6 forEthernet channel 0, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typedhcpinfo -eth0
The following example shows the information that is returned:system:mm[1]> dhcpinfo -eth0DHCP is disabled-server6 FE80:0000:0000:0000:0202:55FF:FE21:0F23-i6 2000:1013:0000:0000:DDDD:CCCC:D7C8:F925-d6 datacentertech.net-dns61 2000:1013:0000:0000:0000:0000:0100:0100-dns62 2000:1013:0000:0000:0000:0000:0100:0101-dns63 2000:1013:0000:0000:0000:0000:0100:0102system:mm[1]>
118 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
displaylog commandThis command displays management-module event log entries.
Note: Event descriptions and suggested user actions for items shown by thedisplaylog 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
Displaymanagement-moduleevent log entries
Displays five entries from themanagement-module event log.The first time the command isexecuted, the five most recent logentries are displayed. Eachsubsequent time the command isissued, the next five entries in thelog display.
displaylog -T system:mm[x]
where x is the primarymanagement-modulebay number.
Displaymanagement-moduleevent log entries (resetcounter)
Resets the counter and displays thefirst five most recent entries in themanagement-module event log.
displaylog -f -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display log entries withEvent ID
Displays log entries with Event ID. displaylog -e -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display log entries withtheir call-home flag
Displays log entries with theircall-home flag.
displaylog -c -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display allmanagement-moduleevent log entries
Displays all entries in themanagement module event log.
displaylog -a -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display all event logfilters
Displays all filters that can be usedto control management moduleevent log output.
displaylog -filters -T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 119
Table 27. displaylog (display management-module event log) command (continued)
Function What it does Command Valid targets
Display event log entriesfiltered by date
Displays management moduleevent log information that meetsthe specified date filter criteria.Note:v This command displays the first
five most recent entries in themanagement-module event logthat meet the specified filtercriteria. Adding the -a option tothe command displays all entriesthat meet the specified filtercriteria.
v If the filter criteria entered doesnot match the criteria previouslyspecified, this resets the counterand displays the first five mostrecent log entries that match thespecified filter criteria.
v The index number displayed foreach filtered log entry might notmatch the index number shownfor the same log entry displayedin an unfiltered list.
displaylog -datedate_filter
where date_filter is a pipe (| ) separated list of datefilters in mm/dd/yyformat.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display event log entriesfiltered by severity level
Displays management moduleevent log information that meetsthe specified severity level filtercriteria.Note:v This command displays the first
five most recent entries in themanagement-module event logthat meet the specified filtercriteria. Adding the -a option tothe command displays all entriesthat meet the specified filtercriteria.
v If the filter criteria entered doesnot match the criteria previouslyspecified, this resets the counterand displays the first five mostrecent log entries that match thespecified filter criteria.
v The index number displayed foreach filtered log entry might notmatch the index number shownfor the same log entry displayedin an unfiltered list.
displaylog -sevseverity_filter
where severity_filter is apipe ( | ) separated list ofseverity filters:v I (information)v E (error)v W (warning)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display event log entriesfiltered by source
Displays management module loginformation that stored in the auditlog.
displaylog -src Audit -T system:mm[x]
where x is the primarymanagement-modulebay 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 entriesfiltered by every flagexcept the one specified
Displays management module loginformation that is stored in logsother than the specified log.Note:v This command displays the first
five most recent entries in themanagement-module event logthat meet the specified filtercriteria. Adding the -a option tothe command displays all entriesthat meet the specified filtercriteria.
v If the filter criteria entered doesnot match the criteria previouslyspecified, this resets the counterand displays the first five mostrecent log entries that match thespecified filter criteria.
v The index number displayed foreach filtered log entry might notmatch the index number shownfor the same log entry displayedin an unfiltered list.
displaylog -src!filter_out
where filter_out is thecategory of event logentries that is not to bedisplayed. Use thedisplaylog -filterscommand to discoverexcludable event logcategories.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display audit log entriesfiltered by source
Displays management moduleaudit log information that meetsthe specified source filter criteria.Note:v This command displays the first
five most recent entries in themanagement-module event logthat meet the specified filtercriteria. Adding the -a option tothe command displays all entriesthat meet the specified filtercriteria.
v If the filter criteria entered doesnot match the criteria previouslyspecified, this resets the counterand displays the first five mostrecent log entries that match thespecified filter criteria.
v The index number displayed foreach filtered log entry might notmatch the index number shownfor the same log entry displayedin an unfiltered list.
displaylog -srcsource_filter
where source_filter is apipe ( | ) separated list ofsource filters. To specify arange of blade servers asthe source, use a hyphen (- ), as follows:Blade_01-08.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 121
Table 27. displaylog (display management-module event log) command (continued)
Function What it does Command Valid targets
Display log entriesfiltered by call-homeflag
Displays log entries that meet thespecified call-home events filtercriteria.Note:v This command displays the five
most recent entries in themanagement-module event logthat meet the specified filtercriteria. Adding the -a option tothe command displays all entriesthat meet the specified filtercriteria.
v If the filter criteria entered doesnot match the criteria previouslyspecified, this resets the counterand displays the first five mostrecent log entries that match thespecified filter criteria.
v The index number displayed foreach filtered log entry might notmatch the index number shownfor the same log entry displayedin an unfiltered list.
displaylog -ch option
where option are:v C (call home)v N (no call home)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display the state of thelog state event option
Displays the state (enabled ordisabled) of the log state eventoption, which generates an eventwhen the event log becomes 75%or 100% full.
displaylog -lse -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablemonitoring of event logstate
Enables or disables the monitoringof the event log state to generate anevent when the log becomes 75%or 100% full.Note: The displaylog -lsecommand must be run exclusive ofother log-reading command options(-f, -a, -filters, -date, -sev, - src, -i,and -l).
displaylog -lse state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis log
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Save event log to TFTPserver
Saves the event log with thespecified filename to the specifiedTFTP server.Note: The -i and -l commandoptions must be run together andexclusive of other commandoptions.
displaylog -i ip_address-l filename
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theevent log is beingsaved.
v filename is the name ofthe event log file.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 otherthan those in the audit log, while the BladeCenter unit is set as the persistentcommand environment, at the system> prompt, typedisplaylog -src !Audit -T mm[1]
To display audit log entries generated by the management module in bay 1, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, typedisplaylog -src Audit -T mm[1]
The following example shows the information that is returned from thesecommands:system> displaylog -src !Audit -T mm[1]1 I SERVPROC 08/04/08 14:18:06 Recovery Event log full2 I SERVPROC 08/04/08 14:18:06 Alarm Manager removed a MNR
alert during recovery of Eventlog 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 atIP 9.44.124.157
2 I Audit 08/04/08 14:28:18 Remote login successful foruser ’spdev’ from Telnet atIP 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>
Chapter 3. Command reference 123
displaysd commandThis command captures and displays service information.
Service information for the management modules includes BladeCenter VPD, themanagement-module event log, connection status, and self-test results. If multipleuser interface sessions issue the displaysd command, the commands will beprocessed in the order that they are received. Some types of service information aredisplayed for only the primary management module.
Table 28. displaysd command
Function What it does Command Valid targets
Capture and displayservice information
Capture and display serviceinformation on page from theprimary or standby managementmodule.
displaysd -T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Display managementmodule connection andself-test status
Displays connection status andlatest self-test results for theprimary management module.
displaysd -mmstat -T system:mm[x]
where x is the primarymanagement-modulebay number.
Save service informationto TFTP server
Saves service information fromprimary management module withthe specified filename to thespecified TFTP server.Note: The -save and -i commandoptions must be run together.
displaysd -save filename-i ipaddress
where:v filename is the location
where serviceinformation will besaved. The filenameshould use a .tgzextension to allowsupport personnel toidentify the file.
v ip_address is the IPv4 orIPv6 IP address of theTFTP server.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display all blade serverSRC records
Displays a list of the most recent(up to 32) SRCs for the specifiedblade server.Note: SRC information is availablefor only those blade servers thatsupport this feature.
displaysd -src list -T system:blade[x]
where x is the bladeserverbay number.
Display specific bladeserver SRC record
Displays a specific SRC, based onthe specified record number, for thespecified blade server.Note: SRC information is availablefor only those blade servers thatsupport this feature.
displaysd -src index
where index is the SRCrecord number to display,between 1 and 32.
-T system:blade[x]
where x is the bladeserverbay number.
124 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To capture and display service information from the managementmodule in bay 1, while the chassis is set as the persistent command environment,at the system> prompt, typedisplaysd -T system:mm[1]
To capture service information from the management module in bay 1 and save itto a file named sdc.tgz on a TFTP server with a IP address of 9.67.22.176, while thechassis is set as the persistent command environment, at the system> prompt, typedisplaysd -T system:mm[1] -save sdc.tgz -i 9.67.22.176
The following example shows the information that is returned from thesecommands:system> displaysd -T system:mm[1]SPAPP Capture AvailableTime: 10/04/2005 21:47:43UUID: Not Available•••system> displaysd -T system:mm[1] -save sdc.tgz -i 9.67.22.176OKsystem>
Note: If a large amount of service information is available, display could exceedthe capacity of your command-prompt window, resulting in loss of informationdisplayed at the start of the data set. If this happens, you will need to clear themanagement-module event log to reduce the amount of information beingcaptured.
Chapter 3. Command reference 125
dns commandThis command configures and displays the management-module DNS settings.
Table 29. dns command
Function What it does Command Valid targets
Display DNSconfiguration ofmanagement module
Displays the current DNSconfiguration of the managementmodule. Possible return values are:v enabledv disabledv -i1 IPv4_first_ip_addressv -i2 IPv4_second_ip_addressv -i3 IPv4_third_ip_addressv -i61 IPv6_first_ip_addressv -i62 IPv6_second_ip_addressv -i63 IPv6_third_ip_addressv -ddns dynamic_DNS_state
(enabled/disabled)v -p DNS_server_priority
(ipv4/ipv6)
dns -T system:mm[x]
where x is the primarymanagement-modulebay number.
DNS - enable / disable Enables or disables themanagement-module DNSconfiguration.
dns -state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Dynamic DNS - enable /disable
Enables or disables dynamic DNSfor the management module.
dns -ddns state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 IPaddress - set
Sets the first IPv4 IP address. dns -i1 ip_address
where ip_address is thefirst IP address in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
DNS second IPv4 IPaddress - set
Sets the second IPv4 IP address. dns -i2 ip_address
where ip_address is thesecond IP address indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
DNS third IPv4 IPaddress - set
Sets the third IPv4 IP address. dns -i3 ip_address
where ip_address is thethird IP address in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 127
Table 29. dns command (continued)
Function What it does Command Valid targets
DNS first IPv6 IPaddress - set
Sets the first IPv6 IP address. dns -i61 ip_address
where ip_address is thefirst IP address in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
DNS second IPv6 IPaddress - set
Sets the second IPv6 IP address. dns -i62 ip_address
where ip_address is thesecond IP address in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
DNS third IPv6 IPaddress - set
Sets the third IPv6 IP address. dns -i63 ip_address
where ip_address is thethird IP address in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay 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 themanagement module to IPv4 orIPv6..
dns -p priority
where priority is ipv4 oripv6.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To set the first IP address of the management-module DNS server to192.168.70.29 and enable DNS on the primary management module that does nothave IPv6 support, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typedns -i1 192.168.70.29 -on
To display the DNS status of the primary management module, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typedns
The following example shows the information that is returned from these twocommands:system:mm[1]> dns -i1 192.168.70.29 -onChanges to the network settings will take effect after the next reset of the MM.system:mm[1]> dnsEnabled-i1 192.168.70.29-i2 0.0.0.0-i3 0.0.0.0system: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 thesystem:mm[1]> prompt, typedns
Chapter 3. Command reference 129
The following example shows the information that is returned from this command:system:mm[1]> dnsEnabledEnabled-i1 192.168.70.230-i2 0.0.0.0-i3 0.0.0.0-i61 2002:1013::211:25ff:fec3:227d-i62 ::-i63 ::-ddns disabled-p ipv4system:mm[1]>
130 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
env (environment) commandThis command sets the persistent environment for commands that are enteredduring the remainder of the current session.
The persistent command environment is indicated by the command prompt. Whenyou start the command-line interface, the persistent command environment is theBladeCenter unit, denoted as system by the command prompt. You can target asingle command to an environment other than the one that is set as the default byadding a -T option to the command that includes a valid target destination (see“Selecting the command target” on page 6 for information). Target environmentscan be specified using the full path name, or using a partial path name based onthe persistent command environment. Full path names always begin with system.The levels in a path name are divided by using a colon ( : ).
The following table lists BladeCenter components and the command paths that aresupported 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(BMC or service processor)
system:blade[x]:sp
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]
Chapter 3. Command reference 131
Table 31. env (environment) command
Function What it does Command Valid targets
Set BladeCenter unit ascommand target
Sets the BladeCenter unit as thepersistent target for commandsduring the current session. This isthe persistent commandenvironment you are in at thebeginning of each command-lineinterface session, indicated by thesystem> prompt.
env
env -T system
The env command canbe directed to anyinstalled device.
Set management moduleas command target
Sets the management module asthe persistent target for commandsduring the current session.
env -T system:mm[x]
where x is the bay (1 or 2)that identifies themanagement module.
The env command canbe directed to anyinstalled device, in thiscase
-T system:mm[x]
where x is themanagement-modulebay number.
Set blade server ascommand target
Sets the specified blade server asthe persistent target for commandsduring the current session.
env -T system:blade[x]
where x is the blade baythat identifies the bladeserver. A blade server thatoccupies more than oneblade bay is identified bythe lowest bay numberthat it occupies.
The env command canbe directed to anyinstalled device, in thiscase
-T system:blade[x]
where x is the bladebay that identifies theblade 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 serversub-component ascommand target
Sets the specified sub-componenton the specified blade server as thepersistent target for commandsduring the current session. Validsub-components are:v Integrated system management
processor (BMC or serviceprocessor)
v I/O-expansion cardv Microprocessorv Storage expansion unitv High-speed expansion cardv Memoryv Mezzanine assembly for
double-width form factor bladeservers
env -Tsystem:blade[x]:comp
where x is the blade baythat identifies the bladeserver on which thesub-component isinstalled. A blade serverthat occupies more thanone blade bay is identifiedby the lowest bay numberthat it occupies.
where comp is thesub-component:v sp for BMC or service
processorv exp[x] for
I/O-expansion card(where x identifies theexpansion card)
v cpu[x] formicroprocessor (where xidentifies themicroprocessor)
v be[x] for storageexpansion unit (where xidentifies the expansionunit)
v ckvm for concurrentKVM feature card
v hsec[x] for high-speedexpansion card (where xidentifies the high-speedexpansion card)
v memory[x] for memory(where x identifies thememory module)
v mgmtcrd formanagement card
v sb for mezzanineassembly fordouble-width formfactor blade servers )
The env command canbe directed to anyinstalled device, in thiscase
-Tsystem:blade[x]:comp
where x is the bladebay that identifies theblade server on whichthe integrated systemmanagement processoris installed.
where comp is thesub-component:v sp for BMC or
service processorv exp[x] for
I/O-expansion card(where x identifiesthe expansion card)
v cpu[x] formicroprocessor(where x identifiesthe microprocessor)
v be[x] for storageexpansion unit(where x identifiesthe expansion unit)
v ckvm for concurrentKVM feature card
v hsec[x] forhigh-speedexpansion card(where x identifiesthe high-speedexpansion card)
v memory[x] formemory (where xidentifies thememory module)
v mgmtcrd formanagement card
v sb for mezzanineassembly fordouble-width formfactor blade servers )
Chapter 3. Command reference 133
Table 31. env (environment) command (continued)
Function What it does Command Valid targets
Set I/O module ascommand target
Sets the specified I/O module asthe persistent target for commandsduring the current session.
env -T system:switch[x]
where x is the I/O-modulebay where the I/Omodule is installed.
The env command canbe directed to anyinstalled device, in thiscase
-T system:switch[x]
where x is theI/O-module bay wherethe I/O module isinstalled.
Set power module ascommand target
Sets the specified power module asthe persistent target for commandsduring the current session.
env -T system:power[x]
where x is the powermodule bay where thepower module is installed.
The env command canbe directed to anyinstalled device, in thiscase
-T system:power[x]
where x is the powermodule bay where thepower module isinstalled.
Set blower as commandtarget
Sets the specified blower as thepersistent target for commandsduring the current session.
env -T system:blower[x]
where x is the blower baywhere the blower isinstalled.
The env command canbe directed to anyinstalled device, in thiscase
-T system:blower[x]
where x is the blowerbay where the bloweris installed.
Set media tray ascommand target
Sets the media tray as thepersistent target for commandsduring the current session.
env -T system:mt[x]
where x is the media-traybay where the media trayis installed.
The env command canbe directed to anyinstalled device, in thiscase
-T system:mt[x]
where x is themedia-tray bay wherethe media tray isinstalled.
Set media tray batterybackup unit ascommand target
Sets the specified battery backupunit on the specified media tray asthe persistent target for commandsduring the current session.
env -Tsystem:mt[x]:bbu[y]
where x is the media trayon which the batterybackup unit is installed.
where y is the batterybackup unit number:
The env command canbe directed to anyinstalled device, in thiscase
-Tsystem:mt[x]:bbu[y]
where x is the mediatray on which thebattery backup unit isinstalled.
where y is the batterybackup unit number:
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 ascommand target
(BladeCenter HT unitsonly)
Sets the alarm panel as thepersistent target for commandsduring the current session.
env -T system:tap The env command canbe directed to anyinstalled device, in thiscase
-T system:tap
Set multiplexerexpansion module ascommand target
(BladeCenter HT unitsonly)
Sets the multiplexer expansionmodule as the persistent target forcommands during the currentsession.
env -T system:mux[x]
where x is the multiplexerexpansion modulenumber.
The env command canbe directed to anyinstalled device, in thiscase
-T system:mux[x]
where x is themultiplexer expansionmodule number.
Set network clockmodule as commandtarget
(BladeCenter HT unitsonly)
Sets the network clock module asthe persistent target for commandsduring the current session.
env -T system:ncc[x]
where x is the networkclock module number.
The env command canbe directed to anyinstalled device, in thiscase
-T system:ncc[x]
where x is the networkclock module number.
Set storage module ascommand target
(BladeCenter S unitsonly)
Sets the storage module as thepersistent target for commandsduring the current session.
env -T system:storage[x]
where x is thestorage-module bay wherethe storage module isinstalled.
The env command canbe directed to anyinstalled device, in thiscase
-T system:storage[x]
where x is thestorage-module baywhere the storagemodule is installed.
Set storage module diskdrive as command target
(BladeCenter S unitsonly)
Sets the specified disk drive in thespecified storage module as thepersistent target for commandsduring the current session.
env -Tsystem:storage[x]:disk[y]
where x is the storagemodule on which the diskdrive is installed.
where y is the disk drivenumber:
The env command canbe directed to anyinstalled device, in thiscase
-T system:storage[x]:disk[y]
where x is the storagemodule on which thedisk drive is installed.
where y is the diskdrive number:
Chapter 3. Command reference 135
Example: To set the persistent target of commands to the service processor on theblade server in blade bay 5, while the BladeCenter unit is set as the defaultcommand target, at the system> prompt, typeenv -T system:blade[5]:sp
The following example shows the information that is returned:system> env -T system:blade[5]:spOKsystem:blade[5]:sp>
To set the persistent target of commands to the service processor on the bladeserver in blade bay 5, while the BladeCenter unit is set as the default commandtarget, at the system> prompt, you can also typeenv -T blade[5]:sp
The following example shows the information that is returned:system> env -T blade[5]:spOKsystem:blade[5]:sp>
To issue the reset command on the blade server in blade bay 5, while themanagement module is set as the default command target, at the system:mm[x]>prompt, typereset -T system:blade[5]
136 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ethoverusb commandThis command sets and displays the setting for the Ethernet-over-USB commandinterface of a blade server service processor, for blade servers that support thisfeature.
Table 32. ethoverusb command
Function What it does Command Valid targets
Display blade serverEthernet-over-USBsetting
Displays the Ethernet-over-USBcommand interface setting for theservice processor of the specifiedblade server.Note: This command will executeonly on blade servers that supportan Ethernet-over-USB commandinterface for the service processor.
ethoverusb -T system:blade[x]
where x is the bladeserver bay number.
Set blade serverEthernet-over-USBsetting
Enables or disables theEthernet-over-USB commandinterface setting for the serviceprocessor of the specified bladeserver.Note: This command will executeonly on blade servers that supportan Ethernet-over-USB commandinterface for the service processor.
ethoverusb -s state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Example: To view the Ethernet-over-USB command interface setting for the serviceprocessor of the blade server in bay 2, while this blade server is set as thepersistent command environment, at the system:blade[2]> prompt, typeethoverusb
To disable the Ethernet-over-USB command interface setting for the serviceprocessor of the blade server in bay 2, while this blade server is set as thepersistent command environment, at the system:blade[2]> prompt, typeethoverusb -s disabled
The following example shows the information that is returned from thesecommands:system:blade[2]> ethoverusbenabledsystem:blade[2]> ethoverusb -s disabledOKsystem:blade[2]> ethoverusbdisabledsystem:blade[2]>
Chapter 3. Command reference 137
eventinfo commandThis command displays advanced management module event information andsuggested user actions. See the BladeCenter Advanced Management Module MessagesGuide for a complete list of all non-device specific events and recommendedactions, sorted by event ID. Device specific event information is in thedocumentation for the device.
Table 33. eventinfo command
Function What it does Command Valid targets
Display eventdescription and useraction
Displays the event description andsuggested user action for thespecified event ID.
eventinfo -id
where id is the event IDdisplayed from the“displaylog command” onpage 119.
Event IDs are of the form0xnnnnnnnn, wherennnnnnnn is ahexadecimal number thatidentifies the specificevent (the 0x prefix is notentered). Leading zerosneed not be entered whenusing the eventinfocommand: in thisexample, specifying anevent ID of 00104204, or104204 would return thesame result.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display eventdescription
Displays the event description forthe specified event ID.
eventinfo -id -d
where id is the event IDdisplayed from the“displaylog command” onpage 119.
Event IDs are of the form0xnnnnnnnn, wherennnnnnnn is ahexadecimal number thatidentifies the specificevent (the 0x prefix is notentered). Leading zerosneed not be entered whenusing the eventinfocommand: in thisexample, specifying anevent ID of 00104204, or104204 would return thesame result.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 useraction
Displays the suggested user actionfor the specified event ID.
eventinfo -id -u
where id is the event IDdisplayed from the“displaylog command” onpage 119.
Event IDs are of the form0xnnnnnnnn, wherennnnnnnn is ahexadecimal number thatidentifies the specificevent (the 0x prefix is notentered). Leading zerosneed not be entered whenusing the eventinfocommand: in thisexample, specifying anevent ID of 00104204, or104204 would return thesame result.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the event description and suggested user action for an eventwith an ID of 0x00104204, while the BladeCenter unit is set as the persistentcommand environment, at the system:> prompt, typeeventinfo -T mm[1] -00104204
The following example shows the information that is returned from this command:system> eventinfo -T mm[1] -00104204Event Description:The primary advanced management module was reset.Recommended Action:Information only; no action is required.system>
Chapter 3. Command reference 139
events commandThis command manages the Call Home events exclusion list for the advancedmanagement module.
Table 34. events command
Function What it does Command Valid targets
Display Call Homeevents list and freespace
Displays a list of Call Home eventIDs that will not be reported by theCall Home feature, and how manymore events can be added to thisCall Home events exclusion list.This Call Home exclusion listallows a maximum of 20 events.
events -che
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Add a Call Home eventto the Call HomeExclusion list
Adds a Call Home event to theCall Home exclusion list. Events onthis list are specified by an eventID, and are not included in the CallHome reports.Note: The Service Advisor termsand conditions must first beaccepted, or the AutomatedFTP/TFTP Report of Service Datamust be enabled before using thiscommand.
events -che -add event_ID
where event_ID is aneight-digit hexadecimalnumber with an optionalprefix of 0x or 0X.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 Homeevent from the CallHome Exclusion list
Removes a Call Home event fromthe Call Home exclusion list.Events removed from this list areincluded in the Call Home reports.Note: The Service Advisor termsand conditions must first beaccepted, or the AutomatedFTP/TFTP Report of Service Datamust be enabled before using thiscommand.
events -che -rm event_ID
where event_ID isv an eight-digit
hexadecimal numberwith an optional prefixof 0x or 0X to remove asingle Call Home event
v all to remove all theCall Home events fromthe exclusion list
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the Call Home exclusion list and the number of remainingevents can be added to the list, while the BladeCenter unit is set as the persistentcommand environment, at the system:> prompt, typeevents -T mm[1] -che
To add Call Home event number 0x00020003 to the Call Home exclusion list, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, typeevents -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 thesystem> prompt, typeevents -T mm[1] -che -rm 0x00020001
The following example shows the information that is returned from thesecommands:system> events -T mm[1] -cheA maximum of 20 events can be added to this exclusion list, currently18 more events can be added.Call Home Exclusion List is illustrated as follows:Index Event ID1 0x000200012 0x00020002system> events -T mm[1] -che -add 0x00020003OKsystem> events -T mm[1] -cheA maximum of 20 events can be added to this exclusion list, currently17 more events can be added.Call Home Exclusion List is illustrated as follows:Index Event ID1 0x000200012 0x00020002
Chapter 3. Command reference 141
3 0x00020003system> events -T mm[1] -che -rm 0x00020001OKsystem> events -T mm[1] -cheA maximum of 20 events can be added to this exclusion list, currently18 more events can be added.Call Home Exclusion List is illustrated as follows:Index Event ID1 0x000200022 0x00020003system>
142 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
exit commandThis command exits the command-line interface, terminating the current session.
Table 35. exit command
Function What it does Command Valid targets
Exit Terminates the currentcommand-line interface session.
exitNote: You can also usethe Ctrl-D keycombination to end thecurrent session and exitthe command-lineinterface.
Any installed device.
Example: To terminate the current command-line interface session, typeexit
Chapter 3. Command reference 143
feature commandThis command manages licensing for advanced features for the advancedmanagement module.
Table 36. feature command
Function What it does Command Valid targets
Display feature list andlicense status
Displays a list of advanced featuresfor the management module andtheir licensing status.
feature -T system:mm[x]
where x is the primarymanagement-modulebay number.
Add a feature license Adds a license for a managementmodule advanced feature. Featureson this list are specified using thefeature index number that appearsat the left of the feature list.
feature -index -add -keylisc_key
where:v index is the number for
the feature at the left ofthe feature listdisplayed by thefeature command.
v lisc_key is the7-character part numberof the feature.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Remove a feature license Removes a license for amanagement module advancedfeature. Features on this list arespecified using the feature indexnumber that appears at the left ofthe feature list.
feature -index -remove
where index is the numberfor the feature at the leftof the feature listdisplayed by the featurecommand.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
144 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 36. feature command (continued)
Function What it does Command Valid targets
Import datacenterfeature licenses
Import a datacenter featurelicensing file for use by theBladeCenter unit.
The file name to import mustspecify a qualified location for thelicensing file that indicates theprotocol to be used. For example,tftp://192.168.0.1/license.csv
feature -applyfile_location
where file_location is aqualified location for thelicense file of up to 256characters in length thatindicates the protocol tobe used (tftp, ftp, ftps,http, or https) andcontains any characterexcept the percent sign (% ) or double-quote ( � ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Export datacenter featurelicenses
Export a BladeCenter featurelicensing file for use by otherBladeCenter units in the datacenter.
The file name to export mustspecify a qualified location for thelicensing file that indicates theprotocol to be used. For example,tftp://192.168.0.1/license.csvNote: While the licensing file isexporting, a string of periods willdisplay on the screen to indicateprogress; a new period beingadded every three seconds.
feature -retrievefile_location
where file_location is aqualified location for thelicense file of up to 256characters in length thatindicates the protocol tobe used (tftp, ftp, ftps,http, or https) andcontains any characterexcept the percent sign (% ) or double-quote ( � ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 145
Example: To view the feature list, while the BladeCenter unit is set as thepersistent command environment, at the system:> prompt, typefeature -T mm[1]
To remove the license for the first feature in the list, while the BladeCenter unit isset as the persistent command environment, at the system> prompt, typefeature -T mm[1] -1 -remove
To export a licensing file to the location tftp://10.11.20.23/IBMtest.csv, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typefeature -retrieve -T mm[1] tftp://10.11.20.23/IBMtest.csv
The following example shows the information that is returned from thesecommands:system> feature -T mm[1]1. IBM BladeCenter Open Fabric Manager-serial 2304369License Status: Activesystem> feature -T mm[1] -1 -removeOKsystem> feature -T mm[1]1. IBM BladeCenter Open Fabric ManagerLicense Status: No Licensesystem> feature -retrieve -T mm[1] tftp://10.11.20.23/IBMtest.csv................OKsystem>
146 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
files commandThis command manages files uploaded to the advanced management module.
Table 37. files command
Function What it does Command Valid targets
Display file list and freespace
Displays a list of files and spaceremaining in the advancedmanagement module file system.
files -T system:mm[x]
where x is the primarymanagement-modulebay number.
Delete file Deletes a file from the advancedmanagement module file system.Note: This command can only beused to delete files: it will notdelete directories.
files -d filename
where filename is a valid,existing filename of lessthan 256 characters inlength.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the files and remaining space in the management module filesystem, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typefiles
To delete the file tftproot/tftp_file.pkt from the management module filesystem, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typefiles -d tftproot/tftp_file.pkt
Chapter 3. Command reference 147
The following example shows the information that is returned from thesecommands:system:mm[1]> files
12288 Thu Jan 05 13:28:23 2006 lost+found/1024 Thu Jul 06 19:32:51 2006 tftproot/1024 Thu Jul 06 19:34:15 2006 tftproot/manu/1024 Thu Jul 06 19:34:15 2006 tftproot/manu/manu2/
0 Sat Aug 19 09:22:02 2006 tftproot/tftp_file.pkt0 Sun Oct 01 07:57:19 2006 tftproot/.Do_not_delete_this_directory0 Tue Dec 15 11:07:19 2009 test0 Thu Apr 13 23:45:40 2006 bob.pkt
1024 Tue Feb 02 15:29:17 2010 pubkeys/426 Tue Feb 02 15:29:17 2010 pubkeys/ssh_key.pub5652 Fri May 12 00:56:36 2006 asm.cfg
Total space: 73108480 bytesUsed: 24576 bytesAvailable: 73083904 bytessystem:mm[1]> files -d tftproot/tftp_file.pktOKsystem:mm[1]>
148 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
fuelg commandThis command displays power domain information, listing the power modules thatare installed in the BladeCenter unit and information about how the power in eachdomain is used. This command also configures the power domain policies forpower redundancy loss and limiting fan noise during thermal events.
Note: For scripting purposes, the -qm and -os fuelg options for managementmodules other than the advanced management module are supported by theadvanced management module.
Table 38. fuelg command
Function What it does Command Valid targets
Display power domainstatus overview
Displays health status, total powerusage, total dc power available,total ac power in use, thermalresponse (acoustic mode) settings,total thermal output in BTU/hour,and the polling intervals used fortrending for all power domains.Note: For the BladeCenter S unit,output will indicate whether thechassis is running in 220 V ac or110 V ac mode.
fuelg -T system
Display blade serverpower status overview
Displays the power managementand capping setting (on/off) andpower management capability forthe specified blade server.Depending on the powermanagement capability of thespecified blade server, thefollowing information will alsodisplay:v CPU duty cyclesv Effective and maximum CPU
speedsv Power capping value (minimum
and maximum)v Maximum, minimum, and
average power levelsv Time when above data was
capturedv Power saver mode status (on,
off)
fuelg -T system:blade[x]
where x is theblade-server baynumber.
Display I/O modulepower status
Displays the maximum, minimum,and average power information forthe specified I/O module.
fuelg -T system:switch[x]
where x is theI/O-module baynumber.
Display blower powerstatus and temperature
Displays the maximum power,minimum power, average power,and current temperatureinformation for the specifiedblower module.
fuelg -T system:blower[x]
where x is the blowerbay number.
Display media traytemperature
Displays the current temperaturefor the specified media tray.
fuelg -T system:mt[x]
where x is the mediatray number.
Chapter 3. Command reference 149
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Display detailed powerdomain status
Displays detailed status and usageinformation for the specified powerdomains, including the policysetting for that domain, themaximum power limit, and thepower in use. The valid states forcomponents in the domain are:v * - blade server might throttlev C - communication errorv D - discoveringv Hib - hibernatev NP - module is not presentv SB - standbyv T - throttledv U - unable to power up
Note: For the BladeCenter S,output will indicate whether thechassis is running in 220 V ac or110 V ac mode.
fuelg domain
where domain is:v pd1 for power domain 1.v pd2 for power domain 2.v If no domain is specified,
a status overview for allpower domains displays.
Note: The BladeCenter Sunit has only one powerdomain. Use either pd orpd1 to specify the powerdomain for theBladeCenter S unit.
-T system
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 domainredundancy loss policy
Sets how the BladeCenter unitresponds to a condition that couldcause a loss of redundant powNote: For the BladeCenter S,output will indicate whether thechassis is running in 220 V or 110V ac mode.er.
fuelg domain -pm policy
where:v domain is:
– pd1 for power domain1.
– pd2 for power domain2.
– If no domain isspecified, the policy isapplied to all powerdomains.
v policy of:– nonred (default)
allows loss ofredundancy.
– redwoperf preventscomponents fromturning on that willcause loss of powerredundancy.
– redwperf powerthrottles componentsto maintain powerredundancy andprevents componentsfrom turning on thatwill cause loss ofpower redundancy.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Display power trendingfor specified time periodand power domain
Displays power trendinginformation for the selected timeinterval and selected powerdomain for the BladeCenter unit.
fuelg domain -pt period
where:v domain is:
– pd1 for power domain1.
– pd2 for power domain2.
– If no domain isspecified, the period isapplied to all powerdomains.
v period is 1, 6, 12, or 24hours.
-T system
Chapter 3. Command reference 151
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Display power trendingfor specified time period
Displays power trendinginformation for the selected timeinterval for the specified commandtarget.
fuelg -pt period
where period is 1, 6, 12, or24 hours.
-T system
-T system:blade[x]
-T system:switch[x]
-T system:blower[x]
where x is the bladeserver, I/O module, orblower bay number.
Set power pollinginterval
Sets the amount of time betweenthermal and power samples thatare taken to build trending data.
fuelg -int interval
where interval is between10 and 60 minutes,inclusive, in 5-minuteincrements.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Display thermal trendingfor specified time period
Displays thermal trendinginformation for the selected timeinterval for the specified commandtarget.
fuelg -tt period
where period is 1, 6, 12, or24 hours.
-T system:mt[x]
-T system:blower[x]
where x is the bladeserver or blower baynumber.
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(acoustic mode)
Sets the acoustic mode ofBladeCenter-unit blowers responseto thermal events.
fuelg -am setting
where the acoustic-modesetting of:v off (default) allows
blowers to increasespeed to provideadditional cooling.
v on keeps blowers at afixed speed and powerthrottles BladeCentercomponents to reducepower consumption(only for BladeCentercomponents that supportpower throttling).
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Thermal event response(Telco environment)
Sets the Telco environment of theBladeCenter-unit blowers responseto thermal events.Note: When the environmentmode is set to nebs, the -am modeis automatically turned off.
fuelg -e environment
where the thermal-eventresponse environment of:v nebs allows blowers to
increase speed toprovide additionalcooling.
v enterprise allowsacoustic mode.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 153
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Set power capping valuefor blade server
Sets the power capping value for aspecified blade server that supportthis feature.Note: A blade server must beturned on before you can set itspower capping value.
fuelg -pcap setting
where the power cappingsetting is a numeric valuethat falls within the rangeof power capping valuesdisplayed when runningthe fuelg -T blade[x]command on a bladeserver.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Power management andcapping - enable ordisable for blade server
Turns power management andcapping for the specified bladeserver on or off.Note: A blade server must beturned on before you can enablepower management and cappingfor it.
fuelg -pme setting
where a setting of:v off (default) disables
power management andcapping for the bladeserver.
v on enables powermanagement andcapping for the bladeserver.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
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 savermode - enable or disablefor blade server
Turns the static low power savermode for the specified blade serveron or off.Notes:v A blade server must be turned
on before you can enable powersaver mode for it.
v Not all blade servers support thepower saver mode.
fuelg -ps setting
where a setting of:v off (default) disables
power saver mode forthe blade server.
v on enables power savermode for the bladeserver.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Dynamic poweroptimizer - enable ordisable for blade server
Turns dynamic power optimizer forthe specified blade server on or off.Notes:v A blade server must be turned
on before you can enabledynamic power optimizer for it.
v Not all blade servers support thedynamic power optimizer.
fuelg -dps setting
where a setting of:v off (default) disables
dynamic poweroptimizer for the bladeserver.
v on enables dynamicpower optimizer for theblade server.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Chapter 3. Command reference 155
Table 38. fuelg command (continued)
Function What it does Command Valid targets
Favor performance overpower - enable or disablefor blade server
Turns the favor performance overpower feature on or off for thespecified blade server.Notes:v A blade server must be turned
on before you can enable thefavor performance over powerfeature for it.
v Not all blade servers support thefavor performance over powerfeature.
v This feature can only be active ifthe dynamic power optimizer isenabled.
fuelg -fpop setting
where a setting of:v off (default) disables
favor performance overpower for the bladeserver.
v on enables favorperformance over powerfor the blade server.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Example: To view a power domain status overview, while the BladeCenter unit isset as the persistent command environment, at the system> prompt, typefuelg
To view the detailed power domain status for power domain 1, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typefuelg pd1
To view BladeCenter unit power trending information for the past 6 hours, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, typefuelg -pt 6
To view the power status for the blade server in blade bay 1, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typefuelg -T blade[1]
The following example shows the information that is returned from thesecommands when the fuelg command is run on an advanced management module.system> fuelgNote: All power values are displayed in Watts.
Total DC Power Available: 8000Total AC Power In Use: 1603 (+/- 16.0%)Total Thermal Output: 5469 BTU/hour
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: 3160Power Management Policy: Basic Power ManagementPower in Use: 1313 (+/- 16.0%)Total Power: 4000Allocated Power (Max): 1423Remaining Power: 2577
Power Domain 2--------------Status: Power domain status is good.Modules:Bay 3: 2880Bay 4: 2880Power Management Policy: Basic Power ManagementPower in Use: 73 (+/- 16.0%)Total Power: 4000Allocated Power (Max): 1082Remaining Power: 2918
-am on-e enterprise-int 10
system> fuelg pd1Maximum Power Limit: 1450Power In Use: 856
Power -- Allocated Power --Bay(s) Module State Current Max Min====== ============================= ===== ======= ===== =====Chassis Components
Midplane On 10 10 101 Media Tray 1 On 10 10 10
Chassis Cooling Devices1 Chassis Cooling Device 1 On 11 68 682 Chassis Cooling Device 2 On 11 68 683 Chassis Cooling Device 3 On 11 68 684 Chassis Cooling Device 4 On 11 68 68
Power Module Cooling Devices1 PM Cooling Device 1 On 10 10 102 PM Cooling Device 2 On 10 10 103 PM Cooling Device 3 On 10 10 104 PM Cooling Device 4 (NP) 0 10 10
Storage1 Storage Module 1 (NP) 0 120 1202 Storage Module 2 On 0 100 100
Management Module1 SN#YK168082H25F On 25 25 25
I/O Modules1 Ethernet SM On 45 45 452 Ethernet SM On 45 45 453 I/O Module 3 (NP) 0 45 454 Server Conn Mod On 45 45 45
Blades1 Maui A On 236 236 236
(100%,100%,100%,100%)2 LewisA1-LS21 (T) (CA) On 71 75 753 Lucas_55 (T) (CA) On 66 76 764 Mongoose-2 (T) (CA) On 108 127 1215 Crichton8 (T) (CA) On 99 109 1086 Mongoose-3 (T) (CA) On 142 34 34
Domain totals:Allocated Power 856 1414 1407
Note: (T) means "throttled", (U) means "unable to power up",* means "the blade may throttle", (NP) means "the module is not present",(D) means "discovering", (C) means "comm error", (SB) means "Standby"
Chapter 3. Command reference 157
(CA) means “capped max power allocation”
-pm nonred
system> fuelg -pt 6Date Time Avg Pwr-------- -------- -------07/17/07 08:09:44 293007/17/07 08:24:44 292607/17/07 08:39:48 291607/17/07 08:54:44 290607/17/07 09:09:44 292207/17/07 09:24:44 292607/17/07 09:39:44 292607/17/07 09:54:44 292607/17/07 10:09:44 291407/17/07 10:24:44 292807/17/07 10:39:48 293007/17/07 10:54:44 291407/17/07 11:09:43 276207/17/07 11:24:44 292407/17/07 11:39:44 292607/17/07 11:54:44 293207/17/07 12:09:44 292807/17/07 12:24:44 292207/17/07 12:39:43 276207/17/07 12:54:43 277207/17/07 13:09:43 277007/17/07 13:24:44 276607/17/07 13:39:44 276807/17/07 13:54:47 2926
system> fuelg -T blade[1]-pme offPM Capability: Dynamic Power Measurement with cappingEffective CPU Speed: 2955 MHzMaximum CPU Speed: 3000 MHz-pcap 190 (min: 174, max: 280)Maximum Power: 235Minimum Power: 199Average Power: 235Data captured at 07/17/07 13:59:05system>
158 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
groups commandThis command displays and configures Active Directory groups of the primarymanagement module. This group information is used only when LDAP servers areenabled for authentication with local authorization.
Table 39. groups (Active Directory groups) command
Function What it does Command Valid targets
Display all ActiveDirectory groups
Displays all Active Directorygroups, up to 16, configured for theBladeCenter unit.
groups -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display specific ActiveDirectory group
Displays information for thespecified Active Directory group.
groups -group_num
where group_num is anumber from 1 to 16,inclusive, that identifiesthe Active Directorygroup.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set Active Directorygroup name
Sets a name for the specified ActiveDirectory group.
groups -group_num -ngroup_name
where:v group_num is a number
from 1 to 16, inclusive,that identifies the ActiveDirectory group.
v group_name is aalphanumeric string upto 63 characters inlength that can includeperiods ( . ) andunderscores ( _ ). Eachof the 16 group namesmust be unique.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 159
Table 39. groups (Active Directory groups) command (continued)
Function What it does Command Valid targets
Set Active Directorygroup authority level
Sets the authority level for thespecified Active Directory group.
groups -group_num -agroup_authority
where:v group_num is a number
from 1 to 16, inclusive,that identifies the ActiveDirectory group.
v group_authority uses thefollowing syntax:– operator (Operator)– rbs:levels:scope
where the levels areone or more of thefollowing authoritylevels, separated by avertical bar ( | ):- super (Supervisor)- cam (Chassis User
AccountManagement)
- clm (Chassis LogManagement)
- co (ChassisOperator)
- cc (ChassisConfiguration)
- ca (ChassisAdministration)
- bo (BladeOperator)
- brp (Blade RemotePresent)
- bc (BladeConfiguration)
- ba (BladeAdministration)
- so (I/O ModuleOperator)
- sc (I/O ModuleConfiguration)
- sa (I/O ModuleAdministration)
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 Directorygroup authority level
(continued)
where the scope is one ormore of the followingdevices, separated by avertical bar ( | ). Rangesof devices are separatedby a dash ( - ).v cn (Chassis n, where n
is 1 for the ActiveDirectory environment.)
v bn (Blade n, where n isa valid blade baynumber in the chassis)
v sn (I/O module n,where n is a valid I/Omodule bay number inthe chassis)
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
Delete Active Directorygroup
Delete the specified ActiveDirectory group.
groups -group_num -clear
where group_num is anumber from 1 to 16,inclusive, that identifiesthe Active Directorygroup.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 161
Example: To create Active Directory group number 3 with a group name of group3that has supervisor rights to all BladeCenter components, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typegroups -3 -n group3 -a rbs:super:c1|b1-b14|s1-s4
To display information for group3, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typegroups -3
The following example shows the information that is returned from thesecommands:system:mm[1]> groups -3 -n group3 -a rbs:super:c1|b1-b14|s1-s4OKsystem:mm[1]> groups -3-n group3-a Role:supervisor
Blades:1|2|3|4|5|6|7|8|9|10|11|12|13|14Chassis:1Modules:1|2|3|4
system:mm[1]>
162 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
health commandThis command displays the current health status of the command target. It canalso 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 statusof the command target. Returnvalues are different for theBladeCenter and BladeCenter Tconfigurations.v Possible return values for the
BladeCenter configuration are:– ok– warning– critical
v Possible return values for theBladeCenter T configurations are:– ok– minor– major– critical
health -T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
-T system:storagex](for BladeCenterS units)
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, blower bay, orstorage bay number.
Display health status fortree
Displays the current health statusof the tree structure of devicespresent in the BladeCenter unit,starting at the command targetlevel. If management-module baysare part of the tree, they will beidentified as primary or standby(redundant). Return values aredifferent for the BladeCenter andBladeCenter T configurations.v Possible return values for the
BladeCenter configuration are:– ok– warning– critical
v Possible return values for theBladeCenter T configurations are:– ok– minor– major– critical
health -l depth
where depth
v 1 displays health statusof the current commandtarget
v 2, all, or a displays afull tree display, startingat the command targetlevel
-T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Chapter 3. Command reference 163
Table 40. health command (continued)
Function What it does Command Valid targets
Display health statusand alerts
Displays the current health statusand active alerts for the commandtarget. Return values are differentfor the BladeCenter andBladeCenter T configurations.v Possible return values for the
health status of the BladeCenterconfiguration are:– ok– warning– critical
v Possible return values for thehealth status of the BladeCenterT configurations are:– ok– minor– major– critical
v Active alert information providesshort text descriptions of alertsthat are active for eachmonitored component.
The total amount of informationreturned from the health -fcommand is limited to 1024 bytes.
health -f -T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Display results withtimestamp
(BladeCenter E unitsonly)
Adds display of timestampinformation to status commandoutput.
health -tNote: The -t option mustbe used with the -f option.
-T system
-T system:mm[x]
-T system:blade[x]
-T system:switch[x]
-T system:power[x]
-T system:blower[x]
where x is the primarymanagement-module,blade server, I/Omodule, powermodule, or blower baynumber.
Example: To display the overall health status of the BladeCenter T unit, while theBladeCenter T unit is set as the default command target, at the system> prompt,typehealth
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 defaultcommand target, at the system> prompt, typehealth -l a
To display the health status of the blade server installed in blade bay 5, while theBladeCenter T unit is set as the default command target, at the system> prompt,typehealth -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 theBladeCenter T unit, that are valid command targets, while the BladeCenter T unitis set as the default command target, at the system> prompt, typehealth -l a -f
The following example shows the information that is returned from thesecommands:system> healthsystem:majorsystem> health -l asystem: Major
mm[1] : OKblade[1] : OKblade[3] : OKblade[5] : Minorpower[1] : OKpower[2] : Minorblower[1] : OKblower[2] : OKblower[3] : OKblower[4] : OKswitch[1] : Major
system> health -T system:blade[5]system: blade[5] : Minorsystem> health -l a -fsystem: Major
blade[5] : Minor5V over voltageCPU1 temperature warningpower[2] : Minor5V over voltageswitch[1] : Majortemperature fault
system>
Chapter 3. Command reference 165
help commandThis command displays a list of all commands that are available in thecommand-line interface with a brief description of each command.
You can also issue the help command by typing ?. Adding a -h, -help, or ? optionto 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 abrief description of each command.
help Any installed device.
? Any installed device.
Example: To display a list of commands, while the advanced management modulein bay 1 is set as the default command target, at the system:mm[1]> prompt, typehelp
The following example shows the information that is returned:system> help
? -- Display commandsaccseccfg -- View/edit account security config
advfailover -- View/edit advanced failover modealertcfg -- Displays/Configures the global remote alert settings
alertentries -- View/edit remote alert recipientsautoftp -- View/Edit auto ftp/tftp settingbaydata -- View/edit Blade Bay Data string
bofm -- Apply new BOFM configurationboot -- Boot target
bootmode -- Boot modebootseq -- View/edit the blade boot sequence settings
buildidcfg -- View/Edit the Blade Firmware Build ID Listchconfig -- View/edit Service Advisor Settings
chlog -- Display Service Advisor Activity Log entireschmanual -- Manually generate call home request
cin -- Displays/Configures Chassis Internal Networkcinstatus -- Displays Status of Chassis Internal Network
clear -- Clear the configclearlog -- Clear the event log
clock -- View/edit date, time, GMT offset, and dst settingconfig -- View/edit general settingsconsole -- Start SOL session to a bladedhcpinfo -- View DHCP server assigned settings
displaylog -- Display log entriesdisplaysd -- Display service data
dns -- View/edit DNS configenv -- Set persistent command target
ethoverusb -- View/edit the status of a blade SP’s interface on Ethernet-over-USBeventinfo -- Display event description and user action
events -- View/edit Events configexit -- Log off
feature -- View/edit licensed featuresfiles -- Displays and deletes files stored on the AMMfuelg -- Power managementgroups -- View/edit Active Directory groupshealth -- View system health status
help -- Display command listhistory -- Display command historyidentify -- Control target location LEDifconfig -- View/edit network interface config
info -- Display identity and config of targetiocomp -- View I/O compatibility for blades and switches
kvm -- Controls the kvm owner
166 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ldapcfg -- View/edit LDAP configled -- Display and control Ledslist -- Display installed targetsmcad -- Displays and configures MCAD
modactlog -- Displays module activity logmonalerts -- Displays and configures monitored alerts
mt -- Controls the media tray ownernat -- Display and configure NATntp -- View/edit NTP configping -- Pings targeted switch module
pmpolicy -- View/edit power management policy settingsportcfg -- Serial port configuration
ports -- Port configurationpower -- Control target powerrdoc -- Controls the remote DiskOnCardread -- Restore configuration from the chassis or a file
remotechassis -- Chassis discovered over the networkreset -- Reset targetscale -- Display and configure the settings of scalable complexessddump -- Initiate service data dumpsdemail -- Send service information using emailsecurity -- View/edit security configservice -- Enable debugging by service personnelshutdown -- Shutdown target
slp -- View/edit SLP parameterssmtp -- View/edit SMTP configsnmp -- View/edit SNMP configsol -- View SOL status and view/edit SOL config
sshcfg -- View/edit SSH configsslcfg -- View/edit SSL configsyslog -- View/edit syslog config
tcpcmdmode -- View/edit TCP command mode configtelnetcfg -- View/edit telnet config
temps -- View temperaturestrespass -- View/edit trespassing warning config
uicfg -- View/edit user interface configurationupdate -- Update firmware from remote locationuplink -- View/edit failover on network uplink loss configusers -- View/edit user login profilesvolts -- View voltageswrite -- Save configuration to chassis or a local file
zonecfg -- Zone configuration for I/O modules
Type "Type "<command> -h" for individual command syntax help.[ ] is used for indexing (by bay number)< > denotes a variable{ } denotes optional arguments| denotes choice
system>
To obtain help about the env command, type one of the following commands:v env -hv env -helpv env ?
Chapter 3. Command reference 167
history commandThis command displays the last eight commands that were entered, allowing theuser to choose and re-enter one of these commands.
You choose the command to re-enter from the displayed list by typing anexclamation point (!) followed immediately by the numeric designation thecommand is assigned in the list. You can also recall one of the past eightpreviously 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 commandsthat were entered.
history Any installed device.
Re-enter previouscommand using numericdesignation
Re-enters a numerically-specifiedcommand from the commandhistory.
!x
where x is the number ofthe command (0 - 7) tore-enter from thecommand history list.
Any installed device.
Example: To display a list of the last eight commands entered, while managementmodule 1 is set as the default command target, at the system:mm[1]> prompt, typehistory
To re-enter the command designated by "2" in the command history, type!2
The following example shows the information that is returned from these twocommands:system:mm[1]> history0 dns1 dns -on2 dns3 dns -i1 192.168.70.294 dns5 dns -i1 192.168.70.29 -on6 dns7 historysystem:mm[1]> !2Enabled-i1 192.168.70.29-i2 0.0.0.0-i3 0.0.0.0system:mm[1]>
168 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
identify (location LED) commandThis command controls operation of the location LED in a blade server or in theBladeCenter 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 LEDstate
Displays the current state of thelocation LED in the commandtarget.
Possible LED states are:v offv onv blink
identify -T system
-T system:blade[x]
where x is the bladebay number.
Set location LED state Sets the state of the location LED inthe command target.
identify -s state
where state isv onv offv blink
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
(for BladeCenter unit)v Blade configuration (for
blade server)
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:blade[x]
where x is the bladebay number.
Turn on BladeCenterunit location LED forspecified period of time
Turns on the location LED in theBladeCenter unit for a specifiedperiod of time before turning it offautomatically.
identify -s on -d time
where time is the numberof seconds the locationLED will remain lit.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 169
Example: To display the status of the location LED in the blade server in blade bay4, while the BladeCenter unit is set as the persistent command environment, at thesystem> prompt, typeidentify -T system:blade[4]
To light the location LED in the blade server in blade bay 4, while the BladeCenterunit is set as the persistent command environment, at the system> prompt, typeidentify -s on -T system:blade[4]
The following example shows the information that is returned from a series ofidentify commands:system> identify -T system:blade[4]-s offsystem> identify -s on -T system:blade[4]OKsystem> identify -T system:blade[4]-s onsystem>
170 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ifconfig commandThis command configures and displays the network interface settings for themanagement-module Ethernet interface, I/O-module Ethernet interface, and theblade server integrated system management processors and installed options.
Table 44. ifconfig command
Function What it does Command Valid targets
Display primarymanagement moduleEthernet channel 0configuration
Displays the current configurationof Ethernet channel 0 for theprimary management module.Possible return values are:v enabledv disabledv -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 hostnamev -c config_methodv -r data_ratev -d duplex_modev -m mtuv -l locally_administered_mac_addrv -b burnedin_mac_addressv -dn domain_namev -ipv6 ipv6_statev -ipv6static static_ipv6_statev -i6 static_ip_address (IPv6 format)v -p6 address_prefix_lengthv -g6 gateway-default_routev -dhcp6 dhcpv6_statev -sa6 ipv6_stateless_autoconfig_state
If IPv6 is enabled, the link-localaddress link_local_address (for IPv6connection) also displays.
If IPv6 and statelessauto-configuration (-sa6) are bothenabled, the Stateless auto-config IPAddresses / Prefix Lengthaddress_table (table listingauto-generated IPv6 addresses andtheir prefix lengths) also displays.
ifconfig -eth0 -T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 171
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Display standbymanagement moduleEthernet channel 0configuration
Displays the current configurationof Ethernet channel 0 for thestandby management module.Note: This option does not applyto the BladeCenter S unit.Possiblereturn values are:v enabledv disabledv -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 hostnamev -c config_methodv -r data_ratev -d duplex_modev -m mtuv -l locally_administered_mac_addrv -b burnedin_mac_addressv -dn domain_namev -ipv6 ipv6_statev -ipv6static static_ipv6_statev -i6 static_ip_address (IPv6 format)v -p6 address_prefix_lengthv -g6 gateway-default_routev -dhcp6 dhcpv6_statev -sa6 ipv6_stateless_autoconfig_state
If IPv6 is enabled, the link-localaddress link_local_address (for IPv6connection) also displays.
If IPv6 and statelessauto-configuration (-sa6) are bothenabled, the Stateless auto-config IPAddresses / Prefix Lengthaddress_table (table listingauto-generated IPv6 addresses andtheir prefix lengths) also displays.
ifconfig -eth0 -o -T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command displaysinformation for thestandby managementmodule, it still mustspecify the primarymanagement moduleas the command target.
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 moduleEthernet channel 0 staticIP address (IPv4)
Sets the IPv4 static IP address forEthernet channel 0 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -iip_address
where ip_address is thestatic IP address forEthernet channel 0 indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 0 staticIP address (IPv6)
Sets the IPv6 static IP address forEthernet channel 0 for themanagement module.
ifconfig -eth0 -i6ip_address
where ip_address is thestatic IP address forEthernet channel 0 in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set standby managementmodule Ethernet channel0 static IP address (IPv4)
Sets the IPv4 static IP address forEthernet channel 0 for the standbymanagement module.Note: This option does not applyto the BladeCenter S unit.
ifconfig -eth0 -o -iip_address
where ip_address is thestatic IP address forEthernet channel 0 indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command displaysinformation for thestandby managementmodule, it still mustspecify the primarymanagement moduleas the command target.
Chapter 3. Command reference 173
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set standby managementmodule Ethernet channel0 static IP address (IPv6)
Sets the IPv6 static IP address forEthernet channel 0 for the standbymanagement module.Note: This option does not applyto the BladeCenter S unit.
ifconfig -eth0 -o -i6ip_address
where ip_address is thestatic IP address forEthernet channel 0 in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command displaysinformation for thestandby managementmodule, it still mustspecify the primarymanagement moduleas the command target.
Set management moduleEthernet channel 0gateway IP address(IPv4)
Sets the IPv4 gateway IP addressfor Ethernet channel 0 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -gip_address
where ip_address is thegateway IP address forEthernet channel 0 indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 0gateway/default route(IPv6)
Sets the IPv6 gateway/defaultroute for Ethernet channel 0 for themanagement module.
ifconfig -eth0 -g6ip_address
where ip_address is thegateway/default route forEthernet channel 0 in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 moduleEthernet channel 0subnet mask (IPv4)
Sets the IPv4 subnet mask forEthernet channel 0 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -ssub_mask
where sub_mask is thesubnet mask for Ethernetchannel 0 in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 0hostname
Sets the host name for Ethernetchannel 0 for the managementmodule.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -nhostname
where hostname is the hostname for Ethernet channel0. The hostname can be astring up to 63 charactersin length that includesalphanumeric characters,hyphens, and underscores.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 175
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set standby managementmodule Ethernet channel0 hostname
Sets the host name for Ethernetchannel 0 for the standbymanagement module.Note: This option does not applyto the BladeCenter S unit.
ifconfig -eth0 -o -nhostname
where hostname is the hostname for Ethernet channel0. The hostname can be astring up to 63 charactersin length that includesalphanumeric characters,hyphens, and underscores.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command displaysinformation for thestandby managementmodule, it still mustspecify the primarymanagement moduleas the command target.
Set management moduleEthernet channel 0configuration method
Sets the configuration method forEthernet channel 0 for themanagement module.
A value of dthens will try theDHCP configuration and default tothe static IP configuration if DHCPis unsuccessful after 2 minutes.Note:v If the management module
DHCP setting is set to try theDHCP server and then use thestatic IP address, themanagement module will use thestatic IP address when the DHCPserver is not available duringmanagement module start up.When this occurs, the IP addressmight not be reachable ifmultiple management moduleswere started with the same staticIP address.
v Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of theprimary management module.
ifconfig -eth0 -cconfig_method
where config_method isv dhcpv staticv dthens
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 moduleEthernet channel 0 datarate
Sets the data rate for Ethernetchannel 0 for the managementmodule.
ifconfig -eth0 -rdata_rate
where data_rate isv autov 10v 100
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 0duplex mode
Sets the duplex mode for Ethernetchannel 0 for the managementmodule.
ifconfig -eth0 -dduplex_mode
where duplex_mode isv autov halfv full
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 0 MTU
Sets the MTU (maximumtransmission unit) for Ethernetchannel 0 for the managementmodule.
ifconfig -eth0 -m mtu
where mtu is between 60and 1500, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 177
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management moduleEthernet channel 0 staticMAC address (locallyadministered)
Sets the locally administered MACaddress to the specified MACaddress for Ethernet channel 0 forthe management module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -l address
where address is the locallyadministered MACaddress for Ethernetchannel 0. The MACaddress is 6 bytes inlength, hexadecimal,separated by colons. TheMAC address can not be amulticast address (the firstbyte must be even).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the standbymanagement-modulebay number.
Set standby managementmodule Ethernet channel0 static MAC address(locally administered)
Sets the locally administered MACaddress to the specified MACaddress for Ethernet channel 0 forthe standby management module.Note: This option is not availableon the BladeCenter S.
ifconfig -eth0 -o -laddress
where address is the locallyadministered MACaddress for Ethernetchannel 0. The MACaddress is 6 bytes inlength, hexadecimal,separated by colons. TheMAC address can not be amulticast address (the firstbyte must be even).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command displaysinformation for thestandby managementmodule, it still mustspecify the primarymanagement moduleas the command target.
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 moduleEthernet channel 0domain name
Sets the domain name for Ethernetchannel 0 for Ethernet channel 0 forthe management module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth0 -dndomain
where domain is analphanumeric string up to127 characters in length.The domain name mustcontain at least one dot (.).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable IPv6addressing formanagement moduleEthernet channel 0
Enable or disable IPv6 addressingfor Ethernet channel 0 for themanagement module.
ifconfig -eth0 -ipv6state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable staticIPv6 configuration formanagement moduleEthernet channel 0
Enable or disable static IPv6configuration for Ethernet channel0 for the management module.
ifconfig -eth0-ipv6static state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 179
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management moduleEthernet channel 0address prefix length
Sets the IPv6 address prefix lengthfor Ethernet channel 0 for themanagement module.
ifconfig -eth0 -p6 length
where length is between 1and 128 (inclusive).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disableDHCPv6 formanagement moduleEthernet channel 0
Enable or disable static DHCPv6for Ethernet channel 0 for themanagement module.
ifconfig -eth0 -dhcp6state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable IPv6statelessauto-configuration formanagement module forEthernet channel 0
Enable or disable IPv6 statelessauto-configuration for Ethernetchannel 0 for the managementmodule.
ifconfig -eth0 -sa6 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
180 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Display primarymanagement moduleEthernet channel 1configuration
Displays the current configurationof Ethernet channel 1 for theprimary management module.Possible return values are:v up (enabled)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_ratev -d duplex_modev -m mtuv -l locally_administered_mac_addrv -b burnedin_mac_address
ifconfig -eth1 -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 1 staticIP address (IPv4)
Sets the static IP address (IPv4) forEthernet channel 1 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth1 -iip_address
where ip_address is thestatic IP address forEthernet channel 1 indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 1gateway IP address(IPv4)
Sets the gateway IP address (IPv4)for Ethernet channel 1 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth1 -gip_address
where ip_address is thegateway IP address forEthernet channel 1 indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 181
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set management moduleEthernet channel 1subnet mask (IPv4)
Sets the subnet mask (IPv4) forEthernet channel 1 for themanagement module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth1 -ssub_mask
where sub_mask is thesubnet mask for Ethernetchannel 1 in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 1 datarate
Sets the data rate for Ethernetchannel 1 for the managementmodule.
ifconfig -eth1 -rdata_rate
where data_rate isv autov 10v 100
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 1duplex mode
Sets the duplex mode for Ethernetchannel 1 for the managementmodule.
ifconfig -eth1 -dduplex_mode
where duplex_mode isv autov halfv full
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 moduleEthernet channel 1 MTU
Sets the MTU (maximumtransmission unit) for Ethernetchannel 1 for the managementmodule.
ifconfig -eth1 -m mtu
where mtu is between 60and 1500, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduleEthernet channel 1 staticMAC address (locallyadministered)
Sets the locally administered MACaddress to the specified MACaddress for Ethernet channel 1 forthe management module.Note: Changes made to the IPconfiguration of the primarymanagement module take effectafter the next reset of the primarymanagement module.
ifconfig -eth1 -l address
where address is the locallyadministered MACaddress for Ethernetchannel 1. The MACaddress is 6 bytes inlength, hexadecimal,separated by colons. TheMAC address can not be amulticast address (the firstbyte must be even).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the standbymanagement-modulebay number.
Enable managementmodule Ethernet channel1
Enables the Ethernet channel 1interface for the managementmodule.
ifconfig -eth1 -up
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 183
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Disable managementmodule Ethernet channel1
Disables the Ethernet channel 1interface for the managementmodule.
ifconfig -eth1 -down
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display cKVM andnetwork configurationstatus for blade server
Displays the cKVM status andnetwork status for the specifiedblade server.v Valid cKVM states include:
– Enabled– Disabled
v If the blade server supportsnetwork configuration, thiscommand also displays the NICnumbers (such as -eth0 and-eth1), NIC states (up or down),and other NIC configurationinformation for the blade serverand all network cards connectedto the blade server.
ifconfig -T system:blade[x]
where x is theblade-server baynumber.
Display networkconfigurationinformation for networkcard
Displays the NIC number (such as-eth0 and -eth1), NIC state (up ordown), and other NICconfiguration information for thespecified network card in thespecified blade server.
ifconfig -ethx
where x is the NICnumber.
-T system:blade[x]
where x is theblade-server baynumber.
Set I/O module for bladeserver managementtraffic
Sets the I/O module that will beused to route management trafficfor the specified blade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -eth1 -i IO_bay
where IO_bay is the baynumber of the I/Omodule that should beused to route managementtraffic.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
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 cKVMfeature for blade server
Enable or disable cKVM feature forthe specified blade server.Note: The cKVM feature requiresspecial hardware and is notavailable for all blade servers.
ifconfig -ckvm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server Ethernetchannel static IP address(IPv4)
Sets the IPv4 static IP address forthe specified Ethernet channel ofthe specified blade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -iip_address
where:v x is the NIC number.v ip_address is the static IP
address for Ethernetchannel x in dotteddecimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Chapter 3. Command reference 185
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set blade server Ethernetchannel static IP address(IPv6)
Sets the IPv6 static IP address forthe specified Ethernet channel ofthe specified blade server.Note:v This command will run only if
the target blade server supportsmanual IPv6 configuration of itsmanagement network interface.
v A static IPv6 configuration ID isrequired for network interfacesthat support more than one staticconfiguation.
ifconfig -ethx -i6ip_address -id id
where:v x is the NIC number.v ip_address is the static IP
address for Ethernetchannel x in IPv6format.
v id is the static IPv6configuration ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server Ethernetchannel gateway IPaddress (IPv4)
Sets the IPv4 gateway IP addressfor the specified Ethernet channelof the specified blade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -gip_address
where:v x is the NIC number.v ip_address is the
gateway IP address forEthernet channel x indotted decimal IPaddress format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
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 Ethernetchannel gateway/defaultroute (IPv6)
Sets the IPv6 gateway/defaultroute for the specified Ethernetchannel of the specified bladeserver.Note:v This command will run only if
the target blade server supportsmanual IPv6 configuration of itsmanagement network interface..
v A static IPv6 configuration ID isrequired for network interfacesthat support more than one staticconfiguation.
ifconfig -ethx -g6ip_address -id id
where:v x is the NIC number.v ip_address is the
gateway/default routefor Ethernet channel xin IPv6 format.
v id is the static IPv6configuration ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server Ethernetchannel subnet mask(IPv4)
Sets the IPv4 subnet mask for thespecified Ethernet channel of thespecified blade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -ssub_mask
where:v x is the NIC number.v sub_mask is the subnet
mask for Ethernetchannel x in dotteddecimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Chapter 3. Command reference 187
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set blade server Ethernetchannel configurationmethod
Sets the configuration method forthe specified Ethernet channel ofthe specified blade server.
A value of dthens will try theDHCP configuration and default tothe static IP configuration if DHCPis unsuccessful after 2 minutes.Note:v This command will run only if
the target blade server supportsmanual configuration of itsmanagement network interface.
v If the DHCP setting is set to trythe DHCP server and then usethe static IP address, the NICwill use the static IP addresswhen the DHCP server is notavailable during start up. Whenthis occurs, the IP address mightnot be reachable if multipledevices were started with thesame static IP address.
v Blade servers based on thePower PC chip, including theJS12 and JS22, only support thestatic and DHCP options.
ifconfig -ethx -cconfig_method
where:v x is the NIC number.v config_method is
– dhcp– static– dthens
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set management moduleEthernet channel VLANID
Sets the VLAN ID for the specifiedEthernet channel of the specifiedblade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -v vlan_id
where:v x is the NIC number.v vlan_id is from 1 to
4095, inclusive. If youenter a value outsidethis range, an error willbe displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
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 serverEthernet channel VLANID
Enables or disables the VLAN IDfor the specified Ethernet channelof the specified blade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -ve state
where:v x is the NIC number.v state is enable or
disable.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server Ethernetchannel hostname
Sets the host name for the specifiedEthernet channel of the specifiedblade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -nhostname
where:v x is the NIC number.v hostname is the host
name. The hostnamecan be a string up to 63characters in length thatincludes alphanumericcharacters, hyphens,and underscores.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Enable blade serverEthernet channel
Enables the specified Ethernetchannel interface of the specifiedblade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -up
where x is the NICnumber.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Chapter 3. Command reference 189
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Disable blade serverEthernet channel
Disables the specified Ethernetchannel interface of the specifiedblade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -ethx -down
where x is the NICnumber.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Enable / disable IPv6addressing for bladeserver
Enable or disable IPv6 addressingfor the specified Ethernet channelinterface of the specified bladeserver.Note: This command will run onlyif the target blade server supportsmanual IPv6 configuration of itsmanagement network interface.
ifconfig -ethx -ipv6state
where:v x is the NIC number.v state is enabled or
disabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server addressprefix length
Sets the IPv6 address prefix lengthfor the specified Ethernet channelinterface of the specified bladeserver.Note:v This command will run only if
the target blade server supportsmanual IPv6 configuration of itsmanagement network interface.
v A static IPv6 configuration ID isrequired for network interfacesthat support more than one staticconfiguation.
ifconfig -ethx -p6 length-id id
where:v x is the NIC number.v length is between 1 and
128 (inclusive).v id is the static IPv6
configuration ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
190 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disableDHCPv6 for bladeserver
Enable or disable static DHCPv6for the specified Ethernet channelinterface of the specified bladeserver.Note: This command will run onlyif the target blade server supportsmanual IPv6 configuration of itsmanagement network interface.
ifconfig -ethx -dhcp6state
where:v x is the NIC number.v state is enabled or
disabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Enable / disable IPv6statelessauto-configuration forblade server
Enable or disable IPv6 statelessauto-configuration for the specifiedEthernet channel interface of thespecified blade server.Note: This command will run onlyif the target blade server supportsmanual IPv6 configuration of itsmanagement network interface.
ifconfig -ethx -sa6 state
where:v x is the NIC number.v state is enabled or
disabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is theblade-server baynumber.
Set blade server ISMPstatic IP address (IPv4)
Sets the IPv4 static IP address forthe integrated system managementprocessor (ISMP) of the specifiedblade server.Note: This command will run onlyif the target blade server supportsmanual configuration of itsmanagement network interface.
ifconfig -i ip_address
where ip_address is thestatic IP address for theblade server ISMP indotted decimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]:sp
where x is theblade-server baynumber.
Chapter 3. Command reference 191
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Display network settingsfor BladeCenter unit
Displays network settings for theBladeCenter unit. Valid returnvalues are:v -v VLAN-idv -maxv enabled/disabled
ifconfig -T system
Enable / disablemultiple video sessionsfor blade servers
Set state to allow only a singleremote video session or allow up tofour remote video sessions for eachblade server.
ifconfig -maxv state
where state is enabled(allow multiple videosessions) or disabled(allow only one videosession).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
VLAN ID forBladeCenter unit
Sets the VLAN ID for theBladeCenter unit.
ifconfig -v VLAN-id
where VLAN-id is from 1to 4095, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Set state for BladeCenterunit VLAN ID
Enables or disables the VLAN IDfor the BladeCenter unit.
ifconfig -ve state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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 globalcKVM feature forBladeCenter unit
Enable or disable cKVM featureglobally for the BladeCenter unit.(This is the same as running theifconfig -ckvm enable commanddirected to each blade server.)Note: The cKVM feature requiresspecial hardware and is notavailable for all blade servers.
ifconfig -ckvm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Display network settingsfor I/O module
Displays network settings for thespecified I/O module. Valid returnvalues are:v I/O-module typev -i ip_address (dotted decimal IPv4
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_statusv -ep ext_port_statusv -pm enabled/disabled (protected
mode)v -pip enabled/disabledv -c config_methodv -ipv6 ipv6_statev -ipv6static static_ipv6_statev -i6 static_ip_address (IPv6 format)v -p6 address_prefix_length (IPv6
format)v -g6 gateway-default_route (IPv6
format)v -dhcp6 dhcpv6_statev -sa6 ipv6_stateless_autoconfig_state
If IPv6 is enabled, the link-localaddress link_local_address (for IPv6connection) also displays.
If IPv6 and statelessauto-configuration (-sa6) are bothenabled, the Stateless auto-config IPAddresses / Prefix Lengthaddress_table (table listingauto-generated IPv6 addresses andtheir prefix lengths) also displays.
ifconfig -T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 193
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set starting IP addressfor I/O module (IPv4)
Sets the IPv4 IP addresses for thespecified I/O module.
ifconfig -i ip_address
where ip_address is the IPaddress of the specifiedI/O module in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Set starting IP addressfor I/O module (IPv6)
Sets the IPv6 static IP address forthe specified I/O module.
ifconfig -i6 ip_address
where ip_address is thestatic IP address for thespecified I/O module inIPv6 format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Set I/O-module gatewayIP address (IPv4)
Sets the gateway IPv4 IP addressfor the specified I/O module.
ifconfig -g ip_address
where ip_address is thegateway IP address for theI/O module in dotteddecimal IP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
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 gatewayIP address (IPv6)
Sets the IPv6 gateway/defaultroute for the specified I/O module.
ifconfig -g6 ip_address
where ip_address is thegateway IP address for theI/O module in IPv6format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Keep new IP addressconfiguration forI/O-module after reset
Retains a new IP addressconfiguration after the specifiedI/O module is reset.Note: Make sure a valid NewStatic IP Configuration is enteredfor this I/O module so that whenthe module's factory defaults arerestored, or when a reset isinitiated by a source other than themanagement module, the NewStatic IP Configuration will beconfigured. In these casesmanagement modulecommunication with the I/Omodule will be preserved.
ifconfig -pip enabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Revert to old IP addressconfiguration forI/O-module after reset
Reverts IP address to oldconfiguration after the specifiedI/O module is reset.Note: The factory default IPconfiguration will become activewhen the I/O module is reset tofactory defaults by either themanagement module or the I/Omodule. If an I/O module reset isinitiated by a source other than themanagement module, then theprevious IP configuration will be inaffect. In both of these cases themanagement module will lose IPcommunications with the I/Omodule.
ifconfig -pip disabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 195
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set I/O-module subnetmask (IPv4)
Sets the IPv4 subnet mask for thespecified I/O module.
ifconfig -s sub_mask
where sub_mask is thesubnet mask for the I/Omodule in dotted decimalIP address format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disable externalmanagement for I/Omodule
Enables or disables externalmanagement on all ports for thespecified I/O module.
ifconfig -em state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disable externalports for I/O module
Enables or disables external portsfor the specified I/O module.
ifconfig -ep state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
196 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Enable / disableprotected mode for I/Omodule
Enables or disables protected modefor the specified I/O module.
ifconfig -pm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disable IPv6addressing for I/Omodule
Enable or disable IPv6 addressingfor the specified I/O module.
ifconfig -ipv6 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disable staticIPv6 configuration forI/O module
Enable or disable static IPv6configuration for the specified I/Omodule.
ifconfig -ipv6staticstate
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 197
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set I/O module addressprefix length
Sets the IPv6 address prefix lengthfor the specified I/O module.
ifconfig -p6 length
where length is between 1and 128 (inclusive).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disableDHCPv6 for I/O module
Enable or disable static DHCPv6for the specified I/O module.
ifconfig -dhcp6 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Enable / disable IPv6statelessauto-configuration forI/O module
Enable or disable IPv6 statelessauto-configuration for the specifiedI/O module.
ifconfig -sa6 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
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 forRAID controller andSAS system (IPv4)
(BladeCenter S unitsonly)
Sets IPv4 IP addresses for RAIDcontroller and SAS system.
ifconfig -i ip_address_a-ir ip_address_b
wherev ip_address_a is the IP
address of the specifiedSAS system in dotteddecimal IP addressformat.
v ip_address_b is the IPaddress of theassociated RAIDcontroller in dotteddecimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the RAIDcontroller bay number.
Set gateway IP addressesfor RAID controller andSAS system (IPv4)
(BladeCenter S unitsonly)
Sets the IPv4 gateway IP addressesfor RAID controller and SASsystem.
ifconfig -g ip_address_a-gr ip_address_b
wherev ip_address_a is the
gateway IP address ofthe specified SASsystem in dotteddecimal IP addressformat.
v ip_address_b is thegateway IP address ofthe associated RAIDcontroller in dotteddecimal IP addressformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the RAIDcontroller bay number.
Chapter 3. Command reference 199
Table 44. ifconfig command (continued)
Function What it does Command Valid targets
Set subnet masks forRAID controller andSAS system (IPv4)
(BladeCenter S unitsonly)
Sets the IPv4 subnet masks for theRAID controller and SAS system.
ifconfig -s sub_mask_a-sr sub_mask_b
wherev sub_mask_a is the subnet
mask of the specifiedSAS system in dotteddecimal IP addressformat.
v sub_mask_b is the subnetmask of the associatedRAID controller indotted decimal IPaddress format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the RAIDcontroller bay number.
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 thesystem:mm[1]> prompt, typeifconfig -eth0
To set the IPv4 static IP address for Ethernet channel 0 to 192.168.70.133, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeifconfig -eth0 -i 192.168.70.133 -c static
To set the IPv4 IP addresses for the BladeCenter S SAS subsystem to 9.186.10.16and the IPv4 IP address for the RAID controller to 9.186.10.17, while switchmodule 3 is set as the persistent command environment, at the system:switch[3]>prompt, typeifconfig -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.1and the IPv4 gateway address for the RAID controller to 9.186.11.1, while switchmodule 3 is set as the persistent command environment, at the system:switch[3]>prompt, typeifconfig -g 9.186.10.1 -gr 9.186.11.1
The following example shows the information that is returned from thesecommands:system:mm[1]> ifconfig -eth0Enabled-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:80system:mm[1]> ifconfig -eth0 -i 192.168.70.133 -c staticChanges 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.17OKsystem:switch[3]>ifconfig -g 9.186.10.1 -gr 9.186.11.1OKsystem:mm[1]>
To display the configuration for Ethernet channel 0, that supports IPv6, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeifconfig -eth0
The following example shows the information that is returned from thesecommands:system:mm[1]> ifconfig -eth0Enabled-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 enabledLink-local address: fe80::214:5eff:fedf:fceStateless auto-config IP Addresses Prefix Length--------------------------------------- -------------
Chapter 3. Command reference 201
2000:1013::214:5eff:fedf:fce 642001:1013::214:5eff:fedf:fce 642002:1013::214:5eff:fedf:fce 64system:mm[1]>
202 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
info (configuration information) commandThis command displays information about BladeCenter components and theirconfiguration, and how to reload the component information.
Table 45. info (configuration information) command
Function What it does Command Valid targets
Display componentinformation
Displays identification andconfiguration information for thecommand target.
info
Note: Only one target at atime can be viewed withthe info command.
-T system
-T system:mm[x]
-T system:blade[x]
-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]
(continued on next page)
Chapter 3. Command reference 203
Table 45. info (configuration information) command (continued)
Function What it does Command Valid targets
Display componentinformation
(continued)
where:
v x is themanagement-modulebay number, bladeserver bay number,I/O-module baynumber,microprocessornumber, power modulebay number,media-tray baynumber, storage baynumber , ordaughter-card number.
v y or z is the:
– blade server storageexpansion unitnumber (be).
– blade server I/Oexpansion cardnumber (exp).
– microprocessornumber (CPU).
– memory DIMMnumber.
– high-speedexpansion cardnumber (hsec).
– battery backup unitnumber (bbu).
– disk drive number(disk).
Display managementchannel pathinformation
Displays the management channelpath information for theBladeCenter unit.
info -path -T system
Reload componentinformation forfirmware
Reloads vital product data (VPD)for firmware.
info -reload fw -T system
Reload componentinformation forhardware
Reloads vital product data (VPD)for hardware.
info -reload hw -T system
Reload information onMAC addresses
Reloads vital product data (VPD)for MAC addresses.
info -reload mac -T system
Reload WWN andGUID information
Reloads vital product data (VPD)for world-wide name (WWN) andglobally-unique identifier (GUID).
info -reload wwn -T system
Reload all componentinformation
Forces reload of all VPD andMAC address information.
info -reload all -T system
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 breakbefore the :exp[y]. When this command target is entered, the entire entry mustall be on one line.
2. This command returns vital product data (VPD) information that is unique foreach command target. For some targets, additional VPD information isavailable 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 thecorresponding category; for example, all MAC addresses are reloaded for alltargets when the command is info -reload mac with system:blade[x] as thetarget.
Example: To view the information about an advanced management module inmanagement-module bay 1, while this management module is set as the persistentcommand environment, at the system:mm[1]> prompt, typeinfo
The following example shows the information that might be returned from the infocommand:system:mm[1]> info
Name: AMM_KPManufacturer: Not Available (Not Available)Manufacturer ID: 288Product ID: 1Mach type/model: Management ModuleMach serial number: Not AvailableManuf date: 3005Hardware rev: 51Part no.: 26R099000000FRU no.: 25R5777FRU serial no.: 0J1U9E584130CLEI: Not AvailableAMM firmware
Build ID: BPET30UFile name: CNETCMUS.PKTRel date: 08-09-07Rev: 30
AMM firmware (Flashed - pending restart)Build ID: BPET30xFile name: CNETCMUS.PKTRel date: 09-09-08Rev: 30
system:mm[1]>
Chapter 3. Command reference 205
iocomp commandThis command displays the compatibility between all blade servers and their I/Omodules. It can also display detailed interface information for an individual bladeserver or I/O module.
Table 46. iocomp command
Function What it does Command Valid targets
Display compatibilitybetween all blade serversand I/O modules
Displays I/O module compatibilityinformation for all blade serversand I/O modules.
iocomp -T system
Display blade servercompatibility details
Displays detailed I/O modulecompatibility information for thespecified blade server.
iocomp -T system:blade[x]
where x is the bladeserver bay number.
Display I/O modulecompatibility details
Displays detailed compatibilityinformation for the specified I/Omodule.
iocomp -T system:switch[x]
where x is theI/O-module baynumber.
Example: To view I/O module compatibility information for all blade servers andI/O modules, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typeiocomp -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 thesystem:mm[1]> prompt, typeiocomp -T system:blade[1]
To view I/O module compatibility information for the I/O module in bay 2, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeiocomp -T system:switch[2]
The following example shows the information that is returned from thesecommands:system:mm[1]> iocomp -T systemBlades1 xPert1 OK2 xPert2 OK3 Development OK4 Marketing OK5 xpert3 OK6 Sales OK7 xPert4 OK9 xPert5 OK11 Finance OK12 HR OK13 xPert6 OK14 xPert7 OK
I/O Modules1 OK2 OK3 OK4 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 OKIOM 2 On Ethernet Switch Module Ethernet OKsystem:mm[1]> iocomp -T system:switch[1]
Bay Power Fabric Type Compat---------- ------- -------------- ----------Blade 1 On Ethernet OKBlade 2 On Ethernet OKBlade 3 On Ethernet OKBlade 4 On Ethernet OKBlade 5 Off Ethernet OKBlade 6 On Ethernet OKBlade 7 On Ethernet OK
n/a No FabricBlade 9 On Ethernet OK
Ethernet OKBlade 11 On Ethernet OKBlade 12 On Ethernet OKBlade 13 On Ethernet OKBlade 14 On Ethernet OKsystem:mm[1]>
Chapter 3. Command reference 207
kvm (keyboard, video, mouse) commandThis command sets and displays the blade server that is in control of theBladeCenter unit shared KVM.
Table 47. kvm command
Function What it does Command Valid targets
Display KVM owner Displays the number of the bladeserver that has KVM ownershipand the global local KVMswitching state for all blade servers.A blade server that occupies morethan one blade bay is identified bythe lowest bay number that itoccupies. A return value of 0indicates that no owner is set.
kvm -T system
Set KVM owner Sets a blade server as the KVMowner.
kvm -b blade_server
where blade_server is theblade-bay number thatidentifies the blade server.A blade server thatoccupies more than oneblade bay is identified bythe lowest bay numberthat it occupies. A settingof 0 sets no owner.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Enable / disable localKVM switching globally
Enable or disable local KVMswitching globally for all bladeservers.
kvm -local state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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 managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typekvm -T system -b 1
To display the KVM owner and global local KVM switching state for all bladeservers, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typekvm -T system
The following example shows the information that is returned from these twocommands:system:mm[1]> kvm -T system -b 1OKsystem:mm[1]> kvm -T system-b 1-local enabledsystem:mm[1]>
Chapter 3. Command reference 209
ldapcfg commandThis command sets and displays the LDAP configuration settings for the advancedmanagement module.
Table 48. ldapcfg command
Function What it does Command Valid targets
Display LDAP settings Displays the LDAP settings for themanagement module.
ldapcfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP securityversion
Sets version of LDAP security usedby the management module.
ldapcfg -v version
where version is:v v1 for old user
permission modelv v2 for the enhanced
role-based securitymodel
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP name Sets the LDAP name for themanagement module.Note: For an LDAP name to beused, LDAP security must be set tov2 using the -v command option.
ldapcfg -t name
where name is analphanumeric string up to63 characters in lengthcontaining any characterexcept for angle brackets (< and > ) and spaces.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 serverdiscovery method
Sets the method to use fordiscovering LDAP servers thatprovide user authentication.Note:v If the dns method is specified,
the following values must alsobe set:– A domain source using the
-ds command option.– A service name using the -sn
command option.– A search domain must be set
using the -sd commandoption.
v If the preconf method isspecified, the following valuesmust also be set:– An LDAP server hostname or
IP address using the -i1, -i2,and -i3 command options.
– A port for each LDAP serverhostname or IP address usingthe -p1, -p2, and -p3command options.
ldapcfg -server method
where method is:v dns for dynamic
discoveryv preconf to use an LDAP
server that wasmanuallypre-configured
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP server domainname
Sets the search domain to use forDomain Controller (DC) dynamicdiscovery.
ldapcfg -dn domain
where domain is analphanumeric string up to31 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP server forestname
Sets the forest name to use forGlobal Catalog (GC) dynamicdiscovery.
ldapcfg -fn forestname
where forestname is analphanumeric string up to63 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 211
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
First LDAP server hostname or IP address - set
Checks syntax and sets the firstLDAP server host name or IPaddress to use for pre-configuredLDAP server discovery.Note: A port for this LDAP serverhostname or IP address must be setusing the -p1 command option.
ldapcfg -i1hostname/ip_address
where hostname/ip_addressis the first host name or IPaddress.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Second LDAP serverhost name or IP address- set
Checks syntax and sets the secondLDAP server host name or IPaddress to use for pre-configuredLDAP server discovery.Note: A port for this LDAP serverhostname or IP address must be setusing the -p2 command option.
ldapcfg -i2hostname/ip_address
where hostname/ip_addressis the second host name orIP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Third LDAP server hostname or IP address - set
Checks syntax and sets the thirdLDAP server host name or IPaddress to use for pre-configuredLDAP server discovery.Note: A port for this LDAP serverhostname or IP address must be setusing the -p3 command option.
ldapcfg -i3hostname/ip_address
where hostname/ip_addressis the third host name orIP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay 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 hostname or IP address - set
Checks syntax and sets the fourthLDAP server host name or IPaddress to use for pre-configuredLDAP server discovery.Note: A port for this LDAP serverhostname or IP address must be setusing the -p4 command option.
ldapcfg -i4hostname/ip_address
where hostname/ip_addressis the fourth host name orIP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
First LDAP server portnumber - set
Sets the port number of the firstLDAP server to use forpre-configured LDAP serverdiscovery.
ldapcfg -p1 port
where port is from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Second LDAP serverport number - set
Sets the port number of the secondLDAP server to use forpre-configured LDAP serverdiscovery.
ldapcfg -p2 port
where port is from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 213
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Third LDAP server portnumber - set
Sets the port number of the thirdLDAP server to use forpreconfigured LDAP serverdiscovery.
ldapcfg -p3 port
where port is from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Fourth LDAP server portnumber - set
Sets the port number of the fourthLDAP server to use forpreconfigured LDAP serverdiscovery.
ldapcfg -p4 port
where port is from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP rootdistinguished name
Sets the root distinguished namefor the root entry of the LDAPdirectory tree that is used as thebase object for all searches.
ldapcfg -rd "name"
where "name" is up to 63characters in length andcontained withindouble-quotes. Names cancontain any character,including spaces.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 searchattribute
Sets the UID search attribute thatrepresents the user IDs stored onthe LDAP server.
On Active Directory servers, theUID search attribute is typically setto "sAMAccountName". On NovelleDirectory and OpenLDAP servers,it is typically set to "uid".
ldapcfg -usa "UID"
where "UID" is up to 23characters in length andcontained withindouble-quotes. The UIDcan contain only letters,numbers, spaces, and thefollowing characters: "-","(", ")", "+", ",", ".", "/", ":",and"?".
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP serverbinding method
Sets the binding method for initialconnection to the LDAP server.Note:v If the binding method is set to
anon, a UID search attributemust be set using the -usacommand option.
v If the binding method is set tocc, the following values mustalso be set:– A UID search attribute using
the -usa command option– A client distinguished name
using the -cd commandoption.
– A client password using the-p and -cp command options.
ldapcfg -bm version
where version is:v anon for anonymousv cc for configured
credentialsv lc for login credentials
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP server to beused for authenticationonly
Enables the authentication mode touse the LDAP server forauthentication only with localauthorization. This automaticallydisables the authentication modethat uses the LDAP Server for bothauthentication and authorization.
LDAP server authentication usesthe settings configured by the“groups command” on page 159.
ldapcfg -aom state
where state is enabled ordisabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 215
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Set LDAP clientdistinguished name
Sets the client distinguished name(DN) for initial connection to theLDAP server.Note: A client password must alsobe set using the -p and -cpcommand options.
ldapcfg -cd domain
where domain is analphanumeric string up to63 characters in lengthcontaining any characterexcept for angle brackets (< and > ) and spaces.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP clientdistinguished namepassword
Sets the client distinguished namepassword for initial connection tothe LDAP server.Note: The passwords must bespecified by both the -p and -cpcommand options and must match.
ldapcfg -p password
where password is analphanumeric string up to15 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set (confirm) LDAPclient distinguishedname password
Sets, for confirmation purposes, theclient distinguished name passwordfor initial connection to the LDAPserver.Note: The passwords must bespecified by both the -p and -cpcommand options and must match.
ldapcfg -cp password
where password is analphanumeric string up to15 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 themanagement module that can beused for authentication duringLDAP server login.
ldapcfg -gf "filter"
where "filter" is aquote-delimited string ofup to 511 characters inlength and consists of oneor more group names. Thecolon (:) character is usedto delimit multiple groupnames. Leading spacesand trailing spaces areignored. Other spaces aretreated as part of thegroup name. The wildcardcharacter (*) is notsupported for securityreasons. A group namecan be specified as a fulldomain name or by usingthe common name (cn)portion.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set LDAP group searchattribute
Sets the group search attribute thatrepresents groups of user IDsstored on the LDAP server.
On Active Directory servers, thegroup search attribute is typicallyset to "memberOf". On eDirectoryservers, it is typically set to"groupMembership".
In an OpenLDAP serverenvironment, users are typicallyassigned to groups whoseobjectClass equals "PosixGroup". Inthis case, the group search attributeidentifies members of a particularPosixGroup that is typically"memberUid".
ldapcfg -gsa "GSA"
where "GSA" is aquote-delimitedalphanumeric string of upto 23 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 217
Table 48. ldapcfg command (continued)
Function What it does Command Valid targets
Set LDAP loginpermission attribute
Sets the login permission attributethat is used to determine retrieveuser permissions on the LDAPserver.
ldapcfg -lpa "permission"
where "permission" is aquote-delimitedalphanumeric string up to23 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Note: The -ds, -sd, and -sn options for the ldapcfg command have been deletedand replaced by the -dn and -fn command options. To implement this transition,the items specified for dynamic discovery have changed and must be modified tomatch the syntax required by the new command options.
Example:
To display the management module LDAP settings, while management module 1is set as the persistent command environment, at the system:mm[1]> prompt, typeldapcfg
To enable the authentication mode to use the LDAP server for authentication onlywith local authorization, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typeldapcfg -aom enabled
The following example shows the information that is returned from these twocommands:system:mm[1]> ldapcfg-server preconfParameters 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 v1Parameters for ’-v v1’ configuration:
-gf-gsa-lpa
Parameters for ’-v v2’ configuration:-t
system:mm[1]> ldapcfg -aom enabledOKsystem:mm[1]>
Chapter 3. Command reference 219
led commandThis command displays and sets the LED states for a specified command target, ifthis command target supports the LED.
Table 49. led command
Function What it does Command Valid targets
Display various LEDstates
Displays various LED states. Valuesreturned are:v status of all LEDs on the target
blade and its subcomponentsv status of info LEDv status of location LED
(on/off/blink)v status of the identification LED
of the system for a specifiednumber of seconds
led -T system
-T system:blade[x]
where x is the bladeserver number.
Display state forfanpack fault LED
Displays the state of the fan packfault LED of the BladeCenter HTunit.
led -T system:power[x]
where x is the powermodule (fanpack)number.
Display state for blowerfault LED
Displays the state of the blowerfault LED of the BladeCenter HTunit.
led -T system:blower[x]
where x is the blowernumber.
Display front panel LEDstate for blade server
Displays the state of the front panelLEDs on the specified blade server.
led -T system:blade[x]
where x is the bladeserver number.
Display external portlink status LED state forI/O module
Displays state of the external andinternal port link status LEDs forthe specified I/O module.
led -T system:switch[x]
where x is the I/Omodule (switch) baynumber.
Display fault LED state
(for BladeCenter HTunits only)
Displays the state of the fault LEDfor the specified command target.Possible return values are:v The state of the requested LED is
onv The state of the requested LED is
off
led -e -T system:tap
-T system:ncc[x]
-T system:mux[x]
-T system:mt[x]
where x is the alarmpanel module, networkclock module,multiplexer expansionmodule, or media traynumber.
Display safe-to-removeLED state
(for BladeCenter HTunits only)
Displays the state of thesafe-to-remove LED, that is on theBladeCenter unit and somecomponents, for the specifiedcommand target. Possible returnvalues are:v onv off
led -r -T system:tap
-T system:ncc[x]
-T system:mux[x]
where x is the alarmpanel module, networkclock module, ormultiplexer expansionmodule.
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 forblade server and allsub-components
Displays the state of all LEDs onthe specified blade server and itssubcomponents. Possible returnvalues are:
v on
v off
v blink
led -l -T system:blade[x]
where x is the bladeserver number.
Turn off informationLED
Turns off the information LED, thatis on the BladeCenter unit andsome components, for the specifiedcommand target
led -info off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management (forBladeCenter unit,network clock module,multiplexer expansionmodule, or media tray)
v Chassis logmanagement (forBladeCenter unit,network clock module,multiplexer expansionmodule, or media tray)
v Chassis administration(for BladeCenter unit,network clock module,multiplexer expansionmodule, or media tray)
v Chassis configuration(for BladeCenter unit,network clock module,multiplexer expansionmodule, or media tray)
v Blade administration(for blade server)
v Blade configuration (forblade server)
v Blade remote presence(for blade server)
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:blade[x]
-T system:ncc[x] (forBladeCenter HT unitsonly)
-T system:mux[x] (forBladeCenter HT unitsonly)
-T system:mt[x]
where x is the bladeserver, network clockmodule, multiplexerexpansion module, ormedia tray number.
Chapter 3. Command reference 221
Table 49. led command (continued)
Function What it does Command Valid targets
Set location LED state Sets the state of the location LED,that is on the BladeCenter unit andsome blade servers, for thecommand target.
led -loc state
where state isv onv offv blink
Note: A state of blink canonly be used for the -Tsystem command targetand for the blade servers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management (forBladeCenter unit)
v Chassis logmanagement (forBladeCenter unit)
v Chassis administration(for BladeCenter unit)
v Chassis configuration(for BladeCenter unit)
v Blade administration(for blade server)
v Blade configuration (forblade server)
v Blade remote presence(for blade server)
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:blade[x]
where x is the bladebay number.
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 LEDfor specified period oftime
Turns on the location LED, that ison the BladeCenter unit and someblade servers, for a specified periodof time before turning it offautomatically.
led -loc on -d time
where time is the numberof seconds the locationLED will remain lit.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example: To display the failure LED status for the blade server in bay 1, while theBladeCenter HT unit is set as the persistent command environment, at the system>prompt, typeled -T system:blade[1]
To display status of the front-panel LEDs for the blade server in bay 1, while theBladeCenter HT unit is set as the persistent command environment, at the system>prompt, typeled -T blade[1]
To display status of all LEDs for the blade server in bay 1, while the BladeCenterHT unit is set as the persistent command environment, at the system> prompt,typeled -l -T blade[1]
The following example shows the information that is returned from thesecommands:system> led -T blade[1]hs21_345678Error: offInformation: offKVM: offMT: offLocation: blinksystem> led -T blade[1] -lComponent Label State LocationProcessor1 CPU1 Off System boardProcessor2 CPU2 Off System boardBlade1 Fault Off Front panelBlade2 Information Off Front panelBlade3 Location Blink Front panelBlade4 Power On Front panel
KVM Off Front panelBlade5 Media Tray Off Front panel
Chapter 3. Command reference 223
Blade7 Over Temp Off System boardBlade8 N/A Off System boardBlade1 N/A Off System boardStorage1 DASD1 Off System boardMemory1 DIMM1 Off System boardMemory2 DIMM2 Off System boardMemory3 DIMM3 Off System boardMemory4 DIMM4 Off System boardMemory5 DIMM5 Off System boardMemory6 DIMM6 Off System boardMemory7 DIMM7 Off System boardMemory8 DIMM8 Off System boardPanel1 N/A Off System boardExpansion1 N/A Off FRU
N/A Off FRUExpansion2 N/A Off FRU
N/A Off FRUN/A Off FRUN/A Off FRU
Expansion3 N/A Off FRUsystem>
224 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
list (system physical configuration) commandThis command displays a list of devices present within the command target. It canbe used to determine how many management modules are installed in theBladeCenter 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 commandtarget. If a management-modulebay is the current command target,it will be identified as primary orstandby (redundant).
list Any installed device.
View systemconfiguration tree
Displays the tree structure ofdevices present in the BladeCenterunit, starting at the commandtarget level. If management-modulebays are part of the tree, they willbe identified as primary or standby(redundant). For components thathave been assigned a name, thisname will be displayed next to thecomponent bay number.
list -l depth
where depth isv all or a for full tree
display, starting at thecommand target level
v 1 to display the currentcommand target
v 2 displays the content ofthe current commandtarget plus one levelbelow it
Any installed device.
Example: To display a list of devices installed in the BladeCenter unit, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typelist -l a
(This is the command syntax that can be used to determine the primarymanagement module.)
The following example shows the information that is returned when the commandis run on an advanced management module:system> list -l asystem
mm[1] primarymm[2] standbypower[1]power[2]power[3]power[4]blower[1]blower[2]switch[1]switch[2]switch[3]switch[4]blade[1] Accounting
spcpu[1]cpu[2]
blade[2] HRspcpu[1]cpu[2]
blade[3] Developmentsp
Chapter 3. Command reference 225
cpu[1]blade[4] Marketing
spckvmcpu[1]cpu[2]
blade[5] Salesspcpu[1]cpu[2]
blade[6] TechSupportspexp[2]cpu[1]cpu[3]cpu[4]
mt[1]system>
Note: The BladeCenter S unit supports one management module. The listcommand for this unit does not refer to primary and standby managementmodules.
226 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
mcad commandThis command configures and displays the auto-discovery setting for theBladeCenter unit management channel.
Note: See the BladeCenter Advanced Management Module User's Guide for additionalinformation about management channel auto discovery.
Table 51. mcad command
Function What it does Command Valid targets
Display managementchannel auto-discoverystatus for BladeCenterunit
Displays the auto-discovery settingfor the BladeCenter unitmanagement channel. Valid statesinclude:v Enabledv Disabled
mcad -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablemanagement channelauto-discovery forBladeCenter unit
Enable or disable managementchannel auto-discovery for theBladeCenter unit.
mcad -e state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To display the auto-discovery setting for the BladeCenter unit managementchannel, while the BladeCenter unit is set as the persistent command environment,at the system> prompt, typemcad -T mm[1]
To enable management channel auto-discovery for the BladeCenter unit, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typemcad -T mm[1] -e enabled
The following example shows the information that is returned from thesecommands:system> mcad -T mm[1]-e disabledsystem> mcad -T mm[1] -e enabledOKsystem>
Chapter 3. Command reference 227
modactlog commandThis command displays information about modules installed in all of the bladeservers.
Table 52. modactlog command
Function What it does Command Valid targets
Display blade servermodule information andactivity
Displays a list of modules installedin all blade servers, along withtheir activity and VPD information.
modactlog -T system
Example: To view the list of modules installed in all blade servers, along with theiractivity and VPD information, while the BladeCenter unit is set as the defaultcommand target, at the system> prompt, typemodactlog
The following example shows the information that is returned from this command:system> modactlogBay Name FRU Number FRU Serial No Manuf. ID Action Timestamp--- ----------------------------- ------------ ------------- --------- ------- -------------------14 Fibre Channel Expansion Card 59P6624 J1RJH3CY18N SLRM Added 15:51:18 02/09/200711 cKVM card 13N0842 YK328064418F IBM Added 15:51:07 02/09/2007system>
Note: The BladeCenter S unit will also display information about the Direct SerialAttach Module and the storage modules.
228 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
monalerts commandThis command displays and configures alerts that are monitored by the advancedmanagement module.
Important: The monalertsleg command is no longer supported by the advancedmanagement module firmware. Legacy alert monitoring that uses the monalertslegcommand must transition to use of the monalerts command. Existing legacy alertsettings are automatically mapped to the new alert categories as part of thetransition.
Table 53. monalerts command
Function What it does Command Valid targets
Display monitored alertstates
Displays the state of all alerts beingmonitored by the managementmodule.
monalerts -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set state for enhancedlegacy alert categories
Enables enhanced legacy alertcategories.v If enhanced legacy alert
categories are enabled, alerts areconfigured using the monalertscommand.
v If enhanced legacy alertcategories can not be disabledonce they have been enabled.
monalerts -ec state
where state is enabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forall critical alerts
Enables or disables monitoring ofall critical alerts.
monalerts -ca state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 229
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state forblade device criticalalerts
Enables or disables monitoring ofblade device critical alerts.
monalerts -cb state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forI/O-module critical alerts
Enables or disables monitoring ofI/O-module critical alerts.
monalerts -ciom state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forstorage-module criticalalerts
(BladeCenter S unitsonly)
Enables or disables monitoring ofstorage-module critical alerts.
monalerts -cstg state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 forchassis or systemmanagement criticalalerts
Enables or disables monitoring ofchassis or system managementcritical alerts.
monalerts -ccsm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forcooling device criticalalerts
Enables or disables monitoring ofcooling device critical alerts.
monalerts -ccd state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forpower module criticalalerts
Enables or disables monitoring ofpower module critical alerts.
monalerts -cpm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 231
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state forall warning alerts
Enables or disables monitoring ofall warning alerts.
monalerts -wa state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forblade device warningalerts
Enables or disables monitoring ofblade device warning alerts.
monalerts -wb state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forI/O-module warningalerts
Enables or disables monitoring ofI/O-module warning alerts.
monalerts -wiom state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 forstorage-module warningalerts
(BladeCenter S unitsonly)
Enables or disables monitoring ofstorage-module warning alerts.
monalerts -wstg state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forchassis or systemmanagement warningalerts
Enables or disables monitoring ofchassis or system managementwarning alerts.
monalerts -wcsm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forevent log warning alerts
Enables or disables monitoring ofevent log warning alerts.
monalerts -wel state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 233
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state forcooling device warningalerts
Enables or disables monitoring ofcooling device warning alerts.
monalerts -wcd state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forpower module warningalerts
Enables or disables monitoring ofpower module warning alerts.
monalerts -wpm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forall informational alerts
Enables or disables monitoring ofall informational alerts.
monalerts -ia state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 forblade deviceinformational alerts
Enables or disables monitoring ofblade device informational alerts.
monalerts -ib state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forI/O-moduleinformational alerts
Enables or disables monitoring ofI/O-module informational alerts.
monalerts -iiom state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forstorage-moduleinformational alerts
(BladeCenter S unitsonly)
Enables or disables monitoring ofstorage-module informationalalerts.
monalerts -istg state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 235
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state forchassis or systemmanagementinformational alerts
Enables or disables monitoring ofchassis or system managementinformational alerts.
monalerts -icsm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forpower stateinformational alerts
Enables or disables monitoring ofpower state (on/off) informationalalerts.
monalerts -ipon state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forinventory changeinformational alerts
Enables or disables monitoring ofinventory change (installedcomponents) informational alerts.
monalerts -iinv state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 forevent log informationalalerts
Enables or disables monitoring ofevent log informational alerts.
monalerts -iel state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state fornetwork changeinformational alerts
Enables or disables monitoring ofnetwork change informationalalerts.
monalerts -inc state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state foruser activityinformational alerts
Enables or disables monitoring ofuser activity informational alerts.
monalerts -iua state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 237
Table 53. monalerts command (continued)
Function What it does Command Valid targets
Set monitoring state forcooling deviceinformational alerts
Enables or disables monitoring ofcooling device informational alerts.
monalerts -icd state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set monitoring state forpower moduleinformational alerts
Enables or disables monitoring ofpower module informational alerts.
monalerts -ipm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To enable monitoring of all critical alerts and event log warning alertsand disable monitoring of all informational alerts, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typemonalerts -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 disabledOKsystem:mm[1]>
238 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
mt (media tray) commandThis command sets and displays the blade server that is in control of theBladeCenter unit shared media tray.
Table 54. mt command
Function What it does Command Valid targets
Display media trayowner
Displays the number of the bladeserver that has media trayownership and the global local andremote media tray switching statesfor all blade servers. A blade serverthat occupies more than one bladebay is identified by the lowest baynumber that it occupies. A returnvalue of 0 indicates that no owneris set.
mt -T system
Set media tray owner Sets a blade server as the mediatray owner.
mt -b blade_server
where blade_server is theblade bay that identifiesthe blade server. A bladeserver that occupies morethan one blade bay isidentified by the lowestbay number that itoccupies. A setting of 0sets no owner.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system
Enable / disable localmedia tray switchingglobally
Enable or disable local media trayswitching globally for all bladeservers.
mt -local state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 239
Table 54. mt command (continued)
Function What it does Command Valid targets
Enable / disable remotemedia tray switchingglobally
Enable or disable remote mediatray switching globally for all bladeservers.
mt -remote state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Example:
To set the media tray owner to the blade server in blade bay 1, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typemt -T system -b 1
To display the media tray owner and the global local and remote media trayswitching states for all blade servers, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typemt -T system
The following example shows the information that is returned from these twocommands:system:mm[1]> mt -T system -b 1OKsystem:mm[1]> mt -T system-b 1-local enabled-remote enabledsystem:mm[1]>
240 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
nat commandThis command sets and displays the network address table (NAT) settings for thespecified I/O module.
Notes:
1. If the nat command is directed to an I/O module that does not support thenetwork address table, the "NAT configuration is not supported on this I/Omodule" message is returned.
2. When setting values for an empty row in the network address table, all optionsmust be specified together using a single command.
Table 55. nat command
Function What it does Command Valid targets
Display I/O-modulenetwork protocolsettings
Displays the network port settingsfor the specified I/O module.Returned values include those inTable 56 on page 244.
nat -T system:switch[x]
where x is theI/O-module baynumber.
Reset I/O-modulenetwork protocolsettings
Resets all network address tablesettings for the specified I/Omodule to the default values.Default values are in Table 56 onpage 244.
You must activate any changes tothe network protocol settingsbefore they take effect.
nat -reset
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Activate I/O-modulenetwork protocolsettings
Activates all network port settingsfor the specified I/O module,putting them into effect.
nat -activate
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 241
Table 55. nat command (continued)
Function What it does Command Valid targets
Set protocol name forrow in I/O-module NATtable
Sets a protocol name for thespecified row in the NAT table forthe specified I/O module.
nat -index -pnprotocol_name
where:v index is a number from
1 to 10 that correspondsto a row in the NATtable.
v protocol_name is a textstring with a maximumlength of 19 charactersand no spaces.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Set protocol ID for rowin NAT table
Sets a protocol ID for the specifiedrow in the NAT table for thespecified I/O module.
nat -index -pi protocol_id
where:v index is a number from
1 to 10 that correspondsto a row in the NATtable.
v protocol_id is TCP orUDP.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
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 numberfor row in NAT table
Sets the internal port number forthe specified row in the NAT tablefor the specified I/O module.
nat -index -ipport_number
where:v index is a number from
1 to 10 that correspondsto a row in the NATtable.
v port_number is between1 and 65534, inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Set external port numberfor row in NAT table
Sets the external port number forthe specified row in the NAT tablefor the specified I/O module.
nat -index -ep port_number
where:v index is a number from
1 to 10 that correspondsto a row in the NATtable.
v port_number is between1000 and 65534,inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 243
Table 55. nat command (continued)
Function What it does Command Valid targets
Set state for row in NATtable
Enables or disables the specifiedrow in the NAT table for thespecified I/O module.
nat -index -en state
where:v index is a number from
1 to 10 that correspondsto a row in the NATtable.
v state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Table 56. Default NAT table values for nat command
IndexProtocolName Protocol ID Internal Port External Port State
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
6 through 10 Unset
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 thesystem:switch[3]> prompt, typenat
The following example shows the information that is returned from this command:system:switch[3]> natIndex Protocol Name Protocol ID Internal Port External Port Enabled1 HTTP TCP 80 1080 enabled2 TELNET TCP 23 1023 enabled3 HTTPS TCP 43 1043 enabled4 SSH TCP 22 1022 enabled5 SNMP UDP 161 1161 enabledsystem:switch[3]>
244 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
ntp (network time protocol) commandThis command configures and displays the management-module network timeprotocol (NTP) settings.
Table 57. ntp command
Function What it does Command Valid targets
Display managementmodule NTP settings
Displays the NTP settings for thespecified I/O module. Possiblereturn values are:v -en state (enabled, disabled)v -i ipaddress/hostname (IP address
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)
ntp -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable NTP Enables or disables NTP for themanagement-module.
ntp -en state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
NTP server IP address orhostname - set
Checks syntax and sets the IPaddress or hostname of the NTPserver.
ntp -i ipaddress/hostname
where ipaddress/hostname isthe IP address orhostname of the NTPserver.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 245
Table 57. ntp command (continued)
Function What it does Command Valid targets
NTP update frequency -set
Sets how often the managementmodule clock is automaticallyupdated by the NTP server.
ntp -f time
where time is the NTPupdate frequency, inminutes with a maximumvalue of 45000.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
NTP - Enable / disableV3 authentication
Enables or disables V3authentication between themanagement-module and the NTPserver.Note: The NTP serverauthentication key must be set,using the ntp -v3 command option,before enabling V3 authentication.
ntp -v3en state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
NTP serverauthentication key - set
Sets the v3 authentication key thatthe management module uses toaccess the NTP server. Theauthentication key contains thefollowing values:v Key index: An NTP server can be
configured with one or more keyentries. The key index specifieswhich key the server expects theclient to authenticate with.
v Key type: The advancedmanagement module supportsonly the MD5 key type.
v Key: The key is an 8-characterASCII string.
ntp -v3 key_index key_typekey
where:v key_index is from 1 to
65535, inclusive. If youenter a value outsidethis range, an error willbe displayed.
v key_type is M (MD5).v key is a 8-character
ASCII string.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 themanagement-module clock with theNTP server. (You must configure avalid NTP server before you cansynchronize.)
ntp -synch
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To display NTP settings for the management module, while management module 2is set as the persistent command environment, at the system:mm[2]> prompt, typentp
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 configuredNTP is disabled.system:mm[2]>
Chapter 3. Command reference 247
ping commandThis command tests the internal communication path between the advancedmanagement module and a BladeCenter component by sending it a ping request.
Table 58. ping command
Function What it does Command Valid targets
Display I/O module IPaddresses
Displays a list of IP addresses forthe specified I/O module.
ping -i
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisor,v Operator (general
operator, not chassisoperator)
v I/O moduleadministration,
v I/O moduleconfiguration
v I/O module operator
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Ping IP address Pings the specified IP address totest communication between it andthe management module.Note: This command testscommunication paths, including IPaddresses outside of theBladeCenter unit.
ping -i ip_address
where ip_address is the IPaddress for a componentinstalled in theBladeCenter unit.
All users can attempt toping a specific IP address.
This command willattempt to ping thespecified IP address,regardless of commandtarget, including IPaddresses outside ofthe BladeCenter unit.
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 IPaddress
Pings the specified IP address of anI/O module to test communication.
ping -i index
where index is the indexnumber for theI/O-module IP address toping. Use the ping -icommand, with noarguments, to list availableIP addresses and theirindex numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisor,v Operator (general
operator, not chassisoperator)
v I/O moduleadministration,
v I/O moduleconfiguration
v I/O module operator
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Example: To display list of IP addresses for the I/O module in bay 1, while theBladeCenter unit is set as the persistent command environment, at the system>prompt, typeping -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 thesystem> prompt, typeping -i 1 -T switch[1]
To ping the first IP address of the I/O module in bay 1 using an IP address, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, typeping -i 10.13.3.171
Chapter 3. Command reference 249
The following example shows the information that is returned from thesecommands:system> ping -i -T switch[1]1. 10.13.3.1712. FE80:0000:0000:0000:0218:B1FF:FE9F:9000system> ping -i 1 -T switch[1]Reply from 10.13.3.171: bytes=64 time=4.150msReply from 10.13.3.171: bytes=64 time=0.392msReply from 10.13.3.171: bytes=64 time=0.400msReply from 10.13.3.171: bytes=64 time=0.389mssystem> ping -i 10.13.3.171Reply from 10.13.3.171: bytes=64 time=0.418msReply from 10.13.3.171: bytes=64 time=0.417msReply from 10.13.3.171: bytes=64 time=0.362msReply from 10.13.3.171: bytes=64 time=6.90mssystem>
250 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
pmpolicy commandThis command displays and sets the power management policies for theBladeCenter unit.
Table 59. pmpolicy command
Function What it does Command Valid targets
Display powermanagement policy
Displays the current powermanagement policy for alldomains.
pmpolicy -T system
Display powermanagement policy for aBladeCenter S unit
Displays both the current andavailable power managementpolicies for a BladeCenter S unit,that has a single power domain.
pmpolicy domain
where domain is pd
-T system
Display powermanagement policy fordomain
Displays both the current andavailable power managementpolicies for the specified powerdomain in a BladeCenter unit thatsupports two power domains.
pmpolicy domain
where domain is:v pd1 (power domain 1)v pd2 (power domain 2)
-T system
Set power managementpolicy for domain
Set power management policy forspecified power domain.
pmpolicy domain -pm policy
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 unitsonly)
v acredov (ac powersource redundancypolicy, with bladethrottling - BladeCenterS units only)
v redwoperf (powermodule redundancy, nooversubscription)
v redwperf (powermodule redundancywith power throttling)
v nonred (no powermanagement policy)
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 251
Example:
To view the current policy and the available policies for a power domain 1, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, type
pmpolicy pd1
The following example shows the output generated by this command.system> pmpolicy pd1
Power Domain 1--------------
*** Current Policy ***
Power Management Policy:Power Module Redundancy with Blade Throttling Allowed (redwperf)
Description:Very similar to Power Module Redundancy. This policy allows you todraw more total power; however, capable blades may be allowed tothrottle down if one Power Module fails.
Power Supply Failure Limit: 1Maximum Power Limit (Watts): 3380Your Estimated Utilization: 5%
*** Available Policies ***
Power Management Policy:Power Module Redundancy (redwoperf)
Description:Intended for a single AC power source into the chassis where eachPower Module is on its own dedicated circuit. Total allowed powerdraw is limited to one less than the number of Power Modules whenmore than one Power Module is present. One Power Module can failwithout affecting blade operation. Multiple Power Module failures cancause the chassis to power off. Note that some blades may not beallowed to power on if doing so would exceed the policy power limit.
Power Supply Failure Limit: 1Maximum Power Limit (Watts): 2880Your Estimated Utilization: 6%
Power Management Policy:Basic Power Management (nonred)
Description:Total allowed power is higher than other policies and is limited onlyby the total power capacity of all the Power Modules up to themaximum of chassis power rating. This is the least conservativeapproach, since it does not provide any protection for AC powersource or Power Module failure. If any single power supply fails,blade and/or chassis operation may be affected.
Power Supply Failure Limit: 0Maximum Power Limit (Watts): 3520Your Estimated Utilization: 5%
NOTE:Power Supply Failure Limit: This is the maximum number of power supplies
that can fail while still guaranteeing theoperation of the domain in the selected policy.
Your Estimated Utilization: The estimated utilization is based on the maximumpower limit allowed in this policy and the currentaggregated power in use of all components in thedomain.
system>
252 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
portcfg commandThis command configures and displays the settings for the advancedmanagement-module serial port.
Table 60. portcfg command
Function What it does Command Valid targets
Displaymanagement-moduleserial port configuration
Displays the current configurationof the management-module serialport. Possible return values are:v -b baud_ratev -p parityv -s stop_bits
portcfg -com1 -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management-moduleserial port baud rate
Checks syntax and sets the baud(communications) rate of themanagement-module serial port.
portcfg -com1 -bbaud_rate
where baud_rate is 2400,4800, 9600, 19200, 38400,or 57600.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management-moduleserial port parity
Checks syntax and sets the parityof the management-module serialport.
portcfg -com1 -p parity
where parity isv nonev oddv evenv markv space
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 253
Table 60. portcfg command (continued)
Function What it does Command Valid targets
Set management-moduleserial port stop bits
Checks syntax and sets the numberof stop bits for themanagement-module serial port.
portcfg -com1 -s stop_bits
where stop_bits is 1 or 2.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To display the configuration for the management-module serial port, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeportcfg -com1
To set the baud rate for the management-module serial port to 9600, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeportcfg -com1 -b 9600
The following example shows the information that is returned from these twocommands:system:mm[1]> portcfg -com1-b 2400-p none-s 1system:mm[1]> portcfg -com1 -b 9600These 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 commandThis command sets and displays the network port configuration settings for theadvanced 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 activeimmediately. Changes to the remaining settings become active after the next resetof the advanced management module.
Table 61. ports command
Function What it does Command Valid targets
Display network portsettings
Displays the network port settingsfor the management module.Returned values are:v -ftpp FTP_prt_numv -ftpdp FTP_data_prt_numv -httpp HTTP_prt_numv -httpsp HTTPS_prt_numv -rpp rpp_prt_numv -slpp SLP_prt_numv -smashsp
secSMASH_SSH_prt_numv -smashtp SMASH_telnet_prt_numv -snmpap SNMP_agent_prt_numv -snmptp SNMP_traps_prt_numv -sshp SSH_prt_numv -stcmp secure_tcmpv -tcmp TCP_cmd_md_portv -telnetp _Telnet_prt_numv -tftpp TFTP_prt_numv -ftpe FTP_statev -httpse HTTPS_prt_statev -kvme KVM_statev -ntpe NTP_statev -rde rd_statev -rdoce rdoc_statev -slpe SLP_state.v -smashse sec_SMASH_SSH_statev -smashte SMASH_telnet_statev -snmp1ae SNMPv1_agent_statev -snmp3ae SNMPv3_agent_statev -snmpte SNMP_traps_statev -sshe SSH_prt_statev -stcme secure_TCP_cmd_modev -tcme TCP_cmd_mode_statev -telnete Telnet_prt_state-v -tftpe TFTP_statev -ftpt FTP_timeoutv -tcmt TCP_cmd_mode_timeoutv -telnett Telnet_prt_timeout
ports -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display openmanagement moduleports
Displays the management moduleports that are currently open.
ports -open -T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 255
Table 61. ports command (continued)
Function What it does Command Valid targets
Reset network portsettings
Resets all network port settings forthe management module to thedefault values. Default values are:v -ftpp: 21v -ftpdp: 20v -httpp: 80v -httpsp: 443v -rpp: 3900v -slpp: 427v -tcmp: 6090v -smashtp: 50023v -smashsp: 50022v -snmpap: 161v -snmptp: 162v -sshp: 22v -stcmp: 6091v -telnetp: 23v -tftpp: 69
ports -reset
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set FTP port number Sets the port number for themanagement module FTP port.
ports -ftpp FTP_prt_num
where FTP_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set FTP data portnumber
Sets the port number for themanagement module FTP dataport.
ports -ftpdpFTP_data_prt_num
where FTP_data_prt_numis from 1 to 65535,inclusive. If you enter avalue outside this range,an error will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay 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 themanagement module HTTP port.
ports -httppHTTP_prt_num
where HTTP_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set HTTPS port number Sets the port number for themanagement module HTTPS port.
ports -httpspHTTPS_prt_num
where HTTPS_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set Remote Presenceport number
Sets the remote presence portnumber for the managementmodule remote presence port.
ports -rpp rpp_prt_num
where rpp_prt_num is from1 to 65535, inclusive. Ifyou enter a value outsidethis range, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 257
Table 61. ports command (continued)
Function What it does Command Valid targets
Set SLP port number Sets the SLP port number. ports -slpp SLP_prt_num
where SLP_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set SMASH Telnet portnumber
Sets the port number for themanagement module SMASHcommand-line processor overTelnet port.
ports -smashtpSMASH_telnet_prt_num
whereSMASH_telnet_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 portnumber
Sets the port number for themanagement module SNMP agentport.
ports -snmpapSNMP_agent_prt_num
whereSNMP_agent_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set SNMP traps portnumber
Sets the port number for themanagement module SNMP trapsport.
ports -snmptpSNMP_traps_prt_num
whereSNMP_traps_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 259
Table 61. ports command (continued)
Function What it does Command Valid targets
Set command mode portnumber
Sets the TCP command mode portnumber.
ports -tcmpTCP_cmd_md_prt_num
whereTCP_cmd_md_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set secure commandmode port number
Sets the secure TCP commandmode port number.
ports -stcmp secure_tcmp
where secure_tcmp is from1 to 65535, inclusive. Ifyou enter a value outsidethis range, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set SSH port number Sets the port number for themanagement module SSH port.
ports -sshp SSH_prt_num
where SSH_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 themanagement module Telnet port.
ports -telnetpTelnet_prt_num
where Telnet_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set TFTP port number Sets the port number for themanagement module TFTP port.
ports -tftppTFTP_prt_num
where TFTP_prt_num isfrom 1 to 65535, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable FTP Enables or disables FTP for themanagement module.
ports -ftpe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 261
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disable HTTPSport
Enables or disables themanagement module HTTPS port.
ports -httpse state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set KVM port state Sets the KVM port state to on oroff.
ports -kvme state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable NTP Enables or disables NTP for themanagement module.
ports -ntpe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 forthe management module.
ports -rde state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable RDOCE Enables or disables remote disk oncard for the management module.
ports -rdoce state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disables SLP Enables or disables SLP for themanagement module.
ports -slpe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 263
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disable secureSMASH over SSH
Enables or disables the secureSMASH command-line processorover SSH for the managementmodule.
ports -smashse state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable SMASHover Telnet
Enables or disables SMASHcommand-line processor overTelnet for the management module.
ports -smashte state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disableSNMPv1 agent
Enables or disables the SNMPv1agent for the management module.
ports -snmp1ae state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
264 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disableSNMPv3 agent
Enables or disables the SNMPv3agent for the management module.
ports -snmp3ae state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable SNMPtraps
Enables or disables the SNMP trapsfor the management module.
ports -snmpte state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable SSHport
Enables or disables themanagement module SSH port.
ports -sshe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 265
Table 61. ports command (continued)
Function What it does Command Valid targets
Enable / disable TCPcommand mode
Enables or disables the TCPcommand mode for themanagement module.
ports -tcme state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set number of TCPcommand modeconnections
Turns the TCP command mode onor off, or sets the maximumnumber of connections explicitly.Note: Any number of connections(1 through 20) displays a status ofon. Zero connections displays astatus of off.
ports -tcme port_mode
where port_mode is on (1connection), off (noconnections), or a numberbetween 0 and 20,inclusive, that indicatesthe maximum number ofTCP session connections.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable secureTCP command mode
Enables or disables the secure TCPcommand mode for themanagement module.
ports -stcme state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 secureTCP command modeconnections
Turns the secure TCP commandmode on or off, or sets themaximum number of connections.Notes:v On a write operation, the
maximum number ofconnections can be set explicitly(0-20), or it can be turned on (1connection) or off (0connections).
v On a read operation, off means 0connections, and on means 1 ormore connections.
v The total session count of TCMand STCM is limited to 20.
ports -stcme port_mode
where port_mode is on (1connection), off (noconnections), or a numberbetween 0 and 20,inclusive, that indicatesthe maximum number ofTCP session connections.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable Telnetport
Enables or disables themanagement module Telnet port.
ports -telnete state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable TFTP Enables or disables TFTP for themanagement module.
ports -tftpe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 267
Table 61. ports command (continued)
Function What it does Command Valid targets
Set FTP timeout Sets the FTP timeout value for themanagement module.
ports -ftpt timeout
where timeout is from 0seconds (no timeout) to4294295967 seconds,inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set TCP command-modetimeout
Sets the TCP command-modetimeout value for the managementmodule.
ports -tcmt timeout
where timeout is from 0seconds (no timeout) to4294295967 seconds,inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set Telnet port timeout Sets the Telnet port timeout valuefor the management module.
ports -telnett timeout
where timeout is from 0seconds (no timeout) to4294295967 seconds,inclusive.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 portsettings for I/O module
Displays the network port settingsfor the I/O module. These settingscan include:v cable compatibilityv cable lengthv cable typev data ratev labelv port indexv port mediav port widthv protocolv speedv speed settingv available speedsv statev state settingv typev vendor
Note: Other device specific valuesmight be returned.
ports -T system:switch[x]
where x is theI/O-module baynumber.
Enable or disable portfor I/O module
Enables or disables specified porton specified I/O module.
ports -port_index -statestate
wherev port_index is from 1 to
65535, inclusive.v state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the I/Omodule bay number.
Chapter 3. Command reference 269
Table 61. ports command (continued)
Function What it does Command Valid targets
Sets speed of port forI/O module
Sets speed of specified port on I/Omodules that support this feature.
ports -port_index -speedspeed_setting
wherev port_index is from 1 to
65535, inclusive.v speed_setting specifies
the port speed, in termsof:– multiplier– units, m or g for
megabits or gigabits– duplex mode, h or f
for half or full
For example, 100mh setsthe port speed to 100Mbps half-duplex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Example:
To display the management module network port settings, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typeports
To disable FTP for the management module, while management module 1 is set asthe persistent command environment, at the system:mm[1]> prompt, typeports -ftpe off
The following example shows the information that is returned from these twocommands: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 300system:mm[1]> ports -ftpe offChanges 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.OKsystem>
Chapter 3. Command reference 271
power commandThis command turns on and turns off blade servers and I/O modules. Foradvanced management modules installed in BladeCenter HT units, it also turns onand turns off the alarm panel module and network clock module.
Table 62. power command
Function What it does Command Valid targets
Power on Turns on the specified commandtarget.
power -on
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
(for blade server)v I/O module
administration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
-T system:switch[x]
-T system:tap(BladeCenter HT unitsonly)
-T system:ncc[x](BladeCenter HT unitsonly)
where x is the bladeserver, I/O-modulebay, or network clockmodule number.
Power on to commandconsole
Opens a command console with anSOL session when the specifiedblade server is turned on.
power -on -c
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Power off Turns off the specified commandtarget.
power -off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
(for blade server)v I/O module
administration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
-T system:switch[x]
-T system:tap(BladeCenter HT unitsonly)
-T system:ncc[x](BladeCenter HT unitsonly)
where x is the bladeserver, I/O-modulebay, or network clockmodule number.
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 poweroff blade server
Shuts down the operating systemand turns off the specified bladeserver.
power -softoff
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver number.
Power cycle Cycles power for the specifiedblade server or I/O module. If theblade server or I/O module is off,it will turn on. If the blade serveror I/O module is on, it will turnoff and then turn on.
power -cycle
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
(for blade server)v I/O module
administration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
-T system:switch[x]
where x is the bladeserver or I/O-modulebay number.
Power cycle to commandconsole
Cycles power for the specifiedblade server. If the blade server isoff, it opens a command consolewith an SOL session when it isturned on. If the blade server is on,it will turn off and then turn on.
power -cycle -c
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Display power state Displays the current power statefor the specified blade server orI/O module. Possible return valuesare off, on, standby, or hibernate.
power -state -T system:blade[x]
-T system:switch[x]
where x is the bladeserver or I/O-modulebay number.
Chapter 3. Command reference 273
Table 62. power command (continued)
Function What it does Command Valid targets
Enable / disable Wakeon LAN globally
Enables or disables Wake on LANglobally for all blade servers.
power -wol state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Enable / disable Wakeon LAN for blade server
Enables or disables Wake on LANfor the specified blade server.
power -wol state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Enable / disable localpower control globally
Enables or disables local powercontrol globally for all bladeservers.
power -local state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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 localpower control for bladeserver
Enables local power control for thespecified blade server.
power -local state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Set automatic power-onpolicy for BladeCenterunit
Sets the automatic power-on policyfor the BladeCenter unit.
Changes to the power-on policysetting take effect after the nextcold start of the BladeCenter unit.
power -ap policy
where policy is:v restore: all blade
servers that werepreviously on will bepowered on
v auto: when power isapplied to theBladeCenter unit, allblade servers will bepowered on
v manual: all blade serverswill remain off untilmanually powered on
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Display fast POSTsetting for I/O module
Displays the current fast POSTsetting for specified I/O module.Note: This target works only forsome I/O modules.
power -T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 275
Table 62. power command (continued)
Function What it does Command Valid targets
Enable / disable fastPOST for I/O module
Enables or disables fast POSTglobally for the specified I/Omodule.Note: This option works only forsome I/O modules.
power -fp state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Display POST status forI/O module
Displays the POST status for thespecified I/O module. If thecommand is run while POST is inprogress, it returns the level ofPOST that is currently in process. Ifthe command is run after POST iscomplete, it displays one of thefollowing return values:v The POST results could not be
read. message displays if therewas an internal error duringPOST.
v The POST results not complete:hex_code message displays ifPOST results are not availableafter POST completes.
v If POST returns valid results, oneof the following messagesdisplays:– hex_code: Base internal
function failure detected.– hex_code: Internal
interface failure detected.– hex_code: External
interface failure detected.– hex_code: Module completed
POST successfully.– hex_code: Cannot decode
POST result code.v The Invalid POST results.
message displays if none of theabove conditions is true.
Where hex_code is a hexadecimalcode. See the documentation thatcomes with your I/O module forinformation.Note: This command option is notsupported for serial concentratorI/O modules.
power -state -post -T system:switch[x]
where x is theI/O-module baynumber.
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 bladeserver is set as the persistent command environment, at the system:blade[5]>prompt, typepower -state
To turn on the blade server in blade bay 5, while this blade server is set as thepersistent command environment, at the system:blade[5]> prompt, typepower -on
To display the power state for the blade server in blade bay 5 again, while thisblade server is set as the persistent command environment, at thesystem:blade[5]> prompt, typepower -state
The following example shows the information that is returned from these threecommands:system:blade[5]> power -stateOffsystem:blade[5]> power -onOKsystem:blade[5]> power -stateOnsystem:blade[5]>
Chapter 3. Command reference 277
rdoc commandThis command displays volume information for remote disk-on-card local storageon the advanced management module. The command also allows you to mount,unmount, or map a file image to this device.
Table 63. rdoc command
Function What it does Command Valid targets
Display advancedmanagement modulevolume information
Displays the remote disk-on-cardvolume information for localstorage on the advancedmanagement module. Volumeinformation returned includes:v Health conditionv Sizev Amount of free space
rdoc -T system:mm[x]
where x is the primarymanagement modulebay number.
Map file as advancedmanagement modulevolume image
Maps the specified file as the activeimage for the remote disk-on-cardlocal storage volume on theadvanced management module.
rdoc -map filename
where filename is the nameof the file to be mapped asthe active remotedisk-on-card image.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement modulebay number.
Mount advancedmanagement modulevolume
Mounts the remote disk-on-cardlocal storage volume on theadvanced management module.Note: The advanced managementmodule will only mount the firstpartition, if the volume hasmultiple partitions.
rdoc -mount
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement modulebay number.
Unmount advancedmanagement modulevolume
Unmounts the remote disk-on-cardlocal storage volume on theadvanced management module.
rdoc -unmount
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade remote presence
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement modulebay number.
278 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To display volume information for local storage on the advancedmanagement module in bay 1, while this management module is set as thepersistent command environment, at the system:mm[1]> prompt, typerdoc
The following example shows the information that is returned from this command:system:mm[1]> rdocVolume 0Health: goodVolume Size: 73108480 (Bytes)Free Size: 69120000 (Bytes)system:mm[1]>
Chapter 3. Command reference 279
read commandThis command restores the management-module configuration that was previouslysaved to the BladeCenter unit chassis or to a file.
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
Displaymanagement-moduleautomatic configurationsetting
Displays the automaticconfiguration setting (-autocommand option) of themanagement module.
read -T system:mm[x]
where x is the primarymanagement-modulebay number.
Restoremanagement-moduleconfiguration fromBladeCenter unitmidplane
Restores the management-moduleconfiguration from an image thatwas previously saved to theBladeCenter unit midplane.
read -config chassis
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Restoremanagement-moduleconfiguration from file(no encryption)
Restores the management-moduleconfiguration from an image thatwas previously saved to a filewhile data encryption was notenabled for the BladeCenter unit.
read -config file -lfilename -i ip_address
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
280 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 64. read command (continued)
Function What it does Command Valid targets
Restoremanagement-moduleconfiguration from file(encryption)
Restores the management-moduleconfiguration from an image thatwas previously saved to a filewhile data encryption was enabledfor the BladeCenter unit.Note: When a configuration filewas created with a pass-phrase(encryption enabled), if thisconfiguration file is restored on thesame management module, thepass-phrase entered duringrestoration is ignored.
read -config file -lfilename -i ip_address -ppassphrase
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v "passphrase" is thequote-delimitedpass-phrase that wasused to save theoriginal configurationfile. Maximumpass-phrase length is1600 characters.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable automaticmanagement-moduleconfiguration
Enables automatic configuration ofthe management module, based onsettings stored in the BladeCenterunit midplane, when themanagement module is installed.Note: The -auto option can only beused when themanagement-module configurationwas stored to the BladeCenter unitmidplane.
read -config chassis-auto on
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 281
Table 64. read command (continued)
Function What it does Command Valid targets
Disable automaticmanagement-moduleconfiguration
Disables automatic configuration ofthe management module, based onsettings stored in the BladeCenterunit midplane, when themanagement module is installed.
read -config chassis-auto off
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To restore the management-module configuration from an image previously savedto the BladeCenter unit chassis, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typeread -config chassis
The following example shows the information that is returned from this command:system:mm[1]> read -config chassisOKConfiguration restore from the chassis was successfulRestart the MM for the new settings to take effectsystem:mm[1]>
282 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
remotechassis commandThis command displays and manages the list of BladeCenter units that themanagement module discovers on the network.
Note: The advanced management module that runs the remotechassis command isalso included in all lists.
Table 65. remotechassis command
Function What it does Command Valid targets
Display complete list Displays a list of all BladeCenterunits that the management modulediscovers on the network. The listincludes the following informationabout each BladeCenter unit:v Namev IP addressv Statusv Firmware levelv Typev Serial numberv FRU numberv Chassis serial numberv Chassis FRU numberv Chassis machine-type model
(MTM)v Chassis UUID
remotechassis -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display list grouped byhealth status
Displays a list of names forBladeCenter units that themanagement module discovers onthe network. The list is grouped byhealth status.
remotechassis -health -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display list filtered byIP address
Displays a list of BladeCenter unitsthat the management modulediscovers on the network, filteredby the specified IP address. The listincludes the following informationabout each BladeCenter unit:v Namev IP addressv Statusv Firmware levelv Typev Serial numberv FRU numberv Chassis serial numberv Chassis FRU numberv Chassis machine-type model
(MTM)v Chassis UUID
remotechassis -ipip_address
where ip_address is an IPaddress pattern that usesthe asterisk (*) as awildcard (for example;201.47.123.*).
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 283
Table 65. remotechassis command (continued)
Function What it does Command Valid targets
Display list filtered byname
Displays a list of BladeCenter unitsthat the management modulediscovers on the network, filteredby the specified name. The listincludes the following informationabout each BladeCenter unit:v Namev IP addressv Statusv Firmware levelv Typev Serial numberv FRU numberv Chassis serial numberv Chassis FRU numberv Chassis machine-type model
(MTM)v Chassis UUID
remotechassis -name name
where name is a namepattern that uses theasterisk (*) as a wildcard(for example; WebServer*).
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Clear list Clears the list of BladeCenter unitsthat the management modulediscovered on the network.
remotechassis -clear -T system:mm[x]
where x is the primarymanagement-modulebay number.
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 thepersistent command environment, at the system:mm[1]> prompt, typeremotechassis -name WebServer*
The following example shows the information that is returned from this command:system:mm[1]> remotechassis -name WebServer*Running chassis discovery...------------------------------------------------Name: WebServer001IP: 145.48.204.212Status: normalFirmware: BPET25L,CNETMNUS.PKT,01-08-07,37,1Type: management-moduleSerial: 0J1M9E585630FRU: 25R5777Chassis Serial: 23A2343Chassis FRU: 25R5780R5780Chassis MTM: 885222ZChassis UUID: 4E349451FA8011D9B10C89E0183AD13D------------------------------------------------Name: WebServer002IP: 145.48.204.222Status: normalFirmware: BPET25L,CNETMNUS.PKT,01-08-07,37,1Type: management-moduleSerial: 0J1M9E585656FRU: 25R5777Chassis Serial: 23A2356Chassis FRU: 25R5780R5780
284 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chassis MTM: 885222ZChassis 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 commandenvironment, at the system:mm[1]> prompt, typeremotechassis -name SYSTEM*
The following example shows the information that is returned from this command:system:mm[1]> remotechassis -name SYSTEM*Running chassis discovery...------------------------------------------------Name: SYSTEMIP: 10.13.1.190IPv6: 2002:1013::211:25ff:fec3:227c
2001:1013::211:25ff:fec3:227c2000:1013::211:25ff:fec3:227cfe80::211:25ff:fec3:227c2000:1013::a1be:a348:7672:2def2000:1013::1:191
Status: criticalFirmware: BPET002,CNETMNUS.PKT,02-17-10,1Type: management-moduleSerial: YK118165A117FRU: 39Y9661Chassis Serial: KQWPLB9Chassis FRU: 44X2302Chassis MTM: 8852HC1Chassis UUID: E13112E1829448E29999DA2066681D89------------------------------------------------Name: SYSTEMIP: 10.13.1.30IPv6: 2000:1013::fc58:325c:c8b4:9c4c
2000:1013::214:5eff:fed0:2e1c2000:1013::1:30fe80::5652:ff:fe69:d7632002:1013::211:25ff:fec3:8cfa2001:1013::211:25ff:fec3:8cfa2000:1013::211:25ff:fec3:8cfafe80::211:25ff:fec3:8cfa
Status: attentionFirmware: BPET54A,CNETMNUS.PKT,02-17-10,84Type: management-module-telcoSerial: YK118269Y115FRU: 39Y9661Chassis Serial: 23A0052Chassis FRU: 42C3673Chassis MTM: 87501RZChassis UUID: B5BAEC01A10B11DB9F3BC1BE8FFF3B3C------------------------------------------------system:mm[1]>
Chapter 3. Command reference 285
reset commandThis command resets blade servers, blade server integrated system managementprocessors (service processors), I/O modules, or the primary management module.For advanced management modules installed in BladeCenter HT units, it alsoresets the multiplexer expansion module.
Table 66. reset command
Function What it does Command Valid targets
Reset Performs an immediate reset andrestart of the specified device.
reset
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
(for blade server orblade server ISMP)
v I/O moduleadministration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
-T system:switch[x]
-T system:blade[x]:sp
where x is the bladeserver or I/O-modulebay number.
Reset primarymanagement module
Performs an immediate reset andrestart of the primary managementmodule.
reset
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Reset standbymanagement module
Performs an immediate reset of thestandby management module.Note: This option does not applyto the BladeCenter S unit.
reset -standby
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.Note: Even thoughthis command resetsthe standbymanagement module,it still must specify theprimary managementmodule as thecommand target.
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 tocommand console
Opens a command console with anSOL session when the specifiedblade server is reset.
reset -c
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Reset with failover Resets the specified commandtarget, enabling failover if aredundant (stanfdby) componentfor the command target is present.
An error message is displayed ifyou try to failover a managementmodule when a standbymanagement module is notinstalled or if the firmware in theone of the management modules isupdating.Note: This option does not applyto the BladeCenter S unit.
reset -f
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:mux[x] (foradvanced managementmodules inBladeCenter HT unitsonly)
where x is the primarymanagement-modulebay or multiplexerexpansion modulenumber.
Reset managementmodule with forcedfailover
Resets the primary managementmodule with failover to thestandby management module.
An error message is displayed ifyou try to force failover for amanagement module when astandby management module is notinstalled or if the firmware in theprimary management module isupdating.Note: This option does not applyto the BladeCenter S unit.
reset -force
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Reset I/O module withstandard diagnostics
Performs an immediate reset andrestart of the specified device,running standard diagnostics onthe I/O module after it restarts.
Running the reset -std commandgives the same result as runningthe reset command on a I/Omodule.
reset -std
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 287
Table 66. reset command (continued)
Function What it does Command Valid targets
Reset I/O module withextended diagnostics
Performs an immediate reset andrestart of the specified device,running extended diagnostics onthe I/O module after it restarts.
reset -exd
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Reset I/O module withfull diagnostics
Performs an immediate reset andrestart of the specified device,running full diagnostics on the I/Omodule after it restarts.
reset -full
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Restart blade server withNMI
Performs an immediate reset andrestart of the specified blade server.Command results depend on theblade server model that isspecified:v For a JS12 or JS22 blade server,
this option is not available.v For a JS20 blade server, the
command performs animmediate reset and restart ofthe specified blade server withnon-maskable interrupt (NMI).
v For all other blade servers, thecommand performs animmediate reset and restart ofthe specified blade server.
reset -sft
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
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 andclear NVRAM
Performs an immediate reset andrestart of the specified blade server.Command results depend on theblade server model that isspecified:v For a JS12 or JS22 blade server,
this option is not available.v For a JS20 blade server, the
command performs animmediate reset and restart ofthe specified JS20 blade serverand clears all settings stored innon-volatile memory (NVRAM).
v For all other blade servers, thecommand performs animmediate reset and restart ofthe specified blade server.
reset -clr
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Restart blade server andrun diagnostics
Performs an immediate reset andrestart of the specified blade server.Command results depend on theblade server model that isspecified:v For a JS12 or JS22 blade server,
this option is not available.v For a JS20 blade server, the
command performs animmediate reset and restart ofthe specified JS20 blade serverand runs diagnostics.
v For all other blade servers, thecommand performs animmediate reset and restart ofthe specified blade server.
reset -dg
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Restart blade server andrun diagnostics usingdefault boot sequence
Performs an immediate reset andrestart of the specified blade server.Command results depend on theblade server model that isspecified:v For a JS12 or JS22 blade server,
this option is not available.v For a JS20 blade server, the
command performs animmediate reset and restart ofthe specified JS20 blade serverand runs diagnostics using thedefault boot sequence configuredfor the blade server.
v For all other blade servers, thecommand performs animmediate reset and restart ofthe specified blade server.
reset -ddg
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
and blade remotepresence
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 289
Table 66. reset command (continued)
Function What it does Command Valid targets
Restart blade server andenter SMS menu
Performs an immediate reset andrestart of the specified blade serverand enters the System ManagementServices (SMS) firmware menu.Note: This option applies to allJSxx blade servers other than theJS20 blade server.
reset -sms
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Example: To reset the service processor on the blade server in blade bay 5, whilethe BladeCenter unit is set as the persistent command environment, at the system>prompt, typereset
The following example shows the information that is returned:system> reset -T blade[5]:spOKsystem>
290 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
scale commandThis command sets and displays the partition control and configuration settings formultiple blade servers or nodes in a scalable complex, for blade servers installed inthe BladeCenter unit that support this feature.
Note:
v The scale command will execute only on blade servers that support scalablecomplexes.
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, makesure 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 scalablecomplex information
Displays all scalable complexinformation for the BladeCenterunit.
scale -T system
Display information forspecific scalable complex
Displays information for thespecified scalable complex.Note:v The complex_id is found by
running the scale commandwith no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -compid complex_id
where complex_id is aunique complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
-T system
Display information forspecific node in ascalable complex
Displays information for a specificnode in the scalable complex.Note:v The complex_id and node_id are
found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -node node_id-compid complex_id
where :v node_id is the checksum
or blade server baynumber, of the node.
v complex_id is a uniquecomplex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
-T system
Display information forspecific partition in ascalable complex
Displays information for a specificnode in the scalable complex.Note:v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -compid complex_id-partition partition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
-T system
Chapter 3. Command reference 291
Table 67. scale command (continued)
Function What it does Command Valid targets
Automatically createpartition in scalablecomplex
Automatically creates a partition inthe scalable complex.Note:v Creating a partition with nodes
(blade servers) that are enabledfor Blade Open Fabric Manager(BOFM) might cause loss ofports configured for Open FabricManager.
v The complex_id is found byrunning the scale commandwith no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -auto -compidcomplex_id
where complex_id is aunique complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Automatically createstand-alone partition inscalable complex
Automatically creates a stand-alonepartition in the scalable complex.Single blade servers set up as astand-alone partition will performconsistently if they are installed inanother BladeCenter unit.Note:v Creating a partition with nodes
(blade servers) that are enabledfor Blade Open Fabric Manager(BOFM) might cause loss ofports configured for Open FabricManager.
v The complex_id andpri_node_chksum are found byrunning the scale commandwith no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -autopri_node_chksum -compidcomplex_id
where :v pri_node_chksum is a
checksum that identifiesthe node where thepartition is to becreated.
v complex_id is a uniquecomplex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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-alonepartition in scalablecomplex
Creates stand-alone partitions forspecified blade servers or nodes inthe scalable complex. Single bladeservers set up as a stand-alonepartition will perform consistentlyif they are installed in anotherBladeCenter unit.Note:v Creating a partition with nodes
(blade servers) that are enabledfor Blade Open Fabric Manager(BOFM) might cause loss ofports configured for Open FabricManager.
v The comma-separated-valueformat of this command isprimarily used to createstand-alone partitions, sincethese systems are not contiguouslike blade-server systems. Forblade-server systems, thecommand can accept acomma-separated-value list ofblade server bay numbers, butthese bay numbers must becontiguous.
v The checksums, blade server baynumbers and complex_id arefound by running the scalecommand with no options.
v The namespace for a nodechecksum and blade server baynumber should not overlap.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -create id_x,id_y-compid complex_id
where:v id_x and id_y are
checksums or bladeserver bay numbers,separated by commas,that identify the nodewhere the partition is tobe created. The list cancontain one or morecomma-separatedvalues. Both checksumsand bay numbers canbe used in the same list.
v complex_id is a uniquecomplex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 293
Table 67. scale command (continued)
Function What it does Command Valid targets
Create partition inscalable complex
Creates partitions for specifiedblade servers in the scalablecomplex.Note:v Creating a partition with nodes
(blade servers) that are enabledfor Blade Open Fabric Manager(BOFM) might cause loss ofports configured for Open FabricManager.
v For blade-server systems, acontiguous range of blade-serverbays can be specified.
v The blade server bay numbersand complex_id are found byrunning the scale commandwith no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -createstart_bay-end_bay -compidcomplex_id
where:v start_bay and end_bay
are blade server baynumbers, separated by ahyphen, that identifythe range of bladeserver bays wherepartitions are to becreated. The range cancontain a single baynumber.
v complex_id is a uniquecomplex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Delete all partitionsfrom scalable complex
Deletes all partitions in the scalablecomplex.Note:v All partitions must be powered
off to delete them.v The blade server bay numbers
and complex_id are found byrunning the scale commandwith no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -delete -compidcomplex_id
where complex_id is aunique complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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 fromscalable complex
Deletes a specific partition in thescalable complex.Note:v A partition must be powered off
to delete it.v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -delete -compidcomplex_id -partidpartition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Set partition mode tostand alone
Sets the mode for a specificpartition in the scalable complex tostandalone. A partition set tostand-alone mode operates as asingle blade server system. Singleblade servers set up as astand-alone partition will performconsistently if they are installed inanother BladeCenter unit.Note:v A partition must be powered off
to change its mode.v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -mode standalone-compid complex_id-partid partition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 295
Table 67. scale command (continued)
Function What it does Command Valid targets
Set partition mode topartition
Sets the mode for a specificpartition in the scalable complex topartition.Note:v A partition must be powered off
to change its mode.v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -mode partition-compid complex_id-partid partition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Power on partition inscalable complex
Turns on a specific partition in thescalable complex.Note:v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -on -compidcomplex_id -partidpartition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
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 inscalable complex
Turns off a specific partition in thescalable complex.Note:v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -off -compidcomplex_id -partidpartition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Power cycle partition inscalable complex
Cycles power for a specificpartition in the scalable complex. Ifthe partition is off, it will turn on.If the partition is on, it will turn offand then turn on.Note:v The complex_id and partition_id
are found by running the scalecommand with no options.
v The -compid command option isrequired for only blade-serversystems that can have multiplescalable complexes defined in thesame BladeCenter unit. Thisoption does not need to bespecified for stand-alone systems.
scale -cycle -compidcomplex_id -partidpartition_id
where :v complex_id is a unique
complex identifier(hexadecimal string offour alphanumericcharacters), assigned bythe blade complex.
v partition_id is a partitionidentifier, assigned bythe blade complex.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 297
Example: To view all scalable complexes in the system, while the BladeCenter unitis set as the persistent command environment, at the system> prompt, typescale
To power on a partition targeted by the complex ID “06EC” and the partition ID“1”, while the BladeCenter unit is set as the persistent command environment, atthe system> prompt, typescale -on -compid 06EC -partid 1
The following example shows the information that is returned from thesecommands:system> scale
--- Complex ID: 06EC ---
Partition ID: 1Assigned Nodes:---------------
Bay: 2Name: HX5 SDV #3Processors/Memory: 2 Intel Xeon/4 DIMMs 2GBLogical Node ID: 0Status: powered onMode: partitionPrimary: Yes
Bay: 3Name: HX5 SDV #4Processors/Memory: 2 Intel Xeon/4 DIMMs 2GBLogical Node ID: 1Status: powered onMode: partitionPrimary: No
system> scale -on -compid 06EC -partid 1Note: The power operation may take a few moments to complete.OKsystem>
298 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sddump commandThis command initiates a dump of service data from blade servers that supportthis function.
Table 68. sddump command
Function What it does Command Valid targets
Dump service data Dumps service data of the specifiedtype from the specified bladeserver target.Note: Data dumps can be initiated,but are not collected, from theadvanced management module.
sddump -init type
where type is:v sd for a service data
dump.v sp for a service
processor data dump.v pf for a platform data
dump.v pt for a partition data
dump.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Get service data Collects and displays service data,from the last generated service-datadump, of the specified type fromthe specified blade server target.
sddump -coll type
where type is:v sd to collect and display
service data from lastdump.
v sp to collect and displayservice processor datafrom last dump.
v pf to collect and displayplatform data from lastdump.
v pt to collect and displaypartition data from lastdump.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 299
Example: To initiate a data dump from the service processor of the blade server inbay 2, while this blade server is set as the persistent command environment, at thesystem:blade[2]> prompt, typesddump -init sp
The following example shows the information that is returned from this command:system:blade[2]> sddump -init spOKsystem:blade[2]>
300 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sdemail commandThis command sends an email with the service information to the specifiedrecipients.
Table 69. sdemail command
Function What it does Command Valid targets
Send service informationusing email to specifiedrecipients
Send an email with serviceinformation to the specifiedrecipients. You assign a subject andan email address. When you runthis command, it attaches theservice log to the message.
sdemail -subj "subject"-to address
where:v "subject" is a
quote-delimited textstring up to 119characters in length.
v address is the recipientsemail address. Multipleaddresses separatedwith a comma can beentered (119 charactersmaximum).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement modulebay number.
Example:
To send a service information email message, while management module 1 is setas the persistent command environment, at the system:mm[1]> prompt, typesdemail -to [email protected] -subj "Blade 8 Reboot"
Chapter 3. Command reference 301
The following example shows the information that is returned from this command:system:mm[1]> sdemail -to [email protected] -subj "Blade 8 Reboot"OK
302 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
security commandThis command enables and displays the state of the data encryption feature forsensitive information stored in the advanced management module, such aspasswords and keys.
Once enabled, the security feature can not be disabled without resetting allmanagement module settings to their default configuration.
Table 70. security command
Function What it does Command Valid targets
Display managementmodule security setting
Displays the security setting formanagement module dataencryption (on or off).
security -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable data encryptionfor management module
Enables data encryption for themanagement module.
Attention: If you enable dataencryption, you can not disable itwithout resetting the managementmodule to the defaultconfiguration.
security -e
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To enable data encryption for the management module, while management module1 is set as the persistent command environment, at the system:mm[1]> prompt, typesecurity -e
To display the data encryption setting for the management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typesecurity
The following example shows the information that is returned from these twocommands:system:mm[1]> security -eOKsystem:mm[1]> security-e onsystem:mm[1]>
Chapter 3. Command reference 303
service commandThis command configures and displays the management-module service setting.
Table 71. service command
Function What it does Command Valid targets
Display service setting Displays the service setting fortechnician debug of the advancedmanagement module with a USBkey (enable or disable).
service -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable technician debug Configure service setting to enabletechnician debug of the advancedmanagement module with a USBkey.
service -enable
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Disable techniciandebug
Configure service setting to disable(default setting) technician debugof the advanced managementmodule with a USB key.
service -disable
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 thesystem:mm[1]> prompt, typeservice -enable
To display the service setting of the advanced management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeservice
304 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following example shows the information that is returned from these twocommands:system:mm[1]> service -enableOKsystem:mm[1]> serviceDebug with USB key: Enabledsystem:mm[1]>
Chapter 3. Command reference 305
shutdown commandThis command forces a blade server to shut down.
Table 72. shutdown command
Function What it does Command Valid targets
Shutdown blade server Forces a shutdown for the specifiedblade server.
shutdown -f
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Blade administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Example:
To force a shutdown for the blade server in blade bay 5, while this blade server isset as the persistent command environment, at the system:blade[5]> prompt, typeshutdown -f
The following example shows the information that is returned from this command:system:blade[5]> shutdown -fOKsystem:blade[5]>
306 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
slp commandThis command sets and displays the service location protocol (SLP) settings for themanagement module.
Table 73. slp command
Function What it does Command Valid targets
Displaymanagement-moduleSLP settings
Displays the SLP settings for theprimary management module.Returned values are:v -t address_typev -i multicast_addr
slp -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management-moduleSLP address type
Sets the SLP address type for theprimary management module.
slp -t address_type
where address_type ismulticast or broadcast.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management-moduleSLP multicast address
Sets the SLP multicast address forthe primary management module.
slp -i multicast_addr
where multicast_addr is themulticast IP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 thesystem:mm[1]> prompt, typeslp -t multicast
To display the SLP settings of the advanced management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeslp
Chapter 3. Command reference 307
The following example shows the information that is returned from these twocommands:system:mm[1]> slp -t multicastOKsystem:mm[1]> slp-t multicast-i 255.255.255.255system:mm[1]>
308 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
smtp commandThis command configures and displays the management-module SMTP settings.
Table 74. smtp command
Function What it does Command Valid targets
Display SMTP serverhost name or IP address
Displays the SMTP server hostname or IP address.
smtp -T system:mm[x]
where x is the primarymanagement-modulebay number.
Server host name or IPaddress - set
Checks syntax and sets the serverhost name or IP address.
smtp -shostname/ip_address
where hostname/ip_addressis the host name or IPaddress of the server.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 309
Table 74. smtp command (continued)
Function What it does Command Valid targets
SMTP e-mail serverdomain name - set
Checks syntax and sets the SMTPe-mail server domain name.
smtp -d domainname
where domainname is avalid domain name thatmeets the followingcriteria:
v Alphanumeric string upto 63 characters inlength.
v Can contain dots (.),dashes (-), orunderscores (_).
v Must contain at leastone dot.
v No consecutive dots areallowed.
v Quotes are not required.
v Value can be cleared bysetting it to an empty,double-quote limitedstring ("").
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To set the SMTP server host name to us.ibm.com, while management module 1 isset as the persistent command environment, at the system:mm[1]> prompt, typesmtp -s us.ibm.com
To display the SMTP configuration, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typesmtp
310 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
The following example shows the information that is returned from these twocommands:system:mm[1]> smtp -s us.ibm.comOKsystem:mm[1]> smtp-s us.ibm.comsystem:mm[1]>
Chapter 3. Command reference 311
snmp commandThis command configures and displays the management-module SNMP settings.
Table 75. snmp command
Function What it does Command Valid targets
Display SNMPconfiguration ofmanagement module
Displays the current SNMPconfiguration of the managementmodule.
snmp -T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMPv1 agent -enable/disable
Enables or disables themanagement-module SNMPv1agent.Note: Before you can enable theSNMPv1 agent, the following mustbe specified:v management module contact
namev management module locationv at least one community namev at least one valid IP address for
that community
(see “config command” on page111)
snmp -a -state
where state is on or off.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMPv3 agent -enable/disable
Enables or disables themanagement-module SNMPv3agent.Note: Before you can enable theSNMPv3 agent, the following mustbe specified:v management module contact
namev management module location
(see “config command” on page111)
snmp -a3 -state
where state is on or off.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMP traps -enable/disable
Enables or disables themanagement-module SNMP traps.
snmp -t -state
where state is on or off.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 1name - set
Sets the name of community 1. snmp -c1 name
where name is a descriptivename of community 1.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 313
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 1first host name or IPaddress - set
Checks syntax and sets the firsthost name or IP address ofcommunity 1.
snmp -c1i1hostname/ip_address
where hostname/ip_address isthe first host name or IPaddress of community 1.v The first IP address of
the first community canbe set to 0.0.0.0 if thecommunity access type isset to GET (for allmanagement moduletypes) or SET.
v Arguments containingspaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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,first host name - setaccess to SET(wildcard)
Sets the access type for community1 to SET.
snmp –ca1 set -c1i10.0.0.0v With the access type of
SET, anyone can querythe managementinformation base (MIB)and set MIB values.Using 0.0.0.0 IP addresswith SET access allowsopen access to themanagement module forwrite (SET) operations. A0.0.0.0 address cannot bea trap receiver.
v Arguments containingspaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 315
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP Community 1,first host name or IPaddress - set access toGET (wildcard)
Sets the access type for community1 to GET.
snmp –ca1 get -c1i10.0.0.0v With the access type of
GET, anyone can querythe MIB. Using 0.0.0.0 IPaddress with GET accessallows open access to themanagement module forread (GET). A 0.0.0.0address cannot be a trapreceiver.
v Arguments containingspaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 1second host name or IPaddress - set
Checks syntax and sets the secondhost name or IP address ofcommunity 1.
snmp -c1i2hostname/ip_address
where hostname/ip_address isthe second host name or IPaddress of community 1.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 317
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 1third host name or IPaddress - set
Checks syntax and sets the thirdhost name or IP address ofcommunity 1.
snmp -c1i3hostname/ip_address
where hostname/ip_address isthe third host name or IPaddress of community 1.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMPv3 community 1view type - set
Sets the SNMPv3 view type forcommunity 1.
snmp -ca1 type
where type isv getv setv trap
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 2name - set
Sets the name of community 2. snmp -c2 name
where name is a descriptivename of community 2.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMP community 2first host name or IPaddress - set
Checks syntax and sets the firsthost name or IP address ofcommunity 2.
snmp -c2i1hostname/ip_address
where hostname/ip_address isthe first host name or IPaddress of community 2.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 319
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 2second host name or IPaddress - set
Checks syntax and sets the secondhost name or IP address ofcommunity 2.
snmp -c2i2hostname/ip_address
where hostname/ip_address isthe second host name or IPaddress of community 2.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 2third host name or IPaddress - set
Checks syntax and sets the thirdhost name or IP address ofcommunity 2.
snmp -c2i3hostname/ip_address
where hostname/ip_address isthe third host name or IPaddress of community 2.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMPv3 community 2view type - set
Sets the SNMPv3 view type forcommunity 2.
snmp -ca2 type
where type isv getv setv trap
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 321
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 3name - set
Sets the name of community 3. snmp -c3 name
where name is a descriptivename of community 3.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMP community 3first host name or IPaddress - set
Checks syntax and sets the firsthost name or IP address ofcommunity 3.
snmp -c3i1hostname/ip_address
where hostname/ip_address isthe first host name or IPaddress of community 3.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 3second host name or IPaddress - set
Checks syntax and sets the secondhost name or IP address ofcommunity 3.
snmp -c3i2hostname/ip_address
where hostname/ip_address isthe second host name or IPaddress of community 3.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 323
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP community 3third host name or IPaddress - set
Checks syntax and sets the thirdhost name or IP address ofcommunity 3.
snmp -c3i3hostname/ip_address
where hostname/ip_address isthe third host name or IPaddress of community 3.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SNMPv3 community 3view type - set
Sets the SNMPv3 view type forcommunity 3.
snmp -ca3 type
where type isv getv setv trap
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 -set
Sets the contact name. snmp -cn contact_name
where contact_name is thename of the party to becontacted when SNMPtraps an event.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 325
Table 75. snmp command (continued)
Function What it does Command Valid targets
SNMP location - set Sets the location. snmp -l hostname/ip_address
where hostname/ip_addressidentifies the websitesupporting SNMP for thismanagement module.v Arguments containing
spaces must be enclosedin quotation marks. Noleading or trailing spacesare allowed inarguments.
v If this argument is notspecified, the snmpcommand clears thisoption.
v You can also clear thisoption by assigning anempty string as its value.
This command can only berun by users who have oneor more of the followingcommand authorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the SNMP configuration, while advanced management module 1is set as the persistent command environment, at the system:mm[1]> prompt, typesnmp
To enable the SNMP agent and SNMP traps, while advanced management module1 is set as the persistent command environment, at the system:mm[1]> prompt, typesnmp -a -on -t -on
The following example shows the information that is returned from these twocommands: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 -onsystem:mm[1]>
Chapter 3. Command reference 327
sol (serial over LAN) commandThis command configures SOL functions and indicates SOL status.
Table 76. sol (serial over LAN) command
Function What it does Command Valid targets
Display SOL status Displays the SOL status for thetargeted device:v When the command target is the
primary management module, itdisplays the following values:– -status on/off (global SOL
status)– -c retry_count– -e CLI_key_sequence– -i retry_interval– -r reset_blade_key_seq– -s send_threshold– -t accumulate_timeout– -v VLAN_id
Note: For the advancedmanagement module, theVLAN_id is identified as "VLANID".
v When the command target is ablade server, it displays thefollowing:– -status enabled/disabled (SOL
status for the blade server)– Status of any SOL sessions for
that blade server:- Not ready- Ready- Active
sol -T system:mm[x]
-T system:blade[x]
where x is the primarymanagement-moduleor blade server baynumber.
SOL retry interval - set Sets the SOL retry interval to theinput value.
sol -i value
where value is from 10 msto 2550 ms, inclusive, in 10ms increments. If youenter a value less than 10ms, the retry interval willbe set to 10 ms. If youenter a value greater than2550 ms, the retry intervalwill be set to 2550 ms.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 theinput value.
sol -c value
where value is from 0 to 7,inclusive. If you enter avalue of 0, no retries willbe attempted. If you entera value greater than 7, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SOL send threshold - set Sets the SOL send threshold to theinput value. Setting the thresholdvalue to 1 causes the blade serverintegrated system managementprocessor to send an SOL packet assoon as the first character isreceived.
sol -s value
where value is from 1 to251, inclusive. If you entera value outside this range,an error will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 329
Table 76. sol (serial over LAN) command (continued)
Function What it does Command Valid targets
SOL accumulate timeout- set
Sets the SOL accumulate timeout tothe input value.
sol -t value
where value is from 5 msto 1275 ms, inclusive. Ifyou enter a value less than5 ms, the accumulatetimeout will be set to 5ms. If you enter a valuegreater than 1275 ms, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SOL enable - global Enables SOL globally for theBladeCenter unit. The global SOLenable command does not affectthe SOL session status for eachblade server.
sol -status enabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SOL enable - bladeserver
Enables SOL for the specified bladeserver.
sol -status enabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
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 theBladeCenter unit. The global SOLdisable command does not affectthe SOL session status for eachblade server.
sol -status disabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
SOL disable - bladeserver
Disables SOL for the specifiedblade server.
sol -status disabled
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:blade[x]
where x is the bladeserver bay number.
Chapter 3. Command reference 331
Table 76. sol (serial over LAN) command (continued)
Function What it does Command Valid targets
CLI key sequence - set Sets the key sequence that is usedto enter the CLI while a Telnetsession in SOL mode.
sol -e value
where value is the keysequence. In this sequence,a ^ (the carat symbol)indicates a Ctrl that mapsto control-key sequences;for example:v ^[ (the carat symbol
followed by a leftbracket) means Esc
v ^M (the carat symbolfollowed by a capitolM) means carriagereturn.
Refer to an ASCII-to-keyconversion table for acomplete listing ofcontrol-key sequences.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 keysequence - set
Sets the key sequence that willreset a blade server while a Telnetsession in SOL mode.
sol -r value
where value is the keysequence. In this sequence,a ^ (the carat symbol)indicates a Ctrl that mapsto control-key sequences;for example:v ^[ (the carat symbol
followed by a leftbracket) means Esc
v ^M (the carat symbolfollowed by a capitolM) means carriagereturn.
Refer to an ASCII-to-keyconversion table for acomplete listing ofcontrol-key sequences.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configurationv Blade configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To set the SOL accumulate timeout to 25 ms, while management module 1 is set asthe persistent command environment, at the system:mm[1]> prompt, typesol -t 25
To set the reset blade server key sequence to Esc R Esc r Esc R, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typesol -r ^[R^[r^[R
To display the SOL settings for the management module, while the managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typesol
To display the SOL settings for the server blade in the third bay, while blade 3 isset as the persistent command environment, at the system:blade[3]> prompt, typesol
Chapter 3. Command reference 333
The following example shows the information that is returned from thesecommands:system:mm[1]> sol -t 25OKsystem:mm[1]> sol-status enabled-c 3-e ^[(-i 250-r ^[R^[r^[R-s 250-t 5VLAN ID 4095system:mm[1]>
system:blade[3]> sol-status enabledSOL Session: Not ReadySOL retry interval: 250 msSOL retry count: 3SOL bytes sent: 0SOL bytes received: 0SOL destination IP address: 10.10.10.80SOL destination MAC: 00:00:00:00:00:00SOL I/O module slot number: 0SOL console user ID:SOL console login from:SOL console session started:SOL console session stopped:Blade power state: OnSOL recommended action: Internal network path between the AMM and thisblade server is currently not available. Please refer to AMM user guide fortroubleshooting information.system:blade[3]>
334 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sshcfg commandThis 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 themanagement module. Returnedvalues are:
v -v1 off
v -cstatus: state of CLI SSH server(enabled, disabled)
v CLI SSH port number
v -sstatus: state of SMASH SSHserver (enabled, disabled)
v SMASH SSH port number
v ssh-dss fingerprint
v ssh-rsa fingerprint
v number of SSH public keysinstalled
v number of locations available tostore SSH keys
Note: For scripting purposes, the"-v1 off" state is always displayed.
sshcfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display RSA host keyinformation
Displays RSA host key informationfor the management module.
sshcfg -hk rsa -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display DSA host keyinformation
Displays DSA host key informationfor the management module.
sshcfg -hk dsa -T system:mm[x]
where x is the primarymanagement-modulebay number.
Generate host key Generates a host key for themanagement module.
sshcfg -hk gen
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 335
Table 77. sshcfg command (continued)
Function What it does Command Valid targets
Set state of CLI SSHserver
Sets the state of the CLI SSH serverfor the management module.
sshcfg -cstatus state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set state of SMASHSSH server
Sets the state of the SMASH SSHserver for the management module.
sshcfg -sstatus state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To display SSH status, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typesshcfg
The following example shows the information that is returned from this command:system:mm[1]> sshcfg-v1 off-cstatus enabledCLI SSH port 22-sstatus disabledSMASH SSH port 50024ssh-dss 2048 bit fingerprint: 27:ee:bd:a9:27:28:d8:a5:93:03:3d:8e:77:d0:38:2cssh-rsa 2048 bit fingerprint: 66:c9:73:4f:18:11:02:10:f3:05:6e:d7:27:05:a5:012 SSH public keys installed10 locations available to store SSH public keyssystem:mm[1]>
336 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sslcfg commandThis command sets and displays the Secure Sockets Layer (SSL) status of theadvanced management module.
Table 78. sslcfg command
Function What it does Command Valid targets
Display managementmodule SSL status
Displays the SSL status of thespecified management module.This status includes informationabout SSL certificates.
sslcfg -T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Set SSL certificatehandling for standbymanagement module
Enables or disables use of anadditional SSL certificate for thestandby management module. Ifdisabled, the standby managementmodule uses the same SSLcertificate as the primarymanagement module.Note: An additional SSL certificatecan only be configured whenmanagement module advancedfailover is set to "swap" and thestandby management module has avalid SSL certificate set up.
sslcfg -ac state
where state is:v on to use an additional
certificatev off to use the same
certificate
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the standbymanagement-modulebay number.
Set SSL state formanagement moduleweb server
Enables or disables SSL for themanagement module web server.Note: The SSL for themanagement module web servercan only be enabled if a valid SSLcertificate is set up.
sslcfg -server state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Chapter 3. Command reference 337
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Set SSL state for LDAPclient
Enables or disables SSL for theLDAP client.Note: The SSL for the LDAP clientcan only be enabled if a valid SSLcertificate is set up.
sslcfg -client state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
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-signedcertificate
Generates a self-signed certificatefor the management module webserver or the LDAP client.
The following values must be setwhen generating a self-signedcertificate:v Country using the -c command
option.v State or province using the -sp
command option.v City or locality using the -cl
command option.v Organization name using the -on
command option.v Management module host name
using the -hn command option.Note: This host name mustmatch the host name that is usedby a web browser to connect tothe management module.
The following optional values canbe set when generating aself-signed certificate:v Contact person using the -cp
command option.v Email address of the contact
person using the -ea commandoption.
v Unit within a company ororganization using the -oucommand option.
v Additional information such as asurname using the -s commandoption.
v Additional information such as agiven name using the -gncommand option.
v Additional information such asinitials using the -in commandoption.
v Additional information such as adistinguished name qualifierusing the -dq command option.
sslcfg -cert type -ccountry -sp "state" -cl"city" -on "org" -hnhostname -cp "name" -eaemail -ou "org_unit" -s"surname" -gn"given_name" -in "initial"-dq "dn_qualifier"
where the followingrequired options are:v type is:
– server for amanagement moduleweb server certificate.
– client for an LDAPclient certificate.
v country is two-characteralphabetic code for thecountry.
v "state" is a state orprovince name of up to60 characters in length.
v "city" is a city orlocality name of up to50 characters in length.
v "org" is an organizationname of up to 60characters in length.
v hostname is a valid hostname of up to 60characters in length.
where the followingoptional options are:v "name" is up to 60
characters in length.v email is a valid email
address of up to 60characters.
v "org_unit" is up to 60characters.
v "surname" is up to 60characters.
v "given_name" is up to 60characters.
v "initial" is up to 20characters.
v "dn_qualifier" is up to 60characters.
(continued on next page)
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Chapter 3. Command reference 339
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Generate self-signedcertificate
(continued)
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
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 signingrequest (CSR) for the managementmodule web server or the LDAPclient.
The following values must be setwhen generating a CSR:v Country using the -c command
option.v State or province using the -sp
command option.v City or locality using the -cl
command option.v Organization name using the -on
command option.v Management module host name
using the -hn command option.Note: This host name mustmatch the host name that is usedby a web browser to connect tothe management module.
The following optional values canbe set when generating a CSR:v Contact person using the -cp
command option.v Email address of the contact
person using the -ea commandoption.
v Unit within a company ororganization using the -oucommand option.
v Additional information such as asurname using the -s commandoption.
v Additional information such as agiven name using the -gncommand option.
v Additional information such as ainitials using the -in commandoption.
v Additional information such as adistinguished name qualifierusing the -dq command option.
v Additional information such as aCSR password using the -cpwdcommand option.
(continued on next page)
sslcfg -csr type -ccountry -sp "state" -cl"city" -on "org" -hnhostname -cp "name" -eaemail -ou "org_unit" -s"surname" -gn"given_name" -in "initial"-dq "dn_qualifier" -cpwdpassword -un "un_name"
where the followingrequired options are:v type is:
– server for amanagement moduleweb server CSR.
– client for an LDAPclient CSR.
v country is two-characteralphabetic code for thecountry.
v "state" is a state orprovince name of up to60 characters in length.
v "city" is a city orlocality name of up to50 characters in length.
v "org" is an organizationname of up to 60characters in length.
v hostname is a valid hostname of up to 60characters in length.
where the followingoptional options are:v "name" is up to 60
characters in length.v email is a valid email
address of up to 60characters.
v "org_unit" is up to 60characters.
v "surname" is up to 60characters.
v "given_name" is up to 60characters.
(continued on next page)
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Chapter 3. Command reference 341
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Generate CSR
(continued)
v Additional information such asan unstructured name qualifierusing the -un command option.
v "initial" is up to 20characters.
v "dn_qualifier" is up to 60characters.
v password is between 6and 30 characters.
v "un_name" is up to 60characters.
Note: Arguments thatmust be quote-delimitedare shown in quotationmarks.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
Download certificate file Downloads the specified certificatefile.
The IP address of the TFTP serverfor downloading an SSL self-signedcertificate or CSR must be set usingthe -i command.
The file name for downloading anSSL self-signed certificate or CSRcan be set using the -l command.If no file name is specified, thedefault file name for the file will beused.
sslcfg -dnld -cert_type -lfilename -i ipaddress
where:v cert_type is
– cert for an SSLself-signed certificate
– csr for a CSRv filename is a valid
filename of up to 256characters in lengthcontaining any characterexcept the percent sign (% ), forward-slash ( / ),or double-quote ( " ).
v ipaddress is the IPv4 orIPv6 IP address of theTFTP server.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
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 specifiedcertificate file.
The IP address of the TFTP serverfor uploading an SSL self-signedcertificate must be set using the -icommand.
The file name for uploading an SSLself-signed certificate can be setusing the -l command.
sslcfg -upld -cert -lfilename -i ipaddress
where:v filename is a valid
filename of up to 256characters in lengthcontaining any characterexcept the percent sign (% ), forward-slash ( / ),or double-quote ( " ).
v ipaddress is the IPv4 orIPv6 IP address of theTFTP server.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Chapter 3. Command reference 343
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Import/download/remove trustedcertificate 1
Perform the specified operation ontrusted certificate 1 for the SSLclient. Valid operations are:v import (upload)v downloadv remove
The IP address of the TFTP serverfor uploading or downloading atrusted certificate must be set usingthe -i command.
The file name for uploading ordownloading a trusted certificatecan be set using the -l command.
sslcfg -tc1 operation
where operation is:v importv downloadv remove
Note: The -tc1 optionmust be used with thefollowing options:v -i ipaddressv -l filename
where:v ipaddress is the IPv4 or
IPv6 IP address of theTFTP server.
v filename is a validfilename of up to 256characters in lengthcontaining any characterexcept the percent sign (% ), forward-slash ( / ),or double-quote ( " ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
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/remove trustedcertificate 2
Perform the specified operation ontrusted certificate 2 for the SSLclient. Valid operations are:v import (upload)v downloadv remove
The IP address of the TFTP serverfor uploading or downloading atrusted certificate must be set usingthe -i command.
The file name for uploading ordownloading a trusted certificatecan be set using the -l command.
sslcfg -tc2 operation
where operation is:v importv downloadv remove
Note: The -tc2 optionmust be used with thefollowing options:v -i ipaddressv -l filename
where:v ipaddress is the IPv4 or
IPv6 IP address of theTFTP server.
v filename is a validfilename of up to 256characters in lengthcontaining any characterexcept the percent sign (% ), forward-slash ( / ),or double-quote ( " ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Chapter 3. Command reference 345
Table 78. sslcfg command (continued)
Function What it does Command Valid targets
Import/download/remove trustedcertificate 3
Perform the specified operation ontrusted certificate 3 for the SSLclient. Valid operations are:v import (upload)v downloadv remove
The IP address of the TFTP serverfor uploading or downloading atrusted certificate must be set usingthe -i command.
The file name for uploading ordownloading a trusted certificatecan be set using the -l command.For importing a certificate "-l<filename>" is required.
sslcfg -tc3 operation
where operation is:v importv downloadv remove
Note: The -tc3 optionmust be used with thefollowing options:v -i ipaddressv -l filename
where:v ipaddress is the IPv4 or
IPv6 IP address of theTFTP server.
v filename is a validfilename of up to 256characters in lengthcontaining any characterexcept the percent sign (% ), forward-slash ( / ),or double-quote ( " ).
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primaryor standbymanagement-modulebay number.
Example: To view SSL information for the management module in bay 1, whilethis management module is set as the persistent command environment, at thesystem:mm[1]> prompt, typesslcfg
The following example shows the information that is returned from this command:system:mm[1]> sslcfg-server disabled-client disabledSSL Server Certificate status:A CA-signed certificate is installedSSL Client Certificate status:No certificate has been generatedSSL Client Trusted Certificate status:Trusted Certificate 1: Not availableTrusted Certificate 2: Not availableTrusted Certificate 3: Not availablesystem:mm[1]>
346 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
syslog commandThis command manages how the advanced management module handlestransmission of event log messages to networked syslog event collectors.
Table 79. syslog command
Function What it does Command Valid targets
Display syslogconfiguration
Displays the syslog event logtransmission configuration of theadvanced management module.
syslog -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set syslog filter level Set severity filtering levels forsyslog event log transmission.
syslog -sev level
where level is:v i selects error, warning,
and informational logsv w selects error and
warning logsv e selects error logs
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set syslog event logtransmission state forcollector 1
Enables or disables syslog event logtransmission to collector 1.
syslog -coll1 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 347
Table 79. syslog command (continued)
Function What it does Command Valid targets
Set syslog event logtransmission state forcollector 2
Enables or disables syslog event logtransmission to collector 2.
syslog -coll2 state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
syslog event logcollector 1 host name orIP address - set
Sets the host name or IP addressfor syslog event collector 1.
syslog -i1hostname/ip_address
where hostname/ip_addressis the collector 1 hostname or IP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
syslog event logcollector 2 host name orIP address - set
Sets the host name or IP addressfor syslog event collector 2.
syslog -i2hostname/ip_address
where hostname/ip_addressis the collector 2 hostname or IP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 logcollector 1 port number -set
Sets the port number for syslogevent collector 1.
syslog -p1 port
where port is the collector1 port number from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
syslog event logcollector 2 port number -set
Sets the port number for syslogevent collector 2.
syslog -p2 port
where port is the collector2 port number from 1 to65535, inclusive. If youenter a value outside thisrange, an error will bedisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 349
Table 79. syslog command (continued)
Function What it does Command Valid targets
Generate test message Generates a test syslog message totest the configuration.Note: The -test command optionsmust be run exclusive of othercommand options.
syslog -test
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis log
managementv Chassis administrationv Chassis configurationv Blade administrationv Blade configurationv Blade remote presencev I/O module
administrationv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To view the syslog event log transmission configuration of the primaryadvanced management module in bay 1, while this management module is set asthe persistent command environment, at the system:mm[1]> prompt, typesyslog
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 514system:mm[1]>
350 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
tcpcmdmode commandThis command displays and changes the timeout of the TCP command-modesessions that are used by IBM Systems Director software for out-of-bandcommunication with the management module. This command is also used toenable or disable the TCP command-mode sessions.
Table 80. tcpcmdmode command
Function What it does Command Valid targets
Display TCPcommand-mode sessionstatus and timeout
Displays the secure and non-secureTCP command-mode session status(maximum number of sessions) andtimeout.
tcpcmdmode -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set TCP command-modesession timeout
Sets the secure and non-secure TCPcommand-mode session timeoutvalue.
tcpcmdmode -t timeout
where timeout is from 0seconds (no timeout) to4294967295 seconds,inclusive. If you enter avalue outside this range,an error will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Disable TCPcommand-mode sessions
Disables TCP command-modesessions that are used by IBMSystems Director software forout-of-band communication withthe management module. Thisapplies to both read and writeoperations.
tcpcmdmode -status 0
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 351
Table 80. tcpcmdmode command (continued)
Function What it does Command Valid targets
Enable and set numberof TCP command-modesessions
Enables TCP command-mode andsets the maximum number ofsessions that can be used by IBMSystems Director software forout-of-band communication withthe management module. For readoperations, all of the values from 1to 20, inclusive, mean enabled.Note: The advanced managementmodule supports a combined totalof up to 20 secure and non-secureTCP command-mode sessions.
tcpcmdmode -statusnumber_sessions
where number_sessions isfrom 1 to 20, inclusive. (Avalue of 0 disables TCPcommand-mode sessions.)If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Disable secure TCPcommand-mode sessions
Disables secure TCPcommand-mode sessions that areused by IBM Systems Directorsoftware for out-of-bandcommunication with themanagement module. This appliesto both read and write operations.
tcpcmdmode -sstatus 0
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable and set numberof secure TCPcommand-mode sessions
Enables secure TCPcommand-mode and sets themaximum number of sessions thatcan be used by IBM SystemsDirector software for out-of-bandcommunication with themanagement module. For readoperations, all of the values from 1to 20, inclusive, mean enabled.Note: The advanced managementmodule supports a combined totalof up to 20 secure and non-secureTCP command-mode sessions.
tcpcmdmode -sstatusnumber_sessions
where number_sessions isfrom 1 to 20, inclusive. (Avalue of 0 disables secureTCP command-modesessions.) If you enter avalue outside this range,an error will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
352 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Example: To enable a maximum of three TCP command-mode sessions for theprimary management module, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typetcpcmdmode -status 3
To enable a maximum of five secure TCP command-mode sessions for the primarymanagement module, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typetcpcmdmode -sstatus 5
To set the TCP command-mode session timeout for the primary managementmodule to 6 minutes, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typetcpcmdmode -t 360
To display the TCP command-mode session status and timeout for the primarymanagement module, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typetcpcmdmode
The following example shows the information that is returned from thesecommands:system:mm[1]> tcpcmdmode -status 3OKsystem:mm[1]> tcpcmdmode -sstatus 5OKsystem:mm[1]> tcpcmdmode -t 360OKsystem:mm[1]> tcpcmdmode-status 3 connections-sstatus 5 connections-t 360 secondssystem:mm[1]>
Chapter 3. Command reference 353
telnetcfg (Telnet configuration) commandThis command displays and configures the command-line session parameters ofthe primary management module.
Table 81. telnetcfg (Telnet configuration) command
Function What it does Command Valid targets
Display command-linesession configuration
Displays the command-line sessionconfiguration of the primarymanagement module.
telnetcfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
Set command-linesession timeout forprimary managementmodule
Sets the command-line sessiontimeout value for the primarymanagement module.
telnetcfg -t timeout
where timeout is from 0seconds (no timeout) to4294967295 seconds,inclusive. If you enter avalue outside this range,an error will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To set the command-line session timeout for the primary managementmodule to 6 minutes, while management module 1 is set as the persistentcommand environment, at the system:mm[1]> prompt, typetelnetcfg -t 360
To display the command-line session configuration for the primary managementmodule, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typetelnetcfg
The following example shows the information that is returned from these twocommands:system:mm[1]> telnetcfg -t 360OKsystem:mm[1]> telnetcfg-t 360system:mm[1]>
354 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
temps commandThis command displays actual temperatures and temperature threshold values forBladeCenter components.
Table 82. temps command
Function What it does Command Valid targets
Display temperaturevalues
Displays the current temperatureand temperature threshold settingsfor the specified component:v The management module target
displays the managementmodule ambient temperature.
v The blade server target displaysthe temperature values forcomponents in the specifiedblade server, such asmicroprocessors and expansionmodules.
v The media tray target displaysvalues for the temperature sensorin the media tray.
temps -T system:mm[x]
-T system:blade[x]
-T system:mt
where x is the primarymanagement-moduleor blade server baynumber.
Example: To view the current temperature and temperature thresholds for theblade server in bay 3, while this blade server is set as the persistent commandenvironment, at the system:blade[3]> prompt, typetemps
The following example shows the information that is returned from this command:system:blade[3]> temps
Hard WarningComp Value Warning Shutdown Reset---- ----- ------- -------- -------CPU1 38.00 85.00 95.00 78.00CPU2 35.00 85.00 95.00 78.00BEM ----- ----- ----- -----system:blade[3]>
Chapter 3. Command reference 355
trespass commandThis command sets and displays the status and message for the advancedmanagement module trespass feature that can display a warning message to userswhen they log in.
Table 83. trespass command
Function What it does Command Valid targets
Display status ofmanagement moduletrespass feature
Displays status of the trespassfeature for the managementmodule. Possible return values are:
v -twe (on or off)
v -tw warning_message
Note: The warning_message isshown only when the trespassfeature is enabled (-twe on).
trespass -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablemanagement moduletrespass feature
Enables or disables trespass featurefor management module.
trespass -twe state
where state is on or off.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set management moduletrespass message
Sets message that is displayed tousers who log in to themanagement module when thetrespass feature is enabled.Note: Setting a newwarning_message permanentlyreplaces the default warningmessage.
trespass -tw"warning_message"
where "warning_message"is up to 1600 characters inlength and enclosed indouble-quotation marks.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 moduletrespass feature todefault values
Sets trespass feature to defaultvalues:
v -twe: off
v -tw (warning message):WARNING! This computersystem and network is PRIVATEAND PROPRIETARY and mayonly be accessed by authorizedusers. Unauthorized use of thiscomputer system or network isstrictly prohibited and may besubject to criminal prosecution,employee discipline up to andincluding discharge, or thetermination of vendor/servicecontracts. The owner, or itsagents , may monitor anyactivity or communication on thecomputer system or network.The owner, or its agents, mayretrieve any information storedwithin the computer system ornetwork. By accessing and usingthis computer system ornetwork, you are consenting tosuch monitoring and informationretrieval for law enforcement andother purposes. Users shouldhave no expectation of privacy asto any communication on orinformation stored within thecomputer system or network,including information storedlocally or remotely on a harddrive or other media in use withthis computer system ornetwork.
trespass -twd
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To enable the management module trespass feature, while management module 1is set as the persistent command environment, at the system:mm[1]> prompt, typetrespass -twe on
To set the trespass feature message to 'Authorized Access only', while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typetrespass -tw "Authorized Access only"
To display the management module trespass feature status, while managementmodule 1 is set as the persistent command environment, at the system:mm[1]>prompt, typetrespass
Chapter 3. Command reference 357
The following example shows the information that is returned from thesecommands:system:mm[1]> trespass -twe onOKsystem:mm[1]> trespass -tw "Authorized Access only"-tw OKsystem:mm[1]> trespass-twe on-tw Authorized Access onlysystem:mm[1]>
358 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
uicfg commandThis command displays and configures the management module user interfacesettings.
Table 84. uicfg command
Function What it does Command Valid targets
Display managementmodule user interfacesettings
Displays the user interface settingsfor the management module.Returned values indicate enabledor disabled status for the followinginterfaces:v -cliv -snmpv -tcm (TCP command mode)v -stcm (secure TCP command
mode)v -web (web interface)
uicfg -T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disablecommand-line interface
Enables or disables themanagement modulecommand-line interface (usingTelnet or SSH).
uicfg -cli state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disableSNMPv1 and SNMPv3
Enables or disables SNMPv1 andSNMPv3 connections to themanagement module.
uicfg -snmp state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 359
Table 84. uicfg command (continued)
Function What it does Command Valid targets
Enable / disable TCPcommand mode
Enables or disables TCP commandmode (used by IBM SystemsDirector) for the managementmodule.
uicfg -tcm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set number of TCPcommand modeconnections
Enable or disable the TCPcommand mode, or sets themaximum number of connectionsexplicitly.Note: Any number of connections(1 through 20) displays a status ofenabled. Zero connections displaysa status of disabled.
uicfg -tcm port_mode
where port_mode isenabled (1 connection),disabled (no connections),or a number between 0and 20, inclusive, thatindicates the maximumnumber of non-secure TCPsession connections.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable secureTCP command mode
Enables or disables secure TCPcommand mode (used by IBMSystems Director) for themanagement module.
uicfg -stcm state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 secureTCP command modeconnections
Enable or disable the secure TCPcommand mode, or sets themaximum number of connectionsexplicitly.Notes:
v On a write operation, themaximum number ofconnections can be set explicitly(0-20), or it can be enabled (1connection) or disabled (0connections).
v On a read operation, disabledmeans 0 connections, andenabled means 1 or moreconnections.
v The total session count of TCMand STCM is limited to 20.
uicfg -stcm port_mode
where port_mode isenabled (1 connection),disabled (no connections),or a number between 0and 20, inclusive, thatindicates the maximumnumber of secure TCPsession connections.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable webinterface
Enables or disables themanagement module web interface.
uicfg -web state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To disable Secure TCP command mode for the management module,while management module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeuicfg -stcm disabled
To display the user interface configuration for the management module, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeuicfg
Chapter 3. Command reference 361
The following example shows the information that is returned from these twocommands:system:mm[1]> uicfg -stcm disabledWarning: Communication with IBM Systems Director via Secure TCP Command Modehas been disabled.OKsystem:mm[1]> uicfg-cli enabled (telnet only)-snmp enabled-stcm enabled-tcm disabled-web enabledsystem:mm[1]>
362 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update (update firmware) commandThis command updates firmware using the uniform resource locator (URL) of aTFTP, FTP, HTTP, or HTTPS server and displays information about firmwareinstalled 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 issupported for the cluster solution before you update the code.
v Scalable complexes in a BladeCenter unit require a consistent firmware level onall blade servers in a complex. When scripting firmware updates for bladeservers in a scalable complex, make sure that the update commands are includedfor each node in the complex.
Table 85. update (update firmware) command
Function What it does Command Valid targets
Display firmwareattributes
Displays attributes of the firmwareinstalled in the command target.Return values are:v Firmware typev Build IDv Filenamev Release datev Revision level
Notes:v When the command target is the
primary management module,this command will return thevalues for the currently activefirmware and for the pendingfirmware, that will become activeafter the next managementmodule reboot.
v For standby advancedmanagement modules, thereturned value will also indicateif a firmware update is inprogress and the percentage thatis complete.
v For I/O modules that support it,this command will also displayfirmware image information.
update -a -T system:mm[x]
-T system:blade[x]:sp
-T system:switch[x]
where x is the primarymanagement-modulenumber, standbymanagement-modulenumber, blade serverbay number, or I/Omodule bay number.
Chapter 3. Command reference 363
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update firmware usingURL
Update firmware for the commandtarget using a uniform resourcelocator (URL).Important: Command authoritydefinitions might change betweenfirmware versions. Make sure thatthe command authority level set foreach user is correct after updatingmanagement-module firmware (see“Commands and user authority”on page 8).Notes:v Updating to older firmware
levels may cause loss of certainfunctionality
v The JS22 or JS12 blade serverfirmware is too large to beupdated using this command.See the User's Guide for yourJS22 or JS12 blade server forinformation about updatingfirmware.
update -u U_R_L
where U_R_L is fullyqualified uniform resourcelocator of a tftp, ftp, http,or https server where thefirmware update image islocated.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
(for managementmodule)
v Blade administration(for blade server)
v I/O moduleadministration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]:sp
-T system:switch[x]
where x is the primarymanagement-module,blade server baynumber, orI/O-module baynumber.
Update firmware andreboot
Update firmware and reboot theadvanced management module touse new firmware if the updatesucceeds.Important: Command authoritydefinitions might change betweenfirmware versions. Make sure thatthe command authority level set foreach user is correct after updatingmanagement-module firmware.
update -u U_R_L -r
where U_R_L is fullyqualified uniform resourcelocator of a tftp, ftp, http,or https server where thefirmware update image islocated.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-module.
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(verbose)
Update firmware for the commandtarget, showing details of thefirmware download and flashoperations. The detailedinformation is not shown until theupdate is complete, which mighttake several minutes.Important: Command authoritydefinitions might change betweenfirmware versions. Make sure thatthe command authority level set foreach user is correct after updatingmanagement-module firmware.Notes:v Updating to older firmware
levels may cause loss of certainfunctionality
v The JS22 or JS12 blade serverfirmware is too large to beupdated using this command.See the User's Guide for yourJS22 or JS12 blade server forinformation about updatingfirmware.
update -u U_R_L -v
where U_R_L is fullyqualified uniform resourcelocator of a tftp, ftp, http,or https server where thefirmware update image islocated.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
(for managementmodule)
v Blade administration(for blade server)
v I/O moduleadministration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]:sp
-T system:switch[x]
where x is the primarymanagement-module,blade server baynumber, orI/O-module baynumber.
Update I/O modulefirmware
Directly update I/O modulefirmware image.Note: Only some I/O moduleshave this capability.
update -u U_R_L -imgimg_index
where:v U_R_L is fully qualified
uniform resource locatorof a tftp, ftp, http, orhttps server where thefirmware update imageis located.
v img_index is the imageindex you are updating.Use the update -acommand to listavailable images andtheir index numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 365
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update I/O modulefirmware (verbose)
Directly update I/O modulefirmware image, showing details ofthe firmware download and flashoperations. The detailedinformation is not shown until theupdate is complete, which mighttake several minutes.
update -u U_R_L -imgimg_index -v
where:v U_R_L is fully qualified
uniform resource locatorof a tftp, ftp, http, orhttps server where thefirmware update imageis located.
v img_index is the imageindex to the I/Omodule firmware youare updating. Use theupdate -a command tolist available imagesand their indexnumbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Activate I/O modulefirmware
Directly activate I/O modulefirmware image.Note: Only some I/O moduleshave this capability.
update -activateimg_index
where img_index is theimage index you areactivating. Use the update-a command to listavailable images and theirindex numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
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/Omodule firmware
Directly update I/O module andactivate the firmware image.Notes:v Only some I/O modules have
this capability.v The activate option can be used
with the other options. You canflash first, then activate thespecified index.
v The image index you activatecan be different from the oneyou update.
update -u U_R_L -imgimg_index -activateimg_index
where:v U_R_L is fully qualified
uniform resource locatorof a tftp, ftp, http, orhttps server where thefirmware update imageis located.
v img_index is the imageindex you areactivating. Use theupdate -a command tolist available imagesand their indexnumbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Chapter 3. Command reference 367
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update firmware
(Obsolete command. SeeNote following table.)
Update firmware for the commandtarget.Important: Command authoritydefinitions might change betweenfirmware versions. Make sure thatthe command authority level set foreach user is correct after updatingmanagement-module firmware.Note: The P6 blade serverfirmware is too large to be updatedusing this command. See the User'sGuide for your P6 blade server forinformation about updatingfirmware.
update -i ip_address -lfilelocation
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server.
v filelocation is the locationof the firmware updatefile.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
(for managementmodule)
v Blade administration(for blade server)
v I/O moduleadministration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]:sp
-T system:switch[x]
where x is the primarymanagement-module,blade server baynumber, or I/O(switch) module baynumber.
Update firmware(verbose)
(Obsolete command. SeeNote following table.)
Update firmware for the commandtarget, showing details of thefirmware download and flashoperations. The detailedinformation is not shown until theupdate is complete, which mighttake several minutes.Important: Command authoritydefinitions might change betweenfirmware versions. Make sure thatthe command authority level set foreach user is correct after updatingmanagement-module firmware.Note: The P6 blade serverfirmware is too large to be updatedusing this command. See the User'sGuide for your P6 blade server forinformation about updatingfirmware.
update -i ip_address -lfilelocation -v
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server.
v filelocation is the locationof the firmware updatefile.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis administration
(for managementmodule)
v Blade administration(for blade server)
v I/O moduleadministration (for I/Omodule)
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
-T system:blade[x]:sp
-T system:switch[x]
where x is the primarymanagement-module,blade server baynumber, or I/O(switch) module baynumber.
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 modulefirmware
(Obsolete command. SeeNote following table.)
Directly update I/O modulefirmware image.Note: Only some I/O moduleshave this capability.
update -i ip_address -lfilelocation -img img_index
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server.
v filelocation is the locationof the firmware updatefile.
v img_index is the imageindex you are updating.Use the update -acommand to listavailable images andtheir index numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the I/O(switch) module baynumber.
Chapter 3. Command reference 369
Table 85. update (update firmware) command (continued)
Function What it does Command Valid targets
Update I/O modulefirmware (verbose)
(Obsolete command. SeeNote following table.)
Directly update I/O modulefirmware image, showing details ofthe firmware download and flashoperations. The detailedinformation is not shown until theupdate is complete, which mighttake several minutes.Note: Only some I/O moduleshave this capability.
update -i ip_address -lfilelocation -img img_index-v
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server.
v filelocation is the locationof the firmware updatefile.
v img_index is the imageindex to the I/Omodule firmware youare updating. Use theupdate -a command tolist available imagesand their indexnumbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the I/O(switch) module baynumber.
Activate I/O modulefirmware
(Obsolete command. SeeNote following table.)
Directly activate I/O modulefirmware image.Note: Only some I/O moduleshave this capability.
update -activateimg_index
where img_index is theimage index you areactivating. Use the update-a command to listavailable images and theirindex numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the I/O(switch) module baynumber.
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/Omodule firmware
(Obsolete command. SeeNote following table.)
Directly update I/O module andactivate the firmware image.Notes:v Only some I/O modules have
this capability.v The activate option can be used
with the other options. You canflash first, then activate thespecified index.
v The image index you activatecan be different from the oneyou update.
update -i ip_address -lfilelocation -img img_index-activate img_index
where:v ip_address is the IPv4 or
IPv6 IP address of theTFTP server.
v filelocation is the locationof the firmware updatefile.
v img_index is the imageindex you areactivating. Use theupdate -a command tolist available imagesand their indexnumbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
administration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is the I/O(switch) module baynumber.
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 fewreleases before being removed, users are encouraged to transition to the -u optionas soon as possible.
To accomplish this transition, the IP address and file location of the firmwareupdate file or image, specified by the arguments to the -i and -l options, must bereplaced by the -u option followed by an argument that specifies the fullyqualified uniform resource locator (URL) of a tftp, ftp, http, or https server wherethe firmware update file or image is located.
Example: To update the advanced management module firmware from a TFTPserver and reboot the advanced management module in management-module bay1 after a successful update, type the following command at the system:> prompt.For this example, the IP address of the TFTP server is 9.37.177.215 and thefirmware file containing the update is named CNETMNUS.pkt. The verbose modeand reboot flag are also specified.update -u tftp://9.37.177.215/temp/CNETMNUS.pkt -T mm[1] -v -r
Chapter 3. Command reference 371
The following example shows the information that is returned from the updatecommand:system> update -u tftp://9.37.177.215/temp/CNETMNUS.pkt -T mm[1] -v -r100% transferred (100/100)transfer completed successfullyflashing firmware to target deviceStarting flash packet preparation.Flash preparation - packet percent complete 4.Flash preparation - packet percent complete 8.Flash preparation - packet percent complete 12.Flash preparation - packet percent complete 16.Flash preparation - packet percent complete 20.Flash preparation - packet percent complete 24.Flash preparation - packet percent complete 28.Flash preparation - packet percent complete 32.Flash preparation - packet percent complete 36.Flash preparation - packet percent complete 40.Flash preparation - packet percent complete 44.Flash preparation - packet percent complete 50.Flash preparation - packet percent complete 54.Flash preparation - packet percent complete 58.Flash preparation - packet percent complete 62.Flash preparation - packet percent complete 66.Flash preparation - packet percent complete 70.Flash preparation - packet percent complete 74.Flash preparation - packet percent complete 78.Flash preparation - packet percent complete 82.Flash preparation - packet percent complete 86.Flash preparation - packet percent complete 90.Flash preparation - packet percent complete 94.Flash preparation - packet percent complete 98.Flash operation phase starting.Flashing - packet percent complete 34.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 50.Flashing - packet percent complete 82.Update of AMM Main Application firmware was successful.
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) commandThis command displays and configures the management-module uplink failoverfeature. 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.
Note: This command does not apply to the BladeCenter S unit.
Table 86. uplink command
Function What it does Command Valid targets
Display uplink failoverstatus
Displays the management-moduleuplink failover status (enabled ordisabled) and the failover delay.
uplink -T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set physical networkuplink failover delay
Sets the amount of time betweendetection of a management-modulephysical uplink failure and failoverto the standby managementmodule.
uplink -dps delay
where delay is from 10 to172800 seconds, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable physicaluplink failover
Enables or disables failover to thestandby management module if theexternal physical network interfaceof the primary managementmodule fails.
uplink -ep state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 373
Table 86. uplink command (continued)
Function What it does Command Valid targets
Set logical networkuplink failover delay
Sets the amount of time betweendetection of a management-modulelogical uplink failure and failoverto the standby managementmodule.
uplink -dls delay
where delay is from 60 to172800 seconds, inclusive.If you enter a valueoutside this range, anerror will be displayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable / disable logicaluplink failover
Enables or disables failover to thestandby management module if theexternal logical network interface ofthe primary management modulefails.
You must enter a non-zero IPaddress (-ip command option) orIPv6 IP address (-ip6 commandoption) for a device that themanagement module can access tocheck its logical network linkbefore you can enable logicaluplink failover.
uplink -el state
where state is enabled ordisabled.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set IP address to checklogical network uplink
Sets the IPv4 IP address of thedevice that the managementmodule accesses to check its logicalnetwork link.
uplink -ip ip_address
where ip_address is a validIPv4 IP address. You mustenter a non-zero IPv4 IPaddress, in dotted decimalIP address format, beforeyou can enable logicaluplink failover.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 tocheck logical networkuplink
Sets the IPv6 IP address of thedevice that the managementmodule accesses to check its logicalnetwork link.
uplink -ip6 ip_address
where ip_address is a validIPv6 IP address. You mustenter a non-zero IPaddress, in IPv6 format,before you can enablelogical uplink failover.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set logical link loss alertand failover policy
Sets the alert and failover policy forlogical link loss to check either theIPv4 IP address, the IPv6 IPaddress, or both of these IPaddresses.Note: The -alert command optionapplies only when both the -ip and-ip6 command options are set.
uplink -alert setting
where setting is:v either to check either
the IPv4 IP address orthe IPv6 IP address.
v both to check both theIPv4 IP address and theIPv6 IP address.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To enable failover to the standby management module if the externalphysical network interface of a primary management module fails, whilemanagement module 1 is set as the persistent command environment, at thesystem:mm[1]> prompt, typeuplink -ep enabled
Chapter 3. Command reference 375
To display the uplink failover configuration, while management module 1 is set asthe persistent command environment, at the system:mm[1]> prompt, typeuplink
The following example shows the information that is returned from thesecommands:system:mm[1]> uplink -ep enabledOKsystem:mm[1]> uplinkFailover on network uplink loss is enabled for physical detectionUplink delay for physical detection: 60 seconds
Failover on network uplink loss is enabled for logical detectionUplink delay for logical detection: 1800 secondsDestination IP for MM to check its logical link: 1.1.1.0Destination IPv6 IP for MM to check its logical link: 1::2Alert and failover if both IPv4 and IPv6 link checks failsystem:mm[1]>
376 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
users commandThis command displays and configures user accounts, also called user profiles, ofthe primary management module.
Important: Command authority definitions might change between firmwareversions. Make sure that the command authority level set for each user is correctafter updating management-module firmware.
Table 87. users (management-module users) command
Function What it does Command Valid targets
Display all user profiles Displays all 12management-module user profiles.Returned values are:v User namev Authority levelv Current log in or log out statev Password compliancev State of account (active or
inactive)v Number of SSH public keys
installed for user
users -T system:mm[x]
where x is the primarymanagement-modulebay number.
Display active users Displays all users that are currentlylogged in to the managementmodule. Returned values include:v User namev User IP addressv Connection type (SNMPv1,
SNMPv3, SSH, TCP commandmode, Telnet, Web)
v Session ID
users -curr -T system:mm[x]
where x is the primarymanagement-modulebay number.
Terminate user session Terminates the specified user loginsession.Note: The session ID is found byrunning the users -curr command.
users -ts sessionID
where sessionID is anumber that correspondsto the user session ID.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 377
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Display single userprofile
Displays the specifiedmanagement-module user profile.Returned values are:v User namev Authority levelv Context namev Authentication protocolv Privacy protocolv Access typev Hostname/IP addressv Maximum simultaneous sessions
allowedv Number of active sessionsv Password compliancev Password expiration datev Account statev Number of SSH public keys
installed for this userv Last time this user logged in
users -user_number
where user_number is anumber from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all user profiles"list.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Delete user profile Delete the specifiedmanagement-module user profile.
users -user_number -clear
where user_number is anumber from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all user profiles"list. It is possible to deletean empty user profile.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 specifiedmanagement-module user account.
users -user_number-disable
where user_number is anumber from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all user profiles"list.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis administrationv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Enable user profile Enable a disabledmanagement-module user account.
users -user_number-enable
where user_number is anumber from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all user profiles"list.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis administrationv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 379
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Unlock user profile Unlock a lockedmanagement-module user account.
users -user_number-unlock
where user_number is anumber from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all user profiles"list.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
managementv Chassis administrationv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 specifiedmanagement-module user profile.
All fields must be specified whencreating a user profile for theBladeCenter T managementmodule.
For management modules otherthan those installed in aBladeCenter T unit, only thefollowing user-profile fields arerequired:v -user_numberv -n user_namev -a user_authorityv -p user_password
users -user_number
-n user_name -puser_password -auser_authority -cncontext_name -apauth_protocol -ppprivacy_protocol -ppwprivacy_pwd -at access_type-i ip_addr/hostname -msmax_sessions
where:v user_number is a number
from 1 to 12 thatcorresponds to anunused user number inthe "Display all userprofiles" list.
v user_name is analphanumeric string upto 15 characters inlength that can includeperiods ( . ) andunderscores ( _ ). Eachof the 12 user namesmust be unique.
v user_password can beblank or analphanumeric string upto 15 characters inlength that can includeperiods ( . ) andunderscores ( _ ), andmust include at leastone alphabetic and onenon-alphabeticcharacter.
v user_authority is one ofthe following:– operator (read-only)– rbs (see Set user
authority level formore information)
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 381
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Create user profile
(continued)
v context_name is analphanumeric string upto 31 characters inlength that can includeperiods ( . ) andunderscores ( _ ).
v auth_protocol choices are:– md5– sha– none
v privacy_protocol choicesare:– des– aes– none
v privacy_pwd is analphanumeric string upto 31 characters inlength that can includeperiods ( . ) andunderscores ( _ ).
v access_type choices are:– get– set– trap
v ip_addr/hostname is up to63 characters in length.
v max_sessions is anumber from 0 to 20.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional 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 specifiedmanagement-module user profile.
users -user_number -nuser_name
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v user_name is aalphanumeric string upto 15 characters inlength that can includeperiods ( . ) andunderscores ( _ ). Eachof the 12 user namesmust be unique.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 383
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set user password Sets a user password in thespecified management-module userprofile.
users -user_number -puser_password
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v user_password can beblank or analphanumeric string upto 15 characters inlength that can includeperiods ( . ) andunderscores ( _ ), andmust include at leastone alphabetic and onenon-alphabeticcharacter.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 thespecified management-module userprofile.Note: Users can change their ownpassword even if they do not haveauthority to manage accounts. The-op option is only used whenchanging your own password
users -user_number -opold_password -pnew_password
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v old_password is thecurrent password forthe specified user.
v new_password can beblank or analphanumeric string upto 15 characters inlength that can includeperiods ( . ) andunderscores ( _ ), andmust include at leastone alphabetic and onenon-alphabeticcharacter.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 385
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set user authority level Sets a user authority level in thespecified management-module userprofile.
users -user_number -auser_authority
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v user_authority is one ofthe following:– operator (read-only)– rbs (custom)
The custom authority levelparameter is specifiedusing the followingsyntax:
rbs:levels:devices
where the levels are one ormore of the followingauthority levels, separatedby a vertical bar ( | ):v super (Supervisor)v cam (Chassis User
Account Management)v clm (Chassis Log
Management)v co (Chassis Operator)v cc (Chassis
Configuration)v ca (Chassis
Administration)v bo (Blade Operator)v brp (Blade Remote
Present)v bc (Blade Configuration)v ba (Blade
Administration)v so (I/O Module
Operator)v sc (I/O Module
Configuration)v sa (I/O Module
Administration)
(continued on next page)
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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
(continued)
Notes:
v The LDAP authority levels arenot supported by themanagement-module webinterface.
v To use the LDAP authoritylevels, make sure that the versionof LDAP security used by themanagement module is set to v2(enhanced role-based securitymodel). See “ldapcfg command”on page 210 for information.
The levels can also includeone or more of thefollowing authority levelswhen using LDAP.v brpv (Blade Remote
Presence View Video)v brpk (Blade Remote
Presence KVM)v brpr (Blade Remote
Presence Remote DriveRead)
v crpru (Blade RemotePresence Remote DriveRead or Write)
v rps (Remote PresenceSupervisor)
where the devices are oneor more of the followingdevices, separated by avertical bar ( | ). Rangesof devices are separatedby a dash ( - ).v cn (Chassis n, where n
is a valid chassisnumber. Use c1 forsingle-chassisenvironments.)
v bn (Blade n, where n isa valid blade baynumber in the chassis)
v sn (I/O module n,where n is a valid I/Omodule bay number inthe chassis)
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
Chapter 3. Command reference 387
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set maximum number ofsimultaneous sessionsfor user
Sets the maximum number ofsimultaneous login sessions for thespecified user.
users -user_number -msmax-session
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v max-session is a numberfrom 0 to 20 that setsthe maximum numberof simultaneous sessionsfor the user. A value of0 means that there is nosession limit for theuser.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set SNMPv3 usercontext name
Sets an SNMPv3 context name inthe specified management-moduleuser profile.
The context name defines thecontext the SNMPv3 user isworking in. A context name can beshared by multiple users.
users -user_number -cncontext_name
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v context_name is a stringup to 31 characters inlength. Each of the 12context names must beunique.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 userauthentication protocol
Sets the SNMPv3 authenticationprotocol to be used for thespecified management-module userprofile.
users -user_number -apauth_protocol
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v auth_protocol is:– sha– md5– none
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set SNMPv3 userprivacy protocol
Sets the SNMPv3 privacy protocolto be used for the specifiedmanagement-module user profile.
If the privacy protocol is set tonone, no -ppw command option(privacy password) is required.
users -user_number -ppprivacy_protocol
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v privacy_protocol is:– aes– des– none
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 389
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Set privacy password forSNMPv3 user
Sets an SNMPv3 privacy passwordin the specifiedmanagement-module user profile.
users -user_number -ppwprivacy_pwd
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v privacy_pwd is a stringup to 31 characters inlength.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Set access type forSNMPv3 user
Sets an SNMPv3 access type for thespecified management-module userprofile.
This command supports thefollowing access types:v get: the user can query
Management Information Base(MIB) objects and receive traps.
v set: the user can query and setMIB objects and receive traps.
v trap: the user can only receivetraps.
users -user_number -ataccess_type
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v access_type is– get– set– trap
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 orhostname for SNMPv3trap receiver
Sets the IP address or hostnamethat will receive SNMPv3 traps forthe specified management-moduleuser profile.
users -user_number -iip_addr/hostname
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v ip_addr/hostname is avalid static IP addressor an alphanumerichostname string up to63 characters in length.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Display SSH public key Displays the entire specified SSHpublic key for the specified user inOpenSSH format.Note: The -pk and -e options mustbe used exclusive of all other userscommand options.
users -user_number -pk-key_index -e
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to display. If the-key_index is all, thenall keys for the user aredisplayed.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 391
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Add SSH public key Adds an SSH public key for thespecified user.Notes:
v The -pk and -add options mustbe used exclusive of all otherusers command options.
v The SSH Public Key is added tothe first available storagelocation. Each advancedmanagement module cansupport up to 12 SSH publickeys.
v Each user is permitted amaximum of four SSH publickeys, if the space is available.
users -user_number -pk-add key
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key is a valid key inOpenSSH format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Add specific SSH publickey
Adds a specific SSH public key forthe specified user.Note: The -pk and -add optionsmust be used exclusive of all otherusers command options.
users -user_number -pk-key_index -add key
where:v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to add.
v key is a valid key inOpenSSH format.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 thespecified user.Note: The -pk and -remove optionsmust be used exclusive of all otherusers command options.
users -user_number -pk-key_index -removev user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to remove. If the-key_index is "all", thenall keys for the user areremoved.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 393
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Upload SSH public key Uploads a new SSH public key. users -user_number -pk-upld -i ip_addr/hostname-l filenamev user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v ip_addr/hostname is avalid static IPv4 or IPv6IP address or analphanumeric hostnamestring up to 63characters in length ofthe TFTP server.
v filename is the filenameof the key file. Keysmust be in OpenSSHformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 publickey.
users -user_number -pk-key_index -upld -iip_addr/hostname -lfilenamev user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to replace.
v ip_addr/hostname is avalid static IPv4 or IPv6IP address or analphanumeric hostnamestring up to 63characters in length ofthe TFTP server.
v filename is the filenameof the key file. Keysmust be in OpenSSHformat.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 395
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Download SSH publickey
Downloads a specific SSH publickey to a TFTP server.Note: The -pk and -dnld optionsmust be used exclusive of all otherusers command options.
users -user_number -pk-key_index -dnld -iip_addr/hostname -lfilenamev user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in theDisplay all userprofiles list.
v key_index identifies thekey number from 1 to12 to upload.
v ip_addr/hostname is avalid static IPv4 or IPv6IP address or analphanumeric hostnamestring up to 63characters in length ofthe TFTP server.
v filename is the filenameof the key file.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
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 publickey
Accept connections from SSHpublic key host.
users -user_number -pk-key_index -af from="list"v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to connect.
v "list" is acomma-separate list ofhostnames and IPaddresses. The list is analphanumeric string upto 511 characters inlength that can includealphanumericcharacters, commas,asterisks, questionmarks, exclamationpoints, periods, andhyphens. The stringmust be enclosed indouble-quotes.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 397
Table 87. users (management-module users) command (continued)
Function What it does Command Valid targets
Comment SSH publickey
Add comment to an SSH publickey.
users -user_number -pk-key_index -cm "comment"v user_number is a number
from 1 to 12 thatcorresponds to the usernumber assigned in the"Display all userprofiles" list.
v key_index identifies thekey number from 1 to12 to comment.
v "comment" is up to 255characters in length,enclosed indouble-quotes.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis account
management
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example: To create user number 3 with a user name of user3 who has supervisorrights to all BladeCenter components, while management module 1 is set as thepersistent command environment, at the system:mm[1]> prompt, typeusers -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 commandenvironment, at the system:mm[1]> prompt, typeusers
The following example shows the information that is returned from thesecommands:
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 entrymust 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.129OK
system:mm[1]> users0 active session(s)Password compliantAccount active
398 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Role:camBlades:1|2|3|4|5|6|7|8|9|10|11|12|13|14Chassis:1Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user2. kprevent0 active session(s)Password compliantAccount active
Role:supervisorBlades:1|2|3|4|5|6|7|8|9|10|11|12|13|14Chassis:1Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user3. johnh0 active session(s)Password compliantAccount active
Role:supervisorBlades:1|2|3|4|5|6|7|8|9|10|11|12|13|14Chassis:1Modules:1|2|3|4|5|6|7|8|9|10
There are no SSH public keys installed for this user4. toms1 active session(s)Password compliantAccount active
Role:supervisorBlades:1|2|3|4|5|6|7|8|9|10|11|12|13|14Chassis:1Modules:1|2|3|4|5|6|7|8|9|10
Number of SSH public keys installed for this user: 35. <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]>
Chapter 3. Command reference 399
volts commandThis command displays actual voltages and voltage threshold values forBladeCenter components.
Table 88. volts command
Function What it does Command Valid targets
Display voltage values Displays the current voltage andvoltage threshold settings for thespecified component:v The management module target
displays the voltage values forthe BladeCenter unit.
v The blade server target displaysthe internal voltage values forthe specified blade server.
Note: The voltage values thatdisplay will vary based onBladeCenter unit and blade servertype.
volts -T system:mm[x]
-T system:blade[x]
where x is the primarymanagement-moduleor blade server baynumber.
Example: To view the current voltage and voltage thresholds for the blade serverin bay 3, while this blade server is set as the persistent command environment, atthe system:blade[3]> prompt, typevolts
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 commandThis command saves the management-module configuration to the chassis of theBladeCenter unit or to a file.
Table 89. write command
Function What it does Command Valid targets
Savemanagement-moduleconfiguration to chassis
Saves an image of themanagement-module configurationto the BladeCenter unit chassis.
write -config chassis
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Savemanagement-moduleconfiguration to file (noencryption)
Saves an image of themanagement-module configurationto a file while data encryption isnot enabled for the BladeCenterunit.
write -config file -lfilename -i ip_address
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
Note: If the -l filenameoption is not specified, thedefault filename ofasm.cfg is used.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Chapter 3. Command reference 401
Table 89. write command (continued)
Function What it does Command Valid targets
Savemanagement-moduleconfiguration to file(encryption)
Saves an image of themanagement-module configurationto a file while data encryption isenabled for the BladeCenter unit.Note: When a configuration file iscreated with a pass-phrase(encryption enabled), if thisconfiguration file is restored on thesame management module, thepass-phrase entered duringrestoration is ignored.
write -config file -lfilename -i ip_address -ppassphrase
where:v filename is the name of
the configuration file.v ip_address is the IPv4 or
IPv6 IP address of theTFTP server where theconfiguration file islocated.
v passphrase is adouble-quote delimitedpass-phrase that will beneeded to restore theconfiguration file.Maximum pass-phraselength is 1600characters.
Note: If the -l filenameoption is not specified, thedefault filename ofasm.cfg is used.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv Chassis configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:mm[x]
where x is the primarymanagement-modulebay number.
Example:
To save the management-module configuration to an image on the BladeCenterchassis, while management module 1 is set as the persistent commandenvironment, at the system:mm[1]> prompt, typewrite -config chassis
The following example shows the information that is returned from this command:system:mm[1]> write -config chassisOKConfiguration settings were successfully saved to the chassissystem:mm[1]>
402 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
zonecfg commandThis command sets and displays the serial attached SCSI (SAS) device informationfor BladeCenter components that is stored in I/O modules that support thisfeature.
Table 90. zonecfg command
Function What it does Command Valid targets
Display SAS zone list Displays a list of SAS device zonesand their information that is storedin the specified I/O module.
zonecfg -T system:switch[x]
where x is theI/O-module baynumber.
Activate SAS zone -single SAS switch
Activates a SAS zone, selected byindex number, for the specifiedSAS switch module.Note: If the I/O module is not inan operating condition that allowsa zone to be activated, thecommand returns an advisorymessage.
zonecfg -activate zone
where zone is the indexnumber for a valid zone.Use the zonecfgcommand, with nooptions, to list valid zonesand their index numbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system:switch[x]
where x is theI/O-module baynumber.
Activate SAS zone - allSAS switches
Activates a SAS zone, selected byindex number, for all SAS switchmodules.Note: If the I/O module is not inan operating condition that allowsa zone to be activated, thecommand returns an advisorymessage.
zonecfg -activate zone
where zone is the indexnumber for a valid zone.Use the zonecfgcommand, with nooptions, on all I/Omodules to determine thevalid zones that arecommon to all SAS switchmodules and their indexnumbers.
This command can onlybe run by users who haveone or more of thefollowing commandauthorities:v Supervisorv I/O module
configuration
See “Commands and userauthority” on page 8 foradditional information.
-T system
Chapter 3. Command reference 403
Table 90. zonecfg command (continued)
Function What it does Command Valid targets
Display SAS zoneinformation
Displays information about a SASzone, selected by index number,that is stored in the specified I/Omodule.
zonecfg -view zone
where zone is the indexnumber for a valid zone.
-T system:switch[x]
where x is theI/O-module baynumber.
Note: If you install both RAID SAS (RSS) and Non-RAID SAS (NSS) mass storagedevices, you can only power on and manage the zone configuration for one at atime.
Example: To view the list of SAS zones stored in the I/O module in bay 1, whilethis I/O module is set as the persistent command environment, at thesystem:switch[1]> prompt, typezonecfg
To activate SAS zone 5 for the I/O module in bay 1, while this I/O module is setas the persistent command environment, at the system:switch[1]> prompt, typezonecfg –activate 5
The following example shows the information that is returned from thesecommands:system:switch[1]> zonecfgIndex: 3Name: Name3Description string for zone config 3Status: InactiveType: PredefinedDate: <mm>
Index: 5Name: Name5Description string for zone config 5Status: InactiveType: ConfigurableDate: <mm>
Index: 2Name: Name2Description string for zone config 2Status: InactiveType: ConfigurableDate: <mm>
Index: 24Name: Name24Description string for zone config 24Status: ActiveType: ConfigurableDate: <mm>system:switch[1]> zonecfgIndex: 3Name: Name3Description string for zone config 3Status: InactiveType: PredefinedDate: <mm>
Index: 5
404 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Name: Name5Description string for zone config 5Status: PendingType: ConfigurableDate: <mm>
Index: 2Name: Name2Description string for zone config 2Status: InactiveType: ConfigurableDate: <mm>
Index: 24Name: Name24Description string for zone config 24Status: ActiveType: ConfigurableDate: <mm>system:switch[1]> zonecfg –activate 5OKsystem:switch[1]>
Chapter 3. Command reference 405
406 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Chapter 4. Error messages
This topic lists error messages for the BladeCenter command-line interface.
The command-line interface provides error messages specific to each command.The following topics list the common error messages that apply to all commandsand command-specific error messages, along with their definitions.v “Common errors” on page 409v “accseccfg command errors” on page 411v “advfailover command errors” on page 412v “alarm command errors” on page 413v “alertcfg command errors” on page 414v “alertentries command errors” on page 414v “autoftp command errors” on page 415v “baydata command errors” on page 415v “bofm command errors” on page 416v “boot command errors” on page 417v “bootmode command errors” on page 417v “bootseq command errors” on page 418v “buildidcfg command errors” on page 418v “chconfig command errors” on page 419v “chlog command errors” on page 420v “chmanual command errors” on page 421v “cin command errors” on page 421v “clear command errors” on page 423v “clearlog command errors” on page 423v “clock command errors” on page 423v “config command errors” on page 424v “console command errors” on page 425v “dhcpinfo command errors” on page 426v “displaylog command errors” on page 426v “displaysd command errors” on page 427v “dns command errors” on page 428v “env command errors” on page 428v “ethoverusb command errors” on page 428v “eventinfo command errors” on page 429v “events command errors” on page 429v “exit command errors” on page 430v “feature command errors” on page 430v “files command errors” on page 432v “fuelg command errors” on page 433v “groups command errors” on page 436v “health command errors” on page 436v “help command errors” on page 437
© Copyright IBM Corp. 2011 407
v “history command errors” on page 437v “identify command errors” on page 437v “ifconfig command errors” on page 438v “info command errors” on page 442v “iocomp command errors” on page 443v “kvm command errors” on page 443v “ldapcfg command errors” on page 443v “led command errors” on page 444v “list command errors” on page 445v “modactlog command errors” on page 445v “monalerts command errors” on page 445v “monalertsleg command errors” on page 446v “mcad command errors” on page 445v “mt command errors” on page 446v “nat command errors” on page 446v “ntp command errors” on page 447v “ping command errors” on page 447v “pmpolicy command errors” on page 448v “portcfg command errors” on page 448v “ports command errors” on page 448v “power command errors” on page 450v “rdoc command errors” on page 450v “read command errors” on page 451v “remotechassis command errors” on page 452v “reset command errors” on page 452v “scale command errors” on page 453v “sddump command errors” on page 454v “sdemail command errors” on page 454v “security command errors” on page 455v “service command errors” on page 455v “shutdown command errors” on page 455v “slp command errors” on page 455v “smtp command errors” on page 455v “snmp command errors” on page 456v “sol command errors” on page 457v “sshcfg command errors” on page 458v “sslcfg command errors” on page 459v “syslog command errors” on page 461v “tcpcmdmode command errors” on page 462v “telnetcfg command errors” on page 462v “temps command errors” on page 463v “thres command errors” on page 463v “trespass command errors” on page 463v “uicfg command errors” on page 464v “update command errors” on page 465
408 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
v “uplink command errors” on page 467v “users command errors” on page 468v “volts command errors” on page 472v “write command errors” on page 472v “zonecfg command errors” on page 473
Common errorsThis topic lists error messages that apply to all commands.
Each command that has unique errors will also have a list of command-specificerror 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 alarmpanel card slot.
Backplane Mux card is not present in this slot. The user tries to issue a command to an emptybackplane mux card slot.
Command cannot be issued to this target. Type env - hfor help on changing targets.
The user tries to issue a command to a target that doesnot support that command.
Command line contains extraneous arguments. Extra command arguments were entered.
Duplicate option: option
where option identifies the command option that wasentered more than once.
A user tries to enter the same command option in asingle command multiple times. For example, dns -i192.168.70.29 -i
Each option can only be used once per command. A user tries to enter the same command option in asingle command multiple times. For example, env -Tsystem:blade[4] -T system:blade[5].
Error: Command not recognized. Type 'help' to get a listof supported commands.
A user tries to enter a command that does not exist.
Error reading data for the option - option
where option identifies the command option that isreturning an error.
An error occurs while the management module isreading data of a option.
Error writing data for the option option
where option identifies the command option that isreturning an error.
An error occurs while the management module iswriting a command option value.
Firmware update is in progress. Try again later. Firmware update is in progress.
Illegal option: option
where option identifies the illegal short command optionthat was entered.
An illegal short command option is entered.
Integer argument out of range (range - range) for option:argument
where:v range identifies the range limitsv option identifies the command optionv argument identifies the integer that is out of range
An integer is entered that is out of range.
Internal error. An internal error occurs.
Chapter 4. Error messages 409
Table 91. Common errors (continued)
Error message Definition
Invalid integer argument for option: argument
where:v option identifies the command optionv argument identifies the invalid argument
An invalid integer is entered.
Invalid option. An invalid command option is entered.
Invalid option argument for option: argument
where:v option identifies the command optionv argument identifies the invalid argument
An invalid argument for a command option is entered.
Invalid option for this target: option
where option identifies the option that is invalid.
A user tries to issue a command with an invalid optionfor the target.
Invalid parameter. Input must be numeric. A user tries to enter a non-numeric argument.
Invalid syntax. Type command - h for help.
where command identifies the command that is returningan error.
A user tries to enter a command that is not syntacticallycorrect.
Invalid target path. A user tries to issue a command to a target that is notvalid.
Long option option requires an argument
where option identifies the long command option that ismissing an argument.
A long command option is entered without a requiredargument.
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 networkcard slot.
Read/write command error. An error occurs while the management module isexecuting the command.
Short option option requires an argument
where option identifies the short command option that ismissing an argument.
A short command option is entered without a requiredargument.
Syntax error. Type command -h for help.
where command identifies the command that is returningan error.
A user tries to enter a command improperly.
That blade is presently not available. Please try againshortly.
A user tries to connect to a blade that is already in use.
The argument for the option arg is outside the validrange.
where arg identifies the command option that is out ofrange.
A user tries to enter an arg outside the option's validrange.
The target bay is empty. The user tries to issue a command to an empty bladebay, blower bay, I/O-module bay, management-modulebay, or power bay.
The target bay is out of range. A user tries to issue a command to a target that is out ofrange for that target. For example, the env -Tsystem:blade[15] command is out of range because theBladeCenter unit has only 14 blade bays.
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 isout of range for that target.
There is no blade present in that bay. The user tries to issue a command to an empty bladebay.
There is no blower present in that bay. The user tries to issue a command to an empty chassiscooling unit bay.
There is no management module present in that bay. The user tries to issue a command to an emptymanagement module bay.
There is no power source present in that bay. The user tries to issue a command to an empty powermodule bay.
There is no switch present in that bay. The user tries to issue a command to an empty I/Omodule bay.
Unknown long option: option
where option identifies the command option that isunknown.
A user tries to enter a long option that is not valid forthe command.
Unknown option: option
where option identifies the command option that isunknown.
An unknown option is used.
Unrecognized long option: option
where option identifies the illegal long command optionthat was entered.
An illegal long command option is entered.
Unsupported target type. A user tries to issue a command to an unsupportedtarget.
User does not have the authority to issue this command. A user lacks the authority level necessary to execute acommand.
accseccfg command errorsThis topic lists error messages for the accseccfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 92. accseccfg command errors
Error message Definition
'Password required' is currently disabled. A user without a password tries to change the securitylevel to -high. User must have a password to performthis action.
'Password required' is currently enabled. A user without a password tries to change the securitylevel to -legacy. User must have a password to performthis action.
Reading account security level failed. An error occurs while the management module isreading the security level.
Setting account defaults to high level failed. An error occurs while the management module is settingthe security level to -high.
Chapter 4. Error messages 411
Table 92. accseccfg command errors (continued)
Error message Definition
Setting account defaults to legacy level failed. An error occurs while the management module is settingthe security level to -legacy.
The -high option cannot be used with other options. The user tries to set the account security to high settingswhile changing individual option values.
The -legacy option cannot be used with other options. The user tries to set the account security to legacysettings while changing individual option values.
The account inactivity disable time period must begreater than the account inactivity alert time period.
A user tries to set the account inactivity disable timeperiod to be less than the account inactivity alert timeperiod.
The argument for the option -dc is outside the validrange.
The user tries to set the -dc option to a value outside ofits valid range.
The argument for the option -ia is outside the validrange.
The user tries to set the -ia option to a value outside ofits valid range.
The argument for the option -id is outside the validrange.
The user tries to set the -id option to a value outside ofits valid range.
The argument for the option -lf is outside the validrange.
The user tries to set the -lf option to a value outside ofits valid range.
The argument for the option -lp is outside the validrange.
The user tries to set the -lp option to a value outside ofits valid range.
The argument for the option -pe is outside the validrange.
The user tries to set the -pe option to a value outside ofits valid range.
The argument for the option -rc is outside the validrange.
The user tries to set the -rc option to a value outside ofits valid range.
The minimum password change interval must be lessthan the password expiration period (%d days or %dhours).
A user tries to set the -pc option to a value greater thanthe -pe option.
The password expiration period (%d days or %d hours)must be greater than the minimum password changeinterval.
A user tries to set the -pe option to a value less than the-pc option.
User must have a password to change the 'Passwordrequired' setting.
A user without a password tries to change the -proption.
advfailover command errorsThis topic lists error messages for the advfailover command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 93. advfailover command errors
Error message Definition
Operation failed. An error occurs while the management module isprocessing the command.
Operation not allowed, since the standby MM is notpresent.
The user tries to enable advanced failover when there isno standby management module installed in theBladeCenter unit.
412 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 93. advfailover command errors (continued)
Error message Definition
Unknown option: option
where option identifies the illegal command option thatwas entered.
The user tries to enter an illegal command option.
alarm command errorsThis topic lists error messages for the alarm command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 analarm.
The user tries to set an alarm without providing analarm 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 agenerator 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 gettingthe system health summary.
Severity level must be provided for setting an alarm. The user tries to set an alarm without specifying theseverity 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 isacknowledging an alarm.
Unable to clear the requested alarm. An error occurs while the management module isclearing an alarm.
Unable to set the requested alarm. An error occurs while the management module is settingan alarm.
Chapter 4. Error messages 413
alertcfg command errorsThis topic lists errors for the alertcfg command.
There are no unique errors for the alertcfg command. See “Common errors” onpage 409 for a list of error messages that apply to all commands.
alertentries command errorsThis topic lists error messages for the alertentries command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 optionat the same time as the other options.
An entry cannot be modified and deleted in the samecommand.
A user tries to modify an entry and delete it in the samecommand.
Arguments containing spaces must be enclosed inquotation marks.
A user tries to enter a string containing spaces that hasan opening quotation mark without a closing quotationmark.
Enabling the application alert failed. An error occurs while the management module isenabling the application alert.
Generating test alert failed. An error occurs while the management module isgenerating a test alert.
Invalid input. Angle brackets are not allowed in thename field.
A user tries to enter a string parameter containing < or >for the -n (name) command option.
Invalid option. An invalid command option is entered. This includesnumeric options for the alert recipient that are not from 1through 12.
Invalid parameter. Input must be numeric. A user tries to enter a parameter value containingnon-numeric characters for a command option requiringnumeric input.
Restoring previous configured value for the applicationalert failed.
An error occurs while the management module isrestoring previous configured value for the applicationalert.
Syntax error. -e can only be used in conjunction with theemail argument.
A user tries to enter an invalid email address for the -ecommand option.
Syntax error. -i can only be used in conjunction with thedirector argument.
A user tries to enter an invalid IP address for the -icommand option.
Syntax error. Type alertentries -h for help. An alert entry number is entered without the leadingdash ( - ).
The name must be less than 32 characters long. A user tries to enter too many characters in an inputfield.
When creating a new entry, all options are required. A required command option is missing when creating auser.
414 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
autoftp command errorsThis topic lists errors for the autoftp command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 96. autoftp command errors
Error message Definition
Autoftp is disabled, -i, -p, -u and -pw options areinvalid.
A user tries to enter -i, -p, -u, or -pw options when theFTP/TFTP mode is set to disabled.
Invalid FTP/TFTP address. A user tries to enter an FTP or TFTP address that is notvalid.
Invalid input. Address must be less than 64 characters. A user tries to enter an address that is 64 or morecharacters long.
Invalid input. Password must be less than 64 characters. A user tries to enter a password that is 64 or morecharacters long.
Invalid input. Userid must be less than 64 characters. A user tries to enter a user id that is 64 or morecharacters long.
Password must be enclosed in quotation marks.Displayed when the argument of option -p is notquote_delimited.
A user tries to enter a password without quotationmarks.
Read autoftp configuration failed. The management module was unable to read the autoftpconfiguration.
Read autoftp mode failed. The management module was unable to read the autoftpmode status.
The mode is tftp, -u and -pw options are invalid. A user tries to enter a user name or password when themode is set to TFTP.
User Name must be enclosed in quotation marks. A user tries to enter a user name without quotationmarks.
When disabling autoftp, the -i, -p, -u and -pw optionsare invalid.
A user tries to enter -i, -p, -u, or -pw options whensetting the FTP/TFTP mode to disabled in the samecommand.
When setting -m to tftp, the -u and -pw options areinvalid.
A user tries to enter a user name or password whensetting the FTP/TFTP mode to TFTP in the samecommand.
baydata command errorsThis topic lists error messages for the baydata command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 97. baydata command errors
Error message Definition
Error writing bay data to blade bay bayNum.
where bayNum is the blade bay number.
An internal error occurs while the user is changing baydata for the specified blade server.
Invalid blade bay number The command has an invalid bay number.
Chapter 4. Error messages 415
Table 97. baydata command errors (continued)
Error message Definition
Invalid input. The bay data string must be less than themaximum number of characters allowed.
User enters bay data with -data option for a blade serverthat exceeds the maximum length of 60 characters.
The -clear and -data options cannot be used in the samecommand.
User issues a command with both -clear and -dataoptions.
The bay data must be quote-delimited. User enters bay data with -data option for a blade serverwithout double quotation marks.
User not authorized to change bay data for bay number. An unauthorized user issues a command to change baydata for the specified blade server.
bofm command errorsThis topic lists errors for the bofm command.
Notes:
1. The BOFM command displays parsing errors and duplicate addresses thatpoint to flaws in the comma-separated values (csv) configuration database file.The BladeCenter Open Fabric Manager is not a standard management modulefeature; it is offered and documented separately. See the BladeCenter Open FabricManager Installation and Users Guide for more detailed information.
2. If the number of advanced management module TCP command modeconnections is zero, or if all available TCP command mode connections are inuse, a connection failure message is generated by the BOFM feature. Make surethat the advanced management module TCP command mode connection limitis positive and that no more than the available number of connections are inuse. See the BladeCenter Open Fabric Manager Installation and Users Guide foradditional information.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 98. bofm command errors
Error message Definition
Applying new configuration on MM failed. An error occurs while the advanced managementmodule is applying the BOFM configuration.
Confirming configuration change failed. An error occurs while the advanced managementmodule is confirming a configuration change.
File transfer failed. An error occurs while transferring a file during fileupload.
Getting BOFM status failed. An error occurs while the advanced managementmodule is getting BOFM status.
Getting duplicates failed. An error occurs while the advanced managementmodule is getting duplicates.
Getting parsing errors failed. An error occurs while the advanced managementmodule is getting parsing errors.
-i and -l are both required to upload a BOFMconfiguration file.
A user issues a command to apply BOFM configurationto the advanced management module without both -iand -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 applyingthe BOFM configuration to the advanced managementmodule.
Parsing errors. An error occurs while the advanced managementmodule is parsing the BOFM status.
Resetting BOFM configuration on MM failed. An error occurs while the advanced managementmodule is resetting the BOFM configuration.
Retrieving the file from TFTP server failed. An error occurs while the advanced managementmodule is retrieving the configuration file from a TFTPserver.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced managementmodule is uploading a file.
boot command errorsThis topic lists errors for the boot command.
There are no unique errors for the boot command. See “Common errors” on page409 for a list of error messages that apply to all commands.
bootmode command errorsThis topic lists errors for the bootmode command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 99. bootmode command errors
Error message Definition
Boot mode not supported on blade[x]
where x is the number of the blade-server bay.
The command is directed to a blade server that does notsupport the bootmode feature.
Error retrieving the boot mode of this blade. The management module is unable read the boot modeof the blade server.
Set the blade boot mode to option failed
where option is the selected boot mode.
The management module is unable to set the bladeserver boot mode to the specified value.
Chapter 4. Error messages 417
bootseq command errorsThis topic lists error messages for the bootseq command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 100. bootseq command errors
Error message Definition
Error writing boot sequence. An error occurs while the management module isprocessing 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 sequenceto the same device.
Second device cannot be set to 'nodev' when third orfourth device is set.
The user tries to set the second boot device to 'nodev'.
Third device cannot be set to 'nodev' when fourth deviceis set.
The user tries to set the third boot device to 'nodev'.
buildidcfg command errorsThis topic lists error messages for the buildidcfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 listwhile using another command option. The -createcommand option must be run alone.
Adding an entry failed. Please check for duplicates or aninvalid format.
An error occurs while adding an entry to the bladefirmware build ID list.
Build ID must be enclosed in quotation marks. A user tries to enter a blade firmware build ID withoutquotation marks.
Build revision must be enclosed in quotation marks. A user tries to enter a blade firmware build revisionwithout quotation marks.
Error creating the initial build ID list. An error occurs while creating the blade firmware buildID list.
Error removing all the build ID entries. An error occurs while removing all blade firmware buildID list entries.
Error removing build ID entry identifier.
where the identifier identifies the build ID entry specified.
An error occurs while removing a blade firmware buildID list entry.
Importing list failed. Check for duplicates or an invalidformat on line line_number
where the line_number identifies the line numberspecified.
An error occurs during blade firmware build ID listimport.
Machine type must be enclosed in quotation marks. A user tries to enter a machine type without quotationmarks.
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 withoutquotation marks.
Modifying entry identifier failed. Please check forduplicates or an invalid format.
where the identifier identifies the entry specified.
A user tries to modify an blade firmware build ID listentry with duplicate or wrong information.
No entries in the list. The blade firmware build ID list is empty.
Operating error “export identifier”
where the identifier identifies the information to export.
An error occurs during blade firmware build ID listinformation export.
Operating error “import identifier”
where the identifier identifies the information to import.
An error occurs during blade firmware build ID listinformation import.
Some required options for the –ab command are missing. A user tries to add a blade firmware build ID list entry,but does not include all of the required options.
chconfig command errorsThis topic lists errors for the chconfig command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 inquotation marks
City must be enclosed in quotation marks. A user tries to enter a city name that is not enclosed inquotation marks
IBM Support Center: invalid input. Please input 2characters ISO country code for the IBM Support Center.
A user tries to enter a country code that is not valid.
Contact Company must be enclosed in quotation marks. A user tries to enter a company name that is notenclosed in quotation marks
Contact Name must be enclosed in quotation marks. A user tries to enter a contact name that is not enclosedin quotation marks
Email must be enclosed in quotation marks. A user tries to enter an email that is not enclosed inquotation marks
Email: invalid input. Please make sure your input is notempty and within 30 characters.
A user tries to enter an email with a length that is notvalid
Error to enable/disable Service Agent. An error occurs while the advanced managementmodule is enabling or disabling the service agent.
Error to enable Service Agent. You have not set all of therequired contact Information fields yet.
A user tries to issue a command to enable a service agentthat does not have the required contact information set.
HTTP Proxy is disabled now, you can not change proxysettings, please enable http proxy first.
A user tries to change proxy settings when the HTTPproxy is disabled.
Invalid HTTP Proxy location. A user tries to enter a proxy address that is not a validIP address or hostname
Invalid input. -loc should be less than 64 characters. A user tries to enter a proxy address that is 64 or morecharacters long.
Chapter 4. Error messages 419
Table 102. chconfig command errors (continued)
Error message Definition
Invalid input. -pw should be less than 16 characters. A user tries to enter a proxy password that is 16 or morecharacters long.
Invalid input. Password may not contain angle brackets. A user tries to enter a proxy password that contains "<"or "�>".
Invalid input. User Name must be less than 30characters.
A user tries to enter a user name that is 30 or morecharacters long.
Invalid option argument for -li: A user tries to use the -li option without the "view" or"accept" argument.
Terms and conditions is not accepted yet, please viewand accept the terms and conditions first.
A user attempts to change the service advisor settingsbefore accepting the terms and conditions.
The Terms and Conditions should be accepted firstbefore using this command.
A user attempts to change the service manager settingsbefore accepting the license agreement.
Phone number must be enclosed in quotation marks. A user tries to enter a phone number that is not enclosedin quotation marks
Phone number: invalid input. Please make sure yourinput is not empty and 5-30 characters.
A user tries to enter a phone number that is not valid
Postalcode must be enclosed in quotation marks. A user tries to enter a postal code that is not enclosed inquotation marks.
Postalcode: invalid input. Please make sure your input isnot empty and within 9 characters.
A user tries to enter a postal code is not valid in length.
State must be enclosed in quotation marks and has 2 or 3characters.
A user tries to enter a state that is not enclosed inquotation marks, or is not two or three characters inlength.
chlog command errorsThis topic lists errors for the chlog command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 asother options.
-s must be used exclusive of other options. The user tries to use the -s option at the same time asother options.
A call home event with index number was not found.
where number is the decimal number that specifies theserviceable activity log entry that the user is attemptingto acknowledge or unacknowledge.
The management module was unable to find a specifiedcall-home event activity log entry.
Error reading data for Terms and Conditions. An error occurs while the management module isreading the terms and conditions information.
Fail to read Service Advisor Activity Log The management module was unable to read thecall-home event activity log.
Invalid syntax. Type 'chlog -h' for help. A user fails to specify the parameter for the call-homeactivity log entry that they are attempting toacknowledge 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 activitylog but has not yet accepted the Terms and Conditions.
chmanual command errorsThis topic lists errors for the chmanual command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 104. chmanual command errors
Error message Definition
-test must be used exclusive of other options The user attempts to run this command with otheroptions in addition to -test.
Error generating a manual Call Home This command fails when the user attempts the manualcall home operation.
Error generating a test Call Home This command fails when the user attempts the test callhome operation.
Invalid syntax. Type 'chmanual -h' for help. The user attempts to use this command but usesimproper syntax.
Problem description must be enclosed in quotationmarks
The user attempts to run this command when theproblem description is not enclosed in quotation marks.
Test Call Home should be operated on SYSTEM target The user attempts to use this command when thecommand 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 yetaccepted the Terms and Conditions.
The Service Agent is disabled now, please enable itbefore calling 'chmanual'
The user attempts to use this command before theservice advisor is enabled.
cin command errorsThis topic lists error messages for the cin command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 105. cin command errors
Error message Definition
-id cannot be the same as the blade management VLANID. Please try again.
A user tries to enter a command with a VLAN ID whichis 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 isthe same as the IP address of the multicast.
-ip cannot be the same as the management module IPaddress. Please try again
A user tries to enter a command with an IP addresswhich is the same as the IP address of the advancedmanagement module.
An error occurred while changing CIN global statussetting
An error occurs while user is changing CIN global statussetting.
An error occurred while clearing CIN entry An error occurs while the user is clearing a CIN entry.
Chapter 4. Error messages 421
Table 105. cin command errors (continued)
Error message Definition
An error occurred while enabling/disabling CIN entry. An error occurs while the user is enabling/disabling aCIN entry.
An error occurred while setting CIN entry. An error occurs while configuring a CIN entry.
Both -id and -ip are required for adding a CIN entry. A user tries to enter a command to add an entry withoutboth -id and -ip options.
CIN blade pair TLV get failed An error occurs while the management module is gettingCIN blade server configuration parameters.
CIN global TLV get failed. An error occurs while the management module is gettinga CIN global configuration parameter.
CIN command failed. An error occurs while the management module isexecuting a CIN command.
cin -index -en state cannot be used with other options.
wherev index identifies the cin index entryv state is on or off
The user tries to enter a command with the -en optionwith along with other options.
Duplicate CIN (-id, 0.0.0.0) pairs are not allowed. Pleasetry again.
A user tries to enter a command with a duplicated-id/0.0.0.0 pair.
Duplicate -ip is not allowed. Please try again. A user tries to enter a command with a duplicated IPaddress.
Internal error checking CIN entry. An error occurs while the system checks user input forthe CIN entry configuration.
Internal error getting CIN entry An error occurs while the management module is gettingCIN entry configuration parameters.
Invalid index parameter. Input must be numeric. A user tries to enter a command with a non-numericindex.
Invalid index parameter. Input out of range. A user tries to enter a command with an index which isout of range.
Invalid IP argument for an option. Enter 4 bytesseparated by 3 dots.
A user tries to enter a command argument for IP addressoption which is invalid because it is too long, too short,or not numeric.
Invalid IP argument for an option. Too many bytes. A user tries to enter a command with an invalidargument for IP address option which has more thanfour parts.
Invalid IP argument for an option. Too few bytes A user tries to enter a command with an invalidargument for IP address option which has fewer thanfour parts.
Invalid IP argument for an option. Each byte has to be inthe range (0-255).
A user tries to enter a command with an invalidargument for IP address option, each part of which is notin the range of 0-255.
Invalid option argument for -global -en: A user issues a command with an invalid argument for-global -en option.
Invalid option argument for -en to enable an entry. An error occurs while the user is enabling/disabling aCIN entry.
422 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
clear command errorsThis topic lists error messages for the clear command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 itsdefault configuration during a firmware update. Theerror message displays and the management-moduleconfiguration does not reset.
Internal error resetting to defaults. An error occurs while the management module isresetting the management module to its defaultconfiguration. The error message displays and themanagement-module configuration does not reset.
clearlog command errorsThis topic lists error messages for the clearlog command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 107. clearlog command errors
Error message Definition
Error clearing the event log. An error occurs while the management module isclearing the event log.
clock command errorsThis topic lists error messages for the clock command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 108. clock command errors
Error message Definition
GMT+2:00 requires one of the following dst values: off,ee, gtb, egt, or fle
The user tries to change the Greenwich mean-time(GMT) offset to +2:00 without adjusting the DST setting.
GMT+10:00 requires one of the following dst values: off,ea, tas, or vlad
The user tries to change the GMT offset to +10:00without adjusting the DST setting.
GMToffset requires one of the following dst values: off,uc, other
where offset is the daylight-savings time offset.
The user tries to change the GMT offset to -9, -8, -7, -6,or -5 without adjusting the DST setting.
Invalid dst setting for GMT+10:00: setting
where setting is the illegal daylight-savings time settingthat was entered.
The user tries to enter an invalid -dst setting for a GMToffset of 10.
Chapter 4. Error messages 423
Table 108. clock command errors (continued)
Error message Definition
Invalid dst setting for GMT+2:00: setting
where setting is the illegal daylight-savings time settingthat was entered.
The user tries to enter an invalid -dst setting for a GMToffset of 2.
Invalid dst setting for GMToffset: setting
where setting is the daylight-savings time offset andsetting is the illegal daylight-savings time setting thatwas entered.
The user tries to enter an invalid -dst setting for a GMToffset of -9, -8, -7, -6, or -5.
Invalid dst setting. The gmt offset does not support dst. The user tries to turn on dst for a GMT offset that doesnot support daylight-savings time.
Invalid input for -dst. A user tries to enter an invalid argument for the option-dst.
Reading date and time failed. An error occurs while the management module isreading the date and time.
Reading GMT offset failed. An error occurs while the management module isreading the GMT offset.
Reading status of daylight savings time failed. An error occurs while the management module isreading the daylight savings time status.
The gmt offset you entered does not support dst. Turningdst off.
A user tries to enter a GMT offset that does not supportdaylight savings time.
config command errorsThis topic lists error messages for the config command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 109. config command errors
Error message Definition
Arguments containing spaces must be enclosed inquotation marks.
The user tries to enter an advanced management moduleContact or Location without ending double quotes.
Contact must be enclosed in quotation marks. The user tries to enter an advanced management moduleContact without enclosing it in double quotes.
Invalid input. Contact may not contain angle brackets. The user tries to enter an advanced management moduleContact containing angle brackets ("<" and ">").
Invalid input. Location may not contain angle brackets. The user tries to enter an advanced management moduleLocation containing angle brackets ("<" and ">").
Invalid input. Name must be less than 16 characters. The user tries to enter a name that is more than 15characters in length.
Invalid input. Name may not contain angle brackets. The user tries to enter a blade server name that containsangle brackets: "<" or ">".
Invalid input. Only alphanumeric characters,underscores, hyphens, pound signs, and periods areallowed.
The user tries to enter a name for the advancedmanagement module that is not valid.
Invalid input. -sn should have exactly sevenalphanumeric characters.
The user tries to enter a serial number that is not exactlyseven 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 sevenalphanumeric characters.
The user tries to enter a type or model name that is notexactly seven alphanumeric characters.
Invalid input. -uuid should have exactly 32 hex digits. The user tries to enter a universally unique ID that is notexactly 32 hex digits.
Location must be enclosed in quotation marks. The user tries to enter an advanced management moduleLocation without enclosing it in double quotes.
Reading SNMPv1/SNMPv3 status failed. An internal errors occurs while the advancedmanagement module is reading the SNMPv1/v3status.
System location and contact must be defined whenSNMPv1 or SNMPv3 agent is enabled.
The user tries to undefine the system location or contactinformation while an SNMPv1 or SNMPv3 agent isenabled.
console command errorsThis topic lists error messages for the console command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 110. console command errors
Error message Definition
A SOL session socket was not available. The command-line interface fails to establish an SOLconnection to a blade server.
Error entering console mode. An error occurs while the management module is tryingto establish an SOL connection.
Global SOL is not enabled SOL is not enabled globally.
Internal Error An error occurs while the management module isprocessing the command.
SOL is not ready The blade server is not available, or when a socketneeded to establish a connection to the blade server isnot available.
SOL on blade is not enabled SOL is not enabled on the blade server where the user istrying to start an SOL session.
SOL session is already active The user cannot start an SOL session with a blade serverbecause an SOL session with that blade server is alreadyin progress.
The maximum number of sessions to this blade has beenreached.
The blade server has no available sessions for a user toconnect to.
Unknown error occurred while attempting to connect. An unknown error occurs when connecting to a bladeserver.
Chapter 4. Error messages 425
dhcpinfo command errorsThis topic lists errors for the dhcpinfo command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 111. dhcpinfo command errors
Error message Definition
Advanced failover must be enabled before viewing thestandby MM's DHCPv6 config.
A user tries to view the configuration of the standbymanagement module when advanced failover isdisabled.
Command cannot be issued to this type of Blade. Typeenv –h for help on changing targets.
A user issues the dhcpinfo command to a blade serverthat does not support IPv6.
DHCPv6 information is not available. DHCPv6 is enabled, but the command target is notreceiving any DHCPv6 settings.
DHCPv6 is disabled The DHCPv6 assigned configuration can not be retrievedbecause DHCPv6 is disabled.
IPv6 is disabled The DHCPv6 assigned config can not be retrievedbecause IPv6 is disabled.
This management network interface is not installed. A user issues the dhcpinfo command to a blade serverthat does not support a management network interface.
displaylog command errorsThis topic lists error messages for the displaylog command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 samecommand.
-l and -i options must be used exclusive of the otheroptions.
The user tries to issue a command with the -l and -ioptions 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 asother options.
Both -l and -i options must be provided to save eventlog.
The user tries to issue a command to save the event logwithout -l and -i provided.
Cannot open file: filename
where filename is the name of the file that was enteredwhen the error occurred.
An error occurs while the management module is tryingto open a file.
Duplicate date filter: filter
where filter is the duplicate date filter that was entered.
The user tries to use duplicate date filters.
Duplicate call home filter: filter
where filter is N or C.
The user tries to use duplicate call-home filters.
426 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 112. displaylog command errors (continued)
Error message Definition
Duplicate severity filter: filter
where filter is the duplicate severity filter that wasentered.
The user tries to use duplicate severity filters.
Duplicate source filter: filter
where filter is the duplicate source filter that was entered.
The user tries to use duplicate source filters.
Invalid date filter: filter
where filter is the invalid date filter that was entered.
The user tries to use an invalid date filter.
Invalid call home filter: filter
where filter is the invalid filter that was entered.
The user tries to use an invalid call-home filter.
Invalid severity filter: filter
where filter is the invalid severity filter that was entered.
The user tries to use an invalid severity filter.
Invalid source filter: filter
where filter is the invalid source filter that was entered.
The user tries to use an invalid source filter.
Putting event log file filename to tftp server ipaddressfailed
where:v filename is the name of the log filev ip_address is the IP address of the TFTP server
An error occurs while the management module is tryingto put the event log file to TFTP server.
Reading log entries failed. An error occurs while the management module isreading log entries.
displaysd command errorsThis topic lists error messages for the displaysd command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 113. displaysd command errors
Error message Definition
-save and -i must both be specified when saving theservice data.
A user tries to save the service data without specifyingboth 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 SRCdetail information.
Error retrieving blade type. The advanced management module fails to read theblade server type.
Error transferring file. An unspecified TFTP error occurs.
No additional information for this SRC. The advanced management module tries to get the detailinformation of a SRC which does not have detailinformation.
Read/write command error. An error occurs while the management module isprocessing the command.
The format of the received data is wrong. The advanced management module receives wronglyformatted data.
Chapter 4. Error messages 427
dns command errorsThis topic lists error messages for the dns command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 samecommand.
At least one address is required to enable DNS. A user tries to enable DNS without configuring at leastone address.
DNS State Can not be determined. An error occurs while the management module isreading the DNS state.
Input length is greater than the maximum charactersallowed.
A user tries to enter too many characters in an inputfield.
Invalid ip address A user tries to set an invalid IP address.
IPv6 configuration changes will not take effect until IPv6is enabled.
A user attempts to configure the IPv6 DNS settings whileIPv6 is disabled.
Reading status of DNS failed. An error occurs while the management module isreading the DNS state.
Reading status of interface failed. An error occurs while the management module isreading the status of an interface.
env command errorsThis topic lists errors for the env command.
There are no unique errors for the env command. See “Common errors” on page409 for a list of error messages that apply to all commands.
ethoverusb command errorsThis topic lists errors for the ethoverusb command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 115. ethoverusb command errors
Error message Definition
Blade SP's command interface on Ethernet-over-USB isnot supported on blade blade_number
where blade_number identifies the blade server.
The command is directed to a blade server that does notsupport Ethernet-over-USB.
Notice: This operation may take a short while tocomplete. Please view the status to determine when theoperation has completed.
Confirmation message indicating that the command isprocessing and might take a short time to complete.
428 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
eventinfo command errorsThis topic lists errors for the eventinfo command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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.
events command errorsThis topic lists errors for the events command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 sizeof max entries. No more events can be added to the list.
where max is a decimal number.
A user attempts to add an entry while Call HomeExclusion List has reached its maximum size.
Error reading ftp/tftp of Service Data configuration. An error occurs while the management module isreading the FTP/TFTP service data configuration.
Error reading data for Terms and Conditions. An error occurs while the management module isreading the terms and conditions data.
Event id already exists in Call Home Exclusion List.
where id is a hexadecimal number that identifies acall-home event.
A user attempts to add an entry which already exists inCall Home Exclusion List.
Event id does not exist in the Call Home Exclusion List.
where id is a hexadecimal number that identifies acall-home event.
A user attempts to remove an entry which does not existin Call Home Exclusion List.
Event id is invalid to be added into Call Home ExclusionList.
where id is a hexadecimal number that identifies acall-home event.
A user attempts to add an entry with an invalid event id.
ftp/tftp of Service Data must be enabled before usingthis command.
A user attempts to issue an events command while theFTP/TFTP Report of Service Data is disabled
Read Call Home Exclusion List failed. An error occurs while the management module isreading the Call Home Exclusion List.
The terms and conditions should be accepted first beforeusing this command.
A user attempts to issue an events command before theterms and conditions have been accepted.
Chapter 4. Error messages 429
exit command errorsThis topic lists errors for the exit command.
There are no unique errors for the exit command. See “Common errors” on page409 for a list of error messages that apply to all commands.
feature command errorsThis topic lists errors for the feature command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 118. feature command errors
Error message Definition
-add option requires -key option The user tries to add a feature license without specifyingthe 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 alicense file.
Error getting status. An error occurs while getting status when applying orretrieving a license file.
Error parsing license file. An error occurs while applying or retrieving a licensefile.
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
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
An error occurs while applying a license file.
Failed to login to chassis ip_address
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
An error occurs while applying a license file.
Failed to read license status An error occur occurs while the advanced managementmodule is reading the status of the feature license.
Failed to remove license for chassis ip_address
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
An error occurs while applying a license file.
Failed to retrieve data for chassis ip_address
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
An error occurs while applying a license file.
Failed to retrieve status for chassis ip_address
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
An error occurs while applying a license file.
Failed to set license key An error occur occurs while the advanced managementmodule is setting the feature license key.
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 managementmodule is validating the BladeCenter unit serial number.Make sure that the serial number is correct and retry thecommand.
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 managementmodule is validating the feature license key. Make surethat the license key is correct and retry the command.
line number: CSV read error.
where number indicates the line in the license file that isin error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
line number: File open error.
where number indicates the line in the license file that isin error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
line number: Incomplete line.
where number indicates the line in the license file that isin error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
line number: Invalid IP.
where number indicates the line in the license file that isin error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
line number: Line too long.
where number indicates the line in the license file that isin error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
line number: Unknown error: code
where number indicates the line in the license file that isin error and code indicates the type of error.
An error occurs while applying a license file. Errorlocation in license file is specified in the error message.
Remove license failed An error occur occurs while the advanced managementmodule is removing a feature license.
Unknown error for chassis ip_address
where ip_address is the IP address for the BladeCenterunit on which the operation is being performed
Error type is unknown.
Unknown error type Error type is unknown.
Chapter 4. Error messages 431
files command errorsThis topic lists error messages for the files command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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
where filename is the name of the file that was enteredfor deletion.
An error occurs while the management module is tryingto delete a file.
Error deleting file filename
where filename is the name of the file that was enteredfor deletion.
The user tries to delete a directory or delete a file thatdoes not exist.
Error reading file list. An error occurs while the management module isreading the directory file list.
Error reading file system space. An error occurs while the management module isreading the file system space.
Error reading first file in dir directory.
where directory is the name of the directory that wasentered.
An error occurs while the management module isreading the first file in the directory.
File index out of sequence. An error occurs while the management module isreading the index.
File list exhausted. An error occurs while the management module isreading 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 256characters.
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 than256 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 notrecognized.
432 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
fuelg command errorsThis topic lists error messages for the fuelg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 theenvironment is set to nebs.
-ps and -dps cannot be enabled at the same time. The user attempts to enable -ps and idps at the sametime.
A power module failure in domain domain_number canresult in an immediate shutdown.
where domain_number identifies the power domain.
A power module fails and the domain in which it isinstalled loses redundancy. The BladeCenter unit mightturn itself off, based on the power managementconfiguration.
Blade blade_number is not allowed to power on becauseof insufficient power.
where blade_number identifies the blade server.
There is insufficient power available in the powerdomain to turn on this blade server.
Blade blade_number is throttled.
where blade_number identifies the blade server.
The specified blade server has reduced power (powerthrottling) in response to a thermal event oroversubscription condition.
Blade blade_number was instructed to power off due topower budget restrictions.
where blade_number identifies the blade server.
BladeCenter power management turns off a blade serverthat is already on in response to a oversubscriptioncondition.
Blade must be powered on to enable/disable dps. The user attempts to enable or disable dynamic powerserver mode for a blade server while its power is off.
Checking if power is preallocated to switch numberfailed.
where the number I/O-module bay number.
An error occurs while the management module ischecking if power is preallocated for the specified I/Omodule.
Demand exceeds a single power module. Throttling canoccur in power domain domain_number.
where domain_number identifies the power domain.
The power requirements of components installed in apower domain exceed the level required for redundantoperation. Power throttling of BladeCenter componentsmight be able to correct the problem.
Effective CPU Speed not available. An error occurs while the management module isreading the effective CPU Speed.
Error reading blade power management capability. An error occurs while the management module isreading the blade server power management capability.
Error reading soft minimum. An error occurs while the management module isreading the soft minimum value.
Error reading soft minimum, using guaranteed minimuminstead.
An error occurs while the management module isreading the soft minimum value.
Error writing data for the option -pme
Please make sure the blade is powered on
The user attempts to enable power management andcapping for a blade server that is turned off.
Getting blade health state parameters failed. An error occurs while the management module isreading the blade server health state parameters.
Getting blade pcap maximum value failed. An error occurs while the management module isreading the blade server power cap maximum value.
Chapter 4. Error messages 433
Table 120. fuelg command errors (continued)
Error message Definition
Getting blade pcap minimum value failed. An error occurs while the management module isreading the blade server power cap minimum value.
Getting blade power cap level failed. An error occurs while the management module isreading the blade server power cap level.
Getting data of domain 1 (or 2 ) failed. An error occurs while the management module isreading the data of power domain 1 (or 2).
Getting domain latest power sample failed. An error occurs while the management module isreading the latest power domain sample.
Getting duty cycle numbers failed. An error occurs while the management module isreading the duty cycle numbers.
Getting duty cycle numbers of blade blade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the duty cycle numbers of specified blade server.
Getting dynamic power management capabilty ofbladeblade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the dynamic power management capability ofspecified blade server.
Getting information of powernumber failed.
where the number identifies the specified power module.
An error occurs while the management module isreading data of specified power module.
Getting module domain map for blowernumber failed.
where the number identifies the specified chassis coolingunit.
An error occurs while the management module isreading module domain map of specified chassis coolingunit.
Getting module domain map for midplane failed. An error occurs while the management module isreading the module domain map for midplane.
Getting module domain map for MMnumber failed.
where the number identifies the specified managementmodule.
An error occurs while the management module isreading the module domain map of specifiedmanagement module.
Getting module domain map for muxnumber failed.
where the number identifies the location of thecomponent.
An error occurs while the management module isreading the module domain map of specified mux.
Getting module domain map for NCnumber failed.
where the number identifies the location of thecomponent.
An error occurs while the management module isreading the module domain map of specified networkclock module.
Getting module domain map of mtnumber failed.
where the number identifies the specified mt.
An error occurs while the management module isreading the module domain map of specified mt.
Getting module domain map of PM Cooling Devicenumber failed.
where number identifies the blade server.
An error occurs while the management module isreading the module domain map of specified powermodule Cooling Device.
Getting module domain map of switchnumber failed.
where the number represents the specified I/O module.
An error occurs while the management module isreading the module domain map of specified I/Omodule.
Getting module domain map of Telco alarm panel failed. An error occurs while the management module isreading the module domain map of Telco alarm panel.
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 domaindomain_number failed
where domain_number is the number of the domain thatwas entered.
An error occurs while the management module isreading the power management policy of specifieddomain.
Getting power state of bladeblade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the power state of specified blade server.
Getting power values for blowernumber failed.
where the number identifies the location of thecomponent.
An error occurs while the management module isreading the power values of specified chassis coolingunit.
Getting power values for DSSnumber failed.
where the number represents the specified DSS.
An error occurs while the management module isreading the power values of specified DSS.
Getting power values for MMnumber failed.
where the number identifies the location of thecomponent.
An error occurs while the management module isreading the power values of specified managementmodule.
Getting power values for NCnumber failed.
where the number represents the specified NC.
An error occurs while the management module isreading the power values of specified network clockmodule.
Getting power values for switchnumber failed.
where the number represents the specified I/O module.
An error occurs while the management module isreading the power values of specified I/O module.
Getting power values of midplane within domain failed. An error occurs while the management module isreading the power values of midplane within domain.
Getting power values of mtnumber within domain failed.
where the number represents the specified mt.
An error occurs while the management module isreading the power values within domain of specifiedmedia tray.
Getting power values of muxnumber within domainfailed.
where the number represents the specified mux.
An error occurs while the management module isreading the power values within domain of specifiedmux.
Getting power values of PM Cooling Device numberfailed
where the number represents the specified PM coolingdevice.
An error occurs while the management module isreading the power values of specified power modulecooling device.
Getting power values of Telco alarm panel withindomain failed.
An error occurs while the management module isreading the power values of Telco alarm panel withindomain.
Getting status of domain domain_number failed
where domain_number identifies the power domain.
An error occurs while the management module isreading the status of specified domain.
Getting the power control setting on blade failed. An error occurs while the management module isreading the power control setting on blade server.
Invalid option for this blade: option
where option identifies the unacceptable option.
The user attempts to issue a command with an optionwhich is invalid for the targeted blade server.
Maximum CPU Speed not available. An error occurs while the management module isreading maximum CPU Speed.
Chapter 4. Error messages 435
Table 120. fuelg command errors (continued)
Error message Definition
pcap must be between min and max Watts.
where min and max represent the minimum andmaximum wattage values permitted.
The user input for power cap is out of the range.
Power value is not in the guaranteed capping range. The user attempts to set a power value that is out ofrange.
Setting -e to nebs automatically disables -am, so "-am on"will be ignored.
The user attempts to set the environment to nebs and toenable the acoustic mode at the same time.
There are mismatched power modules in power domaindomain_number.
where domain_number identifies the power domain.
The power modules installed in a power domain havedifferent ratings.
There is no thermal trending data to display. An error occurs while the management module isreading thermal trending data.
There is no trending data to display. An error occurs while the management module isreading power trending data.
Unable to change power management settings, domainmay be oversubscribed.
An error occurs while the management module isconfiguring the power management policy.
groups command errorsThis topic lists errors for the groups command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 121. groups command errors
Error message Definition
When creating a new group, a group name and authoritylevel must be specified.
A user tries to create a new group without specifying agroup name or authority level.
health command errorsThis topic lists errors for the health command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 122. health command errors
Error message Definition
Getting system health summary failed. An error occurs while the management module isreading the system health summary.
436 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
help command errorsThis topic lists errors for the help command.
There are no unique errors for the help command. See “Common errors” on page409 for a list of error messages that apply to all commands.
history command errorsThis topic lists errors for the history command.
There are no unique errors for the history command. See “Common errors” onpage 409 for a list of error messages that apply to all commands.
identify command errorsThis section lists error messages for the identify command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 toa target other than system.
-d can only be used with the -s on. The user tries to issue a command with the -d optionwithout -s on setting.
Delay value must be less than max
where max is the preset maximum.
The user input for option -d exceeds the maximum.
Delay value must be less than 60. A user tries to enter a -d value that is greater than 60seconds.
Error accessing remote LED. An error occurs while the management module isaccessing a remote LED.
Error getting LED status. An error occurs while the management module isreading the blade LED status.
Error reading system LED state. An error occurs while the management module isreading the system LED status.
Error setting system LED. An error occurs while the management module is settingthe system LED.
Error unknown command. The user tries to enter unrecognized command.
Identify: Error accessing remote LED. An error occurs while the management module isprocessing the command.
Identify: error getting LED status. An error occurs while the management module isprocessing the command.
Identify: error setting Management Module LED. An error occurs while the management module isprocessing the command.
Identify: Error unknown command. An error occurs while the management module isprocessing the command.
Identify: LED status not supported. The user tries to get the status of an LED that is notsupported by a blade server.
Chapter 4. Error messages 437
Table 123. identify command errors (continued)
Error message Definition
Identify: unknown LED state state
where state identifies the LED state that was returned.
An LED state other than on, off, or blinking is returned.
Identify: Unknown return status status
where the status value varies based on the problem thatwas encountered.
An error occurs while the management module isprocessing the command.
Syntax error. The user tries to enter an invalid command option. Typeidentify -h for command help.
The chassis identification LED cannot be turned off atthis time because one or more blades have their locationLED active.
The user tries to turn off the chassis identification LEDunder conditions that do not permit this action.
ifconfig command errorsThis topic lists error messages for the ifconfig command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 124. ifconfig command errors
Error message Definition
-em cannot be reconfigured while Stacking Mode isenabled on the AMM.
The user tries to issue a command with the -em optionwhile Stacking Mode is enabled on the advancedmanagement module.
-ep cannot be reconfigured while Stacking Mode isenabled on the AMM.
The user tries to issue a command with the -ep optionwhile Stacking Mode is enabled on the advancedmanagement 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.
where option is ir, gr, or sr.
The user tries to issue a command with an option -ir, -gr,or -sr which is not supported by the targeted I/Omodule.
-pip cannot be reconfigured while Stacking Mode isenabled on the AMM.
The user tries to issue a command with the -pip optionwhile Stacking Mode is enabled on the advancedmanagement 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 inconfiguration phase.
An error occurs while the management module is settingthe network configuration.
Configuration not supported on this I/O Module type. The user tries to issue a command for the configurationwhich 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 unsupportedI/O module type.
Error converting the i6 address from string to bytes. An error occurs while converting the i6 address from astring to bytes.
Enabling/Disabling new IP configuration failed. An error occurs while the management module isenabling 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 isreading the gateway address of a network interface (eth0or eth1).
Error reading IP Address. An error occurs while the management module isreading the IP address of the integrated systemmanagement processor on a blade server, or whilereading the IP address of a network interface (eth0 oreth1).
Error reading data for Link-local address. An error occurs while the management module isreading data for the link-local address.
Error reading data for Link-local address prefix length. An error occurs while the management module isreading data for the link-local address prefix length.
Error reading data for Stateless auto-config IP Addresses. An error occurs while the management module isreading the stateless auto-configuration IP address.
Error reading the burned-in MAC address. An error occurs while the management module isreading the burned-in MAC address of a networkinterface (eth0 or eth1).
Error reading the data rate. An error occurs while the management module isreading the data rate setting of a network interface (eth0or eth1).
Error reading the DHCP configuration. An error occurs while the management module isreading the DHCP setting of a network interface (eth0).
Error reading the duplex setting. An error occurs while the management module isreading the duplex setting of a network interface (eth0 oreth1).
Error reading the hostname. An error occurs while the management module isreading the host name of a network interface (eth0).
Error reading the locally administered MAC address. An error occurs while the management module isreading the locally administered MAC address of anetwork interface (eth0 or eth1).
Error reading the maximum transmission unit. An error occurs while the management module isreading the maximum transmission unit (MTU) setting ofa network interface (eth0 or eth1).
Error reading the subnet mask. An error occurs while the management module isreading the subnet mask of a network interface (eth0 oreth1).
Error writing IP Address. An error occurs while the management module is settingthe IP address of the integrated system managementprocessor on a blade server.
Getting blade cKVM status for blade blade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the cKVM status of targeted blade.
Getting interface status failed. An error occurs while the management module isreading the interface status.
I/O Module is in Stacking Mode and cannot change itsGateway configuration.
The user tries to issue a command to change theGateway configuration with the I/O Module in StackingMode.
I/O Module is in Stacking Mode and cannot change itsIP configuration.
The user tries to issue a command to change the IPconfiguration with the I/O Module in Stacking Mode.
Chapter 4. Error messages 439
Table 124. ifconfig command errors (continued)
Error message Definition
I/O Module is in Stacking Mode and cannot change itsSubnet configuration.
The user tries to issue a command to change Subnetconfiguration with I/O Module in Stacking Mode.
Invalid gateway address. The user tries to enter an invalid gateway address.
Invalid hostname. The user tries to enter an invalid hostname.
Invalid hostname arg for option: hostname. Consecutivedots
where:v option identifies the command optionv hostname identifies the invalid hostname argument
The user tries to enter consecutive periods (. ) as part ofa hostname.
Invalid hostname arg for option: hostname. Length has tobe < 64 characters
where:v option identifies the command optionv hostname identifies the invalid hostname argument
The user tries to enter a hostname longer than 63characters.
Invalid hostname arg for option: hostname. Onlyalphanumeric chars and._- allowed
where:v option identifies the command optionv hostname identifies the invalid hostname argument
The user tries to enter an hostname that contains invalidcharacters. Valid characters that can be used in ahostname are letters, numbers, periods ( . ), dashes ( - ),and underscores ( _ ).
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 bladeservers).
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 bein the range (0-255)
where:v option identifies the command optionv ip_address identifies the invalid IP address argument
The user tries to enter an IP address that is out of range.IP addresses must follow the standard format:xxx.xxx.xxx.xxx, where each xxx is a number from 0 to255.
Invalid IP arg for option: ip_address. Enter 4 bytesseparated by 3 dots
where:v option identifies the command optionv ip_address identifies the invalid IP address argument
The user tries to enter an IP address that is too long. IPaddresses must follow the standard format:xxx.xxx.xxx.xxx, where each xxx is a number from 0 to255.
Invalid IP arg for option: ip_address. Too few bytes
where:v option identifies the command optionv ip_address identifies the invalid IP address argument
The user tries to enter an IP address with too few bytes.IP addresses must follow the standard format:xxx.xxx.xxx.xxx, where each xxx is a number from 0 to255.
Invalid IP arg for option: ip_address. Too many bytes
where:v option identifies the command optionv ip_address identifies the invalid IP address argument
The user tries to enter an IP address with too manybytes. IP addresses must follow the standard format:xxx.xxx.xxx.xxx, where each xxx is a number from 0 to255.
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
where:v option identifies the command optionv address identifies the invalid MAC address argument
The user tries to enter an invalid MAC address.
Invalid MAC arg for option: address. Multicast addressesnot allowed
where:v option identifies the command optionv address identifies the invalid MAC address argument
The user tries to enter a multicast address.
Invalid MAC arg for option: address. Too few bytes
where:v option identifies the command optionv address identifies the invalid MAC address argument
The user tries to enter a MAC address with too fewbytes.
Invalid MAC arg for option: address. Too many bytes
where:v option identifies the command optionv address identifies the invalid MAC address argument
The user tries to enter a MAC address with too manybytes.
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 MACaddress cannot be a multicast address.
The user tries to set the locally administered MACaddress to a multicast address.
Invalid parameter. The MTU must be between 60 and1500, inclusive.
The user tries to enter an MTU outside the valid range.
Invalid parameter. Valid values for -c are dhcp, static, ordthens.
A user tries to enter an invalid parameter for the -c(Ethernet configuration method) command option.
Invalid parameter. Valid values for -d are auto, half, andfull.
The user tries to enter an invalid parameter with the -doption.
Invalid parameter. Valid values for -r are auto, 10, and100.
The user tries to enter an invalid parameter with the -roption.
Invalid subnet mask. The user tries to enter an invalid subnet mask.
Maybe blade network configuration is still in discoveryphase. Please check and try again.
An error occurs while the management module isreading the blade network configuration.
Option: -bsmp is not supported any more. The user tries to direct the command to the -bsmpcommand target that is no longer supported.
Please check blade health status and try again. An error occurs while the management module isreading 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 -Tsystem:blade[x]:sp to a blade server other than blade[1].
where ip address is a valid ip address and x identifies theselected blade server.
This target is no longer supported by the ifconfigcommand.
The user tries to direct the command to an invalidcommand target.
When setting –i6, -p6, or –g6, -id must be included. A user tries to configure a blade server static IPv6configuration and does not include the staticconfiguration ID number.
Chapter 4. Error messages 441
info command errorsThis topic lists error messages for the info command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 bladeblade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the blade H8 firmware VPD data of the targetedblade server.
Getting compact flash cards information failed. An error occurs while the management module isreading the compact flash cards information.
Getting firmware version of cKVM bay_number failed.
where the bay_number specifies the cKVM.
An error occurs while the management module isreading the firmware version of targeted cKVM.
Getting firmware's VPD data of type failed. An error occurs while the management module isreading the firmware's VPD data of targeted type.
Getting name of blade blade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the name of the targeted blade server.
Getting name of mm bay_number failed.
where the bay_number specifies the management module.
An error occurs while the management module isreading the name of the targeted management module.
Reload Firmware VPD failed. An error occurs while the management module isreloading the firmware VPD.
Reload Hardware VPD failed. An error occurs while the management module isreloading the hardware VPD.
Reload all failed. An error occurs while the management module isreloading all VPD and MAC addresses.
Reload MAC address failed. An error occurs while the management module isreloading the MAC address.
Reload WWN failed. An error occurs while the management module isreloading WWN.
Status: Unable to read status. An error occurs while the management module isreading the firmware update status.
Unable to read firmware VPD. An error occurs while the management module isreading the firmware VPD.
Unable to read hardware VPD. An error occurs while the management module isreading 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 errorsThis topic lists errors for the iocomp command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 126. iocomp command errors
Error message Definition
Error reading I/O Compatibility Detail for bladeblade_number
where blade_number identifies the blade server.
An error occurs while the management module isreading I/O compatibility for targeted blade server.
Error reading I/O Compatibility Detail for switchbay_number
where the bay_number identifies the I/O module.
An error occurs while the management module isreading I/O compatibility for targeted I/O module.
ERROR!!! IOM bay_number reports incorrect width!sw_width = sw_width
wherev the bay_number identifies the I/O modulev sw_width identifies the invalid width
An error occurs while the management module isreading I/O compatibility for targeted I/O module.
I/O Compatibility Detail or blade blade_number:unknown
where blade_number identifies the blade server.
An error occurs while the management module is gettingthe width of the targeted blade server.
kvm command errorsThis topic lists errors for the kvm command.
There are no unique errors for the kvm command. See “Common errors” on page409 for a list of error messages that apply to all commands.
ldapcfg command errorsThis topic lists error messages for the ldapcfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 127. ldapcfg command errors
Error message Definition
A Client DN password is configured, client DN must beconfigured too.
The user tries to issue a command to remove the clientDN setting with the client DN password configured.
AMM target name is limited to 63 characters. A user tries to set an advanced management moduletarget name that is longer than 63 characters.
Argument of option -arguments must be enclosed inquotation marks.
where arguments is the name of the improperly enteredarguments
The user tries to issue a command with arguments forthe options that are not enclosed in quotation marks.
Arguments containing spaces must be enclosed inquotation marks.
The user tries to issue a command with arguments foroptions without ending double quotes.
Chapter 4. Error messages 443
Table 127. ldapcfg command errors (continued)
Error message Definition
Both password and confirm password must be provided. The user tries to issue a command without providingboth the password and the confirm password.
Client DN password mismatch. Please reenterpasswords.
The user tries to issue a command with both -p and -cpoptions, but their arguments do not match.
Client DN password mismatch. Please reenterpasswords.
The user tries to issue a command with both -p and -cpoptions, but their arguments do not match.
If a Client DN password is configured, client DN mustbe configured too.
The user tries to issue a command to configure the clientDN password while the client DN is not configured.
Invalid option argument for -option:argument. format
where:v option identifies the optionv argument identifies the invalid argumentv format identifies the format of argument
The user tries to issue a command with invalidarguments for the options which do not conform to theformat specified.
You are configuring Client DN password, but no ClientDN. Please configure a Client DN.
The user tries to issue a command to set Client DNpassword while the Client DN is not configured.
You must configure a Search Domain given yourselection of 'option' for Domain Source.
where option is sd or ltsd.
The user tries to issue a command for -ds option settingswithout the Source Domain configured.
led command errorsThis topic lists errors for the led command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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.
where max is 60.
User input for the option -d exceeds the maximum.
Error getting LED status. An error occurs while the management module is gettingthe system LED status.
Error reading system LED state. An error occurs while the management module isreading the system LED state.
Error setting system LED. An error occurs while the management module isconfiguring the system LED.
Invalid option argument for -loc. A user tries to enter an invalid argument for the option-loc.
Error setting -loc for blade[slot] An error occurs while setting location LED for thetargeted blade.
-l can only be used by itself. User issues a command with -l option inclusive of anargument or other options.
Error turning off information LED An error occurs while the user is setting informationLED to off.
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 thistime because one or more blades have their location LEDactive.
A user issues a command to turn off the chassis locationLED under conditions when this is not allowed.
list command errorsThis topic lists error messages for the list command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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-structuredisplay of 0.
mcad command errorsThis topic lists error messages for the mcad command.
There are no unique errors for the mcad command. See “Common errors” on page409 for a list of error messages that apply to all commands.
modactlog command errorsThis topic lists errors for the modactlog command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 130. modactlog command errors
Error message Definition
Unable to read the Module Activity Log. No module activity log is found in the database.
monalerts command errorsThis topic lists errors for the monalerts command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 131. monalerts command errors
Error message Definition
-option must be used exclusive of its sub-options.
where option is -ca, -wa, or -ia.
A user tries to issue a command with the -ca, -wa, or -iaoption at the same time as its sub-options.
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 -ecdisabled setting.
Chapter 4. Error messages 445
monalertsleg command errorsThis topic lists errors for the monalertsleg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Important: The monalertsleg command is no longer supported by the advancedmanagement module firmware. Legacy alert monitoring that uses the monalertslegcommand must transition to use of the monalerts command.
Table 132. monalertsleg command errors
Error message Definition
Invalid syntax. -ec is only allowed to be enabled. A user tries to disable -ec (legacy alerts).
Note: If -ec is enabled, monalerts should be used. A user tries to issue a monalertsleg command with the-ec enable setting.
mt command errorsThis topic lists errors for the mt command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 133. mt command errors
Error message Definition
Remote media tray switching must be enabled to changethe media tray owner.
A user tries to issue a command to change the mediatray owner while media tray switching is not enabled.
nat command errorsThis topic lists error messages for the nat command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 valueoutside of its valid range.
I/O Module is in protected mode and cannot be restoredto its default configuration.
The user tries to restore the default configuration of anI/O module while it is in protected mode.
I/O Module is in Protected Mode and cannot change itsNAT configuration.
The user tries to change the configuration of an I/Omodule 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 valueoutside 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 modulethat 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 orTelnet.
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 attemptingto make a new rule.
Invalid input. '-pn' must be less than maximum_numbercharacters.
where maximum_number is the maximum number ofcharacters allowed for the protocol name.
The user tries to enter a protocol name with a stringlength of more than the maximum allowed.
ntp command errorsThis topic lists error messages for the ntp command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 135. ntp command errors
Error message Definition
Invalid value passed to -en flag. Valid values areenable/disable
The user input for the -en option is invalid.
Please set NTP server name or IP address beforeenabling NTP
The user tries to enable NTP before setting the servername or IP address.
Please set NTP server name or IP address beforesynchronizing the clock
The user tries to synchronize the clock before setting theNTP server name or IP address.
Please set NTP update frequency before enabling NTP The user tries to enable NTP before setting the updatefrequency.
Please set NTP v3 authentication entry before enablingNTP authentication
The user tries to enable NTP authentication beforeconfiguring the v3 authentication.
ping command errorsThis topic lists errors for the ping command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 136. ping command errors
Error message Definition
Error reading IP address of switch bay_number
where the bay_number designates the I/O module.
An error occurs while the management module is gettingthe current IP address of the targeted switch.
Error reading I/O Module's capabilities. An error occurs while the management module isreading the I/O Module's capabilities.
Error reading I/O Module's second ip configuration. An error occurs while the management module isreading the I/O Module's second ip configuration.
Error reading second IP address of I/O Modulebay_number
where the bay_number identifies the I/O module.
An error occurs while the management module isreading the second IP address of the I/O Modulespecified.
Chapter 4. Error messages 447
Table 136. ping command errors (continued)
Error message Definition
The I/O module cannot be pinged while the IP config isprotected.
The user tries to ping a protected member of an I/Omodule stack.
pmpolicy command errorsThis topic lists errors for the pmpolicy command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 137. pmpolicy command errors
Error message Definition
Error getting number of domains. An error occurs while the advanced managementmodule is getting the number of domains.
Getting current policy failed. An error occurs while the advanced managementmodule is getting the current policy for a domain.
Getting valid policies failed. An error occurs while the advanced managementmodule is getting the valid policies for powermanagement.
portcfg command errorsThis topic lists errors for the portcfg command.
There are no unique errors for the portcfg command. See “Common errors” onpage 409 for a list of error messages that apply to all commands.
ports command errorsThis topic lists error messages for the ports command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 138. ports command errors
Error message Definition
A certificate must first be in place before SSL can beenabled.
The user tries to enable SSL before setting up a valid SSLcertificate.
An SSH server key must first be in place before SSH canbe enabled.
The user tries to enable SSH before setting up a validSSH server key.
Duplicate port number entered. The user tries to enter a command with a port numberthat is already in use.
Enabling SNMPv1 failed The SNMPv1 configuration does not meet requiredcriteria.
Enabling SNMPv3 failed The SNMPv3 configuration does not meet requiredcriteria.
Error: A community is configured without an IP addressor host name. Please use ‘snmp' command for snmpconfiguration.
Attempted to configure community without an IPaddress or host name.
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. Pleaseuse ‘snmp' command for snmp configuration.
Attempted to configure a community name that wasalready defined.
Error: At least one configured community is required toenable SNMPv1. Please use ‘snmp' command for snmpconfiguration.
Attempted to enable SNMPv1 without configuring atleast one community.
Error: IP address of 0.0.0.0, 0::0 is allowed only when thefirst community is configed as Get or Set access type.Please use ‘snmp' command for snmp configuration.
IP address of 0.0.0.0 or 0::0 is allowed only when the firstcommunity is configured as a GET or SET access type.
Error: System contact must be defined to enableSNMPv1. Please use ‘snmp' command for snmpconfiguration.
Attempted to enable SNMPv1 without defining a systemcontact.
Error: System location must be defined to enableSNMPv1. Please use ‘snmp' command for snmpconfiguration.
Attempted to enable SNMPv1 without defining a systemlocation.
Error: System contact must be defined to enableSNMPv3. Please use ‘snmp' command for snmpconfiguration.
Attempted to enable SNMPv3 without defining a systemcontact.
Error: System location must be defined to enableSNMPv3. Please use ‘snmp' command for snmpconfiguration.
Attempted to enable SNMPv3 without defining a systemlocation.
Error sanity checking of SNMP configuration. An error occurs while the management module ischecking the SNMP configuration.
Invalid parameter. The timeout must be between 0 and4294967295 seconds.
The user tries to enter a timeout that is outside of thevalid 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 TCPCommand Mode. Use the sslcfg command to generate acertificate.
A user tries to change the state of stcm without a validcertificate in place.
Port number out of range. A user tries to enter a port number that is outside of thevalid range.
Resetting all ports to default values failed. An error occurs while the management module isresetting all ports to their default values.
Secure SMASH CLP cannot be enabled without a validSSH server key in place.
The user tries to enable the secure SMASH CLP beforesetting up a valid SSH server key.
The -prior option has been deprecated. Please use the-rpp option instead.
where prior is kvmp, rdp, rdocp, or sdsp.
The user tries to enter a command with a deprecatedoption, such as -kvmp, -rdp, -rdocp, or -sdsp.
The total number of secure and legacy connections ofTCP Command Mode cannot exceed 20
A user attempted to configure more than 20 TCPCommand Mode connections.
This I/O module does not support port speedconfiguration.
The user tries to enter a command for a speedconfiguration which not supported by the targeted I/Omodule.
Warning: Communication with IBM Director via SecureTCP Command Mode has been disabled.
A user has disabled the Secure TCP command mode.
Warning: Communication with IBM Director via TCPCommand Mode has been disabled.
A user has disabled the TCP command mode.
Chapter 4. Error messages 449
power command errorsThis topic lists error messages for the power command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 -hfor help on changing targets.
The user attempts to apply the -fp option to an I/Omodule that does not support this option.
POST results could not be read. An error occurs during POST.
POST results not complete: hex_code
where the hex_code value varies based on the problemthat was encountered.
The POST results are not available. See thedocumentation that comes with the device that failed torespond correctly to the power command for informationabout the hex_code value.
Powering on/off blade failed. An error occurs while powering the blade server on oroff.
Powering on/off I/O Module failed. An error occurs while the management module ispowering the I/O module on or off.
Powering on/off network clock failed. An error occurs while the management module ispowering the network clock on or off.
Powering on/off Telco Alarm Panel failed. An error occurs while the management module ispowering the Telco Alarm Panel on or off.
Resetting blade failed. An error occurs while the management module isresetting the blade server.
Shutting down OS and powering off blade failed. An error occurs while the management module isshutting down the operating system and powering offthe blade server.
The I/O Module is powering off. The user tries to power on, power off, or restart a RAIDSAS module which is in the process of powering off.(BladeCenter S only)
rdoc command errorsThis topic lists error messages for the rdoc command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 errorsThis topic lists error messages for the read command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 141. read command errors
Error message Definition
Both the -i and -l options must be specified with the-config file.
The user does not specify both the -i and -l options whenrestoring configuration from a file.
Configuration restore from the chassis failed: i2c busread error.
An error occurs while the management module isrestoring the management module configuration from theBladeCenter unit midplane due to an i2c read error.
Configuration restore from the chassis failed: operationnot supported.
An error occurs while the management module isrestoring the management module configuration from theBladeCenter unit midplane due to a failed system check.
Configuration restore from the chassis failed: NVRAMcompression error.
An error occurs while the management module isrestoring the management module configuration from theBladeCenter unit midplane due to an EEPROMcompression error.
Configuration restore from the chassis failed:unsupported midplane data format.
An error occurs while the management module isrestoring the management module configuration from theBladeCenter unit midplane due to an unsupportedEEPROM format.
Could not retrieve encryption data from theconfiguration file successfully.
The user tries to enter a passphrase that does not matchthe one that was used to create the backup configurationfile.
Error writing autoread flag. An error occurs while the management module iswriting autoread flag.
File transfer failed. An error occurs while transferring a file during fileupload.
Firmware update is in progress. Try again later. The user tries to restore the management moduleconfiguration from the BladeCenter unit midplane whilethe management module firmware is updating.
Please make sure you enter the correct passphrase forthis configuration file.
The user tries to enter a passphrase that does not matchthe one that was used to create the backup configurationfile.
Resource allocation failure! Memory allocation failed forconfiguration read.
An error occurs while the management module isallocating memory.
The -auto option can only be used with the -configchassis.
The user tries to set the -auto option when restoring theconfiguration from a file.
The -config option and a config source is required. The user tries to issue a command to read configurationfrom a file without specifying both the -config optionand config source.
The -config option is required. The user does not include a required -config option forthe command.
The -i, -l, and -p options can only be used with the-config file.
The user tries to specify a TFTP server and aconfiguration file when restoring the configuration fromthe BladeCenter unit midplane.
The passphrase is greater than 1600 characters. The user tries to input a passphrase that exceeds themaximum length.
Chapter 4. Error messages 451
Table 141. read command errors (continued)
Error message Definition
The passphrase must be quote-delimited. The user tries to input a passphrase that is notquote-delimited.
There was a problem retrieving the file. TFTP encounters an error when transferring theconfiguration file.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced managementmodule is uploading a file.
remotechassis command errorsThis topic lists error messages for the remotechassis command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 142. remotechassis command errors
Error message Definition
Clearing the internal discovered list of MM's failed. An error occurs while the management module isclearing the internal discovered list of managementmodules.
Discovery cannot be run until SLP has been enabled. The user tries to discover other BladeCenter units on thenetwork when SLP is disabled.
Error running discovery. An error occurs while the management module isrunning discovery.
Getting last discovery time failed. An error occurs while the management module isreading last discovery time.
Getting the first entry of the internal discovered list ofMM's failed.
An error occurs while the management module isreading the first entry of the internal discovered list ofmanagement modules.
Getting the internal discovered list of MM's failed. An error occurs while the management module isreading the internal discovered list of managementmodules.
Unable to read SLP settings. An error occurs while the management module isreading SLP settings.
reset command errorsThis topic lists error messages for the reset command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 143. reset command errors
Error message Definition
An error occurred while disabling failover. An error occurs while the management module isdisabling failover.
An error occurred while enabling failover. An error occurs while the management module isenabling 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 afirmware update. The error message displays and themanagement module does not reset.
Rebooting blade failed. An error occurs while the management module isrebooting the blade server.
Resetting and running standard/extended/fulldiagnostics for I/O module failed.
An error occurs while the management module isresetting and running diagnostics for the I/O module.
Resetting I/O module failed. An error occurs while the management module isresetting the I/O module.
There is no backup management module installed. A user tries to enable failover on a management-modulereset and there is no standby management module.
Resetting blade blade_number with NMI not supported.
where the blade_number identifies the blade server.
A user tries to reset a blade server that does not supportnon-maskable interrupts (NMI).
Resetting blade blade_number with NMI failed.
where the blade_number identifies the blade server.
An error occurs while the management module isresetting a blade server with NMI.
scale command errorsThis topic lists errors for the scale command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 144. scale command errors
Error message Definition
Auto-create partition failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while creating a partition.
Clearing complex failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while clearing a complex.
Create a partition failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while creating a partition.
Deleting a partition failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while deleting a partition.
Getting complex information failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while gathering complex information.
Invalid node slot. A user tries to enter a slot number for a node or bladeserver that is not valid. Make sure that the nodeinformation specified is valid.
Chapter 4. Error messages 453
Table 144. scale command errors (continued)
Error message Definition
Invalid range of node slots. A user tries to enter a range of slot numbers for a nodeor blade server that is not valid. Make sure that the nodeinformation specified is valid.
Power controlling a partition failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while changing the power state of apartition.
Setting mode failed: error_detail
where error_detail provides additional information aboutthe error.
An error occurs while changing the power state of apartition.
sddump command errorsThis topic lists errors for the sddump command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 145. sddump command errors
Error message Definition
Initiate data collection of type type not supported onblade[x]
where type is the type of data requested and x is thenumber of the blade-server bay.
The management module is unable to collect therequested data from the specified blade server.
Initiate data collection type failed. The management module is unable initiate datacollection of the JS12 or JS22 blade server.
sdemail command errorsThis topic lists errors for the sdemail command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 146. sdemail command errors
Error message Definition
-to must be specified. A user tries to send a service data email message withoutspecifying the recipient.
Error sending service data email. An error occurs when the management module tries tosend 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 120characters.
A user tries to enter an email address that is 120 or morecharacters long.
Invalid syntax. Please type 'sdemail -h' for help. A user enters the sdemail command without specifyingthe required options.
Subject must be enclosed in quotation marks. A user tries to send a service data email message with asubject option that is not enclosed in quotation marks.
454 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
security command errorsThis topic lists errors for the security command.
There are no unique errors for the security command. See “Common errors” onpage 409 for a list of error messages that apply to all commands.
service command errorsThis topic lists errors for the service command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 147. service command errors
Error message Definition
Getting status of debug with USB key failed. An error occurs while the management module isreading the status of debug with a USB key.
shutdown command errorsThis topic lists errors for the shutdown command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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.
slp command errorsThis topic lists errors for the slp command.
There are no unique errors for the slp command. See “Common errors” on page409 for a list of error messages that apply to all commands.
smtp command errorsThis topic lists error messages for the smtp command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 149. smtp command errors
Error message Definition
Getting SMTP server host name or IP address failed. An error occurs while the management module isreading the SMTP server host name or IP address.
Input length is greater than the maximum charactersallowed.
A user tries to enter too many characters in an inputfield.
Invalid host name or ip address. A user tries to set the SMTP host name or IP address toan invalid value.
Chapter 4. Error messages 455
Table 149. smtp command errors (continued)
Error message Definition
Removing SMTP server name or IP address failed. An error occurs while the management module isremoving an SMTP server host name or IP address.
Setting SMTP server name or IP address failed. An error occurs while the management module is settingan SMTP server host name or IP address.
SMTP server host name or IP address is not set. A user tries to view the SMTP host name or IP addresswhen the values are not set.
snmp command errorsThis topic lists error messages for the snmp command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 150. snmp command errors
Error message Definition
Arguments containing spaces must be enclosed inquotation marks
A user tries to enter a string containing spaces that hasan opening quotation mark without a closing quotationmark.
At least one configured community is required to enableSNMP.
A user tries to enable SNMP without configuring at leastone community name.
Config failed. IP address of 0.0.0.0 is allowed only for thefirst host name in the first community.
A user tries to set an IP address of 0.0.0.0 for somethingother than the first host name of the first community.
Config failed. IP address of 0.0.0.0 is allowed only whenthe first community is configured as Get access type.
A user tries to set an IP address of 0.0.0.0 for the firsthost name of the first community when the firstcommunity is not configured with the Get access type.
Config failed. You defined a community without an IPaddress or host name.
A user tries to define a community without specifying anIP address or host name.
Config failed. You defined a duplicate community name. A user tries to define a two communities with the samename.
Enabling/Disabling snmp interface failed. An error occurs while the management module isenabling or disabling an snmp interface.
Enabling/Disabling snmp traps failed. An error occurs while the management module isenabling or disabling the snmp traps.
Enabling/Disabling SNMPv3 Agent failed. An error occurs while the management module isenabling or disabling the SNMPv3 Agent.
Input length is greater than the maximum charactersallowed.
A user tries to enter too many characters in an inputfield.
Invalid community name. A user tries to set a community name to an invalidvalue.
Invalid host name or ip address. A user tries to set the SNMP host name or IP address toan invalid value.
Setting access type of type for SNMPv3 failed
where type is the type of SNMPv3 access desired.
An error occurs while the management module is settingaccess type for an SNMPv3.
Setting location/contact of the SNMP agent failed. An error occurs while the management module is settingthe location or contact of the SNMP agent.
456 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sol command errorsThis topic lists error messages for the sol command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 151. sol command errors
Error message Definition
An error occurred while disabling SOL globally. An error occurs while the management module isdisabling SOL globally.
An error occurred while disabling SOL on that blade. An error occurs while the management module isdisabling SOL on a blade server.
An error occurred while enabling SOL globally. An error occurs while the management module isenabling SOL globally.
An error occurred while enabling SOL on that blade. An error occurs while the management module isenabling SOL on a blade server.
An error occurred while reading the global SOL status. An error occurs while the management module isreading the global SOL status.
An error occurred while reading the SOL accumulatetimeout.
An error occurs while the management module isreading the SOL accumulate timeout.
An error occurred while reading the SOL retry count. An error occurs while the management module isreading the SOL retry count.
An error occurred while reading the SOL retry interval. An error occurs while the management module isreading the SOL retry interval.
An error occurred while reading the SOL send threshold. An error occurs while the management module isreading the SOL send threshold.
An error occurred while reading the SOL session statuson that blade.
An error occurs while the management module isreading the SOL session status on a blade server.
An error occurred while reading the SOL VLAN ID. An error occurs while the management module isreading the SOL VLAN ID.
An error occurred while setting the SOL accumulatetimeout.
An error occurs while the management module is settingthe SOL accumulate timeout.
An error occurred while setting the SOL blade resetsequence.
An error occurs while the management module isprocessing the command.
An error occurred while setting the SOL escapesequence.
An error occurs while the management module isprocessing the command.
An error occurred while setting the SOL retry count. An error occurs while the management module is settingthe SOL retry count.
An error occurred while setting the SOL retry interval. An error occurs while the management module is settingthe SOL retry interval.
An error occurred while setting the SOL send threshold. An error occurs while the management module is settingthe SOL send threshold.
An error occurred while setting the SOL vlan id. An error occurs while the management module isprocessing the command.
Checking if this blade supports SOL failed. An error occurs while the management module ischecking 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 -statuscommand option.
Chapter 4. Error messages 457
Table 151. sol command errors (continued)
Error message Definition
Invalid arg for -status. Must be enabled or off. A user tries to enter an invalid argument for the -statuscommand option.
Invalid parameter. The accumulate timeout must bebetween 1 and 251 inclusive.
A user tries to enter an accumulate timeout that isoutside of the valid range.
Invalid parameter. The retry count must be between 0and 7, inclusive.
A user tries to enter a retry count that is outside of thevalid range.
Invalid parameter. The send threshold must be between 1and 251 inclusive.
A user tries to enter a send threshold that is outside ofthe valid range.
Invalid parameter. The vlan id must be between 1 and4095 inclusive.
A user tries to enter a VLAN ID that is out of range.
Retry interval range is too large. Setting to 2550. A user tries to enter a retry interval that is greater than2550 ms. If the user tries to enter a retry interval greaterthan 2550 ms, the retry interval will be set to 2550 ms.
Setting retry interval to 2500 failed. An error occurs while the management module is settingthe retry interval to 2550.
This blade does not support SOL. A user tries to issue the SOL command to a blade serverthat does not support SOL.
sshcfg command errorsThis topic lists errors for the sshcfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 152. sshcfg command errors
Error message Definition
Getting CLI SSH port failed. An error occurs while the management module isreading the CLI SSH port.
Getting DSA host key failed. An error occurs while the management module isreading the DSA host key.
Getting host key size failed. An error occurs while the management module isreading the host key size.
Getting installed key status failed. An error occurs while the management module isreading the installed key status.
Getting number of SSH public keys installed failed. An error occurs while the management module isreading the number of SSH public keys installed.
Getting SMASH SSH port failed. An error occurs while the management module isreading the SMASH SSH port.
When displaying host keys, -hk must be used by itself. The user tries to issue a command to display the hostkeys with option -hk.
458 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sslcfg command errorsThis topic lists errors for the sslcfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 153. sslcfg command errors
Error message Definition
-dnld must be used with the -cert/-csr (server, client) aswell as -i and optionally -l
A user tries to issue a download certificate or certificatesigning request command without the -cert or -csr, and -ioptions.
-i must be provided to download a trusted certificate. A user tries to issue a downloading trusted certificatecommand without the -i option.
-upld must be used with the -cert (server, client) as wellas -i and -l
A user tries to issue an import certificate commandwithout the -cert, -l and -i options.
Cannot open file: filename
where filename is the name of the file that was enteredfor opening.
An error occurs while the management module is tryingto open a file.
Cert generation for server/client failed
where server/client specifies whether the certificate wasbeing generated for a server or client.
An error occurs while the management module isgenerating a certificate for the server or client.
CLI map failed error = error
where error specifies error.
An error occurs while the management module ismapping the file to memory.
Converting DER back to X509 format failed. An error occurs while the management module isconverting DER back to X509 format.
CSR generation for server/client failed
where server/client specifies whether the certificatesigning request was being generated for a server orclient.
An error occurs while the management module isgenerating a certificate signing request for a server orclient.
Downloading Cert/CSR to tftp server argument is failed
where: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
An error occurs while the management module isdownloading a certificate or certificate signing request tothe tftp server for the SSL server or client.
Error: unknown application An error occurs because an unknown certificate type isreferred to.
Exporting Cert/CSR failed
where Cert/CSR specifies whether the user tried to exporta certificate or certificate signing request.
An error occurs while the management module isexporting a certificate or certificate signing request.
File transfer failed. An error occurs while transferring a file during fileupload.
Getting filename from tfpt server argument failed
where:v filename identifies the name of the requested filev argument identifies the IP address of the tftp server
An error occurs while the management module is gettinga file from the tftp server.
Chapter 4. Error messages 459
Table 153. sslcfg command errors (continued)
Error message Definition
Getting certificate status of standby AMM failed. An error occurs while the management module isreading the certificate status of the standby advancedmanagement module.
Getting failover mode failed. An error occurs while the management module isreading the failover mode.
Getting SSL Server/Client Certificate/CSR status failed. An error occurs while the management module isreading the SSL server or client certificate or certificatesigning request status.
Importing certFileName is failed
where certFileName is the name of the certificate that wasbeing imported.
An error occurs while the management module isimporting a certificate.
Input length is greater than the maximum charactersallowed.
A user tries to issue a command with an invalidargument for the option. The length of the input isgreater than maximum.
Invalid IP arg for -option: argument. Each byte has to bein the range (0-255)
where:v option identifies the command optionv argument identifies the invalid IP address argument
A user tries to issue a command with an invalidargument for the IP Address option. One or more parts isnot in the range of 0-255.
Invalid IP arg for -option: argument. Enter 4 bytesseparated by 3 dots
where:v option identifies the command optionv argument identifies the invalid IP address argument
A user tries to issue a command with an invalidargument for the IP Address option. Invalid argumentscould be too long, too short, or not numeric in all parts.
Invalid IP arg for -option: argument. Too few bytes
where:v option identifies the command optionv argument identifies the invalid IP address argument
A user tries to issue a command with an invalidargument for the IP Address option, an argument whichhas fewer than four parts.
Invalid IP arg for -option: argument. Too many bytes
where:v option identifies the command optionv argument identifies the invalid IP address argument
A user tries to issue a command with an invalidargument for the IP Address option, an argument whichhas more than four parts.
Invalid option for Cert generation: -cpwd A user tries to issue a command with an invalid option-cpwd for certification generation.
Invalid option for Cert generation: -un A user tries to issue a command with an invalid option-un for certification generation.
IPs Swaps is not configured. A user tries to issue a command for the SSLconfiguration against the Standby Server target withoutthe IPs Swaps configured.
Missing required options. A user tries to issue a command for the SSLconfiguration without entering all the required options.
No Cert/CSR available.
where Cert/CSR specifies whether the user specified acertificate or certificate signing request.
A user tries to issue a command to download anonexistent certificate or certificate signing request.
460 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Table 153. sslcfg command errors (continued)
Error message Definition
No tcindex available.
where index is the number of the selected trustedcertificate.
A user tries to issue a command to remove or downloada nonexistent trusted certificate.
No valid client certificate is in place. Type 'sslcfg -h' forsyntax help of the SSLclient Certificate generationcommand.
A user tries to issue a command to enable the SSL clientwithout a valid client certificate in place.
No valid server certificate is in place. Type 'sslcfg -h' forsyntax help of the SSL server Certificate generationcommand.
A user tries to issue a command to enable the SSL serverwithout a valid server certificate in place.
No valid trusted certificate is in place. Type 'sslcfg -h' forsyntax help of the SSL trusted Certificate importingcommand.
A user tries to issue a command to enable the SSL clientwithout a valid trusted certificate in place.
Putting filename to tfpt server ip_address failed.
where:v filename identifies the command optionv ip_address identifies the IP address of the tftp server
An error occurs while the management module isputting a file to the tftp server.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced managementmodule is uploading a file.
Writing X509 format certificate to file failed. An error occurs while the management module iswriting the X509 format certificate to File.
syslog command errorsThis topic lists errors for the syslog command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 154. syslog command errors
Error message Definition
Input length is greater than the maximum charactersallowed.
A user tries to enter too many characters for an inputfield.
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.
Chapter 4. Error messages 461
tcpcmdmode command errorsThis topic lists error messages for the tcpcmdmode command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 155. tcpcmdmode command errors
Error message Definition
Error changing TCP command mode connection. An error occurs while the management module ischanging the TCP command mode Connection.
Error disabling tcpcmdmode. An error occurs while the management module isdisabling the TCP command mode.
Error enabling TCP command mode. An error occurs while the management module isenabling 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-numericcharacters. For example, tcpcmdmode -t 200m.
Invalid parameter. The timeout must be between 0 and4294967295 seconds.
A user tries to enter a parameter value for the -t(timeout) command option that is outside of the validrange.
Maximum connections can not exceed maximum
where maximum designates the total number of permittedconnections.
A user attempted to configure more connections than themaximum number of connections supported.
No valid server certificate is in place for Secure TCPCommand Mode. Use the sslcfg command to generate acertificate.
The user issues a command to enable the Secure TCPCommand Mode when a valid server certificate is not inplace.
The total number of secure and legacy connections ofTCP Command Mode cannot exceed maximum
where maximum designates the total number of permittedconnections.
A user attempted to configure more TCP CommandMode connections than the maximum number of secureand legacy connections supported.
Warning: Communication with IBM Director via SecureTCP Command Mode has been disabled.
A user has disabled the Secure TCP command mode.
Warning: Communication with IBM Director via TCPCommand Mode has been disabled.
A user has disabled the TCP command mode.
telnetcfg command errorsThis topic lists error messages for the telnetcfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 156. telnetcfg command errors
Error message Definition
Invalid parameter. Input must be numeric. A user tries to enter a Telnet timeout value containingnon-numeric characters. For example, telnetcfg -t 200w.
Invalid parameter. The telnet timeout range must be lessthan 4294967295.
The user tries to enter a timeout value greater than4294967295 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 and4294967295 seconds.
A user tries to enter a Telnet timeout value that is out ofrange.
temps command errorsThis topic lists errors for the temps command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 157. temps command errors
Error message Definition
Blade blade_number: Too many SDRs found.
where blade_number identifies the blade server.
A database error occurs when too many SDRs are found.
Getting power state of blade blade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the power state of the specified blade server.
thres command errorsThis topic lists errors for the thres command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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.
trespass command errorsThis topic lists error messages for the trespass command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 thetrespassing warning without the -twe enabled setting.
The trespassing warning must be quote-delimited. The user tries to enter a trespassing warning that is notenclosed in double-quotation marks.
The trespassing warning is greater than 1600 characters. The user tries to enter a trespassing warning that islonger than 1600 characters.
Chapter 4. Error messages 463
uicfg command errorsThe following table lists error messages for the uicfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 160. uicfg command errors
Error message Definition
Enabling SNMPv1/v3 failed. The SNMPv1/v3 configuration does not meet requiredcriteria. 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 issanity-checking the SNMP configuration.
Maximum connections can not exceed maximum
where maximum designates the total number of permittedconnections.
A user has attempted to configure more connections thanthe maximum number of connections supported.
No valid server certificate is in place for Secure TCPCommand Mode. Use the sslcfg command to generate acertificate.
The user issues a command to configure the Secure TCPCommand Mode when a valid server certificate is not inplace
Reading telnet/ssh/snmpv1/snmpv3 status failed. An error occurs while the management module isreading the telnet, ssh, snmpv1, or snmpv3 status.
The total number of secure and legacy connections ofTCP Command Mode cannot exceed maximum
where maximum designates the total number of permittedconnections.
A user attempted to configure more TCP CommandMode connections than the maximum number of secureand legacy connections supported.
Warning: Communication with IBM Director via SecureTCP Command Mode has been disabled.
A user has disabled the Secure TCP command mode.
Warning: Communication with IBM Director via TCPCommand Mode has been disabled.
A user has disabled the TCP command mode.
464 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update command errorsThis topic lists error messages for the update command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 161. update command errors
Error message Definition
-r must be used with -u to update firmware to AMM andautomatically reboot AMM if firmware update succeeds.
A user tries to enter a command with the -r option toupdate firmware to a primary advanced managementmodule, but fails to include the -u option.
Cannot perform this command right now. The agent isnot active.
A user tries to enter a command while the agent is notactive.
Disabling failover failed. An error occurs while the management module isturning off the automatic failover feature.
Error reading information for firmware imageindex.maximum
where index specifies the firmware image.
An error occurs while the management module isreading information for a specified firmware image.
Error reading the number of firmware images. An error occurs while the management module isreading the number of firmware images.
Flash operation failed. An error occurs during the flash firmware update.
Flash operation failed status percentage
where the percentage value varies based on when theproblem was encountered.
An error occurs during the flash firmware update.
Flash operation not in process or status unavailable. An error occurs during the flash firmware update.
Flash operation timed out percentage.
where the percentage value varies based on when theproblem was encountered.
An error occurs during the flash firmware update.
Flash preparation - error sending packet file filename.
where filename identifies the file being updated.
An error occurs during the flash firmware update.
Flash preparation error. Packet percent completepercentage. Flash percent complete percentage.
where the percentage value varies based on when theproblem was encountered.
An error occurs during the flash firmware update.
Flash preparation error. Timeout on packet preparationoperation percentage.
where the percentage value varies based on when theproblem was encountered.
An error occurs during the flash firmware update.
Flashing not supported on this target. A user attempts to run the update command on amodule that does not support flash firmware updates.
Getting data encryption setting failed. If data encryptionis enabled and you are updating the firmware to a levelwhich does not support data encryption, you will lose allyour configuration settings as a result.
An error occurs while the management module isreading the data encryption setting.
Chapter 4. Error messages 465
Table 161. update command errors (continued)
Error message Definition
Getting name of mm bay_number failed.
where the bay_number identifies the management modulespecified.
An error occurs while the management module isreading the name of the management module indesignated bay.
Invalid image index. Index must be less than maximum
where maximum designates the largest permitted indexvalue.
A user tries to enter an image index that is greater thanthe maximum permitted index value.
Invalid option. An invalid command option is entered. For the updatecommand, invalid command option errors include:v the -i (IP address) command option does not have an
IP address parameterv the -i (IP address) command option specifies an
invalid IP addressv attempting to enter the -i (IP address) command
option without the -n (filename) command optionv the -n (filename) command option does not have a file
name parameterv attempting to enter the -n (filename) command option
without the -i (IP address) command optionv attempting to enter the -v (verbose) command option
without the -i (IP address) command option and -n(filename) command option
v attempting to enter the -v (verbose) command optionwith the -a command option
Invalid syntax. The user tries to execute a command without specifyinga command option.
Management Module bay_number is not installed.
where the bay_number identifies the management modulespecified.
The command is targeted to a management module baywhere no management module is installed.
Rebooting AMM failed. An error occurs while the advanced managementmodule is trying to reboot.
Status: Unable to read status. An error occurs while the management module isreading status.
TFTP Error: error_code.
where the error_code can have one of the followingvalues:v Access violation.v Connection failure.v Disk full or allocation exceeded.v File already exists.v File error.v File not found.v Illegal option negotiation.v Illegal TFTP operation.v Unable to allocate memory.v Unknown transfer ID.v Unknown user.
An error occurs when the user attempts to set up theTFTP connection.
Unable to read blade server VPD bay bay_number name.
where the bay_number and name identify the blade serverby location and name.
The command specifies an empty blade server bay or anerror occurs when reading the VPD.
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.
where the bay_number and name identify the I/O moduleby location and name.
The command specifies an empty I/O-module bay or anerror occurs when reading the VPD.
Unable to read MM VPD bay bay_number name.
where the bay_number and name identify the managementmodule by location and name.
The command specifies an empty management modulebay or an error occurs when reading the VPD.
Unable to read VPD for Blade blade_number name.
where the blade_number and name identify the bladeserver by location and name.
An error occurs while the management module isreading the VPD of the targeted blade server.
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 notvalid.
Update Failed, there was a problem retrieving the file. The management module was unable to complete theupdate because it was unable to retrieve the file from theTFTP server.
uplink command errorsThis topic lists error messages for the uplink command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
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 withouta 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 isenabled.
A user tries to set both -ip and -ip6 to zero while -el isenabled.
Error converting the IPv6 address from string to bytes. An error occurs while converting the IPv6 address froma string to bytes.
Getting status of failver on Lose/Logical of Physical Linkfailed.
An error occurs while the management module isreading status of failver on Lose/Logical of PhysicalLink.
Invalid uplink delay value. A user tries to enter a delay value that is less than 1 orgreater than 255. For example, uplink -del 0.
No option argument for option
where option is the command option for which noargument was specified.
A user tries to enter a command option without itsrequired argument.
The option argument for option is out of the valid range(between 1 and 2880 minutes).
where option is the number of minutes specified.
The user input for an option is out of the range.
Chapter 4. Error messages 467
Table 162. uplink command errors (continued)
Error message Definition
The option argument for option is out of the valid range(between 10 and 172800 seconds).
where option is the number of seconds specified.
The user input for an option is out of the range.
users command errorsThis topic lists error messages for the users command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 163. users command errors
Error message Definition
-af contains invalid characters. Only alphanumeric,comma, asterisk, question mark, hyphen, period, andexclamation point characters are valid.
The user input for the -af option is invalid.
-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 samecommand.
A user tries to simultaneously modify and delete a userin the same command.
Arguments containing spaces must be enclosed inquotation marks.
A user tries to enter a context name containing spacesthat does not have opening and closing quotation marks.
Deleting user failed. An error occurs while the management module isdeleting an user.
Error converting RBS permissions. An error occurs while the management module isconverting permissions data to the role-based security(RBS) format.
Error creating user. An error occurs while the management module iscreating a user.
Error creating user: The authentication protocol cannotbe none because the security settings require passwords.
The user tries to issue a command to create a user withno authentication protocol when the security settingsrequire passwords.
Error reading certificate details. An error occurs while the management module isreading certificate details.
Error reading key. An error occurs while the management module isreading the key.
Error setting the access type. An error occurs while the management module is settingthe access type.
Error setting the authentication protocol. An error occurs while the management module is settingthe authentication protocol.
Error setting the authority level. An error occurs while the management module is settingthe authority level.
Error setting the context name. An error occurs while the management module is settingthe context name.
Error setting the hostname/IP address. An error occurs while the management module is settingthe 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 settingthe password.
Error setting the password. The new password is notcompliant.
The user tries to issue a command to set the newpassword which is not compliant.
Error setting the privacy password. An error occurs while the management module is settingthe privacy password.
Error setting the privacy protocol. An error occurs while the management module is settingthe privacy protocol.
Error setting the username. An error occurs while the management module is settingthe username.
Error transferring file. An error occurs while the management module istransferring file.
File transfer failed. An error occurs while transferring a file during fileupload.
Getting a summary of all keys of user index failed.
where the index value varies based on the problem thatwas encountered.
An error occurs while the management module isreading a summary of all keys of the targeted user.
Getting authority level of user index failed.
where the index value varies based on the problem thatwas encountered.
An error occurs while the management module isreading authority level of the targeted user.
Getting role-based security level of user index failed.
where the index value varies based on the problem thatwas encountered.
An error occurs while the management module isreading role-based security level of the targeted user.
Incorrect login permission option: permission
where the permission value varies based on the problemthat was encountered.
A user tries to specify an invalid login permission for the-a command option.
Invalid argument. Valid arguments for -at are read, write,and traps.
A user tries to set an invalid argument for the -atcommand option.
Invalid argument. Valid choices are des or <none>. A user tries to set an invalid argument for the -ppcommand option.
Invalid argument. Valid choices are md5, sha, or <none>. A user tries to set an invalid argument for the -apcommand 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):device_A-device_B.
where device_A and device_B identify the ends of theinvalid device range being specified.
A user specifies an invalid device range while trying tocreate or modify a user.
Invalid device number: device_number.
where device_number identifies the device number that isinvalid.
A user provides a device number that is out of rangewhile trying to create or modify a user.
Invalid hostname or ip address. A user tries to set an invalid host name or IP address forthe -i command option.
Chapter 4. Error messages 469
Table 163. users command errors (continued)
Error message Definition
Invalid key index for this command. The user input for index is invalid.
Invalid rbs device: device.
where device identifies the device that is invalid.
A user specifies an invalid device while trying to createor modify a user.
Invalid rbs device: Must specify device number A user specifies an invalid device number while trying tocreate or modify a user.
Invalid rbs device list. A user does not specify a device list while trying tocreate or modify a user.
Invalid rbs device (must be same device): device.
where device identifies the device that is invalid.
A user specifies an invalid device while trying to createor modify a user.
Invalid rbs role: role.
where role identifies the role that is invalid.
A user specifies an invalid role while trying to create ormodify a user.
Invalid rbs role list. A user fails to specify a role list while trying to modifyor create a user.
Invalid username. The username can only containnumbers, letters, dots, and underscores.
The user tries to enter The username that containsinvalid characters. Valid characters that can be used in ausername are letters, numbers, periods (. ), andunderscores ( _ ).
Max retries changing password reached. The user tries to issue a command to change a passwordafter the max retries of changing password limit isreached.
Must be set at least one rbs role for this user. The user tries to issue a command to create a userwithout the rbs role settings.
Old password is incorrect. The user tries to issue a command to change a passwordwith an incorrect old password.
Old password must be specified by long option op. The user tries to issue a command to change a passwordwithout the -op option.
Specify your new password with '-p' option. The user tries to issue a command to change a passwordwithout the -p option.
Syntax error. -a option must have an argument. A user tries to attempt to enter the command with an -acommand option that has no argument.
Syntax error. -at option must have an argument. A user tries to attempt to enter the command with an -atcommand option that has no argument.
Syntax error. -cn option must have an argument. A user tries to attempt to enter the command with a -cncommand option that has no argument.
Syntax error. -i option must have an argument. A user tries to attempt to enter the command with an -icommand option that has no argument.
Syntax error. -n option must have an argument. A user tries to attempt to enter the command with an -ncommand option that has no argument.
Syntax error. -ppw option must have an argument. A user tries to attempt to enter the command with a-ppw command option that has no argument.
Syntax error. Multiple -a options found. A user tries to enter the -a command option in a singlecommand multiple times.
Syntax error. Multiple -ap options found. A user tries to enter the -ap option flag in a singlecommand multiple times.
Syntax error. Multiple -at options found. A user tries to enter the -at option flag in a singlecommand multiple times.
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 singlecommand multiple times.
Syntax error. Multiple -i options found. A user tries to enter the -i option flag in a singlecommand multiple times.
Syntax error. Multiple -n options found. A user tries to enter the -n option flag in a singlecommand multiple times.
Syntax error. Multiple -p options found. A user tries to enter the -p option flag in a singlecommand multiple times.
Syntax error. Multiple -pp options found. A user tries to enter the -pp option flag in a singlecommand multiple times.
Syntax error. Multiple -ppw options found. A user tries to enter the -ppw option flag in a singlecommand multiple times.
Syntax error. Type users -h for help. A user tries to set an invalid value for a commandoption.
The context name must be less than 32 characters long. A user tries to set a context name that is longer than 31characters.
The -i and -l options must both be specified when using-upld.
The user tries to issue a -upld command without -i and-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 nomore than 15 characters long.
The user tries to enter a password that is too short or toolong.
The password must contain at least one alphabetic andone non-alphabetic character.
The user tries to enter a password that does not have atleast one alphabetic and one non-alphabetic character.
The privacy password must also be set when setting theprivacy protocol.
Displays if the user tries to set the privacy protocol todes without a specifying a privacy password (-ppwcommand option).
The privacy password must be less than 32 characterslong.
A user tries to set a privacy password that is longer than31 characters.
The user index must be different than that of the currentuser.
The user tries to issue a command to delete the accountof current user.
The username cannot be longer than 15 characters. A user tries to set a user name that is longer than 15characters.
There was a problem retrieving the file. An error occurs while the management module isretrieving the file.
Unable to change password. The minimum passwordchange interval has not expired. Please try again later.
The user tries to issue a command to change a passwordwhile the minimum password change interval has notexpired.
Unable to read the complex password requirement. An error occurs while the management module isreading the complex password requirement.
Unable to read the password required setting. An error occurs while the management module isreading the password required setting.
Unexpected error: Unable to change password. An error occurs while the management module ischanging the password.
Update Failed, there was a problem retrieving the file. An error occurs while the advanced managementmodule is uploading a file.
Chapter 4. Error messages 471
Table 163. users command errors (continued)
Error message Definition
When creating a new user, a username and authoritylevel must be specified.
The user tries to issue a command to create a userwithout the -n and -a options.
When creating a new user, all options are required. A user tries to create a new user without defining all ofthe command options and arguments.
volts command errorsThis topic lists errors for the volts command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 164. volts command errors
Error message Definition
Getting power state of blade blade_number failed.
where blade_number identifies the blade server.
An error occurs while the management module isreading the power state of the targeted blade server.
write command errorsThis topic lists error messages for the write command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 165. write command errors
Error message Definition
Failed to save configuration settings to the chassis. An error occurs while the management module is savingthe management module configuration to theBladeCenter unit midplane.
Firmware update is in progress. Try again later. A user tries to save the management moduleconfiguration to the BladeCenter unit midplane while themanagement module firmware is updating.
Getting security status failed. An error occurs while the management module isreading the security status.
The -config option is required. The user does not include a required -config option forthe command.
The -i, -l, and -p options can only be used with the-config file.
The user tries to specify a TFTP server and aconfiguration file when saving the configuration to theBladeCenter unit midplane.
The -i option is required with the -config file. A user tries to use the -i option with the -config chassisoption.
The -p option is required when encryption is enabled. The user tries to issue a command without the -p optionwhile encryption is enabled.
Error creating file in memory. The management module is unable to create theconfiguration file.
Error locking file. The management module is unable to lock theconfiguration 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 theconfiguration file.
Error transferring file. The management module is unable to transfer theconfiguration file.
Error generating file. The management module is unable to generate theconfiguration file.
Error allocating memory for file. The management module is unable to allocate memoryfor the configuration file.
The passphrase is greater than 1600 characters. The user input for the passphrase exceeds the maximumpermitted length.
The passphrase must be quote-delimited. The user input for the passphrase is not quote-delimited.
zonecfg command errorsThis topic lists errors for the zonecfg command.
See “Common errors” on page 409 for a list of error messages that apply to allcommands.
Table 166. zonecfg command errors
Error message Definition
Activating zone configuration xxx on I/O module yyyfailed.
The management module is unable activate the specifiedzone configuration on the specified I/O module.
Getting current active zone number failed. An error occurs while the management module isreading the current active zone number.
Getting specified configuration of switch slot failed.
where slot identifies the targeted I/O module.
An error occurs while the management module isreading the specified configuration of the targeted I/Omodule.
Getting zone configuration failed. An error occurs while the management module isreading 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 switchmodule.
The I/O Module is currently not powered on or in afault state.
The user tries to show or activate a zone configurationfor an RSS or NSS which is in the power-off state and afault state.
Error retrieving data for I/O module bay_number.
where bay_number identifies the targeted I/O module.
An error occurs while the management module isreading the data for the specified I/O module.
Chapter 4. Error messages 473
474 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Appendix. Getting help and technical assistance
If you need help, service, or technical assistance or just want more informationabout IBM products, you will find a wide variety of sources available from IBM toassist you.
Use this information to obtain additional information about IBM and IBMproducts, determine what to do if you experience a problem with your IBM systemor optional device, and determine whom to call for service, if it is necessary.
Before you callBefore you call, make sure that you have taken these steps to try to solve theproblem yourself.
If you believe that you require IBM to perform warranty service on your IBMproduct, the IBM service technicians will be able to assist you more efficiently ifyou 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 ofthe IBM product, are responsible for maintaining and updating all software andfirmware for the product (unless it is covered by an additional maintenancecontract). Your IBM service technician will request that you upgrade yoursoftware and firmware if the problem has a documented solution within asoftware upgrade.You can obtain the latest downloads for your IBM product fromhttp://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, checkhttp://www.ibm.com/servers/eserver/serverproven/compat/us/eserver.html tomake sure that the hardware and software is supported by your IBM product.
v Use the troubleshooting information in your system documentation, and use thediagnostic tools that come with your IBM product. Information about diagnostictools is in the Problem Determination and Service Guide on the IBM DocumentationCD that comes with your product.
v Go to http://www.ibm.com/systems/support/ to check for information to helpyou solve the problem.
v Gather the following information to provide to IBM service. This data will helpIBM service quickly provide a solution to your problem and ensure that youreceive 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 ElectronicService Request. Submitting an Electronic Service Request will start the process
© Copyright IBM Corp. 2011 475
of determining a solution to your problem by making the pertinent informationavailable to IBM service quickly and efficiently. IBM service technicians can startworking on your solution as soon as you have completed and submitted anElectronic Service Request.
Using the documentationInformation about your IBM system and preinstalled software, if any, or optionaldevice is available in the documentation that comes with the product. Thatdocumentation can include printed documents, online documents, readme files,and help files.
See the troubleshooting information in your system documentation for instructionsfor using the diagnostic programs. The troubleshooting information or thediagnostic programs might tell you that you need additional or updated devicedrivers or other software. IBM maintains pages on the World Wide Web where youcan get the latest technical information and download device drivers and updates.To access these pages, go to http://www.ibm.com/systems/support/.
You can find the most up-to-date information for BladeCenter products athttp://publib.boulder.ibm.com/infocenter/bladectr/documentation/index.jsp.
Getting help and information from the World Wide Web
On the World Wide Web, up-to-date information about IBM systems, optionaldevices, services, and support is available at http://www.ibm.com/systems/support/.
You can find the most up-to-date product information for BladeCenter products athttp://publib.boulder.ibm.com/infocenter/bladectr/documentation/index.jsp.
Software service and supportThrough IBM Support Line, you can get telephone assistance, for a fee, with usage,configuration, and software problems with your IBM products.
For information about which products are supported by Support Line in yourcountry or region, see http://publib.boulder.ibm.com/infocenter/bladectr/documentation/index.jsp.
For more information about Support Line and other IBM services, seehttp://www.ibm.com/services/us/index.wss or see http://www.ibm.com/planetwide/ for support telephone numbers. In the U.S. and Canada, call1-800-IBM-SERV (1-800-426-7378).
Hardware service and supportYou can receive hardware service through your IBM reseller or IBM Services.
To locate a reseller authorized by IBM to provide warranty service, go tohttp://www.ibm.com/partnerworld/ and click Find Business Partners on theright side of the page. For IBM support telephone numbers, seehttp://www.ibm.com/planetwide/. 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 Taiwan product serviceUse this information to contact IBM Taiwan product service.
IBM Taiwan product service contact information:
IBM Taiwan Corporation3F, No 7, Song Ren Rd.Taipei, TaiwanTelephone: 0800-016-888
Appendix. Getting help and technical assistance 477
478 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto you.
This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.
Any references in this information to non-IBM websites are provided forconvenience only and do not in any manner serve as an endorsement of thosewebsites. The materials at those websites are not part of the materials for this IBMproduct, and use of those websites is at your own risk.
IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.
TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corporation in the United States, other countries,or both. If these and other IBM trademarked terms are marked on their firstoccurrence in this information with a trademark symbol (® or ™), these symbolsindicate U.S. registered or common law trademarks owned by IBM at the time thisinformation was published. Such trademarks may also be registered or commonlaw trademarks in other countries.
© Copyright IBM Corp. 2011 479
A current list of IBM trademarks is available on the web at “Copyright andtrademark information” at http://www.ibm.com/legal/copytrade.shtml.
Adobe and PostScript are either registered trademarks or trademarks of AdobeSystems Incorporated in the United States and/or other countries.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc., inthe United States, other countries, or both and is used under license therefrom.
Intel, Intel Xeon, Itanium, and Pentium are trademarks or registered trademarks ofIntel Corporation or its subsidiaries in the United States and other countries.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc., inthe United States, other countries, or both.
Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation inthe United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and othercountries.
Other company, product, or service names may be trademarks or service marks ofothers.
Important notesProcessor speed indicates the internal clock speed of the microprocessor; otherfactors also affect application performance.
This product is not intended to be connected directly or indirectly by any meanswhatsoever to interfaces of public telecommunications networks, nor is it intendedto be used in a public services network.
CD or DVD drive speed is the variable read rate. Actual speeds vary and are oftenless 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 for1,073,741,824 bytes.
When referring to hard disk drive capacity or communications volume, MB standsfor 1,000,000 bytes, and GB stands for 1,000,000,000 bytes. Total user-accessiblecapacity can vary depending on operating environments.
Maximum internal hard disk drive capacities assume the replacement of anystandard hard disk drives and population of all hard disk drive bays with thelargest currently supported drives that are available from IBM.
Maximum memory might require replacement of the standard memory with anoptional memory module.
480 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
IBM makes no representation or warranties regarding non-IBM products andservices that are ServerProven®, including but not limited to the implied warrantiesof merchantability and fitness for a particular purpose. These products are offeredand warranted solely by third parties.
IBM makes no representations or warranties with respect to non-IBM products.Support (if any) for the non-IBM products is provided by the third party, not IBM.
Some software might differ from its retail version (if available) and might notinclude user manuals or all program functionality.
Particulate contaminationAttention: Airborne particulates (including metal flakes or particles) and reactivegases acting alone or in combination with other environmental factors such ashumidity or temperature might pose a risk to the device that is described in thisdocument.
Risks that are posed by the presence of excessive particulate levels orconcentrations of harmful gases include damage that might cause the device tomalfunction or cease functioning altogether. This specification sets forth limits forparticulates and gases that are intended to avoid such damage. The limits must notbe viewed or used as definitive limits, because numerous other factors, such astemperature or moisture content of the air, can influence the impact of particulatesor environmental corrosives and gaseous contaminant transfer. In the absence ofspecific limits that are set forth in this document, you must implement practicesthat maintain particulate and gas levels that are consistent with the protection ofhuman health and safety. If IBM determines that the levels of particulates or gasesin your environment have caused damage to the device, IBM may conditionprovision of repair or replacement of devices or parts on implementation ofappropriate remedial measures to mitigate such environmental contamination.Implementation of such remedial measures is a customer responsibility.
Table 167. Limits for particulates and gases
Contaminant Limits
Particulate v The room air must be continuously filtered with 40% atmosphericdust spot efficiency (MERV 9) according to ASHRAE Standard 52.21.
v Air that enters a data center must be filtered to 99.97% efficiency orgreater, using high-efficiency particulate air (HEPA) filters that meetMIL-STD-282.
v The deliquescent relative humidity of the particulate contaminationmust be more than 60%2.
v The room must be free of conductive contamination such as zincwhiskers.
Gaseous v Copper: Class G1 as per ANSI/ISA 71.04-19853
v Silver: Corrosion rate of less than 300 Å in 30 days
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 forRemoval Efficiency by Particle Size. Atlanta: American Society of Heating, Refrigeratingand Air-Conditioning Engineers, Inc.
2 The deliquescent relative humidity of particulate contamination is the relative humidityat which the dust absorbs enough water to become wet and promote ionic conduction.
3 ANSI/ISA-71.04-1985. Environmental conditions for process measurement and controlsystems: Airborne contaminants. Instrument Society of America, Research Triangle Park,North Carolina, U.S.A.
Documentation formatThe publications for this product are in Adobe Portable Document Format (PDF)and should be compliant with accessibility standards. If you experience difficultieswhen you use the PDF files and want to request a web-based format or accessiblePDF document for a publication, direct your mail to the following address:
Information DevelopmentIBM Corporation205/A0153039 E. Cornwallis RoadP.O. Box 12195Research Triangle Park, North Carolina 27709-2195U.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 ordistribute the information in any way it believes appropriate without incurring anyobligation to you.
Electronic emission notices
Federal Communications Commission (FCC) statementNote: This equipment has been tested and found to comply with the limits for aClass A digital device, pursuant to Part 15 of the FCC Rules. These limits aredesigned to provide reasonable protection against harmful interference when theequipment is operated in a commercial environment. This equipment generates,uses, and can radiate radio frequency energy and, if not installed and used inaccordance with the instruction manual, may cause harmful interference to radiocommunications. Operation of this equipment in a residential area is likely to causeharmful interference, in which case the user will be required to correct theinterference at his own expense.
Properly shielded and grounded cables and connectors must be used in order tomeet FCC emission limits. IBM is not responsible for any radio or televisioninterference caused by using other than recommended cables and connectors or byunauthorized changes or modifications to this equipment. Unauthorized changesor 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 thefollowing two conditions: (1) this device may not cause harmful interference, and(2) this device must accept any interference received, including interference thatmight cause undesired operation.
Industry Canada Class A emission compliance statementThis Class A digital apparatus complies with Canadian ICES-003.
Avis de conformité à la réglementation d'Industrie CanadaCet appareil numérique de la classe A est conforme à la norme NMB-003 duCanada.
Australia and New Zealand Class A statement
Attention: This is a Class A product. In a domestic environment this product maycause radio interference in which case the user may be required to take adequatemeasures.
European Union EMC Directive conformance statementThis product is in conformity with the protection requirements of EU CouncilDirective 2004/108/EC on the approximation of the laws of the Member Statesrelating to electromagnetic compatibility. IBM cannot accept responsibility for anyfailure to satisfy the protection requirements resulting from a nonrecommendedmodification of the product, including the fitting of non-IBM option cards.
Attention: This is an EN 55022 Class A product. In a domestic environment thisproduct may cause radio interference in which case the user may be required totake adequate measures.
Responsible manufacturer:
International Business Machines Corp.New Orchard RoadArmonk, New York 10504914-499-1900
European Community contact:
IBM Technical Regulations, Department M456IBM-Allee 1, 71137 Ehningen, GermanyTelephone: +49 7032 15-2937Email: [email protected]
Germany Class A statementDeutschsprachiger EU Hinweis: Hinweis für Geräte der Klasse A EU-Richtliniezur Elektromagnetischen Verträglichkeit
Dieses Produkt entspricht den Schutzanforderungen der EU-Richtlinie2004/108/EG zur Angleichung der Rechtsvorschriften über die elektromagnetischeVerträglichkeit in den EU-Mitgliedsstaaten und hält die Grenzwerte der EN 55022Klasse A ein.
Um dieses sicherzustellen, sind die Geräte wie in den Handbüchern beschrieben zuinstallieren und zu betreiben. Des Weiteren dürfen auch nur von der IBM
Notices 483
empfohlene Kabel angeschlossen werden. IBM übernimmt keine Verantwortung fürdie Einhaltung der Schutzanforderungen, wenn das Produkt ohne Zustimmung derIBM verändert bzw. wenn Erweiterungskomponenten von Fremdherstellern ohneEmpfehlung der IBM gesteckt/eingebaut werden.
EN 55022 Klasse A Geräte müssen mit folgendem Warnhinweis versehen werden:“Warnung: Dieses ist eine Einrichtung der Klasse A. Diese Einrichtung kann imWohnbereich Funk-Störungen verursachen; in diesem Fall kann vom Betreiberverlangt werden, angemessene Maßnahmen zu ergreifen und dafüraufzukommen.”
Deutschland: Einhaltung des Gesetzes über dieelektromagnetische Verträglichkeit von Geräten
Dieses Produkt entspricht dem “Gesetz über die elektromagnetische Verträglichkeitvon Geräten (EMVG)”. Dies ist die Umsetzung der EU-Richtlinie 2004/108/EG inder Bundesrepublik Deutschland.
Zulassungsbescheinigung laut dem Deutschen Gesetz über dieelektromagnetische Verträglichkeit von Geräten (EMVG) (bzw. derEMC EG Richtlinie 2004/108/EG) für Geräte der Klasse A
Dieses Gerät ist berechtigt, in Übereinstimmung mit dem Deutschen EMVG dasEG-Konformitätszeichen - CE - zu führen.
Verantwortlich für die Einhaltung der EMV Vorschriften ist der Hersteller:
International Business Machines Corp.New Orchard RoadArmonk, New York 10504914-499-1900
Der verantwortliche Ansprechpartner des Herstellers in der EU ist:
IBM DeutschlandTechnical Regulations, Department M456IBM-Allee 1, 71137 Ehningen, GermanyTelephone: +49 7032 15-2937Email: [email protected]
Generelle Informationen:
Das Gerät erfüllt die Schutzanforderungen nach EN 55024 und EN 55022 KlasseA.
Japan VCCI Class A statement
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 Councilfor Interference (VCCI). If this equipment is used in a domestic environment, radiointerference may occur, in which case the user may be required to take correctiveactions.
Korea Communications Commission (KCC) statement
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 forequipment certified for home use.
Russia Electromagnetic Interference (EMI) Class A statement
People's Republic of China Class A electronic emissionstatement
Taiwan Class A compliance statement
Notices 485
486 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Index
Special characters! 168? 166
Aaccessibility features for this product 2accessible documentation 482account inactivity alert time
set for management module 34account inactivity disable time
set for management module 35account lockout period
set for management module 36account security commands 30account security settings
display for management module 30enable complex password for
management module userauthentication 33
enable default administrationpassword expiration formanagement module 34
enable password change at first loginto management module 36
enable password required formanagement module 37
set management module accountinactivity alert time 34
set management module accountinactivity disable time 35
set management module accountlockout period 36
set management moduleauthentication logging timeout 32
set management module CLIinactivity timeout 33
set management module default tohigh 32
set management module default tolegacy 31
set management module maximumLDAP sessions for user 36
set management module maximumnumber of login failures 35
set management module minimumnumber of different characters forpassword 34
set management module passwordexpiration time 37
set management module passwordminimum change interval 37
set management module passwordreuse cycle 38
set management module userauthentication method 33
set management module web interfaceinactivity timeout 38
accseccfg 30
accseccfg (continued)options
alt 32am 33cp, on 33ct 33dc 34de, on 34high 32ia 34ici 35id 35legacy 31lf 35lp 36mls 36pc, on 36pe 37pi 37pr, on 37rc 38wt 38
accseccfg command errors 411accseccfg commands 30
example 38accumulate timeout
set for SOL 330acknowledge alarms
alarm ID 46complete alarm key 46generator ID 45generator information 45
acknowledge call-home activity log entrymanagement module 94
acoustic mode, disable 153acoustic mode, enable 153activate firmware
I/O module 367, 371switch 367, 371
activate I/O module SAS zone 403activate network protocol settings
I/O module 241activate SAS zone
I/O module 403Active Directory group, delete 161Active Directory group, set authority
level 160Active Directory group, set name 159Active Directory groups, display
(all) 159Active Directory groups, display
(specific) 159add Call Home events
management module 140, 141add feature license
management module 144add firmware build ID list entry
blade server 81add SSH public key 392add SSH public key (specific) 392
additional SSL certificatedisable for standby management
module 337enable for standby management
module 337address
IPv6 initial connection 15link local 15
address prefix lengthset for blade server 190set for channel 0 of management
module 180set for I/O module 198
advanced failover settingsdisable network interface for standby
management module 40display for management module 40enable network interface for standby
management module and allow IPswap during failover 40
enable network interface for standbymanagement module and prevent IPswap during failover 41
advanced management moduledisable logical uplink failover 374enable logical uplink failover 374enable physical uplink failover 373logical uplink failover delay 374logical uplink failover IP address 374logical uplink failover IPv6 IP
address 375network interface management
commands 66physical uplink failover delay 373set logical link loss alert and failover
policy 375advfailover 40
optionsip. noswap 41ip. off 40ip. swap 40
advfailover command 40example 41
advfailover command errors 412air filter
set notification interval 42view notification interval 42
air filter notification 42airfilter
example 42management module 42
airfilter command0, 1, 3, 6 months 42notification interval 42
alarmacknowledge (alarm ID) 46acknowledge (complete alarm
key) 46acknowledge (generator ID) 45acknowledge (generator
information) 45
© Copyright IBM Corp. 2011 487
alarm (continued)clear (alarm ID) 48clear (complete alarm key) 48clear (generator ID) 47clear (generator information) 47display (alarm ID) 44display (all) 43display (complete alarm key) 44display (generator ID) 43display (generator information) 44display (power) 43options
c, a 48c, g 47c, k 48c, o 47p 43q 43q, a 44q, g 43q, k 44q, o 44r, a 46r, g 45r, k 46r, o 45s, l 49
set 49alarm command 43alarm command errors 413alarm commands
example 49alarm panel
command target 135alarm panel module
power off 272power on 272turn off 272turn on 272
alerttest 58
alert categories (enhanced legacy)disable 229enable 229
alert notification method, set 57alert recipient, create 54alert recipient, delete 53alert recipient, set email address 57alert recipient, set hostname for
alerts 58alert recipient, set IP address for
alerts 58alert recipient, set name 55alert recipient, set status 56alert recipients, manage 53alert state
display all 229alert type, filter 56alert type, set 56alertcfg 51
optionsdr 51rl 51, 52si 51
alertcfg command errors 414alertcfg commands 51
example 52
alertentries 53options
1 through 12 53create (n, status, f, t, e, i) 54del 53e 57f 56i 58n 55status 56t 57test 58
alertentries command 53alertentries command errors 414alertentries commands
example 59alerts
disable monitoring for all critical 229disable monitoring for all
informational 234disable monitoring for all
warning 232disable monitoring for blade device
critical 230disable monitoring for blade device
informational 235disable monitoring for blade device
warning 232disable monitoring for chassis
critical 231disable monitoring for chassis
informational 236disable monitoring for chassis
warning 233disable monitoring for cooling device
critical 231disable monitoring for cooling device
informational 238disable monitoring for cooling device
warning 234disable monitoring for event log
informational 237disable monitoring for event log
warning 233disable monitoring for I/O module
critical 230disable monitoring for I/O module
informational 235disable monitoring for I/O module
warning 232disable monitoring for inventory
change informational 236disable monitoring for network
change informational 237disable monitoring for power module
critical 231disable monitoring for power module
informational 238disable monitoring for power module
warning 234disable monitoring for power state
informational 236disable monitoring for storage module
critical 230disable monitoring for storage module
informational 235
alerts (continued)disable monitoring for storage module
warning 233disable monitoring for system
management critical 231disable monitoring for system
management informational 236disable monitoring for system
management warning 233disable monitoring for user activity
informational 237display all states 229enable monitoring for all critical 229enable monitoring for all
informational 234enable monitoring for all
warning 232enable monitoring for blade device
critical 230enable monitoring for blade device
informational 235enable monitoring for blade device
warning 232enable monitoring for chassis
critical 231enable monitoring for chassis
informational 236enable monitoring for chassis
warning 233enable monitoring for cooling device
critical 231enable monitoring for cooling device
informational 238enable monitoring for cooling device
warning 234enable monitoring for event log
informational 237enable monitoring for event log
warning 233enable monitoring for I/O module
critical 230enable monitoring for I/O module
informational 235enable monitoring for I/O module
warning 232enable monitoring for inventory
change informational 236enable monitoring for network change
informational 237enable monitoring for power module
critical 231enable monitoring for power module
informational 238enable monitoring for power module
warning 234enable monitoring for power state
informational 236enable monitoring for storage module
critical 230enable monitoring for storage module
informational 235enable monitoring for storage module
warning 233enable monitoring for system
management critical 231enable monitoring for system
management informational 236
488 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
alerts (continued)enable monitoring for system
management warning 233enable monitoring for user activity
informational 237exclude service information with
email alerts 51include service information with email
alerts 51alerts, display 164
timestamp 164algorithms, encryption 14all information reload 204assistance, getting 475attributes, display for firmware 363Australia Class A statement 483authentication logging timeout
set for management module 32authentication method
LDAP 215authority, command 8autoftp
optionsdesc 60i 61m 61p 61pw 61u 61
autoftp command errors 415autoftp commands 60
example 62autoftp settings
call-home 60, 61automatic configuration setting
display for management module 280automatic power-on policy
set for BladeCenter unit 275
Bbattery backup unit
command target 134baud rate
set for serial port of managementmodule 253
bay datablade server 63clear bay data 63clear bay data for specific bay 64display bay data 63display bay data for specific bay 63set bay data 64set data definition to specific blade
server 65baydata 63
optionsb bay_num 63b bay_num -clear 64b bay_num -data
"data_definition" 65clear 63data "data_definition" 64
baydata command errors 415baydata commands 63
example 65
binding methodLDAP 215
blade mezzaninecommand target 133
blade server 185, 186add firmware build ID list entry 81all blade servers 78bay data 63boot 72boot (to console) 72collect service data 299command target 132config command 111, 114
example 114create firmware build ID list 80cycle power 72, 273delete all entries from firmware build
ID list 84delete entry from firmware build ID
list 85dhcpinfo commands 117disable cKVM 185disable DHCPv6 191disable Ethernet channel 190disable IPv6 190disable IPv6 stateless
auto-configuration 191display all SRC records 124display bay data 63display boot mode 74display boot sequence 75display cKVM status 184display Ethernet-over-USB
setting 137display firmware build IDs 80display management network DHCP
configuration 117display name 111display network configuration
status 184display power state 273display service data 299display specific SRC record 124display temperature 355display voltage 400dump service data 299enable cKVM 185enable DHCPv6 configuration 191enable dynamic power optimizer 155enable dynamic power optimizer,
extended 156enable Ethernet channel 189enable IPv6 190enable IPv6 stateless
auto-configuration 191enable local power control 275enable power capping 154enable power management 154enable power saver mode 155enable Wake on LAN 274export firmware build ID list 86get service data 299import firmware build ID list 85power off 272, 273power on 272, 273power on (to console) 272, 273reset 72, 286
blade server (continued)reset (clear NVRAM) 289reset (enter SMS menu) 290reset (run diagnostics with boot
sequence) 289reset (run diagnostics) 289reset (to console) 72, 287reset (with NMI) 288set address prefix length 190set as KVM owner 208set as media tray owner 239set boot mode 74set boot sequence 76, 78set Ethernet channel configuration
method 188set Ethernet channel gateway IP
address (IPv4) 186set Ethernet channel gateway/default
route (IPv6) 187set Ethernet channel hostname 189set Ethernet channel subnet mask
(IPv4) 187set Ethernet channel VLAN ID 188set Ethernet-over-USB setting 137set I/O module for blade server
management traffic 184set IP address (IPv4) 185set IP address (IPv6) 186set name 111set power capping 154shutdown 273, 306turn off 272, 273turn on 272, 273turn on (to console) 272, 273update firmware build ID in firmware
build ID list 83update firmware build revision in
firmware build ID list 84update firmware type in firmware
build ID list 83update machine type in firmware
build ID list 82update manufacturer in firmware
build ID list 82blade server ISMP
set IP address (IPv4) 191blade server module
display activity 228display information 228
blade server power information display(overview) 149
blade server, display powertrending 151, 152
blade serversdisable multiple video sessions 192enable multiple video sessions 192
BladeCenter Open Fabric ManagerBladeCenter units 66I/O modules 66management module 66, 67, 68, 69,
70, 71network interface management
commands 66NIC allocation 66
BladeCenter S 150display
power management policies 251
Index 489
BladeCenter T specific commands 29BladeCenter unit
command target 132configuring 20disable global cKVM 193disable management channel
auto-discovery 227display management channel
auto-discovery status 227display network settings 192display serial number 111display type/model 111display uuid 111enable global cKVM 193enable management channel
auto-discovery 227set automatic power-on policy 275set VLAN ID 192
BladeCenter unitsclear list of discovered 284display all discovered 283display filtered by IP address 283display filtered by name 284display health for all discovered 283
blink location LED 169, 222blower
command target 134blower power information display 149blower temperature display 149blower, display power trending 151, 152BMC
command target 133bofm
optionsl , i 66l , i, d 67l , i, d on 68l , i, p off 70l , i, p on 69l , i, v 71
bofm commandexample 71
bofm command errors 416bofm commands 66boot 72
blade server 72options
c 72p powercycle 72p reset 72
boot (to console)blade server 72
boot command errors 417boot commands 72
example 73boot mode
display for blade server 74set for blade server 74
boot sequencedisplay for blade server 75set for all blade servers 78set for blade server 76
bootmode 74options
p 74bootmode command errors 417bootmode commands 74
bootmode commands (continued)example 74
bootseq 75cd 76floppy 76hd0 76hd1 76hd2 76hd3 76hd4 76hyper 76iscsi 76iscsicrt 76legacy 76nodev 76nw 76options
all 78uefi 76usbdisk 76
bootseq command errors 418bootseq commands 75
example 79buildidcfg 80
optionsab 81create 80db 84, 85export 86import 85ub, ft 83ub, id 83ub, mfg 82ub, mt 82ub, rev 84
buildidcfg command errors 418buildidcfg commands 80
example 86built-in commands 27
Ccall-home
autoftp settings 60, 61problem description 95test call home 96
call-home activity logacknowledge call-home activity log
entry for management module 94display for management module 93display FTP/TFTP server entries for
management module 93display IBM Support entries for
management module 93unacknowledge call-home activity log
entry for management module 94capture service information 124certificate file (SSL CSR)
download 342import 343upload 343
certificate file (SSL self-signed certificate)download 342import 343upload 343
change command environment 25, 131change user password 385
chassis internal network commandcin 97
chassis internal networkconfiguration 97
chassis internal network status 102chassis internal network status
command 102chconfig 87
optionsca 89cci 89ce 89cn 89co 89cph 89cs 89cz 89li 87loc 91po 91ps 91pw 91sa 88sc 89u 91
chconfig command errors 419chconfig commands 87
example 91China Class A electronic emission
statement 485chlog 93
optionsack 94f 93s 93
chlog command errors 420chlog commands 93
example 94chmanual
optionsdesc 95, 96
chmanual command errors 421chmanual commands 95
example 96cin 97
optionsentry_index -ip ip_address 99entry_index clear 98entry_index en 98entry_index id 99global en 97id 100vlan_id -ip ip_address 99
CINturn all index entries on or off 98
cin alloptions
clear 97en state 98
cin commandchassis internal network 97
cin command errors 421cin commands
example 100cin configuration
Specify VLAN ID 100CIN configuration 98
490 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
CIN configuration entries 97CIN configuration entry
create 99delete 98disable 98enable 98Specify IP address 99
CIN configuration tabledisplay for management module 97
CIN index entrycreate 99Specify IP address 99
CIN stateset for enable or disable 97
CIN status table entries 102cinstatus 102cinstatus command 102cinstatus commands
example 102cKVM
disable for blade server 185disable globally for BladeCenter
unit 193enable for blade server 185enable globally for BladeCenter
unit 193cKVM status
display for blade server 184Class A electronic emission notice 482clear
optionscnfg 103
clear alarmsalarm ID 48complete alarm key 48generator ID 47generator information 47
clear CIN configurationmanagement module 97
clear command 103clear command errors 423clear commands
example 104clear event log
management module 105clear for management module 97clear management module event log
commands 105example 105
clearlogl 105
clearlog command errors 423clearlog commands 105
example 105CLI
exit codes for SSH 20CLI inactivity timeout
set for management module 33CLI key sequence
set for SOL 332CLI SSH server
disable for management module 336enable for management module 336
clock 106options
d 106dst 109
clock (continued)options (continued)
g 107t 106
clock command errors 423clock commands 106
example 110clock settings
display for management module 106collect service data
blade server 299command
health 163, 164system physical configuration 225
command authority 8command environment selecting 6command history 168command redirect 25, 131command syntax 29command target 25, 131
alarm panel 135battery backup unit 134blade mezzanine 133blade server 132BladeCenter unit 132blower 134BMC 133disk drive 135high-speed expansion card 133I/O module 134I/O-expansion card 133integrated system management
processor 133management card 133management module 132media tray 134memory 133microprocessor 133multiplexer expansion module 135network clock module 135power module 134service processor 133storage expansion unit 133storage module 135switch module 134temporary 7view 225
command target selection 6command-line interface
enable for management module 359errors 407guidelines 5
case sensitivity 6command history 6data types 6delimiters 6help 6options 5output format 6strings 6
introduction 1starting 14using 5, 25
command-line session configurationdisplay for management module 354
command-line timeoutset for management module 354
commandsaccseccfg 30, 38Active Directory, group
authentication 159advfailover 40, 41airfilter 42alarm 43, 49alertcfg 51, 52alertentries 53, 59autoftp 60, 62baydata 63, 65bofm 66, 71boot 72, 73bootmode 74bootseq 75, 79buildidcfg 80, 86built-in 27chconfig 87, 91chlog 93, 94chmanual 95, 96cin 100cin command 97cinstatus 102cinstatus command 102clear 103, 104clear management module event
log 105clearlog 105clock 106, 110common 27config 111, 114configuration 27console 115, 116dhcpinfo 117, 118discovery 28display management module
call-home events in events log 93display management module event
log 119, 123displaylog 119, 123displaysd 124, 125dns 126, 129environment 131, 136ethoverusb 137event log, clear for management
module 105event log, display for management
module 93, 119, 123eventinfo 138, 139events 140, 141examples
account security 38accseccfg 38advfailover 41alarm 49, 223alertcfg 52alertentries 59autoftp 62baydata 65blade server name 114BladeCenter Open Fabric
Management 71bofm 71boot 73bootmode 74bootseq 79buildidcfg 86
Index 491
commands (continued)examples (continued)
chconfig 91chlog 94chmanual 96cin 100cinstatus 102clear 104clear management module event
log 105clearlog 105clock 110config 114configure automated message
settings 62console 116DHCP settings for management
module 118dhcpinfo 118display automated message
settings 62display call-home owner 96display KVM owner 209display management module event
log 123display management module
security 303display media tray owner 240display Service Advisor owner 91display service information
owner 301displaylog 123displaysd 125DNS 129env 136environment 136environment redirect 136Ethernet network settings for
management module 200ethoverusb 137eventinfo 139events 141exit 143feature 146files 147fuelg 156groups 162health 164help 166history 168I/O management 71I/O module network protocol
configuration 244identify 170ifconfig 200info 205iocomp 206kvm 209LDAP configuration for
management module 218ldapcfg 218list 225management module DHCP
settings 118management module DNS 129management module Ethernet
network settings 200
commands (continued)examples (continued)
management module event logclear 105
management module event logdisplay 123
management module LDAPconfiguration 218
management module name 114management module network port
configuration 270management module restore
configuration 282management module save
configuration 402management module serial port
settings 254management module service 304management module SLP
configuration 307management module SMTP
settings 310management module SNMP
settings 326management module SSH 336management module telnet
configuration 354management module uplink
failover 375mcad 227modactlog 228monalerts 238mt 240name for blade server 114name for management
module 114nat 244network port configuration for
management module 270network protocol configuration for
I/O module 244ntp 247ping 249pmpolicy 252portcfg 254ports 270power 277rdoc 279read 282remotechassis 284reset 290restore configuration for
management module 282save configuration for
management module 402scale 298sddump 300sdemail 301security 303Serial Over LAN 333serial port settings for
management module 254service 304set call-home 96set KVM owner 209set management module
security 303
commands (continued)examples (continued)
set media tray owner 240set Service Advisor 91set service information 301shutdown 306slp 307SLP configuration for management
module 307smtp 310SMTP settings for management
module 310snmp 326SNMP settings for management
module 326sol 333SSH configuration for management
module 336sshcfg 336sslcfg 346syntax help 166syslog 350tcpcmdmode 353telnetcfg 354temps 355trespass 357uicfg 361update 371uplink 375user account security 38user interface configuration 361users 398volts 400write 402zonecfg 404
exit 143feature 144, 146files 147fuelg 149, 156group authentication, Active
Directory 159groups 159, 162help 166history 168identify 169, 170ifconfig 171, 200info 203, 205iocomp 206kvm 208, 209ldapcfg 210, 218led 220, 223LED 29list 225management module event log 28management module failover 373,
375mcad 227memory 29modactlog 228monalerts 229, 238monalertsleg 229mt 239, 240nat 241, 244ntp 245, 247ping 248, 249pmpolicy 251, 252portcfg 253, 254
492 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
commands (continued)ports 255, 270power 272, 277power control 29power management 29power management policy 251rdoc 278, 279read 280, 282remotechassis 283, 284reset 286, 290reset command 29restore configuration 29save configuration 29scale 291, 298sddump 299, 300sdemail 301security 303Serial Over LAN 328, 333service 304session command 29shutdown 306slp 307smtp 309, 310snmp 312, 326SOL 328, 333sshcfg 335, 336sslcfg 337, 346syslog 347, 350system management command 29tcpcmdmode 351, 353telnet configuration 354telnetcfg 354temps 355trespass 356, 357uicfg 359, 361update 363, 371uplink 373, 375user interface configuration 359, 361users 377, 398volts 400write 401, 402zonecfg 403, 404
comment SSH public key 398common commands 27common errors 409communicating with IBM Systems
Director 351communication
out-of-band 351test I/O-module IP address 249test IP address 248test IP address (I/O-module) 249
communication rateset for serial port of management
module 253compatibility
I/O moduledisplay details for blade
server 206display details for I/O
module 206display for all components 206
component and reloadinginformation 203
component information display 203config 111
config (continued)options
contact 112, 113, 114loc 112name 111
config command 111example 114
config command errors 424configuration
disable automatic for managementmodule 282
enable automatic for managementmodule 281
save for management module (tochassis) 401
view for management module 225view tree for system 225
configuration (encryption)save for management module (to
file) 402configuration (no encryption)
save for management module (tofile) 401
configuration commands 27configuration from file (encryption)
restore for management module 281configuration from file (no encryption)
restore for management module 280configuration from midplane
restore for management module 280configuration information
display for network card 184configuration method
set for channel 0 of managementmodule 176
set for channel of blade server 188configure LDAP command
example 218configure network ports command
example 270configure network protocols command
example 244configure SLP command
example 307confirm password
LDAP distinguished name 216connect to SSH public key 397console 115
create override SOL session 115create SOL session 115non-persistent session 115options
l 115o 115
persistent console 115console command 115console command errors 425console commands
example 116contact information
Service Advisor 89contact information, Service Advisor
city 89company 89contact name 89country 89email address 89
contact information, Service Advisor(continued)
phone number 89postal code 89state 89street address 89
contact namedisplay for management module 111set for management module 112, 113,
114contamination, particulate and
gaseous 481create alert recipient 54create CIN configuration entry 99create CIN index entry 99create firmware build ID list
blade server 80create override SOL session 115create partition
scalable complex 294create partition (automatically)
scalable complex 292create SOL session 115
persistent console 115create stand-alone partition
scalable complex 293create stand-alone partition
(automatically)scalable complex 292
create user 381critical alerts
disable monitoring for all 229disable monitoring for blade
device 230disable monitoring for chassis 231disable monitoring for cooling
device 231disable monitoring for I/O
module 230disable monitoring for power
module 231disable monitoring for storage
module 230disable monitoring for system
management 231enable monitoring for all 229enable monitoring for blade
device 230enable monitoring for chassis 231enable monitoring for cooling
device 231enable monitoring for I/O
module 230enable monitoring for power
module 231enable monitoring for storage
module 230enable monitoring for system
management 231CSR
generate for LDAP client 341generate for management module web
server 341CSR (SSL)
download certificate file 342import certificate file 343upload certificate file 343
Index 493
cycle powerblade server 72, 273I/O module 273switch module 273
Ddata encryption
display management modulesetting 303
enable for management module 303data rate
set for channel 0 of managementmodule 177
set for channel 1 of managementmodule 182
datedisplay for management module 106set for management module 106
daylight-savings time modeset for management module 109
daylight-savings time settingdisplay for management module 106
default IP address 15delete Active Directory group 161delete alert recipient 53delete all entries from firmware build ID
listblade server 84
delete all partitionsscalable complex 294
delete CIN configuration 98delete entry from firmware build ID list
blade server 85delete file
management module 147delete partition
scalable complex 295delete user 378DHCP configuration
display for I/O module 117DHCP settings for management module
commandsexample 118
dhcpinfo 117options
eth0 117dhcpinfo command errors 426dhcpinfo commands 117
example 118DHCPv6
disable for blade server 191disable for I/O module 198disable for management module 180enable for blade server 191enable for I/O module 198enable for management module 180
disableadditional SSL certificate for standby
management module 337blade server Ethernet channel VLAN
ID 189BladeCenter unit VLAN ID 192CLI SSH server for management
module 336enhanced legacy alert categories 229
disable (continued)logging of login events from same IP
address 35monitoring for all critical alerts 229monitoring for all informational
alerts 234monitoring for all warning alerts 232monitoring for blade device critical
alerts 230monitoring for blade device
informational alerts 235monitoring for blade device warning
alerts 232monitoring for chassis critical
alerts 231monitoring for chassis informational
alerts 236monitoring for chassis warning
alerts 233monitoring for cooling device critical
alerts 231monitoring for cooling device
informational alerts 238monitoring for cooling device warning
alerts 234monitoring for event log informational
alerts 237monitoring for event log warning
alerts 233monitoring for I/O module critical
alerts 230monitoring for I/O module
informational alerts 235monitoring for I/O module warning
alerts 232monitoring for inventory change
informational alerts 236monitoring for network change
informational alerts 237monitoring for power module critical
alerts 231monitoring for power module
informational alerts 238monitoring for power module
warning alerts 234monitoring for power state
informational alerts 236monitoring for storage module critical
alerts 230monitoring for storage module
informational alerts 235monitoring for storage module
warning alerts 233monitoring for system management
critical alerts 231monitoring for system management
informational alerts 236monitoring for system management
warning alerts 233monitoring for user activity
informational alerts 237secure TCP command mode 352Service Advisor 88SMASH SSH server for management
module 336SSL for LDAP client 338
disable (continued)SSL for management module web
server 337syslog event log transmission for
collector 1 347syslog event log transmission for
collector 2 348TCP command mode 351
disable automatic configurationmanagement module 282
disable CIN configuration entry 98disable cKVM
blade server 185disable DHCPv6
blade server 191I/O module 198management module 180
disable Ethernet channelblade server 190
disable Ethernet channel 1management module 184
disable global cKVMBladeCenter unit 193
disable IPv6blade server 190I/O module 197management module 179
disable IPv6 stateless auto-configurationblade server 191I/O module 198management module 180
disable logical uplink failoveradvanced management module 374management module (advanced) 374
disable management channelauto-discovery
BladeCenter unit 227disable multiple video sessions
blade servers 192disable NAT table
I/O module 244disable NEBS environment mode 153disable network interface
management module (standby) 40disable power domain acoustic
mode 153disable SOL
global 331disable static IPv6 configuration
I/O module 197management module 179
disable technician debugmanagement module 304
disable user 379discovered BladeCenter units
clear list 284display all 283display filtered by IP address 283display filtered by name 284display health for all 283
discovery commands 28disk drive 135display
alert state 229clock settings, management
module 106date, management module 106
494 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
display (continued)daylight-savings time setting,
management module 106GMT offset, management
module 106management channel path
information 204power management policy
all domains 251BladeCenter S 251specified power domain 251
TCP command-mode sessionstatus 351
TCP command-mode sessiontimeout 351
time, management module 106display (reset counter) event log
management module 119display active users 377display activity
blade server module 228display advanced failover settings
management module 40display alarms
alarm ID 44all 43complete alarm key 44generator ID 43generator information 44power 43
display alert properties (allrecipients) 53
display alert properties (singlerecipient) 53
display alerts 164timestamp 164
display all Active Directory groups 159display all BladeCenter units on
network 283display all event log entries
management module 119display all event log filters
management module 119display all information
scalable complex 291display all users 377display automatic configuration setting
management module 280display blade server power information
overview 149display blade server SRC record
(specific) 124display blade server SRC records
(all) 124display blower power information 149display blower temperature 149display boot mode
blade server 74display call-home activity log
management module 93display call-home event management
module event log entries 93display CIN configuration table 97display cKVM status
blade server 184
display command-line sessionconfiguration
management module 354display component information 203display configuration information
network card 184display contact name
management module 111display DHCP configuration
I/O module 117display DNS configuration
management module 126display DSA host key information
management module 335display entries of CIN status table 102display Ethernet channel 0 configuration
management module (primary) 171management module (standby) 172
display Ethernet channel 0 DHCPconfiguration
management module 117display Ethernet channel 1 configuration
management module (primary) 181display Ethernet-over-USB setting
blade server 137display event description
management module 138display event log
management module 119display event log entries filtered by date
management module 120display event log entries filtered by
severity levelmanagement module 120
display event log entries filtered bysource
management module 120, 121display event user action
management module 138, 139display events list
management module 140display failover configuration
management module 373display features
management module 144display file list
management module 147display firmware attributes 363display firmware build IDs
blade server 80display free space
management module 140, 147display FTP/TFTP server call-home
activity logmanagement module 93
display global remote alert settingsmanagement module 51
display health for BladeCenter units onnetwork 283
display health status 163, 164timestamp 164
display health status (tree) 163display I/O module compatibility
all components 206display I/O module compatibility details
blade server 206I/O module 206
display I/O module powerinformation 149
display I/O module SAS zoneinformation 404
display I/O module SAS zone list 403display IBM Support call-home activity
logmanagement module 93
display informationblade server module 228
display IP addressesI/O module 248
display KVM owner 208display LDAP settings
management module 210display LED state
blower fault 220external port link status 220fanpack fault 220fault 220for blade server and all
sub-components 221for blade server front panel 220safe-to-remove 220
display licensesmanagement module 144
display locationmanagement module 111
display log entries with call-home eventsmanagement module 119
display log entries with Event IDmanagement module 119
display management channelauto-discovery status
BladeCenter unit 227display management module account
security settings 30display management module data
encryption setting 303display management module event log
commands 119example 123
display management modulesecurity 303
display management module status 124display management network DHCP
configurationblade server 117
display media tray owner 239display media tray temperature 149display name
blade server 111management module 111
display network configuration statusblade server 184
display network port settingsmanagement module 255switch 269
display network protocol settingsI/O module 241
display network settingsBladeCenter unit 192I/O module 193
display node informationscalable complex 291
display NTP configurationmanagement module 245
Index 495
display open portsmanagement module 255
display partition informationscalable complex 291
display POST statusI/O module 276switch module 276
display power domain informationdetails 150
display power domain informationoverview 149
display power stateblade server 273I/O module 273switch module 273
display power trending (bladeserver) 151, 152
display power trending (blower) 151,152
display power trending (I/Omodule) 151, 152
display power trending (media tray) 152display power trending (power
domain) 151, 152display power trending (system) 151,
152display RSA host key information
management module 335display SAS zone information
I/O module 404display SAS zone list
I/O module 403display serial number
BladeCenter unit 111display serial port configuration
management module 253display Service Advisor 87display service data
blade server 299display service data command 124display service information 124display service setting
management module 304display single user 378display SLP settings
management module 307display SMTP server host name
management module 309display SMTP server IP address
management module 309display SNMP configuration
management module 312display specific Active Directory
groups 159display specific complex information
scalable complex 291display SSH public key 391display SSH status
management module 335display state
location LED 169display state of -lse option
management module 122Display status of first five CIN
entries 102display syslog configuration
management module 347
display telnet configurationmanagement module 354
display temperatureblade server 355management module 355media tray 355
display trespass feature statusmanagement module 356
display type/modelBladeCenter unit 111
display uplink configurationmanagement module 373
display user interface settingsmanagement module 359
display uuidBladeCenter unit 111
display various LED statesLED states 220
display voltageblade server 400management module 400
displaylog 119display log entries with call-home
events 119display log entries with Event ID 119display state of -lse option 122filter log entries by call-home events
flag 122options
-lse 122a 119c 119ch 122date 120e 119f 119filters 119i 122i, l 122l 122l, i 122lse 122sev 120src 120, 121
displaylog command errors 426displaylog commands 119
example 123displaysd 124
optionsi 124i, save 124mmstat 124save 124save, i 124src 124
displaysd command errors 427displaysd commands 124
example 125distinguished name
LDAP client 216distinguished name password
LDAP client 216distinguished name password (confirm)
LDAP client 216dns 126
options-ddns 126
dns (continued)options (continued)
i1 127i2 127i3 127i61 128i62 128i63 128on 126p 129
DNSenable for management module 126
dns command errors 428dns commands 126
example 129DNS configuration
display for management module 126DNS first IPv4 IP address
set for management module 127DNS first IPv6 IP address
set for management module 128DNS second IPv4 IP address
set for management module 127DNS second IPv6 IP address
set for management module 128DNS server priority
set for management module 129DNS third IPv4 IP address
set for management module 127DNS third IPv6 IP address
set for management module 128documentation
using 476documentation format 482Domain Catalog discovery
set search domain 211domain name
set for channel 0 of managementmodule 179
set for management module LDAPserver 211
download 344, 345, 346download certificate file
SSL CSR 342SSL self-signed certificate 342
download SSH public key 396DSA host key information
display for management module 335dump service data
blade server 299duplex mode
set for channel 0 of managementmodule 177
set for channel 1 of managementmodule 182
dynamic DNSenable for management module 126
dynamic power optimizer, enable forblade server 155
dynamic power optimizer, extended ,enable for blade server 156
Eelectronic emission Class A notice 482Electronic emission notices 482
496 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
email alertsexclude service information 51include service information 51
enableadditional SSL certificate for standby
management module 337blade server Ethernet channel VLAN
ID 189BladeCenter unit VLAN ID 192CLI SSH server for management
module 336enhanced legacy alert categories 229monitoring for all critical alerts 229monitoring for all informational
alerts 234monitoring for all warning alerts 232monitoring for blade device critical
alerts 230monitoring for blade device
informational alerts 235monitoring for blade device warning
alerts 232monitoring for chassis critical
alerts 231monitoring for chassis informational
alerts 236monitoring for chassis warning
alerts 233monitoring for cooling device critical
alerts 231monitoring for cooling device
informational alerts 238monitoring for cooling device warning
alerts 234monitoring for event log informational
alerts 237monitoring for event log warning
alerts 233monitoring for I/O module critical
alerts 230monitoring for I/O module
informational alerts 235monitoring for I/O module warning
alerts 232monitoring for inventory change
informational alerts 236monitoring for logging of login events
from same IP address 35monitoring for network change
informational alerts 237monitoring for power module critical
alerts 231monitoring for power module
informational alerts 238monitoring for power module
warning alerts 234monitoring for power state
informational alerts 236monitoring for storage module critical
alerts 230monitoring for storage module
informational alerts 235monitoring for storage module
warning alerts 233monitoring for system management
critical alerts 231
enable (continued)monitoring for system management
informational alerts 236monitoring for system management
warning alerts 233monitoring for user activity
informational alerts 237secure TCP command mode 352Service Advisor 88SMASH SSH server for management
module 336SSL for LDAP client 338SSL for management module web
server 337syslog event log transmission for
collector 1 347syslog event log transmission for
collector 2 348TCP command mode 352
enable automatic configurationmanagement module 281
enable CIN configuration entry 98enable cKVM
blade server 185enable command-line interface
management module 359enable complex password for
management module userauthentication 33
enable data encryptionmanagement module 303
enable default administration passwordexpiration for management module 34
enable DHCPv6blade server 191I/O module 198management module 180
enable DNSmanagement module 126
enable dynamic DNSmanagement module 126
enable dynamic power optimizer forblade server 155
enable dynamic power optimizer,extended, for blade server 156
enable Ethernet channelblade server 189
enable Ethernet channel 1management module 183
enable external managementI/O module 196
enable external portsI/O module 196
enable fast POSTI/O module 275, 276
enable FTPmanagement module 261
enable global cKVMBladeCenter unit 193
enable HTTPS portmanagement module 262
enable IPv6blade server 190I/O module 197management module 179
enable IPv6 stateless auto-configurationblade server 191
enable IPv6 stateless auto-configuration(continued)
I/O module 198management module 180
enable local KVM switchingglobally 208
enable local media tray switchingglobally 239
enable local power controlblade server 275globally 274
enable logical uplink failoveradvanced management module 374management module (advanced) 374
enable management channelauto-discovery
BladeCenter unit 227enable monitoring of event log state
management module 122enable multiple video sessions
blade servers 192enable NAT table
I/O module 244enable NEBS environment mode 153enable network interface and allow IP
swapmanagement module (standby) 40
enable network interface and prevent IPswap
management module (standby) 41enable NTP
management module 245, 262enable password change at first login to
management module 36enable password required for
management module 37enable physical uplink failover
advanced management module 373management module (advanced) 373
enable portswitch 269
enable power capping for bladeserver 154
enable power domain acousticmode 153
enable power management for bladeserver 154, 155
enable power saver mode for bladeserver 155
enable protected modeI/O module 197
enable RDEmanagement module 263
enable RDOCEmanagement module 263
enable remote media tray switchingglobally 240
enable secure SMASH over SSHmanagement module 264
enable secure TCP command modemanagement module 266, 360
enable securitymanagement module 303
enable SLPmanagement module 263
enable SMASH over Telnetmanagement module 264
Index 497
enable SNMP agentmanagement module (SNMPv1) 312management module (SNMPv3) 312
enable SNMP trapsmanagement module 265, 312
enable SNMPv1management module 359
enable SNMPv1 agentmanagement module 264
enable SNMPv3management module 359
enable SNMPv3 agentmanagement module 265
enable SOLglobal 330
enable SSH portmanagement module 265
enable static IPv6 configurationI/O module 197management module 179
enable TCP command modemanagement module 266, 360
enable technician debugmanagement module 304
enable Telnet portmanagement module 267
enable TFTPmanagement module 267
enable trespass featuremanagement module 356
enable user 379enable V3 authentication for NTP
management module 246enable Wake on LAN
blade server 274globally 274
enable web interfacemanagement module 361
encryption algorithms 14end session 143ending an SOL session 23, 115enhanced legacy alert categories
disable 229enable 229
entries of the CIN status tabledisplay for management module 102
env 132, 133options
bbu 134be 133blade 132blower 134ckvm 133cpu 133disk 135exp 133hsec 133mgmtcrd 133mt 134mux 135ncc 135power 134sb 133sp 133storage 135switch 134
env (continued)options (continued)
system (managementmodule) 132
tap 135env command errors 428env commands
example 136environment
alarm panel 135blade mezzanine 133blade server 132BladeCenter unit 132blower 134BMC 133disk drive 135high-speed expansion card 133I/O module 134I/O-expansion card 133integrated system management
processor 133management card 133management module 132media tray 134memory 133microprocessor 133multiplexer expansion module 135network clock module 135power module 134service processor 133storage expansion unit 133storage module 135switch module 134
environment commands 131example 136
errorsaccseccfg command 411advfailover command 412alarm command 413alertcfg command 414alertentries command 414autoftp command 415baydata command 415bofm command 416boot command 417bootmode command 417bootseq command 418buildidcfg command 418chconfig command 419chlog command 420chmanual command 421cin command 421clear command 423clearlog command 423clock command 423command-line interface 407common 409config command 424console command 425dhcpinfo command 426displaylog command 426displaysd command 427dns command 428env command 428ethoverusb command 428eventinfo command 429events command 429
errors (continued)exit command 430feature command 430files command 432fuelg command 433groups command 436health command 436help command 437history command 437identify command 437ifconfig command 438info command 442iocomp command 443kvm command 443ldapcfg command 443led command 444list command 445mcad command 445modactlog command 445monalerts command 445monalertsleg command 446mt command 446nat command 446ntp command 447ping command 447pmpolicy command 448portcfg command 448ports command 448power command 450rdoc command 450read command 451remotechassis command 452reset command 452scale command 453sddump command 454sdemail command 454security command 455service command 455shutdown command 455slp command 455smtp command 455snmp command 456sol command 457sshcfg command 458sslcfg command 459syslog command 461tcpcmdmode command 462telnetcfg command 462temps command 463thres command 463trespass command 463uicfg command 464update command 465uplink command 467users command 468volts command 472write command 472zonecfg command 473
Ethernetconfiguring remote connection 21
Ethernet channeldisable for blade server 190enable for blade server 189
Ethernet channel 0 address prefix lengthset for management module 180
498 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Ethernet channel 0 configurationdisplay for management module
(primary) 171display for management module
(standby) 172Ethernet channel 0 configuration method
set for management module 176Ethernet channel 0 data rate
set for management module 177Ethernet channel 0 DHCP configuration
display for management module 117Ethernet channel 0 domain name
set for management module 179Ethernet channel 0 duplex mode
set for management module 177Ethernet channel 0 gateway IP address
(IPv4)set for management module 174
Ethernet channel 0 gateway/default route(IPv6)
set for management module 174Ethernet channel 0 hostname
set for management module 175set for standby management
module 176Ethernet channel 0 MAC address
set for management module 178set for standby management
module 178Ethernet channel 0 MTU
set for management module 177Ethernet channel 0 static IP address
(IPv4)set for management module 173set for standby management
module 173Ethernet channel 0 static IP address
(IPv6)set for management module 173set for standby management
module 174Ethernet channel 0 subnet mask (IPv4)
set for management module 175Ethernet channel 1
disable for management module 184enable for management module 183
Ethernet channel 1 configurationdisplay for management module
(primary) 181Ethernet channel 1 data rate
set for management module 182Ethernet channel 1 duplex mode
set for management module 182Ethernet channel 1 gateway IP address
(IPv4)set for management module 181
Ethernet channel 1 MAC addressset for management module 183
Ethernet channel 1 MTUset for management module 183
Ethernet channel 1 static IP address(IPv4)
set for management module 181Ethernet channel 1 subnet mask (IPv4)
set for management module 182Ethernet channel configuration method
set for blade server 188
Ethernet channel gateway IP address(IPv4)
set for blade server 186Ethernet channel gateway/default route
(IPv6)set for blade server 187
Ethernet channel hostnameset for blade server 189
Ethernet channel static IP address (IPv4)set for blade server 185
Ethernet channel static IP address (IPv6)set for blade server 186
Ethernet channel subnet mask (IPv4)set for blade server 187
Ethernet channel VLAN IDset for blade server 188
Ethernet network settings formanagement module commands
example 200Ethernet-over-USB setting
display for blade server 137set for blade server 137
ethoverusb 137options
s 137ethoverusb command errors 428ethoverusb commands 137
example 137European Union EMC Directive
conformance statement 483event description
display 138event log
clear for management module 105display (reset counter) for
management module 119display all entries for management
module 119display all filters for management
module 119display entries for management
module, filtered by date 120display entries for management
module, filtered by severitylevel 120
display entries for managementmodule, filtered by source 120, 121
display for management module 119enable monitoring of state 122save to TFTP server 122
event log, clear for management modulecommands 105
event log, display for call-home eventmanagement module entries 93
event log, display for managementmodule commands 119
event user actiondisplay 138, 139
eventinfo 138, 139eventinfo command errors 429eventinfo commands 138
example 139events 140
options-add 140-rm 141
events command errors 429
events commands 140example 141
exit 143exit codes (CLI)
Secure Shell server 20exit command 143exit command errors 430exit commands
example 143export datacenter feature licenses
management module 145export firmware build ID list
blade server 86external management
enable for I/O module 196external ports
enable for I/O module 196
Ffailover configuration
display for management module 373fast POST
enable for I/O module 275, 276FCC Class A notice 482feature 144
options-add 144-apply 145-remove 144-retrieve 145
feature command errors 430feature commands 144
example 146feature license
add for management module 144remove from management
module 144feature licenses
export for datacenter 145import from datacenter 145
featuresdisplay for management module 144
files 147options
d 147files command errors 432files commands 147
example 147filter alert type 56filter log entries by call-home events flag
management module 122firmware
display attributes 363update 364, 368
I/O module 365, 366, 367, 369,370, 371
switch 365, 366, 367, 369, 370, 371verbose 366, 370
update (verbose) 365, 368firmware build ID
update in firmware build ID list 83firmware build ID list
add entry for blade server 81create for blade server 80delete all entries 84delete entry 85
Index 499
firmware build ID list (continued)export for blade server 86import for blade server 85update firmware build ID for blade
server 83update firmware build revision for
blade server 84update firmware type for blade
server 83update machine type for blade
server 82update manufacturer for blade
server 82firmware build IDs
display for blade server 80firmware build revision
update in firmware build ID list 84firmware requirements 2firmware type
update in firmware build ID list 83firmware update 363flash location LED 169, 222forest name
set for Global Catalog discovery 211set for management module LDAP
server 211FTP
enable for management module 261FTP data port number
set for management module 256FTP port number
set for management module 256FTP timeout
set for management module 268fuelg 149, 150
optionsam 153dps 155e 153fpop 156int 152pcap 154pm 151pme 154, 155pt 151, 152tt 152
fuelg command errors 433fuelg commands 149
example 156
Ggaseous contamination 481gateway IP address (IPv4)
set for channel 0 of managementmodule 174
set for channel 1 of managementmodule 181
set for channel of blade server 186set for I/O module 194, 199
gateway IP address (IPv6)set for I/O module 195
gateway/default route (IPv6)set for channel 0 of management
module 174set for channel of blade server 187
generateCSR (LDAP client) 341CSR (management module web
server) 341self-signed certificate (LDAP
client) 339self-signed certificate (management
module web server) 339generate host key
management module 335generate syslog test message
management module 350generate test alert 58Germany Class A statement 483get service data
blade server 299getting help 476global
enable local KVM switching 208enable local media tray
switching 239enable local power control 274enable remote media tray
switching 240enable Wake on LAN 274
Global Catalog discoveryset forest name 211
global disableSOL 331
global enableSOL 330
GMT offsetdisplay for management module 106set for management module 107
group filterLDAP 217
group LDAP authentication, managementmodule 159
group search attributeLDAP 217
groups 159options
a 160clear 161n 159
groups command 159groups command errors 436groups commands
example 162guidelines
case sensitivity 6command history 6data types 6delimiters 6help 6options 5output format 6overview of 5strings 6
Hhardware requirements 2hardware service and support telephone
numbers 476health 163
health (continued)display for all BladeCenter units on
network 283display status 163display status (tree) 163display status and alerts 164display status and alerts with
timestamp 164options
f 164l 163t 164
health command 163, 164example 164
health command errors 436help 25, 166
getting 475help command 166help command errors 437help commands
example 166help, World Wide Web 476high-speed expansion card
command target 133history 168history command 168history command errors 437history commands
example 168host key
generate for managementmodule 335
host nameset for blade server 189set for channel 0 of management
module 175set for channel 0 of standby
management module 176HTTP port number
set for management module 257HTTP proxy setup
Service Advisor 91HTTPS port
enable for management module 262HTTPS port number
set for management module 257
II/O module
activate network protocolsettings 241
activate SAS zone 403BladeCenter Open Fabric
Manager 66bofm 66, 67, 68, 69, 70, 71bofm commands 66command target 134cycle power 273dhcpinfo commands 117disable DHCPv6 198disable IPv6 197disable IPv6 stateless
auto-configuration 198disable NAT table 244disable static IPv6 configuration 197display DHCP configuration 117
500 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
I/O module (continued)display IP addresses 248display network protocol
settings 241display network settings 193display POST status 276display power state 273display SAS zone information 404display SAS zone list 403enable DHCPv6 configuration 198enable external management 196enable external ports 196enable fast POST 275, 276enable IPv6 197enable IPv6 stateless
auto-configuration 198enable NAT table 244enable protected mode 197enable static IPv6 configuration 197I/O management commands 66keep new IP address configuration
after reset 195nat command 241, 244
example 244power off 272power on 272, 273reset 286reset (extended diagnostics) 288reset (full diagnostics) 288reset (standard diagnostics) 287reset configuration 103reset network protocol settings 241revert to old IP address configuration
after reset 195set address prefix length 198set gateway IP address (IPv4) 194set gateway IP address (IPv6) 195set IP address (IPv4) 194set IP address (IPv6) 194set NAT external port number 243set NAT internal port number 243set NAT protocol ID 242set NAT protocol name 242set RAID IP address (IPv4) 199set subnet mask (IPv4) 196turn off 272turn on 273
I/O module compatibilitydisplay details for blade server 206display details for I/O module 206display for all components 206
I/O module for blade servermanagement traffic
set for blade server 184I/O module power information
display 149I/O module, display power
trending 151, 152I/O-expansion card
command target 133I/O-module IP address
ping 249test communication 249
IBM Systems Directorcommunication 351
IBM Taiwan product service 477identify 169
identify (continued)options
s 169s, d 169
identify command 169identify command errors 437identify commands
example 170ifconfig 184, 192, 193
optionsckvm 185ckvm, enabled 193dhcp6 198em, enabled 196ep, enabled 196eth0 171eth0, c 176eth0, d 177eth0, dhcp6 180eth0, dn 179eth0, g 174eth0, g6 174eth0, i 173eth0, i6 173eth0, ipv6 179eth0, ipv6static 179eth0, l 178eth0, m 177eth0, n 175eth0, o 172eth0, o, i 173eth0, o, i6 174eth0, o, l 178eth0, o, n 176eth0, p6 180eth0, r 177eth0, s 175eth0, sa6 180eth1 181eth1, d 182eth1, down 184eth1, g 181eth1, i 181eth1, iom 184eth1, l 183eth1, m 183eth1, r 182eth1, s 182eth1, up 183ethx 184ethx, c 188ethx, dhcp6 191ethx, down 190ethx, g 186ethx, g6 187ethx, i 185ethx, i6 186ethx, ipv6 190ethx, n 189ethx, p6 190ethx, s 187ethx, sa6 191ethx, up 189ethx, v 188ethx, ve 189g 194, 199g6 195
ifconfig (continued)options (continued)
i 191, 194, 199i6 194ipv6 197ipv6static 197ir 199maxv 192p6 198pip 195pm, enabled 197s 196, 200sa6 198v 192ve 192
ifconfig command errors 438ifconfig commands 171
example 200import 344, 345, 346import certificate file
SSL CSR 343SSL self-signed certificate 343
import datacenter feature licensesmanagement module 145
import firmware build ID listblade server 85
important notices 480Industry Canada Class A emission
compliance statement 483info 203
optionspath 204reload, all 204reload, fw 204reload, hw 204reload, mac 204reload, wwn 204
info command 203info command errors 442info commands
example 205information
display for specific scalablecomplex 291
information (all)display for scalable complex 291
information about components andreloading components 203
information center 476information display, blade server power
(overview) 149information display, blower power 149information display, component 203information display, I/O module
power 149information display, power domain
(detailed) 150information display, power domain
(overview) 149information LED
turn off 221information reload, all 204information reload, firmware 204information reload, hardware 204information reload, MAC addresses 204information reload, WWN 204
Index 501
informational alertsdisable monitoring for all 234disable monitoring for blade
device 235disable monitoring for chassis 236disable monitoring for cooling
device 238disable monitoring for event log 237disable monitoring for I/O
module 235disable monitoring for inventory
change 236disable monitoring for network
change 237disable monitoring for power
module 238disable monitoring for power
state 236disable monitoring for storage
module 235disable monitoring for system
management 236disable monitoring for user
activity 237enable monitoring for all 234enable monitoring for blade
device 235enable monitoring for chassis 236enable monitoring for cooling
device 238enable monitoring for event log 237enable monitoring for I/O
module 235enable monitoring for inventory
change 236enable monitoring for network
change 237enable monitoring for power
module 238enable monitoring for power
state 236enable monitoring for storage
module 235enable monitoring for system
management 236enable monitoring for user
activity 237integrated system management processor
command target 133iocomp 206iocomp command errors 443iocomp commands 206
example 206IP address
CIN configuration entry 99CIN index entry 99display BladeCenter units on network
filtered by 283ping 248test communication 248
IP address (I/O-module)ping 249test communication 249
IP address (IPv4)set for blade server 185set for blade server ISMP 191set for I/O module 194
IP address (IPv4) (continued)set for management module 173set for standby management
module 173IP address (IPv6)
set for blade server 186set for I/O module 194set for management module 173set for standby management
module 174IP address configuration
keep new after reset 195revert to old after reset 195
IP address, default 15IP addresses
display for I/O module 248IPv6
disable for blade server 190disable for I/O module 197disable for management module 179enable for blade server 190enable for I/O module 197enable for management module 179
IPv6 configuration (static)disable for I/O module 197disable for management module 179enable for I/O module 197enable for management module 179
IPv6 stateless auto-configurationdisable for blade server 191disable for I/O module 198disable for management module 180enable for blade server 191enable for I/O module 198enable for management module 180
ISMPreset 286
JJapan VCCI Class A statement 484Japan Voluntary Control Council for
Interference Class A statement 484JS20 blade server commands
reset (clear NVRAM) 289reset (run diagnostics with boot
sequence) 289reset (run diagnostics) 289reset (with NMI) 288
JSxx blade server commandsreset (enter SMS menu) 290
Kkeep new IP address configuration after
resetI/O module 195
Korea Communications Commissionstatement 485
kvm 208options
b 208local 208
KVMdisplay owner 208set owner 208
kvm command errors 443kvm commands 208
example 209KVM port
set state for managementmodule 262
LLDAP client
generate CSR 341generate self-signed certificate 339
LDAP client distinguished nameset for management module 216
LDAP client distinguished namepassword
set for management module 216LDAP client distinguished name
password (confirm)set for management module 216
LDAP group filterset for management module 217
LDAP group search attributeset for management module 217
LDAP login permission attributeset for management module 218
LDAP nameset for management module 210
LDAP root distinguished nameset for management module 214
LDAP security versionset for management module 210
LDAP server (first) host nameset for management module 212
LDAP server (first) IP addressset for management module 212
LDAP server (first) port numberset for management module 213
LDAP server (fourth) host nameset for management module 213
LDAP server (fourth) IP addressset for management module 213
LDAP server (fourth) port numberset for management module 214
LDAP server (second) host nameset for management module 212
LDAP server (second) IP addressset for management module 212
LDAP server (second) port numberset for management module 213
LDAP server (third) host nameset for management module 212
LDAP server (third) IP addressset for management module 212
LDAP server (third) port numberset for management module 214
LDAP server authentication methodset for management module 215
LDAP server binding methodset for management module 215
LDAP server discovery methodset for management module 211
LDAP server domain nameset for management module 211
LDAP server forest nameset for management module 211
502 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
LDAP settingsdisplay for management module 210
LDAP UID search attributeset for management module 215
ldapcfg 210options
aom 215bm 215cd 216cp 216dn 211fn 211gf 217gsa 217i1 212i2 212i3 212i4 213lpa 218p 216p1 213p2 213p3 214p4 214rd 214server 211t 210usa 215v 210
ldapcfg command 210example 218
ldapcfg command errors 443led 220
optionse 220info 220info off 221l 220, 221loc 220, 222loc, d 223r 220
LED (information)turn off 221
LED (location), control 169led command 220led command errors 444led commands
example 223LED commands 29LED state
display (blade server frontpanel) 220
display (external port linkstatus) 220
display (fault) 220display (for blade server and all
sub-components) 221display (safe-to-remove) 220display (state for blower fault
LED) 220display (state for fanpack fault
LED) 220display various LED states 220
licensesdisplay for management module 144
light location LED 169, 222time period 223
light location LED (BladeCenter unit)time period 169
link local address 15list 225
optionsl 225
list commandexample 225
list command errors 445local KVM switching
enable globally 208local media tray switching
enable globally 239local power control
enable for blade server 275enable globally 274
locationdisplay for management module 111set for management module 112
location LEDblink 169, 222display state 169flash 169, 222light 169, 222
time period 223light (BladeCenter unit)
time period 169turn off 169, 222
location LED control 169logging
disable for logging of login eventsfrom same IP address 35
enable for logging of login eventsfrom same IP address 35
logical link loss alert and failover policyset for advanced management
module 375set for management module
(advanced) 375login permission attribute
LDAP 218
MMAC address
set for channel 0 of managementmodule 178
set for channel 0 of standbymanagement module 178
set for channel 1 of managementmodule 183
machine typeupdate in firmware build ID list 82
manage alert recipients 53management card
command target 133management channel auto-discovery
disable for BladeCenter unit 227enable for BladeCenter unit 227
management channel auto-discoverystatus
display for BladeCenter unit 227management channel path information
display 204management module
account security commands 30, 66accseccfg 30
management module (continued)accseccfg commands 30, 38acknowledge call-home activity log
entry 94add Call Home events 140, 141add feature license 144add SSH public key 392add SSH public key (specific) 392advfailover command 40, 41
example 41airfilter 42autoftp commands 60, 62bay data 63bofm 66, 67, 68, 69, 70, 71bofm commands 66, 71cabling 12change user password 385chconfig commands 87, 91chmanual commands 95, 96cin commands 97cinstatus commands 102clear CIN configuration entries 97clear event log 105clear event log commands
example 105command target 132command-line session
configuration 354command-line timeout 354comment SSH public key 398config command 111, 114
example 114configuring 21connect to SSH public key 397create alert recipient 54create user 381default IP address 15delete Active Directory group 161delete alert recipient 53delete CIN configuration 98delete file 147delete user 378DHCP settings commands
example 118dhcpinfo commands 117, 118direct connection 13disable automatic configuration 282disable CIN configuration entry 98disable CLI SSH server 336disable DHCPv6 180disable Ethernet channel 1 184disable IPv6 179disable IPv6 stateless
auto-configuration 180disable network interface for
standby 40disable SMASH SSH server 336disable static IPv6 configuration 179disable technician debug 304disable user 379display (reset counter) event log 119display account security settings 30display active users 377display advanced failover settings 40display alert properties (all
recipients) 53
Index 503
management module (continued)display alert properties (single
recipient) 53display all Active Directory
groups 159display all event log entries 119display all event log filters 119display all users 377display automatic configuration
setting 280display call-home activity log 93display CIN configuration table 97display clock settings 106display contact name 111display date 106display daylight-savings time
setting 106display DNS configuration 126display DSA host key
information 335display entries of CIN status
table 102display Ethernet channel 0 DHCP
configuration 117display event description 138display event log 119display event log commands
example 123display event log entries filtered by
date 120display event log entries filtered by
severity level 120display event log entries filtered by
source 120, 121display event user action 138, 139display events list 140display features 144display file list 147display free space 140, 147display FTP/TFTP server call-home
activity log 93display global remote alert
settings 51display GMT offset 106display IBM Support call-home
activity log 93display LDAP settings 210display licenses 144display location 111display log entries with call-home
events 119display log entries with Event ID 119display name 111display network port settings 255display NTP configuration 245display open ports 255display RSA host key
information 335display serial port configuration 253display service setting 304display single user 378display SLP settings 307display SMTP server host name 309display SMTP server IP address 309display SNMP configuration 312display specific Active Directory
groups 159
management module (continued)display SSH public key 391display SSH status 335display state of -lse option 122display status 124Display status of first five CIN
entries 102display syslog configuration 347display temperature 355display time 106display trespass feature status 356display user interface settings 359display voltage 400display volume information 278dns commands 126, 129
example 129download SSH public key 396enable automatic configuration 281enable CIN configuration entry 98enable CLI SSH server 336enable command-line interface 359enable complex password 33enable data encryption 303enable default administration
password expiration 34enable DHCPv6 configuration 180enable DNS 126enable dynamic DNS 126enable Ethernet channel 1 183enable FTP 261enable HTTPS port 262enable IPv6 179enable IPv6 stateless
auto-configuration 180enable monitoring of event log
state 122enable network interface for standby
and allow IP swap 40enable network interface for standby
and prevent IP swap 41enable NTP 245, 262enable password change at first
login 36enable password required 37enable RDE 263enable RDOCE 263enable secure SMASH over SSH 264enable secure TCP command
mode 266, 360enable security 303enable SLP 263enable SMASH over Telnet 264enable SMASH SSH server 336enable SNMP agent (SNMPv1) 312enable SNMP agent (SNMPv3) 312enable SNMP traps 265, 312enable SNMPv1 359enable SNMPv1 agent 264enable SNMPv3 359enable SNMPv3 agent 265enable SSH port 265enable static IPv6 configuration 179enable TCP command mode 266, 360enable technician debug 304enable Telnet port 267enable TFTP 267enable trespass feature 356
management module (continued)enable user 379enable V3 authentication for
NTP 246enable web interface 361Ethernet network settings commands
example 200export datacenter feature
licenses 145failover configuration 373filter alert type 56filter log entries by call-home events
flag 122generate host key 335generate syslog test message 350IBM Systems Director
communication 351ifconfig commands 171, 200import datacenter feature
licenses 145kvm commands 208, 209ldapcfg command 210, 218
example 218map image 278mcad commands 227mount volume 278mt commands 239, 240network connection 13portcfg commands 253, 254ports command 255, 270
example 270read CIN status table entries 102read command 280, 282
example 282remotechassis command 283, 284
example 284remove feature license 144remove SSH public key 393replace SSH public key 395reset (failover) 287reset (force failover) 287reset (primary) 286reset (standby) 286reset configuration (keep logs) 103reset network port settings 256restore configuration from file
(encryption) 281restore configuration from file (no
encryption) 280restore configuration from
midplane 280save configuration to chassis 401save configuration to file
(encryption) 402save configuration to file (no
encryption) 401save event log to TFTP server 122sdemail commands 301security commands 30, 303serial connection 14, 17serial port settings commands
example 254service command
example 304service commands 304set account inactivity alert time 34set account inactivity disable time 35
504 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
management module (continued)set account lockout period 36set account security default to
high 32set account security default to
legacy 31set Active Directory group authority
level 160set Active Directory group name 159set alert notification method 57set alert recipient email address 57set alert recipient name 55set alert recipient status 56set alert type 56set authentication logging timeout 32set CIN state for global enable or
disable 97set CLI inactivity timeout 33set contact name 112, 113, 114set date 106set daylight-savings time mode 109set DNS first IPv4 IP address 127set DNS first IPv6 IP address 128set DNS second IPv4 IP address 127set DNS second IPv6 IP address 128set DNS server priority 129set DNS third IPv4 IP address 127set DNS third IPv6 IP address 128set Ethernet channel 0 address prefix
length 180set Ethernet channel 0 configuration
method 176set Ethernet channel 0 data rate 177set Ethernet channel 0 domain
name 179set Ethernet channel 0 duplex
mode 177set Ethernet channel 0 gateway IP
address (IPv4) 174set Ethernet channel 0
gateway/default route (IPv6) 174set Ethernet channel 0 hostname 175set Ethernet channel 0 MAC
address 178set Ethernet channel 0 MTU 177set Ethernet channel 0 static IP
address (IPv4) 173set Ethernet channel 0 static IP
address (IPv6) 173set Ethernet channel 0 subnet mask
(IPv4) 175set Ethernet channel 1 data rate 182set Ethernet channel 1 duplex
mode 182set Ethernet channel 1 gateway IP
address (IPv4) 181set Ethernet channel 1 MAC
address 183set Ethernet channel 1 MTU 183set Ethernet channel 1 static IP
address (IPv4) 181set Ethernet channel 1 subnet mask
(IPv4) 182set first LDAP server host name 212set first LDAP server IP address 212set first LDAP server port
number 213
management module (continued)set fourth LDAP server host
name 213set fourth LDAP server IP
address 213set fourth LDAP server port
number 214set FTP data port number 256set FTP port number 256set FTP timeout 268set GMT offset 107set hostname for alerts 58set HTTP port number 257set HTTPS port number 257set IP address (IPv4) 173set IP address (IPv6) 173set IP address for alerts 58set LDAP client distinguished
name 216set LDAP client distinguished name
password 216set LDAP client distinguished name
password (confirm) 216set LDAP group filter 217set LDAP group search attribute 217set LDAP login permission
attribute 218set LDAP name 210set LDAP root distinguished
name 214set LDAP security version 210set LDAP server binding method 215set LDAP server discovery
method 211set LDAP server domain name 211set LDAP server for authentication
only 215set LDAP server forest name 211set LDAP UID search attribute 215set location 112set maximum LDAP sessions for
user 36set maximum number of login
failures 35set maximum number of simultaneous
sessions for user 388set minimum number of different
characters for password 34set name 111set NTP server hostname 245set NTP server IP address 245set NTP server key 246set NTP update frequency 246set password expiration time 37set password minimum change
interval 37set password reuse cycle 38set privacy password (SNMPv3) 390set Remote Presence port
number 257set second LDAP server host
name 212set second LDAP server IP
address 212set second LDAP server port
number 213
management module (continued)set secure TCP command mode port
number 260set serial port baud rate 253set serial port communication
rate 253set serial port parity 253set serial port stop bits 254set server host name 309set server IP address 309set SLP address type 307set SLP multicast address 307set SLP port number 258set SMASH Telnet port number 258set SMTP e-mail server domain
name 310set SNMP agent port number 259set SNMP community 1 first host
name 314set SNMP community 1 first host
name - get 316set SNMP community 1 first host
name to set 315set SNMP community 1 IP address
(first host) 314set SNMP community 1 IP address
(first host) to get 316set SNMP community 1 IP address
(first host) to set 315set SNMP community 1 IP address
(second host) 317set SNMP community 1 IP address
(third host) 318set SNMP community 1 name 313set SNMP community 1 second host
name 317set SNMP community 1 third host
name 318set SNMP community 1 view type
(SNMPv3) 318set SNMP community 2 first host
name 319set SNMP community 2 IP address
(first host) 319set SNMP community 2 IP address
(second host) 320set SNMP community 2 IP address
(third host) 321set SNMP community 2 name 319set SNMP community 2 second host
name 320set SNMP community 2 third host
name 321set SNMP community 2 view type
(SNMPv3) 321set SNMP community 3 first host
name 322set SNMP community 3 IP address
(first host) 322set SNMP community 3 IP address
(second host) 323set SNMP community 3 IP address
(third host) 324set SNMP community 3 name 322set SNMP community 3 second host
name 323
Index 505
management module (continued)set SNMP community 3 third host
name 324set SNMP community 3 view type
(SNMPv3) 324set SNMP contact name 325set SNMP location 326set SNMP traps port number 259set SSH port number 260set state for KVM port 262set syslog event log collector 1 IP
address 348set syslog event log collector 1 port
number 349set syslog event log collector 2 IP
address 348set syslog event log collector 2 port
number 349set syslog filter level 347set TCP command mode port
number 260set TCP command-mode timeout 268set Telnet port number 261set Telnet port timeout 268set TFTP port number 261set third LDAP server host name 212set third LDAP server IP address 212set third LDAP server port
number 214set time 106set trespass feature message 356set trespass feature to default 357set tsyslog event log collector 1 host
name 348set tsyslog event log collector 2 host
name 348set user access type (SNMPv3) 390set user authentication method 33set user authentication protocol
(SNMPv3) 389set user authority level 386set user context name (SNMPv3) 388set user hostname (SNMPv3
traps) 391set user IP address (SNMPv3
traps) 391set user name 383set user password 384set user privacy protocol
(SNMPv3) 389set web interface inactivity
timeout 38slp command 307
example 307smtp commands 309, 310SMTP settings commands
example 310snmp commands 312, 326SNMP settings commands
example 326SSH connection 18sshcfg command 335, 336
example 336SSL certificate status 337SSL status 337synchronize with NTP server 247telnet configuration 354
management module (continued)telnet timeout 354terminate user session 377trespass command 356, 357
example 357turn secure TCP command mode on
or off 267, 361turn TCP command mode on or
off 266, 360unacknowledge call-home activity log
entry 94unlock user 380unmount volume 278uplink configuration 373upload SSH public key 394view configuration 225view power management policy 252write command 401, 402
example 402management module (advanced)
disable logical uplink failover 374enable logical uplink failover 374enable physical uplink failover 373logical uplink failover delay 374logical uplink failover IP address 374logical uplink failover IPv6 IP
address 375physical uplink failover delay 373set logical link loss alert and failover
policy 375management module (primary)
display Ethernet channel 0configuration 171
display Ethernet channel 1configuration 181
reset 286management module (standby)
display Ethernet channel 0configuration 172
reset 286set Ethernet channel 0 hostname 176set Ethernet channel 0 MAC
address 178set Ethernet channel 0 static IP
address (IPv4) 173set Ethernet channel 0 static IP
address (IPv6) 174set IP address (IPv4) 173set IP address (IPv6) 174
management module air filtercommand 42
management module event logcommands 28
management module failovercommands 373
management module telnet configurationcommands
example 354management module uplink failover
commandsexample 375
management module web servergenerate CSR 341generate self-signed certificate 339
management module, group LDAPauthentication 159
management module, user accounts 377
management network DHCPconfiguration
display for blade server 117management-module firmware 2manufacturer
update in firmware build ID list 82map image
advanced management modulevolume 278
maximum LDAP sessions for userset for management module 36
maximum number of login failuresset for management module 35
mcad 227options
e 227mcad command errors 445mcad commands 227
example 227media tray
command target 134display owner 239display temperature 355set owner 239
media tray temperature display 149media tray, display power trending 152memory
command target 133memory commands 29microprocessor
command target 133minimum number of different characters
for passwordset for management module 34
modactlog 228modactlog command errors 445modactlog commands 228
example 228module (blade server)
display activity 228display information 228
monalerts 229options
ca 229cb 230ccd 231ccsm 231ciom 230, 233, 235cpm 231ec 229ia 234ib 235icd 238icsm 236iel 237iinv 236iiom 235inc 237ipm 238ipon 236iua 237wa 232wb 232wcd 234wcsm 233wel 233wiom 232
506 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
monalerts (continued)options (continued)
wpm 234monalerts command errors 445monalerts commands 229
example 238monalertsleg command errors 446monalertsleg commands 229monitoring
disable for all critical alerts 229disable for all informational
alerts 234disable for all warning alerts 232disable for blade device critical
alerts 230disable for blade device informational
alerts 235disable for blade device warning
alerts 232disable for chassis critical alerts 231disable for chassis informational
alerts 236disable for chassis warning alerts 233disable for cooling device critical
alerts 231disable for cooling device
informational alerts 238disable for cooling device warning
alerts 234disable for event log informational
alerts 237disable for event log warning
alerts 233disable for I/O module critical
alerts 230disable for I/O module informational
alerts 235disable for I/O module warning
alerts 232disable for inventory change
informational alerts 236disable for network change
informational alerts 237disable for power module critical
alerts 231disable for power module
informational alerts 238disable for power module warning
alerts 234disable for power state informational
alerts 236disable for storage module critical
alerts 230disable for storage module
informational alerts 235disable for storage module warning
alerts 233disable for system management
critical alerts 231disable for system management
informational alerts 236disable for system management
warning alerts 233disable for user activity informational
alerts 237enable for all critical alerts 229
monitoring (continued)enable for all informational
alerts 234enable for all warning alerts 232enable for blade device critical
alerts 230enable for blade device informational
alerts 235enable for blade device warning
alerts 232enable for chassis critical alerts 231enable for chassis informational
alerts 236enable for chassis warning alerts 233enable for cooling device critical
alerts 231enable for cooling device
informational alerts 238enable for cooling device warning
alerts 234enable for event log informational
alerts 237enable for event log warning
alerts 233enable for I/O module critical
alerts 230enable for I/O module informational
alerts 235enable for I/O module warning
alerts 232enable for inventory change
informational alerts 236enable for network change
informational alerts 237enable for power module critical
alerts 231enable for power module
informational alerts 238enable for power module warning
alerts 234enable for power state informational
alerts 236enable for storage module critical
alerts 230enable for storage module
informational alerts 235enable for storage module warning
alerts 233enable for system management critical
alerts 231enable for system management
informational alerts 236enable for system management
warning alerts 233enable for user activity informational
alerts 237mount volume
advanced management module 278mt 239
optionsb 239local 239remote 240
mt command errors 446mt commands 239
example 240
MTUset for channel 0 of management
module 177set for channel 1 of management
module 183multiple video sessions
disable for blade servers 192enable for blade servers 192
multiplexer expansion modulecommand target 135reset (failover) 287
Nname
display BladeCenter units on networkfiltered by 284
display for blade server 111display for management module 111set for blade server 111set for management module 111
name (contact)set for management module 112, 113,
114nat 241
optionsactivate 241en 244ep 243ip 243pi 242pn 242reset 241
nat command 241example 244
nat command errors 446NAT external port number
set for I/O module 243NAT internal port number
set for I/O module 243NAT protocol ID
set for I/O module 242NAT protocol name
set for I/O module 242NAT table
disable for I/O module 244enable for I/O module 244
NEBS, disable 153network card
display configurationinformation 184
network clock modulecommand target 135power off 272power on 272turn off 272turn on 272
network configuration statusdisplay for blade server 184
network interfacedisable for standby management
module 40enable for standby management
module and allow IP swap duringfailover 40
Index 507
network interface (continued)enable for standby management
module and prevent IP swap duringfailover 41
network port settingsdisplay for management module 255display for switch 269reset for management module 256
network protocol settingsactivate for I/O module 241display for I/O module 241reset for I/O module 241
network settingsdisplay for BladeCenter unit 192display for I/O module 193
New Zealand Class A statement 483node information
display for scalable complex 291notes, important 480notices 479
electronic emission 482FCC, Class A 482
notification method, set for alerts 57ntp 245
optionsen, enabled 245f 246i 245synch 247v3 246v3en, enabled 246
NTPenable for management module 245,
262ntp command 245
example 247ntp command errors 447NTP configuration
display for management module 245NTP server
synchronize management moduleclock 247
NTP server hostnameset for management module 245
NTP server IP addressset for management module 245
NTP server keyset for management module 246
NTP update frequencyset for management module 246
Oonline documentation 1open ports
display for management module 255options
a 102f 102
out-of-band communication, IBM SystemsDirector 351
override persistent commandenvironment 7
Pparity
set for serial port of managementmodule 253
particulate contamination 481partition
create for scalable complex 294delete all from scalable complex 294delete from scalable complex 295power cycle in scalable complex 297power off in scalable complex 297power on in scalable complex 296
partition (automatic)create for scalable complex 292
partition informationdisplay for scalable complex 291
partition modeset to partition for scalable
complex 296set to stand alone for scalable
complex 295password
change for user 385LDAP distinguished name 216
password (confirm)LDAP distinguished name 216
password expiration timeset for management module 37
password minimum change intervalset for management module 37
password reuse cycleset for management module 38
path informationdisplay for management channel 204
People's Republic of China Class Aelectronic emission statement 485
persistent command environmentoverride 7
persistent command target 6ping
I/O-module IP address 249IP address 248IP address (I/O-module) 249r 248, 249
ping command errors 447ping commands 248
example 249pmpolicy 251
optionspd 251pdx 251
view for management module 252pmpolicy command
example 252pmpolicy command errors 448polling interval, set for power
trending 152portcfg
optionscom1 253com1, b 253com1, p 253com1, s 254
portcfg command errors 448portcfg commands 253
example 254ports 255
ports (continued)options
-kvme, state 262ftpdp 256ftpe, on 261ftpp 256ftpt 268httpp 257httpse, on 262httpsp 257ntpe, on 262open 255rde, on 263rdoce, on 263reset 256rpp 257slpe , on 263slpp 258smashse, on 264smashte, on 264smashtp 258snmp1ae, on 264snmp3ae, on 265snmpap 259snmpte, on 265snmptp 259sshe, on 265sshp 260stcme, on 266stcme, port mode 267stcmp 260tcme, on 266tcme, port mode 266tcmp 260tcmt 268telnete, on 267telnetp 261telnett 268tftpe, on 267tftpp 261
switch 269, 270ports (open)
display for management module 255ports command 255
example 270ports command errors 448POST status
display for I/O module 276display for switch module 276
poweroptions
ap 275cycle 273cycle, c 273fp 275, 276local 274, 275off 272on 272on, c 272softoff 273state 273state, post 276wol 274
power capping, enable for bladeserver 154
power capping, set for blade server 154power command errors 450
508 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
power commands 272example 277
power control commands 29power cycle partition
scalable complex 297power domain
disable acoustic mode 153disable NEBS environment mode 153enable acoustic mode 153enable NEBS environment mode 153
power domain information display(detailed) 150
power domain information display(overview) 149
power domain redundancy loss policy,set 151
power domain, display powertrending 151, 152
power management commands 29power management policy
displayall 251BladeCenter S policies 251specified power domain
policies 251set
for specified power domain 251power management, enable for blade
server 154, 155power module
command target 134power off
alarm panel module 272blade server 272, 273I/O module 272network clock module 272switch module 272, 273
power off partitionscalable complex 297
power onalarm panel module 272blade server 272, 273I/O module 272, 273network clock module 272switch module 272, 273
power on (to console)blade server 272, 273
power on partitionscalable complex 296
power polling interval, set 152power saver mode, enable for blade
server 155power state
display for blade server 273display for I/O module 273display for switch module 273
power trending, display (bladeserver) 151, 152
power trending, display (blower) 151,152
power trending, display (I/Omodule) 151, 152
power trending, display (powerdomain) 151, 152
power trending, display (system) 151,152
primary management module 7
problem descriptioncall-home 95email 301service information 301
product service, IBM Taiwan 477protected mode
enable for I/O module 197
RRAID controller
set gateway IP address (IPv4) 199set subnet mask (IPv4) 200
RAID IP address (IPv4)set for I/O module 199
RDEenable for management module 263
rdoc 278options
map 278mount 278unmount 278
rdoc command errors 450rdoc commands 278
example 279RDOCE
enable for management module 263read 280
optionsconfig 280config, auto, off 282config, auto, on 281config, l , i 280config, l , i, p 281
read CIN configuration status tableentries 102
read CIN status table entries formanagement module 102
read command 280example 282
read command errors 451redirect command 25, 131redundancy loss policy, power domain
(set) 151reload all information 204reload firmware information 204reload hardware information 204reload MAC address information 204reload MAC addresses information 204reload WNN information 204remote alert
set retry interval 51set retry limit 52
remote media tray switchingenable globally 240
Remote Presence port numberset for management module 257
remotechassis 283options
clear 284health 283ip 283name 284
remotechassis command 283example 284
remotechassis command errors 452remove 344, 345, 346
remove feature licensemanagement module 144
remove SSH public key 393replace SSH public key 395required, firmware 2required, hardware 2reset 286
blade server 72, 286I/O module 286ISMP 286management module (primary) 286management module (standby) 286options
c 287clr 289ddg 289dg 289exd 288f 287force 287full 288sft 288sms 290standby 286std 287
service processor 286switch module 286
reset (clear NVRAM)blade server 289
reset (enter SMS menu)blade server 290
reset (extended diagnostics)I/O module 288switch module 288
reset (failover)management module 287multiplexer expansion module 287
reset (force failover)management module 287
reset (full diagnostics)I/O module 288switch module 288
reset (run diagnostics with bootsequence)
blade server 289reset (run diagnostics)
blade server 289reset (standard diagnostics)
I/O module 287switch module 287
reset (to console)blade server 72, 287
reset (with NMI)blade server 288
reset blase server key sequenceset for SOL 333
reset command 29reset command errors 452reset commands 286
example 290reset configuration
I/O module 103switch module 103
reset configuration (keep logs)management module 103
reset default configuration 103
Index 509
reset network port settingsmanagement module 256
reset network protocol settingsI/O module 241
responding to thermal events 153restore configuration
management module (from file withencryption) 281
management module (from file withno encryption) 280
management module (frommidplane) 280
restore configuration commands 29restore management module
configuration commandexample 282
retry countset for SOL 329
retry intervalset for remote alerts 51set for SOL 328
retry limitset for remote alerts 52
retry numberset for remote alerts 51
revert to old IP address configurationafter reset
I/O module 195RSA host key information
display for management module 335Russia Class A electromagnetic
interference statement 485Russia Electromagnetic Interference (EMI)
Class A statement 485
SSAS system
set gateway IP address (IPv4) 199set subnet mask (IPv4) 200
SAS zoneactivate for I/O module 403
SAS zone informationdisplay for I/O module 404
SAS zone listdisplay for I/O module 403
save configuration commands 29save configuration to chassis
management module 401save configuration to file (encryption)
management module 402save configuration to file (no encryption)
management module 401save event log to TFTP server
management module 122save management module configuration
commandexample 402
save service informationsave to TFTP server 124
scalable complexcreate partition 294create partition (automatically) 292create stand-alone partition 293create stand-alone partition
(automatically) 292delete all partitions 294
scalable complex (continued)delete partition 295display all information 291display node information 291display partition information 291display specific complex
information 291power cycle partition 297power off partition 297power on partition 296set partition mode to partition 296set partition mode to stand alone 295
scale 291options
auto 292compid 291compid, partition 291create 293, 294cycle 297delete 294, 295mode 295, 296node 291off 297on 296
scale command errors 453scale commands 291
example 298sddump
optionscoll 299init 299
sddump command errors 454sddump commands 299
example 300sdemail
optionssubj 301to 301
sdemail command errors 454sdemail commands 301
example 301search domain
set for Domain Catalogdiscovery 211
secure command-line interface 14Secure Shell connection clients 14secure shell server
disabling 19Secure Shell server
exit codes (CLI) 20using 18
secure SMASHenabling 19
secure SMASH over SSHenable for management module 264
secure TCP command modedisable 352enable 352enable for management module 266,
360set number of sessions 352turn secure TCP command mode on
or off for the managementmodule 267, 361
secure TCP command mode port numberset for management module 260
security 14, 303
security (continued)display management module account
settings 30display management module
setting 303enable complex password for
management module userauthentication 33
enable default administrationpassword expiration formanagement module 34
enable for management module 303enable password change at first login
to management module 36enable password required for
management module 37options
e 303set management module account
default to high 32set management module account
default to legacy 31set management module account
inactivity alert time 34set management module account
inactivity disable time 35set management module account
lockout period 36set management module
authentication logging timeout 32set management module CLI
inactivity timeout 33set management module maximum
LDAP sessions for user 36set management module maximum
number of login failures 35set management module minimum
number of different characters forpassword 34
set management module passwordexpiration time 37
set management module passwordminimum change interval 37
set management module passwordreuse cycle 38
set management module userauthentication method 33
set management module web interfaceinactivity timeout 38
security command errors 455security commands 303
account security 30example 303
selecting command environment 6selecting command target 6self-signed certificate
generate for LDAP client 339generate for management module web
server 339self-signed certificate (SSL)
download certificate file 342import certificate file 343upload certificate file 343
send thresholdset for SOL 329
Serial Over LAN 22Serial Over LAN commands 328
510 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
Serial Over LAN commands (continued)example 333
serial port baud rateset for management module 253
serial port communication rateset for management module 253
serial port configurationdisplay for management module 253
serial port parityset for management module 253
serial port settings for managementmodule commands
example 254serial port stop bits
set for management module 254server host name
set for management module 309server IP address
set for management module 309service 304
optionsdisable 304enable 304
Service Advisorcontact information 89disable 88display owner 87enable 88HTTP proxy setup 91
service and supportbefore you call 475hardware 476software 476
service commandexample 304
service command errors 455service commands 304service data
collect for blade server 299display command 124display for blade server 299dump from blade server 299get for blade server 299
service informationcapture 124display 124email 301exclude from email alerts 51include with email alerts 51problem description 301save to TFTP server 124
service processorcommand target 133reset 286
service settingdisplay for management module 304
session command 29set
date, management module 106daylight-savings time mode,
management module 109GMT offset, management
module 107power management policy
specified power domain 251TCP command-mode session
timeout 351
set (continued)time, management module 106
set accumulate timeoutSOL 330
set Active Directory group authoritylevel 160
set Active Directory group name 159set address prefix length
blade server 190I/O module 198
set alarm 49set alert notification method 57set alert recipient email address 57set alert recipient name 55set alert recipient status 56set alert type 56set automatic power-on policy
BladeCenter unit 275set boot mode
blade server 74set CIN state for disable
management module 97set CIN state for enable
management module 97set CLI key sequence
SOL 332set command-line timeout
management module 354set contact name
management module 112, 113, 114set DNS first IPv4 IP address
management module 127set DNS first IPv6 IP address
management module 128set DNS second IPv4 IP address
management module 127set DNS second IPv6 IP address
management module 128set DNS server priority
management module 129set DNS third IPv4 IP address
management module 127set DNS third IPv6 IP address
management module 128set Ethernet channel 0 address prefix
lengthmanagement module 180
set Ethernet channel 0 configurationmethod
management module 176set Ethernet channel 0 data rate
management module 177set Ethernet channel 0 domain name
management module 179set Ethernet channel 0 duplex mode
management module 177set Ethernet channel 0 gateway IP
address (IPv4)management module 174
set Ethernet channel 0 gateway/defaultroute (IPv6)
management module 174set Ethernet channel 0 hostname
management module 175standby management module 176
set Ethernet channel 0 MAC addressmanagement module 178
set Ethernet channel 0 MAC address(continued)
standby management module 178set Ethernet channel 0 MTU
management module 177set Ethernet channel 0 static IP address
(IPv4)management module 173standby management module 173
set Ethernet channel 0 static IP address(IPv6)
management module 173standby management module 174
set Ethernet channel 0 subnet mask (IPv4)management module 175
set Ethernet channel 1 data ratemanagement module 182
set Ethernet channel 1 duplex modemanagement module 182
set Ethernet channel 1 gateway IPaddress (IPv4)
management module 181set Ethernet channel 1 MAC address
management module 183set Ethernet channel 1 MTU
management module 183set Ethernet channel 1 static IP address
(IPv4)management module 181
set Ethernet channel 1 subnet mask (IPv4)management module 182
set Ethernet channel configurationmethod
blade server 188set Ethernet channel gateway IP address
(IPv4)blade server 186
set Ethernet channel gateway/defaultroute (IPv6)
blade server 187set Ethernet channel hostname
blade server 189set Ethernet channel static IP address
(IPv4)blade server 185
set Ethernet channel static IP address(IPv6)
blade server 186set Ethernet channel subnet mask (IPv4)
blade server 187set Ethernet channel VLAN ID
blade server 188set Ethernet-over-USB setting
blade server 137set first LDAP server host name
management module 212set first LDAP server IP address
management module 212set first LDAP server port number
management module 213set fourth LDAP server host name
management module 213set fourth LDAP server IP address
management module 213set fourth LDAP server port number
management module 214
Index 511
set FTP data port numbermanagement module 256
set FTP port numbermanagement module 256
set FTP timeoutmanagement module 268
set gateway IP address (IPv4)I/O module 194RAID controller 199SAS system 199
set gateway IP address (IPv6)I/O module 195
set hostname for alerts 58set HTTP port number
management module 257set HTTPS port number
management module 257set I/O module for blade server
management trafficblade server 184
set IP address (IPv4)blade server 185blade server ISMP 191I/O module 194management module 173standby management module 173
set IP address (IPv6)blade server 186I/O module 194management module 173standby management module 174
set IP address for alerts 58set KVM owner 208set LDAP client distinguished name
management module 216set LDAP client distinguished name
passwordmanagement module 216
set LDAP client distinguished namepassword (confirm)
management module 216set LDAP group filter
management module 217set LDAP group search attribute
management module 217set LDAP login permission attribute
management module 218set LDAP name
management module 210set LDAP security version
management module 210set LDAP server binding method
management module 215set LDAP server discovery method
management module 211set LDAP server domain name
management module 211set LDAP server for authentication only
management module 215set LDAP server forest name
management module 211set LDAP server root distinguished name
management module 214set LDAP UID search attribute
management module 215set location
management module 112
set logical link loss alert and failoverpolicy
advanced management module 375management module (advanced) 375
set logical uplink failover delayadvanced management module 374management module (advanced) 374
set logical uplink failover IP addressadvanced management module 374management module (advanced) 374
set logical uplink failover IPv6 IP addressadvanced management module 375management module (advanced) 375
set management module accountinactivity alert time 34
set management module accountinactivity disable time 35
set management module account lockoutperiod 36
set management module account securitydefault
high 32legacy 31
set management module authenticationlogging timeout 32
set management module CLI inactivitytimeout 33
set management module maximumLDAP sessions for user 36
set management module maximumnumber of login failures 35
set management module minimumnumber of different characters forpassword 34
set management module passwordexpiration time 37
set management module passwordminimum change interval 37
set management module password reusecycle 38
set management module userauthentication method 33
set management module web interfaceinactivity timeout 38
set maximum number of simultaneoussessions for user 388
set media tray owner 239set name
blade server 111management module 111
set NAT external port numberI/O module 243
set NAT internal port numberI/O module 243
set NAT protocol IDI/O module 242
set NAT protocol nameI/O module 242
set NTP server hostnamemanagement module 245
set NTP server IP addressmanagement module 245
set NTP server keymanagement module 246
set NTP update frequencymanagement module 246
set number of sessionssecure TCP command mode 352TCP command mode 352
set partition mode to partitionscalable complex 296
set partition mode to stand alonescalable complex 295
set physical uplink failover delayadvanced management module 373management module (advanced) 373
set port speedswitch 270
set power capping for blade server 154set power domain redundancy loss
policy 151set power polling interval 152set privacy password (SNMPv3) 390set Remote Presence port number
management module 257set reset blase server key sequence
SOL 333set retry count
SOL 329set retry interval 51
SOL 328set retry limit
remote alerts 52set retry number 51
remote alerts 51set SAS controller IP address (IPv4)
I/O module 199set second LDAP server host name
management module 212set second LDAP server IP address
management module 212set second LDAP server port number
management module 213set secure TCP command mode port
numbermanagement module 260
set send thresholdSOL 329
set serial port baud ratemanagement module 253
set serial port communication ratemanagement module 253
set serial port paritymanagement module 253
set serial port stop bitsmanagement module 254
set server host namemanagement module 309
set server IP addressmanagement module 309
set SLP address typemanagement module 307
set SLP multicast addressmanagement module 307
set SLP port numbermanagement module 258
set SMASH Telnet port numbermanagement module 258
set SMTP e-mail server domain namemanagement module 310
set SNMP agent port numbermanagement module 259
512 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
set SNMP community 1 first host namemanagement module 314
set SNMP community 1 first host name-get
management module 316set SNMP community 1 first host name
to setmanagement module 315
set SNMP community 1 IP address (firsthost)
management module 314set SNMP community 1 IP address (first
host) to getmanagement module 316
set SNMP community 1 IP address (firsthost) to set
management module 315set SNMP community 1 IP address
(second host)management module 317
set SNMP community 1 IP address (thirdhost)
management module 318set SNMP community 1 name
management module 313set SNMP community 1 second host
namemanagement module 317
set SNMP community 1 third host namemanagement module 318
set SNMP community 1 view type(SNMPv3)
management module 318set SNMP community 2 first host name
management module 319set SNMP community 2 IP address (first
host)management module 319
set SNMP community 2 IP address(second host)
management module 320set SNMP community 2 IP address (third
host)management module 321
set SNMP community 2 namemanagement module 319
set SNMP community 2 second hostname
management module 320set SNMP community 2 third host name
management module 321set SNMP community 2 view type
(SNMPv3)management module 321
set SNMP community 3 first host namemanagement module 322
set SNMP community 3 IP address (firsthost)
management module 322set SNMP community 3 IP address
(second host)management module 323
set SNMP community 3 IP address (thirdhost)
management module 324set SNMP community 3 name
management module 322
set SNMP community 3 second hostname
management module 323set SNMP community 3 third host name
management module 324set SNMP community 3 view type
(SNMPv3)management module 324
set SNMP contact namemanagement module 325
set SNMP locationmanagement module 326
set SNMP traps port numbermanagement module 259
set SSH port numbermanagement module 260
set state for KVM portmanagement module 262
set static IP address (IPv4)blade server ISMP 191
set subnet mask (IPv4)I/O module 196RAID controller 200SAS system 200
set syslog event log collector 1 host namemanagement module 348
set syslog event log collector 1 IP addressmanagement module 348
set syslog event log collector 1 portnumber
management module 349set syslog event log collector 2 host name
management module 348set syslog event log collector 2 IP address
management module 348set syslog event log collector 2 port
numbermanagement module 349
set syslog filter levelmanagement module 347
set TCP command mode port numbermanagement module 260
set TCP command-mode timeoutmanagement module 268
set Telnet port numbermanagement module 261
set Telnet port timeoutmanagement module 268
set telnet timeoutmanagement module 354
set TFTP port numbermanagement module 261
set third LDAP server host namemanagement module 212
set third LDAP server IP addressmanagement module 212
set third LDAP server port numbermanagement module 214
set trespass feature messagemanagement module 356
set trespass feature to defaultmanagement module 357
set user access type (SNMPv3) 390set user authentication protocol
(SNMPv3) 389set user authority level 386set user context name (SNMPv3) 388
set user hostname (SNMPv3 traps) 391set user IP address (SNMPv3 traps) 391set user name 383set user password 384set user privacy protocol (SNMPv3) 389set VLAN ID
BladeCenter unit 192shutdown
blade server 273, 306options
f 306shutdown command errors 455shutdown commands 306
example 306simultaneous sessions
set maximum number for user 388slp 307
optionsi 307t 307
SLPenable for management module 263
SLP address typeset for management module 307
slp command 307example 307
slp command errors 455SLP multicast address
set for management module 307SLP port number
set for management module 258SLP settings
display for management module 307SMASH (secure) over SSH
enable for management module 264SMASH CLP
enabling 19SMASH over Telnet
enable for management module 264SMASH SSH server
disable for management module 336enable for management module 336
SMASH Telnet port numberset for management module 258
smtp 309options
d 310s 309
smtp command errors 455smtp commands 309
example 310SMTP e-mail server domain name
set for management module 310SMTP server host name
display for management module 309SMTP server IP address
display for management module 309SMTP settings for management module
commandsexample 310
snmp 312options
-ca1 get -c1i1 0.0.0.0 316-ca1 set -c1i1 0.0.0.0 315a, on 312a3, on 312c1 313
Index 513
snmp (continued)options (continued)
c1i1 314c1i2 317c1i3 318c2 319c2i1 319c2i2 320c2i3 321c3 322c3i1 322c3i2 323c3i3 324ca1 318ca2 321ca3 324cn 325l 326t, on 312
SNMP agentenable for management module
(SNMPv1)SNMPv1 312
enable for management module(SNMPv3)
SNMPv3 312SNMP agent port number
set for management module 259snmp command errors 456snmp commands 312
example 326SNMP community 1 first host name
set for management module 314set to get for management
module 316SNMP community 1 first host name to
setset for management module 315
SNMP community 1 IP address (firsthost)
set for management module 314SNMP community 1 IP address (first
host) to getset to get for management
module 316SNMP community 1 IP address (first
host) to setset for management module 315
SNMP community 1 IP address (secondhost)
set for management module 317SNMP community 1 IP address (third
host)set for management module 318
SNMP community 1 nameset for management module 313
SNMP community 1 second host nameset for management module 317
SNMP community 1 third host nameset for management module 318
SNMP community 1 view typeset for management module
(SNMPv3) 318SNMP community 2 first host name
set for management module 319
SNMP community 2 IP address (firsthost)
set for management module 319SNMP community 2 IP address (second
host)set for management module 320
SNMP community 2 IP address (thirdhost)
set for management module 321SNMP community 2 name
set for management module 319SNMP community 2 second host name
set for management module 320SNMP community 2 third host name
set for management module 321SNMP community 2 view type
set for management module(SNMPv3) 321
SNMP community 3 first host nameset for management module 322
SNMP community 3 IP address (firsthost)
set for management module 322SNMP community 3 IP address (second
host)set for management module 323
SNMP community 3 IP address (thirdhost)
set for management module 324SNMP community 3 name
set for management module 322SNMP community 3 second host name
set for management module 323SNMP community 3 third host name
set for management module 324SNMP community 3 view type
set for management module(SNMPv3) 324
SNMP configurationdisplay for management module 312
SNMP contact nameset for management module 325
SNMP locationset for management module 326
SNMP settings for management modulecommands
example 326SNMP traps
disable for management module 312enable for management module 265,
312SNMP traps port number
set for management module 259SNMPv1
enable for management module 359SNMPv1 agent
enable for management module 264SNMPv3
community 1 view type 318community 2 view type 321community 3 view type 324enable for management module 359privacy password 390trap receiver IP address or
hostname 391user access type 390user authentication protocol 389
SNMPv3 (continued)user context name 388user privacy protocol 389
SNMPv3 agentenable for management module 265
software service and support telephonenumbers 476
sol 328options
c 329e 332i 328r 333s 329status 330, 331t 330
SOL 22, 23, 115global disable 331global enable 330set accumulate timeout 330set CLI key sequence 332set reset blase server key
sequence 333set retry count 329set retry interval 328set send threshold 329status 328
sol command errors 457sol commands
example 333SOL commands 328SOL session
ending 23, 115starting 22
Specify IP addressCIN configuration entry 99
Specify VLAN IDCIN configuration 100
SRC recorddisplay specific for blade server 124
SRC recordsdisplay all for blade server 124
SSHdisabling 19
SSH clients 14SSH connection 18SSH port
enable for management module 265SSH port number
set for management module 260SSH public key add 392SSH public key add (specific) 392SSH public key comment 398SSH public key connection 397SSH public key display 391SSH public key download 396SSH public key remove 393SSH public key replace 395SSH public key upload 394SSH status
display for management module 335sshcfg 335
optionscstatus 336hk, dsa 335hk, gen 335hk, rsa 335
514 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
sshcfg (continued)options (continued)
sstatus 336sshcfg command 335
example 336sshcfg command errors 458SSL
disable for LDAP client 338enable for LDAP client 338
SSL certificate (additional)disable for standby management
module 337enable for standby management
module 337SSL certificate status
management module 337SSL CSR
download certificate file 342import certificate file 343upload certificate file 343
SSL for LDAP clientdisable 338enable 338
SSL for management module web serverdisable 337enable 337
SSL for web serverdisable for management module 337enable for management module 337
SSL self-signed certificatedownload certificate file 342import certificate file 343upload certificate file 343
SSL statusmanagement module 337
SSL trusted certificate 1 344download 344import 344remove 344upload 344
SSL trusted certificate 2 345download 345import 345remove 345upload 345
SSL trusted certificate 3 346download 346import 346remove 346upload 346
sslcfg 337options
ac 337c 339, 341cert 339cl 339, 341client 338cp 339, 341cpwd 341csr 341dnld 342dq 339, 341ea 339, 341gn 339, 341hn 339, 341i 342, 343, 344, 345, 346in 339, 341
sslcfg (continued)options (continued)
l 342, 343, 344, 345, 346on 339, 341ou 339, 341s 339, 341server 337sp 339, 341tc1 344tc2 345tc3 346un 341upld 343
sslcfg command errors 459sslcfg commands 337
example 346stand-alone partition
create for scalable complex 293stand-alone partition (automatic)
create for scalable complex 292standby management module
disable additional SSL certificate 337enable additional SSL certificate 337set Ethernet channel 0 hostname 176set Ethernet channel 0 MAC
address 178set Ethernet channel 0 static IP
address (IPv4) 173set Ethernet channel 0 static IP
address (IPv6) 174set IP address (IPv4) 173set IP address (IPv6) 174
standby management modules 7starting a session using SSH 18starting a session using Telnet 16starting an SOL session 22starting command-line interface 14static IP address (IPv4)
set for blade server ISMP 191set for channel 0 of management
module 173set for channel 0 of standby
management module 173set for channel 1 of management
module 181set for channel of blade server 185
static IP address (IPv6)set for channel 0 of management
module 173set for channel 0 of standby
management module 174set for channel of blade server 186
static IPv6 configurationdisable for I/O module 197disable for management module 179enable for I/O module 197enable for management module 179
statusdisplay for management module 124SOL 328
stop bitsset for serial port of management
module 254storage expansion unit
command target 133storage module
command target 135
subnet mask (IPv4)set for channel 0 of management
module 175set for channel 1 of management
module 182set for channel of blade server 187set for I/O module 196set for RAID controller 200set for SAS system 200
switchdisplay network port settings 269enable port 269set port speed 270
switch modulecommand target 134cycle power 273display POST status 276display power state 273power off 272, 273power on 272, 273reset 286reset (extended diagnostics) 288reset (full diagnostics) 288reset (standard diagnostics) 287reset configuration 103turn off 272, 273turn on 272, 273
synchronize clock with NTP servermanagement module 247
syntax help 166syntax help commands
example 166syslog 347
optionscoll1 347coll2 348i1 348i2 348p1 349p2 349sev 347test 350
syslog command errors 461syslog commands 347
example 350syslog configuration
display for management module 347syslog event log collector 1 host name
set for management module 348syslog event log collector 1 IP address
set for management module 348syslog event log collector 1 port number
set for management module 349syslog event log collector 2 host name
set for management module 348syslog event log collector 2 IP address
set for management module 348syslog event log collector 2 port number
set for management module 349syslog event log transmission for collector
1disable 347disable for management module 347enable 347enable for management module 347
Index 515
syslog event log transmission for collector2
disable 348disable for management module 348enable 348enable for management module 348
syslog filter levelset for management module 347
syslog test messagegenerate for management
module 350system
view configuration tree 225system management command 29system physical configuration
command 225system power management policy
command 251system, display power trending 151, 152
TTaiwan Class A compliance
statement 485target 25, 131TCP command mode
disable 351enable 352enable for management module 266,
360set number of sessions 352turn TCP command mode on or off
for the management module 266,360
TCP command mode port numberset for management module 260
TCP command-mode session statusdisplay 351
TCP command-mode session timeoutdisplay 351set 351
TCP command-mode timeoutset for management module 268
tcpcmdmode 351options
status, 0 351, 352status, 1 to 20 352t 351
tcpcmdmode command errors 462tcpcmdmode commands 351
example 353technician debug
disable for management module 304enable for management module 304
Telco environment 153telnet configuration
display for management module 354telnet configuration commands 354Telnet connection 14, 16Telnet port
enable for management module 267Telnet port number
set for management module 261Telnet port timeout
set for management module 268telnet timeout
set for management module 354
telnetcfg 354options
t 354telnetcfg command errors 462telnetcfg commands 354
example 354temperature
display for blade server 355display for management module 355display for media tray 355
temperature display, blower 149temperature display, media tray 149temporary command target 7temps 355temps command errors 463temps commands 355
example 355terminate 377terminate session 143terminate user session
management module 377test alert
generate 58test call home
call-home 96test communication
I/O-module IP address 249IP address 248IP address (I/O-module) 249
TFTPenable for management module 267
TFTP port numberset for management module 261
thermal event response 153thermal trending, display (blower) 152thermal trending, display (media
tray) 152thres command errors 463time
display for management module 106set for management module 106
trademarks 480trespass 356
optionstw 356twd 357twe 356
trespass command 356example 357
trespass command errors 463trespass feature
enable for management module 356trespass feature default
set for management module 357trespass feature message
set for management module 356trespass feature status
display for management module 356trusted certificate 1 (SSL)
download 344import 344remove 344upload 344
trusted certificate 2 (SSL)download 345import 345remove 345
trusted certificate 2 (SSL) (continued)upload 345
trusted certificate 3 (SSL)download 346import 346remove 346upload 346
turn all CIN index entries on or off 98turn off
alarm panel module 272blade server 272, 273I/O module 272network clock module 272switch module 272, 273
turn off LEDinformation 221
turn off location LED 169, 222turn on
alarm panel module 272blade server 272, 273I/O module 272, 273network clock module 272switch module 272, 273
turn on (to console)blade server 272, 273
turn secure TCP command mode on oroff
management module 267, 361turn TCP command mode on or off
management module 266, 360
Uuicfg 359
optionscli, enabled 359snmp, enabled 359stcm, enabled 360stcm, port mode 361tcm, enabled 360tcm, port mode 360web, enabled 361
uicfg command errors 464uicfg commands 359
example 361unacknowledge call-home activity log
entrymanagement module 94
United States electronic emission Class Anotice 482
United States FCC Class A notice 482unlock user 380unmount volume
advanced management module 278update
optionsa 363activate 366i, l 368i, l, img 369, 370i, l, img, activate 370, 371i, n 368u 364u, img 365, 366u, img, activate 367u, r 364u, v 365
516 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
update command 363update command errors 465update commands
example 371update firmware 363, 364, 368
I/O module 365, 366, 367, 369, 370,371
switch 365, 366, 367, 369, 370, 371verbose 366, 370
update firmware (verbose) 365, 368update firmware build ID in firmware
build ID listblade server 83
update firmware build revision infirmware build ID list
blade server 84update firmware type in firmware build
ID listblade server 83
update machine type in firmware buildID list
blade server 82update manufacturer in firmware build
ID listblade server 82
uplink 373options
alert 375dls 374dps 373el, enabled 374ep, enabled 373ip 374ip6 375
uplink command errors 467uplink commands 373
example 375uplink configuration
display for management module 373uplink failover (logical)
disable for advanced managementmodule 374
disable for management module(advanced) 374
enable for advanced managementmodule 374
enable for management module(advanced) 374
uplink failover (physical)enable for advanced management
module 373enable for management module
(advanced) 373uplink failover delay (logical)
set for advanced managementmodule 374
set for management module(advanced) 374
uplink failover delay (physical)set for advanced management
module 373set for management module
(advanced) 373uplink failover IP address (logical)
set for advanced managementmodule 374
uplink failover IP address (logical)(continued)
set for management module(advanced) 374
uplink failover IPv6 IP address (logical)set for advanced management
module 375set for management module
(advanced) 375upload 344, 345, 346upload certificate file
SSL CSR 343SSL self-signed certificate 343
upload SSH public key 394user authentication method
enable complex password 33set for management module 33
user interface configuration 359example 361
user interface settingsdisplay for management module 359
user session 377users 377
options1 through 12 378a 386ap 389at 390clear 378cn 388create (n, p, a, cn, ap, pp, ppw, at,
i) 381curr 377disable 379enable 379i 391ms 388n 383op 385p 384pk, add 392pk, af 397pk, cm 398pk, dnld 396pk, e 391pk, remove 393pk, upld 394, 395pp 389ppw 390ts 377unlock 380
users command 377users command errors 468users commands
example 398users, change password 385users, create 381users, delete 378users, disable 379users, display (active) 377users, display (all) 377users, display (single) 378users, enable 379users, management module 377users, set access type (SNMPv3) 390users, set authentication protocol
(SNMPv3) 389
users, set authority level 386users, set context name (SNMPv3) 388users, set hostname (SNMPv3 traps) 391users, set IP address (SNMPv3
traps) 391users, set maximum number of
simultaneous sessions 388users, set name 383users, set password 384users, set privacy password
(SNMPv3) 390users, set privacy protocol
(SNMPv3) 389users, unlock 380using
Secure Shell server 18using the command-line interface 5
VV3 authentication for NTP
enable for management module 246view command target 225VLAN ID
CIN configuration 100disable for blade server Ethernet
channel 189disable for BladeCenter unit 192enable for blade server Ethernet
channel 189enable for BladeCenter unit 192set for BladeCenter unit 192set for channel of blade server 188
voltagedisplay for blade server 400display for management module 400
volts 400volts command errors 472volts commands 400
example 400volume information
display for management module 278
WWake on LAN
enable for blade server 274enable globally 274
warning alertsdisable monitoring for all 232disable monitoring for blade
device 232disable monitoring for chassis 233disable monitoring for cooling
device 234disable monitoring for event log 233disable monitoring for I/O
module 232disable monitoring for power
module 234disable monitoring for storage
module 233disable monitoring for system
management 233enable monitoring for all 232
Index 517
warning alerts (continued)enable monitoring for blade
device 232enable monitoring for chassis 233enable monitoring for cooling
device 234enable monitoring for event log 233enable monitoring for I/O
module 232enable monitoring for power
module 234enable monitoring for storage
module 233enable monitoring for system
management 233web interface
enable for management module 361web interface inactivity timeout
set for management module 38WNN information reload 204write
optionsconfig 401config, l ,i 401, 402
write command 401example 402
write command errors 472
Zzonecfg 403
optionsactivate 403view 404
zonecfg command errors 473zonecfg commands 403
example 404
518 IBM BladeCenter Advanced Management Module: Command-Line Interface Reference Guide
����
Part Number: 16Y6037
Printed in USA
(1P) P/N: 16Y6037