The setboot Command
The setboot command allows you to display and modify boot variables. You can set a variety of parameters with setboot. The following command shows displaying the current settings with setboot -v on an Integrity server:
# setboot -v
Primary bootpath : 0/0/0/3/0.6.0
Alternate bootpath : 0/0/0/0/0.0.0
Autoboot is ON (enabled)
Autosearch is ON (enabled)
Note: The interpretation of Autoboot and Autosearch has changed for
systems that support hardware partitions. Please refer to the manpage.
TEST CURRENT SUPPORTED DEFAULT NEXT BOOT
---- ------- --------- ------- ---------
all off partial partial off
SELFTESTS off yes on off
early_cpu off yes on off
late_cpu off yes on off
FASTBOOT off partial partial off
full_memory off no off off
PDH off yes on off
CEC off no off off
This output shows the values of many parameters that are in stable storage.
Boot Console Handler (BCH) and Processor Dependent Code (PDC)
PA-RISC systems come with firmware installed called
Processor Dependent Code (PDC). After the system is powered on or the
processor is RESET, the PDC runs self-test operations and initializes
the processor. PDC also identifies the console path so that it can
provide messages and accept input. PDC would then begin the “autoboot”
process, unless you interrupt it during the 10-second interval that is
supplied. If you interrupt the “autoboot” process, you can issue a
variety of commands.
The following example
shows resetting a partition at the Command Menu, seeing log files
generated at the VFP, and then switching back to the console to work
with PDC commands:
MP MAIN MENU:
CO: Consoles
VFP: Virtual Front Panel (partition status)
CM: Command Menu
CL: Console Logs
SL: Show Event Logs
HE: Help
X: Exit Connection
[otcapmp] MP> cm <-- Go CM
Enter HE to get a list of available commands
[otcapmp] MP:CM> rs <-- Reset nPartition
This command resets the selected partition.
WARNING: Execution of this command irrecoverably halts all system
processing and I/O activity and restarts the selected
partition.
Part# Name
----- ----
0) Partition 0
1) nPar1cell0
Select a partition number: 1 <-- Select nPartition 1
Do you want to reset partition number 1? (Y/[N]) y
-> The selected partition will be reset.
[otcapmp] MP:CM> ma
V-- Select VFP from main menu to see progress
# Partition state Activity
- --------------- --------
1 Cell(s) Booting: 378 Logs
# Cell state Activity
- ---------- --------
0 Memory discovery MEM_TEST_READ_BARGRAPH 378 Logs
After the “early” boot is
complete, you get a brief system summary, including the firmware
revision on your system, and are then given the option to automatically
boot off the primary path or press any key to stop the boot process.
Under normal system operation, you would autoboot; however, in this
case, we interrupt the boot process to see what commands are available
in the PDC.
As was done earlier, I return to the Main menu and then type IN to get access to the INformation menu and then view all:
Configuration Menu: Enter command > main
---- Main Menu ---------------------------------------------------------------
Command Description
------- -----------
BOot [PRI|HAA|ALT|<path>] Boot from specified path
PAth [PRI|HAA|ALT] [<path>] Display or modify a path
SEArch [ALL|<cell>|<path>] Search for boot devices
ScRoll [ON|OFF] Display or change scrolling capability
COnfiguration menu Displays or sets boot values
INformation menu Displays hardware information
SERvice menu Displays service commands
DIsplay Redisplay the current menu
HElp [<menu>|<command>] Display help for menu or command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
----
Main Menu: Enter command or menu > in
---- Information Menu --------------------------------------------------------
Command Description
------- -----------
ALL [<cell>] Display all of the information
BootINfo Display boot-related information
CAche [<cell>] Display cache information
ChipRevisions [<cell>] Display revisions of major VLSI
ComplexID Display Complex information
FwrVersion [<cell>] Display version for PDC, ICM, and Complex
IO [<cell>] Display I/O interface information
MEmory [<cell>] Display memory information
PRocessor [<cell>] Display processor information
BOot [PRI|HAA|ALT|<path>] Boot from specified path
DIsplay Redisplay the current menu
HElp [<command>] Display help for specified command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
MAin Return to Main Menu
----
Information Menu: Enter command > all
BOOT INFORMATION
Primary Boot Path: 0/0/0/3/0.6
0/0/0/3/0.6 (hex)
Boot Actions: Boot from this path.
If unsuccessful, go to next path.
HA Alternate Boot Path: 0/0/0/0/0.0
0/0/0/0/0.0 (hex)
Boot Actions: Boot from this path.
If unsuccessful, go to next path.
Alternate Boot Path: 0/0/0/0/0.0
0/0/0/0/0.0 (hex)
Boot Actions: Boot from this path.
If unsuccessful, go to BCH.
Software ID (hex): 0x3e1139bc594121c9
Software Capability: 0x0
Boot Timer : 0
CACHE INFORMATION
Cab/ Instruction Cache Data Cache
Cell Slot CPU Size Size
---- ---- --- ----------------- ---------------
0 0/0 0A 32 MB 32 MB
0B 32 MB 32 MB
CHIP REVISION INFORMATION
Cab/
Cell Slot Module Revision
---- ---- ------- ----------
0 0/0 PDC 21.3
CPU(0A) PA8800 3.2
CPU(0B) PA8800 3.2
CC 1.0
SBA 1.0
LBA 3.2
PDH 2.0
COMPLEX ID INFORMATION
Complex Name: Complex 01
Model String: 9000/800/rp7420
Original Product Number: A7025A
Current Product Number: A7025A
Serial Number: USE4440F97
Number of Supported Cells: 2
Complex Revision Number: 1.0
FIRMWARE INFORMATION
PDC ICM PDC Utils
Cell Cab/Slot PDC Ver PDC Date Code Layout Rev XFace Rev
---- -------- ------- ------------- ---------- ---------
0 0/0 021.003 44.19 008 008
I/O CHASSIS INFORMATION
Cell Info I/O Chassis Info
Cell Cab/Slot Cab Bay Chassis
---- -------- --- --- -------
0 0/0 0 0 0
I/O MODULE INFORMATION
Path Slot Rope IODC
Type (dec) # # HVERSION SVERSION Vers
---- ----- ---- ---- -------- -------- ----
System Bus Adapter 0/0 0x8050 0x0c18 0x00
Local Bus Adapter 0/0/0 0 0 0x7820 0x0a18 0x00
Local Bus Adapter 0/0/1 8 1 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/2 7 2 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/4 6 4 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/6 5 6 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/8 1 8 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/10 2 10 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/12 3 12 0x7830 0x0a18 0x00
Local Bus Adapter 0/0/14 4 14 0x7830 0x0a18 0x00
PCI DEVICE INFORMATION
Path Bus Slot Vendor Device
Description (dec) # # Id Id
----------- ----- --- ------ ------ ------
Communications dev 0/0/0/0/0 0 Built-In 0x103c 0x1290
Comm. serial cntlr 0/0/0/0/1 0 Built-In 0x103c 0x1048
SCSI bus cntlr 0/0/0/3/0 0 Built-In 0x1000 0x0021
SCSI bus cntlr 0/0/0/3/1 0 Built-In 0x1000 0x0021
PCI-to-PCI bridge 0/0/8/1/0 64 1 0x1014 0x01a7
SCSI bus cntlr 0/0/8/1/0/1/0 65 1 0x1000 0x0021
SCSI bus cntlr 0/0/8/1/0/1/1 65 1 0x1000 0x0021
Ethernet cntlr 0/0/8/1/0/4/0 65 1 0x14e4 0x1645
PCI-to-PCI bridge 0/0/10/1/0 80 2 0x1014 0x01a7
Fibre channel 0/0/10/1/0/4/0 81 2 0x1077 0x2312
Ethernet cntlr 0/0/10/1/0/6/0 81 2 0x14e4 0x16c7
PCI-to-PCI bridge 0/0/12/1/0 96 3 0x1014 0x01a7
Fibre channel 0/0/12/1/0/4/0 97 3 0x1077 0x2312
Ethernet cntlr 0/0/12/1/0/6/0 97 3 0x14e4 0x16c7
PARTITION MEMORY INFORMATION
Cell Echelon 0-3 Echelon 4-7 Echelon 8-B Echelon C-F
Size Status Size Status Size Status Size Status
---- ------ --------- ------ --------- ------ --------- ------ ---------
0 4096MB Active --- --- ---
4096MB Active --- --- ---
--- --- --- ---
--- --- --- ---
Partition Total Memory: 8192 MB
Partition Active Memory: 8192 MB
Partition Deconfigured Memory: 0 MB
* status is scheduled to change on next boot.
PROCESSOR INFORMATION
Cab/ Processor
Cell Slot CPU Speed HVERSION SVERSION CVERSION State
---- ---- --- -------- -------- -------- -------- --------------
0 0/0 0A 1000 MHz 0x8830 0x0491 0x0302 Active
0B 1000 MHz 0x8830 0x0491 0x0302 Idle
Partition Total Cells: 1
Partition Total Processors: 2
Partition Active Processors: 2
Partition Deconfigured Processors: 0
This report would be an
excellent addition to a system administration notebook. Knowing such
information as the firmware revision levels and the settings of the boot
flags is valuable.
In the previous example, I used the BCH to issue the PDC commands INformation and then ALL. Both INformation and ALL
are PDC commands issued through the BCH interface. Sometimes PDC and
BCH are used interchangeably in documentation, however, knowing that BCH
is the interface through which PDC commands are issued will usually
serve you well when looking for information on specific commands.
I'll now go back to the Main menu and then look at the SERvice menu:
Information Menu: Enter command > main
---- Main Menu ---------------------------------------------------------------
Command Description
------- -----------
BOot [PRI|HAA|ALT|<path>] Boot from specified path
PAth [PRI|HAA|ALT] [<path>] Display or modify a path
SEArch [ALL|<cell>|<path>] Search for boot devices
ScRoll [ON|OFF] Display or change scrolling capability
COnfiguration menu Displays or sets boot values
INformation menu Displays hardware information
SERvice menu Displays service commands
DIsplay Redisplay the current menu
HElp [<menu>|<command>] Display help for menu or command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
----
Main Menu: Enter command or menu > ser
---- Service Menu ------------------------------------------------------------
Command Description
------- -----------
BAttery [<cell>] Display Cell Battery Status
CLEARPIM [<cell>] Clear the Partition's NVM PIM data
DimmDealloc [<cell>] [<dimm>] Display or Deallocate a DIMM
[ON|OFF]
ErrorLog [<cell>] Display Error log information
[MEMORY|IO|FABRIC|CELL]
LanAddress Display Core LAN station address
MemRead <address> [<len>] Read memory locations scope of Partition
PDT [<cell>] [CLEAR] Display or clear the PDT
PIM [<cell>[<cpu>]][HPMC|LPMC|TOC] Display PIM information
SCSI [<cell>] [<path>] Display or set SCSI device parameters
[INIT|RATE|TERM|WIDTH <value>] [DEFAULT] [DELETE]
BOot [PRI|HAA|ALT|<path>] Boot from specified path
DIsplay Redisplay the current menu
HElp [<command>] Display help for specified command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
MAin Return to Main Menu
----
Among the options you have in the SERvice
menu is to manipulate the Processor Internal Memory, display SCSI
controller values, and enable and disable self-tests. In the following
example, we run scsi to get information on our SCSI interfaces and then return to the Main menu:
Service Menu: Enter command > scsi
This may take a while. Please wait...
Cell: 0
=========
Path (dec) Initiator ID SCSI Rate Auto Term Bus Width
----------------- ------------ --------- --------- ---------
0/0/0/3/0 7 MAX UNKNOWN MAX
0/0/0/3/1 6 MAX UNKNOWN MAX
0/0/8/1/0/1/0 7 MAX UNKNOWN MAX
0/0/8/1/0/1/1 7 MAX UNKNOWN MAX
Note: Only displaying SCSI parameters as stored in PDH NVRAM.
Mismatches between PDH NVRAM and card NVRAM SCSI values will not be reported.
To check PDH NVRAM against I/O card values, run 'SER SCSI <PATH>'
Service Menu: Enter command > main
---- Main Menu ---------------------------------------------------------------
Command Description
------- -----------
BOot [PRI|HAA|ALT|<path>] Boot from specified path
PAth [PRI|HAA|ALT] [<path>] Display or modify a path
SEArch [ALL|<cell>|<path>] Search for boot devices
ScRoll [ON|OFF] Display or change scrolling capability
COnfiguration menu Displays or sets boot values
INformation menu Displays hardware information
SERvice menu Displays service commands
DIsplay Redisplay the current menu
HElp [<menu>|<command>] Display help for menu or command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
----
Now that I've covered some
of the PDC commands, let's return to the process of booting by looking
at the first three commands under Main menu.
BOot allows you to specify the path from which you'll boot your system. PAth allows you to display or modify the boot paths. SEArch will display boot paths. In the following example, I SEArch to show all potential boot devices on the nPartition, run PAth to display the existing boot path, and then specify the device from which I want to boot the system:
Main Menu: Enter command or menu > main
---- Main Menu ---------------------------------------------------------------
Command Description
------- -----------
BOot [PRI|HAA|ALT|<path>] Boot from specified path
PAth [PRI|HAA|ALT] [<path>] Display or modify a path
SEArch [ALL|<cell>|<path>] Search for boot devices
ScRoll [ON|OFF] Display or change scrolling capability
COnfiguration menu Displays or sets boot values
INformation menu Displays hardware information
SERvice menu Displays service commands
DIsplay Redisplay the current menu
HElp [<menu>|<command>] Display help for menu or command
REBOOT Restart Partition
RECONFIGRESET Reset to allow Reconfig Complex Profile
Main Menu: Enter command or menu > sea
Searching for potential boot device(s) on the core cell
This may take several minutes.
To discontinue search, press any key (termination may not be immediate).
IODC
Path# Device Path (dec) Device Type Rev
----- ----------------- ----------- ----
P0 0/0/0/3/0.6 Random access media 3
P1 0/0/0/3/0.5 Random access media 3
0/0/10/1/0/4/0.0 Fibre Channel Protocol 13
0/0/12/1/0/4/0.0 Fibre Channel Protocol 13
Main Menu: Enter command or menu > pa
Primary Boot Path: 0/0/0/3/0.6
0/0/0/3/0.6 (hex)
HA Alternate Boot Path: 0/0/0/0/0.0
0/0/0/0/0.0 (hex)
Alternate Boot Path: 0/0/0/0/0.0
0/0/0/0/0.0 (hex)
Main Menu: Enter command or menu > bo p0
BCH Directed Boot Path: 0/0/0/3/0.6
The SEArch
command shows two internal disks and two fibre interfaces off of which
this nPartition could boot. The path of the two internal boot devices is
composed of numbers separated by slashes (/), which indicate bus
converters, and dots (.), which indicate cards, slot numbers, and
addresses. The paths of the fibre cards are similar, but they have more
entries for the external storage device to which they're connected. You
sometimes end up decoding these paths to figure out what boot devices
map to what hardware devices on your system.
When I issued the BOot command in the previous example, I specified a device of p0, which corresponds to the disk on internal bus1, shown in the SEArch
command results. I responded that I did indeed want to interact with
IPL, which would normally not be the case when booting the system;
however, I want to look briefly at IPL in the upcoming IPL section.
PDC commands issued
through BCH are a mystery to many new system administrators. I covered
enough in this section to get you comfortable enough on your system to
look at the non-intrusive commands, that is, those that supply useful
information without changing the settings on your system. Be careful if
you issue commands that change your configuration.
Under
MAIN-CON-CPU
for
instance, you can configure and reconfigure processors. You would not
want to experiment with this command unless your system is unused.
