HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

s
setboot(1M) setboot(1M)
setboot -T SELFTESTS=on
7. Cause all tests to be skipped on the next reboot. The previously set test values will take effect for sub-
sequent reboots.
setboot -T all=off
WARNINGS
The setboot command fails under the following circumstances:
• The number of writes to the stable storage exceeds the number allowed by the architecture implemen-
tation.
• Hardware failure.
• The implementation does not have memory for the alternate boot path, in which case, this variable is
neither readable nor writable.
The interpretation of Autoboot and Autosearch has changed for systems that support hardware parti-
tions. The firmware interprets the bits in combination and not individually as done before. In order to
approximate the traditional behavior of setboot, the user input for the autboot and autosearch flags is
internally mapped to the right combination to achieve the desired behavior. This mapping should be
transparent to the user of setboot, but might show up when accessing the firmware using means other
than setboot.
For the primary path, the boot action corresponds to the Autoboot and Autosearch flags in the following
manner:
AutoBoot AutoSearch Boot Action
off off Go to the BCH and prompt the user.
on off Attempt the primary path; on failure
go to BCH.
on on Attempt the primary path; on failure
try next path.
off on 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 command. The default boot action for the hardware par-
titions is to "skip this device and try next path". The case where both the autosearch and autoboot flags
are on will not work as expected until the path flags for the alternate paths are set appropriately through
the BCH. In the default case, specifying setboot -b on -s on will not cause an alternate path to
be automatically booted when the primary path fails, instead the user will be prompted.
DEPENDENCIES
If SpeedyBoot is not installed on a system, options -v, -t, and
-T will produce a diagnostic error.
Currently K-class and N4000 systems are the only platforms supporting
-v, -t, and
-T options.
AUTHOR
setboot was developed by HP.
FILES
/dev/kepd Special device file used by the setboot command.
/etc/setboot_tests Definitions of tests which can be viewed or controlled with the -v,
-t, and
-T options.
SEE ALSO
hpux(1M), ioscan(1M), isl(1M), mkboot(1M).
HP-UX 11i Version 1: September 2005 − 5 − Hewlett-Packard Company Section 1M−−835