setboot.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

setboot(1M) setboot(1M)

NAME

setboot - display and modify boot variables in stable storage

SYNOPSIS

setboot [-p primary-path][

-h HA_alternate -path ][-a alternate-path ]

[

-b on|off

][-s on|off][-m on|off][-r

][-v]

[

-t testname =on|off

|default]... [-T testname =onoffdefault]...

DESCRIPTION

The

setboot command displays and sets boot variables in stable storage (also known as nonvolatile

memory). Any user can display the values; only a superuser can change them.

On all systems, the variables are: primary path, alternate path, HA alternate path (if applicable; see

-h

option), autoboot ﬂag, and autosearch ﬂag. If SpeedyBoot is installed, the variables expand to

include: early CPU tests, late CPU tests, memory initialization (on Integrity systems), full memory tests,

processor hardware tests (on PA-RISC), platform dependent tests (on Integrity systems), IO Hardware

tests (on Integrity systems), chipset tests (on Integrity systems), and central electronic complex tests (on

PA-RISC), hyperthreading (on some Integrity systems).

With no options,

setboot displays the current values for the primary boot path, alternate boot path, HA

alternate boot path, and the autoboot and autosearch

ﬂags. If SpeedyBoot is installed, setboot

-v also displays the status of the CPU, memory, hardware, and electronics tests. If the platform supports

hyperthreading, setboot displays whether processor hyperthreading is enabled/disabled for current

and subsequent system boots.

SpeedyBoot

The SpeedyBoot ﬁrmware and software extensions allows a superuser to control which ﬁrmware tests are

executed by the system during the boot process. The tests settings can be speciﬁed both for all subse-

quent boots and for the next one only. They are described in the The Tests section below.

The

-v, -t, and -T options of the setboot command provide the user interface to the ﬁrmware tests.

Currently -t options is not supported on Integrity system architecture.

SpeedyBoot augments the test control that is available on systems that have the Boot Console Handler

(BCH). By turning off some or all of the boot tests, you can shorten boot time appreciably. However, in

the event of a system panic or boot failure, all tests are executed on the subsequent boot.

SpeedyBoot Tests

The SpeedyBoot tests and the possible display values on a PA-RISC platform are summarized in the fol-

lowing table:

Test Current Supported Default NEXT BOOT

all on|off|partial yes|no|partial on|off|partial on|off|partial

SELFTESTS on|off|partial yes|no|partial on|off|partial on|off|partial

early_cpu on|off yes|no on|off on|off

late_cpu on|off yes|no on|off on|off

FASTBOOT on|off|partial yes|no|partial on|off|partial on|off|partial

full_memory on|off yes|no on|off on|off

PDH on|off yes|no on|off on|off

CEC on|off yes|no on|off on|off

The SpeedyBoot tests and the possible display values on an Integrity platform are summarized in the fol-

lowing table:

Test Current Default

all on|off|partial on|off|partial

SELFTESTS on|off|partial on|off|partial

early_cpu on|off on|off

late_cpu on|off on|off

FASTBOOT on|off|partial on|off|partial

Platform on|off on|off

Full_memory on|off on|off

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
setboot(1M) setboot(1M) NAME setboot - display and modify boot variables in stable storage SYNOPSIS setboot [-p primary-path ] [-h HA_alternate -path ] [-a alternate -path ] [-b on|off] [-s on|off] [-m on|off] [-r] [-v] [-t testname =on|off|default]... [-T testname =onoffdefault]... DESCRIPTION The setboot command displays and sets boot variables in stable storage (also known as nonvolatile memory). Any user can display the values; only a superuser can change them.
PAGE 2
setboot(1M) Memory_init IO_HW Chipset setboot(1M) on|off on|off on|off on|off on|off on|off The Columns Test The keyword names of the tests that can be controlled by SpeedyBoot. See The Tests section below. Current The current enablement of each test. on means the test is normally executed on each boot. off means the test is normally omitted on each boot. partial means some of the subtests are normally executed on each boot.
PAGE 3
setboot(1M) setboot(1M) IO_HW IO Hardware. When on, enables system firmware, or EFI drivers to perform all the tests of IO hardware (boot devices only). When off, do not. Supported only on Integrity platform. Chipset When on, enables Chipset tests. When off, does not enable Chipset tests. Supported only on Integrity platform.
PAGE 4
setboot(1M) setboot(1M) section. The -s option is not supported on Integrity system architecture. -b onoff Enable or disable the autoboot sequence. The interpretation of Autoboot and Autosearch has changed for PA-RISC systems that support hardware partitions. Refer to the WARNINGS section. -m onoff Enable or disable hyperthreading. -m option is supported only on Integrity system architecture.
PAGE 5
setboot(1M) setboot(1M) setboot can’t set the specified boot path. type may be primary, HA_alternate, or alternate. error accessing boot path - message The message explains why. For example, you may not have permission (not be superuser) to change parameters. error accessing firmware - message The firmware could not be read or written. The message explains why. Failed to retrieve lun token An error occurs when one of the boot paths is invalid (when running setboot -r or /sbin/init.d/setboot).
PAGE 6
setboot(1M) setboot(1M) setboot -a /dev/disk/disk2 -b on setboot displays: Alternate boot path set to 0/0/0/3/0.0x6.0x0 (/dev/disk/disk2) 3. Display the boot paths, auto flags and hyperthreading: setboot on PA-RISC and Integrity system architecture displays: Primary bootpath : 0/0/0/3/0.0x5.0x0 (/dev/rdisk/disk3) HA Alternate bootpath : 0/0/0/3/0.0x6.0x0 (/dev/rdisk/disk2) Alternate bootpath : 0/0/0/3/0.0x6.
PAGE 7
setboot(1M) setboot(1M) FASTBOOT Platform Full_memory Memory_init IO_HW Chipset 2. on on on on off on on on on on off on Enable full_memory and PDH tests and have those tests executed on all subsequent reboots. setboot -t FASTBOOT=on 3. Disable the late processor tests and have those tests skipped on all subsequent reboots. If early CPU tests are on when this command is executed, the SELFTESTS state in BCH stays on while setboot -v shows the state as partial. setboot -t late_cpu=off 4.
PAGE 8
setboot(1M) off setboot(1M) on try next path. Skip the primary path and try alternate path. If the alternate paths are not configured to boot or fail, go to BCH. Additionally, systems with hardware partitions support a boot action for each path. However the boot action for the paths other than the primary path cannot be set using setboot. Instead, these must be set through the Boot Console Handler using the pf (path flags) command of the BCH Configuration menu.