HP AlphaServer ES47 User manual

AlphaServer ES47/ES80/GS1280
Server Management
Command Line Interface
CLI Reference
Version 3.0
October 2003
This document describes the Server Mangagement Command Line Interface
(CLI) to hp AlphaServer ES47/ES80/GS1280 systems.
The CLI provides access to the whole platform at the most fundamental level.
You can display information, such as the system configuration, cabling, and
environmental component status. You can update the firmware and power the
system or a hard partition on or off, as well as halt and reset. You can create
and delete partitions.
The CLI also provides one of the two ways you can access the SRM console or
operating system running within the system or a partition.

October 2003
© 2003 Hewlett-Packard Company.
HP shall not be liable for technical or editorial errors or omissions contained herein. The information in this document
is provided “as is” without warranty of any kind and is subject to change without notice. The warranties for HP
products are set forth in the express limited warranty statements accompanying such products. Nothing herein should
be construed as constituting an additional warranty.
Regulatory Notices for Series ET2003
FCC Notice
Part 15 of the Federal Communications Commission (FCC) Rules and Regulations has established Radio Frequency
(RF) emission limits to provide an interference-free radio frequency spectrum. Many electronic devices, including
computers, generate RF energy incidental to their intended function and are, therefore, covered by these rules. These
rules place computers and related peripheral devices into two classes, A and B, depending upon their intended
installation. Class A devices are those that may reasonably be expected to be installed in a business or commercial
environment. Class B devices are those that may reasonably be expected to be installed in a residential environment
(i.e., personal computers). The FCC requires devices in both classes to bear a label indicating the interference potential
of the device as well as additional operating instructions for the user. The rating label on the device shows which class
(A or B) the equipment falls into. Class B devices have an FCC ID on the label. Class A devices do not have an FCC
ID on the label. Once the class of the device is determined, refer to the following corresponding statement.
Class A Equipment
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of
the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the
equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case
the user will be required to correct the interference at personal expense.
Class B Equipment
This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of
the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential
installation. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in
accordance with the instructions, may cause harmful interference to radio communications. However, there is no
guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference
to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to
try to correct the interference by one or more of the following measures:
•Reorient or relocate the receiving antenna.
•Increase the separation between the equipment and receiver.
•Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
•Consult the dealer or an experienced radio or television technician for help.
Modifications
The FCC requires the user to be notified that any changes or modifications made to this device that are not expressly
approved by Hewlett-Packard Company may void the user's authority to operate the equipment.
Cables
Connections to this device must be made with shielded cables with metallic RFI/EMI connector hoods in order to
maintain compliance with FCC rules and regulations.
Declaration of Conformity for products marked with the FCC logo – United States only
This device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This
device may not cause harmful interference, and (2) this device must accept any interference received, including
interference that may cause undesired operation.

Taiwanese Notice
Japanese Notice
Canadian Notice (Avis Canadien)
Class A Equipment
This Class A digital apparatus meets all requirements of the Canadian Interference-Causing
Equipment Regulations. Cet appareil numérique de la classe A respecte toutes les exigences du Règlement sur le matériel brouilleur
du Canada.
Class B Equipment
This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations.Cet
appareil numérique de la classe B respecte toutes les exigences du Règlement
sur le matériel brouilleur du Canada.
European Union Notice
Products with the CE marking comply with the EMC Directive (89/336/EEC) and the Low Voltage
Directive (73/23/EEC) issued by the Commission of the European Community and if this product has
telecommunication functionality, the R&TTE Directive (1999/5/EC).
Compliance with these directives implies conformity to the following European Norms (in parentheses
are the equivalent international standards and regulations):
• EN55022 (CISPR 22) – Electromagnetic Interference
• EN55024 (IEC61000-4-2, 3, 4, 5, 6, 8, 11) – Electromagnetic Immunity
• EN61000-3-2 (IEC61000-3-2) – Power Line Harmonics
• EN61000-3-3 (IEC61000-3-3) – Power Line Flicker
• EN60950 (IEC60950) – Product Safety

Contents
Contents
Chapter 1 How to Access the Server Management CLI......................................................1-1
1.1 Access the CLI from the SPM ......................................................................................... 1-1
1.1.1 From the SPM "Actions" Menu Item.......................................................................1-1
1.1.2 From the SPM Tree View........................................................................................1-2
1.1.3 From the SPM Platform View .................................................................................1-3
1.2 Access the CLI from the AMU.........................................................................................1-4
1.3 Access the CLI from a PC Telnet session.......................................................................1-4
1.4 Access the CLI from the MBM Backplane....................................................................... 1-5
1.5 Accessing the Server Management CLI from the SRM Console....................................1-7
Chapter 2 Command Line Interface......................................................................................2-1
2.1 Component Addressing...................................................................................................2-1
2.2 Environment Variables ....................................................................................................2-1
2.3 Partition Naming and Addressing....................................................................................2-3
2.4 Conventions.....................................................................................................................2-4
2.5 Command Names and Qualifiers .................................................................................... 2-4
2.6 Editing..............................................................................................................................2-5
2.7 Online Help......................................................................................................................2-6
2.8 MBM Failsafe Loader ......................................................................................................2-7
2.8.1 Configuration & Booting Images.............................................................................2-7
2.8.2 Updating Firmware Images.....................................................................................2-8
2.8.3 Getting Help............................................................................................................2-8
2.9 CLI Output Messages......................................................................................................2-9
Chapter 3 Commands ............................................................................................................3-1
3.1 Command Summary........................................................................................................3-1
3.2 assign component ...........................................................................................................3-3
3.3 assign memory ................................................................................................................3-5
3.4 bootline............................................................................................................................3-7
3.5 build fru............................................................................................................................3-8
3.6 clear...............................................................................................................................3-12
3.7 clear alert.......................................................................................................................3-13
3.8 clear display...................................................................................................................3-14
3.9 clear error ......................................................................................................................3-15
3.10 clear log.........................................................................................................................3-17
3.11 clear port........................................................................................................................3-18
3.12 clear srmenv..................................................................................................................3-19
3.13 config cables..................................................................................................................3-20
3.14 connect..........................................................................................................................3-22
3.15 create partition...............................................................................................................3-24
3.16 delete partition...............................................................................................................3-26
3.17 deposit or d....................................................................................................................3-28
3.18 disable alert ...................................................................................................................3-30
3.19 disable remote...............................................................................................................3-31
3.20 disable test.....................................................................................................................3-32
3.21 el....................................................................................................................................3-33
iii

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
3.22 enable alert....................................................................................................................3-34
3.23 enable remote................................................................................................................3-35
3.24 enable test.....................................................................................................................3-35
3.25 examine or e..................................................................................................................3-37
3.26 halt in.............................................................................................................................3-39
3.27 halt out...........................................................................................................................3-41
3.28 hangup...........................................................................................................................3-43
3.29 help................................................................................................................................3-44
3.30 init modem.....................................................................................................................3-46
3.31 locate.............................................................................................................................3-47
3.32 logout.............................................................................................................................3-48
3.33 mbmboot or @...............................................................................................................3-49
3.34 modify partition .............................................................................................................. 3-51
3.35 power off........................................................................................................................3-52
3.36 power on........................................................................................................................3-54
3.37 reset...............................................................................................................................3-59
3.38 save partition .................................................................................................................3-63
3.39 set..................................................................................................................................3-64
3.40 set alert..........................................................................................................................3-65
3.41 set baud.........................................................................................................................3-66
3.42 set dial ...........................................................................................................................3-67
3.43 set escape .....................................................................................................................3-68
3.44 set flow...........................................................................................................................3-69
3.45 set init ............................................................................................................................3-70
3.46 set membership.............................................................................................................3-71
3.47 set password..................................................................................................................3-73
3.48 set sys_serial_num........................................................................................................3-74
3.49 set time..........................................................................................................................3-75
3.50 shell ...............................................................................................................................3-76
3.51 show ..............................................................................................................................3-77
3.52 show cables...................................................................................................................3-78
3.53 show duo .......................................................................................................................3-80
3.54 show error......................................................................................................................3-84
3.55 show fru.........................................................................................................................3-88
3.56 show grid .......................................................................................................................3-92
3.57 show log.........................................................................................................................3-93
3.58 show membership .........................................................................................................3-98
3.59 show memory ................................................................................................................ 3-99
3.60 show modem ............................................................................................................... 3-101
3.61 show network...............................................................................................................3-102
3.62 show partition ..............................................................................................................3-103
3.63 show power..................................................................................................................3-106
3.64 show sys_serial_num..................................................................................................3-110
3.65 show system................................................................................................................3-111
3.66 show time.....................................................................................................................3-113
3.67 show version................................................................................................................3-114
3.68 telnet............................................................................................................................3-117
3.69 test...............................................................................................................................3-119
3.70 test alert.......................................................................................................................3-121
3.71 test led.........................................................................................................................3-122
3.72 update..........................................................................................................................3-123
3.73 uptime..........................................................................................................................3-126
Index .........................................................................................................................Index-1
iv

How to Access the Server Management CLI
Chapter 1
How to Access the Server Management CLI
1.1 Access the CLI from the SPM
If your site has an AlphaServer Management Station (AMS) running the Server Platform
Management (SPM) software, and you have administrator or operator access to it, you can use
the SPM window to telnet into the Server Management CLI of a particular platform. You can do
this in three different ways:
1.1.1 From the SPM "Actions" Menu Item
Once you have logged in to the SPM as a valid user, you can left-click on a platform in either the
tree view or the right-hand view. Once you select a platform, you can left-click on the "Actions"
menu item to telnet to the Server Management CLI of the platform you selected.
1-1

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
1.1.2 From the SPM Tree View
Once you have logged in as a valid SPM user, you can directly right-click on a platform in the tree
view to display a pulldown menu from which you can telnet to the Server Management CLI for
that system.
1-2

How to Access the Server Management CLI
1.1.3 From the SPM Platform View
From the right pane of the SPM window, you can right-click on a platform to display a pulldown
menu that allows you to telnet to the Server Management CLI of that particular platform.
1-3

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
1.2 Access the CLI from the AMU
You can access the Server Management CLI interface from the AlphaServer Management Utility
interface as follows:
1. Click on the "Platform" icon in the tree view. (Remember that the AMU is only attached
to a single platform at a time.)
2. Pull down the "Actions" menu and select "Open Telnet" from the options available, as
shown below.
1.3 Access the CLI from a PC Telnet session
You can access the Server Management CLI from a PC attached to the Corporate LAN or the
Multi-Server LAN by installing KEAterm or similar software on the PC.
Instructions for installing this software on your PC is given in the ES47/ES80/GS1280 Service
Manual.
1-4

How to Access the Server Management CLI
1.4 Access the CLI from the MBM Backplane
You can attach a serial terminal directly to an MBM backplane to access the Server Management
CLI.
Figure 1-1 shows the serial connector for the MBM backplane on an 8P drawer.
Figure 1-1 8-P Drawer MBM Backplane Serial Connector
1-5

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
Figure 1-2 shows the serial connector for the MBM backplane on a 2P drawer.
Figure 1-2 2-P Drawer MBM Backplane Connector
1-6

How to Access the Server Management CLI
1.5 Accessing the Server Management CLI from the SRM
Console
If you have accessed the SRM console or operating system for a platform (or for a partition or
subpartition within a platform), you can access the Server Management CLI for the platform by
entering the escape sequence <Esc><Esc>MBM.
1-7

Command Line Interface
Chapter 2
Command Line Interface
The server management command line interface (CLI) performs these tasks for the ES80 and
GS1280 servers:
•Displays system configuration information
•Updates firmware
•Powers on and off, halts, and resets the system or partition
•Provides system partitioning and cabling functions
•Shows the status of fans and power supplies, as well as temperatures
•Implements remote server management
•Connects to the virtual SRM console
Typically the CLI is used on smaller systems that do not use the graphical AlphaServer
Management Utility (AMU).
2.1 Component Addressing
Each component is addressed by its cabinet and drawer thumbwheel in hex. The qualifiers -
cabinet and -drawer are used throughout the server management CLI. For some commands, a
CPU can be specified by its mesh coordinates, -ew and -ns.
Type Address Note
8P drawer -cabinet <cabinet> -drawer <drawer> SBB cabinet = 0–7, drawer = 0–3
MBM -cabinet <cabinet> -drawer<drawer> MBM cabinet = 0–7, drawer = 0–3
DUO -cabinet <cabinet> -drawer<drawer> DUOnn = 0–3 in the 8P drawer
CMM -cabinet <cabinet> -drawer<drawer> CMMnn = 0–3 in the 8P drawer
CPU -cabinet <cabinet> -drawer<drawer> CPUnn = 0–7 in the 8P drawer
CPU -ew <ew_coord> -ns <ns_coord> CPU by mesh coordinate (ew, ns)
IOP -cabinet <cabinet> -drawer <drawer> IOPnn = 0–7 in the 8P drawer; for IO cabling
PCI drawer -cabinet <cabinet> -drawer <drawer> PCI cabinet = 0–F, drawer = 0–F
PBM -cabinet <cabinet> -drawer <drawer> PBM cabinet = 0–F, drawer = 0–F
IOR -cabinet <cabinet> -drawer <drawer> IORnn = 0–3 in the PCI drawer
2.2 Environment Variables
Server management environment variables are settings in the MBM, PBM, and CMM that tailor
their behaviors. They are analogous to SRM environment variables.
All SM variables are global and stored in the flash. The names are case insensitive ASCII strings
with maximum length of 32 characters including NULL. If the variable type is integer, please
specify the value in hex.
The command “show *” lists all variables, as shown in Example 2-1.
2-1

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
Example 2-1 The “show *” Command Lists All Environment Variables
MBM> show *
cpu_enabled FFFFFFF
diag_mask 0
diag_min_flag off
esc_sequence ^[^[MBM
halt_on_error on
mfg_mode off
ocp_text GS1280
srm_auto_connect off
MBM>
The table below lists environment variables.
Table 2-1 Environment Variables
SM Environment
Variable Name Type or
Range
Default
Value Actions Description
cpu_enabled 128-bit
int 32 F's Modify symbol cpu_enabled Bit mask of cpus to configure into the partition
diag_mask 96-bit
int 24 F's Modify symbol diag_maskSelective tests to be run
diag_min_flag Bool
On or
off
Off Modify symbol
min_diag_flag and
diag_mask
When non-zero, only a
minimal set of diagnostics is
run. Remember, this is
required for semi-hard
partitions.
esc_sequence String
(15
chars)
^[^[MBM Modify symbol
mbm_escape_string A sequence to go back to MBM>
halt_on_error String
On or
off
On Modify symbol
halt_on_error On - any failure in starting a partition halts the startup
attempt and returns to the
prompt.
Off - the server manager
automatically maps out the
failing components and retries
starting the now degraded
partition.
mfg_mode String
On or
off
Off Modify symbols
envmon_shutdownEnable
envmon_intrusionEnable
envmon_overtempEnable
On – under this mode, the
system will never be turned
off regardless of any
environmental events. Also
assume all covers are closed.
ocp_text String
(20
chars)
product
name Modify the new string to OCP. Text (usually system name) to be displayed on all drawer
OCPs.
part_force_striping Bool Off Modify force_striping On - All partitions are treated
2-2

Command Line Interface
on or
off as striped.
Off - The striping attributed
indicated from partition
creation is used. The
Default_HP is created non-
striped, so the force_striping
variable is handy to make that
partition behave as a striped
partition.
srm_auto_connect Bool
on or
off
Off Modify symbol
cli_autoconnect On - the output from the SRM/OS automatically is
directed to the MBM session.
At the end of the diagnostic
tests, the MBM does a
connect command
automatically.
Off – Stay at the CLI after
system powers up
2.3 Partition Naming and Addressing
A key attribute of the ES80/GS1280 server is its ability to be divided into partitions, each of which
appears to be a separate computer. A partition contains CPU, memory, and I/O resources.
These servers can be:
•Hard partitioned, with no routing traffic between CPUs.
•Soft partitioned, with routing between all CPUs. All memory access is allowed, and
protection is accomplished through software.
The server management is responsible for creating, configuring, testing, saving, and deleting
partitions.
The partition name is limited to a maximum of 19 characters and restricted to alphanumeric,
underscore, and dash characters. Free_Pool is a reserved name for indicating the partition's pool
of resources that any partition can allocate. It is legal to have the same subpartition name as the
hard partition or to have the same subpartition names under different hard partitions.
A partition must be addressed by name in the format -hp <hard_partition_name> -sp
<sub_partition_name>.
2-3

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
2.4 Conventions
Convention Meaning
Fixed-
font Examples are shown in a fixed-width font for clarity and to preserve
alignment of output, as they would appear on the console terminal device.
Italic Italic type is used to express emphasis.
Bold Command and option keywords embedded in narrative text sections are
presented in bold type.
<item> In command syntax descriptions, angle brackets indicate a placeholder for an
item that the user must specify.
[item] In command syntax descriptions, square brackets enclose optional
parameters, qualifiers, or values.
{a, b, c} In command syntax descriptions, braces containing items separated by
commas imply mutually exclusive items. "{a, b, c}" indicates that you can
choose from a, b, or c.
{a | b | c} In command syntax descriptions, braces containing items separated by
vertical bars imply combinatorial items. "{a | b | c}" indicates that you can
choose any combination of a, b, and c.
2.5 Command Names and Qualifiers
The server management CLI interface is case insensitive.
Command names consist of a command verb and, in some cases, a keyword. Each command
verb and keyword might have an abbreviation, which is determined by the CLI parser. For
example, the minimum match for show system is sh sys. If a user continues typing more than
the minimum, the optional characters must match the full name. This means that sh syst will
work, but sh sysa will not. The optional characters are displayed in square brackets ([ ]) under
the command name in the online help.
The character -introduces a qualifier. Qualifiers may be single characters ("flags") or multiple
characters. The exact match has the highest precedence. A multiple character qualifier can be
abbreviated as long as its partial match is unique within the command. For instance, -c is
sufficient for the qualifier -cabinet if the command has no other qualifiers starting with the letter
“c."
2-4

Command Line Interface
2.6 Editing
The following keys can be used in editing Server Management CLI commands:
Key Function
Backspace Delete the character; the cursor moves to the left
Delete Delete the character; the cursor stays at its position
Down arrow Get next command
End key Moves the cursor to the end of the command line
Home key Moves the cursor to the beginning of the command line
Insert key Toggles to select "Insert" or "Overwrite" mode
Left arrow Move the cursor to the left within the command line
Page Up Reserved for future use
Page Down Reserved for future use
Right arrow Moves the cursor to the right within the command line
Ctrl A Toggle to select "insert" or "overwrite" mode
Ctrl B Recall the previous line
Ctrl C Abort the command
Ctrl D Cancel the current line
Ctrl E Move the cursor to the end of the command line
Ctrl F Move the cursor to the right within the command line
Ctrl H Move the cursor to the beginning of the command line
Ctrl R Reprint the command line
Ctrl U Clear the command line
Other rules include:
•Extra spaces are ignored.
•Everything between the "#" character and the end of the line is treated as a comment.
•The previous 16 commands in the current session can be recalled by using the up arrow
and down arrow keys.
•The use of double quotes is supported; everything inside the quotes is treated as-is. This
is helpful for arguments containing spaces or # (comments).
For example:
MBM> build fru CAB0.DRW0.MBM "partnumber" "serialnum" "mbm module"
MBM> sh fru
Fru Name E Part # Serial # Model/Other
CAB0.DRW0.MBM 00 partnumber serialnum mbm module
2-5

AlphaServer ES47/ES80/GS1280 Server Management CLI Reference
•Command abort. If you get tired of a long and complicated command display or action,
type CTRL/C ( ^C). The command is aborted mid-stream.
For example:
MBM> sh fru
Fru Name E Part # Serial # Model/Other
CAB0.DRW0.DOCP 00 nightlyFri_0 Fri_43
CAB0.DRW0.MBM 00 partnumber serialnum mbm module
CAB0.DRW0.DUO0.CMM 10 nightlyFri_2 Fri_45
CAB0.DRW0.DUO0.DUO 00 nightlyFri_3 Fri_46
~CLI-E-(tCLImodem) command aborted by Ctrl-C
MBM>
•Invalid commands are echoed for easy identification.
For example:
MBM> crete
~CLI-E-(tCLImodem) unrecognized command verb: crete
MBM> create prt
~CLI-E-(tCLImodem) unrecognized keyword: prt
Usage: create {partition}
MBM>
2.7 Online Help
The brief help for each command displays the syntax and a one-line description. The synopsis
line lists all possible options and arguments for the command.
By default, issuing the command help displays a list of supported commands, and help * lists all
commands with their descriptions and syntax. You can also specify a particular command for
help. For example:
MBM>help show cable
NAME
sh[ow] cab[le]
FUNCTION
Display the cable configuration.
SYNOPSIS
show cable [-ip | -io]
MBM>
In the name line, the characters in square brackets ([]) are considered optional. As shown above,
the minimum abbreviated form of show cable is sh cab.
2-6