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

v
vparboot(1M) vparboot(1M)
NAME
vparboot - boot a virtual partition
SYNOPSIS
vparboot -p vp_name [-b kernel_path][
-o boot_opts][-B boot_addr]
vparboot -p vp_name -I ignite_kernel
DESCRIPTION
The vparboot command causes the virtual partition monitor to boot the specified virtual partition. The
monitor must be running. The virtual partition must exist in the monitor configuration and be in the
Down
state. For this reason, it is not possible to boot the local partition using this command. The partition in
which the command is executing is called the local partition.
On hard-partitionable systems such as Superdome, if there is a pending reboot for reconfiguration, the
specified virtual partition will not be booted until all the virtual partitions on that hard partition are shut
down and the virtual partition monitor is rebooted. Refer to "Performing a Reboot for Reconfig for an nPar-
tition" in the HP Systems Partitions Guide, Administration for nPartitions for more information.
Only a superuser can execute the
vparboot command. In a secure virtual partition environment only a
Primary-Admin vPar can boot a virtual partition.
Options
vparboot recognizes the following command line options and arguments:
-p vp_name Specifies the unique name of the virtual partition which is to be booted. The virtual
partition must exist in the monitors database, must be in the Down state, and must
have a configured boot device. Required.
-b kernel_path Specifies the absolute path to a bootable kernel for the virtual partition. For example,
if a non-partitioned system start string at the ISL prompt is:
ISL> hpux -iS /stand/vmunix
the kernel-path is the /stand/vmunix
portion of this string.
If this option is omitted, the value is taken from any
-b kernel_path specified during
virtual partition creation or its most recent modification, or /stand/vmunix
if -b
kernel_path has never been specified.
-o boot_opts Specifies the command-line options applied when the virtual partition is booted. For
example, if a non-partitioned system start string at the ISL prompt is:
ISL> hpux -iS /stand/vmunix
the boot_opts string in this case will be -iS. Note that if there is a space included in
the string, the string must be quoted.
Refer to the virtual partitions administration guide Installing and Managing HP-UX
Virtual Partitions, and the chapter titled "Monitor and Shell Commands" for a full list
of supported boot option strings.
If the
-o option is omitted, the value is taken from any -o boot_opts specified during
virtual partition creation or its most recent modification, or the empty string if -o
boot_opts has never been specified.
-B boot_addr Specifies the device from which the virtual partition kernel image is read. It must be
one of the following three forms:
bo[ot]|pri[mary] (case-insensitive)
This is the default if the -B option is omitted. vparboot attempts to boot
vp_name from the device previously configured with the BOOT attribute. It is an
error if no device has been so configured.
alt[ernate|boot] (case-insensitive)
vparboot attempts to boot vp_name from the device previously configured
with the ALTBOOT attribute. It is an error if no device has been so configured.
tape (case-insensitive)
vparboot attempts to boot vp_name from a device previously configured with
the TAPE attribute. It is an error if no device has been so configured. This will
Section 1M1096 Hewlett-Packard Company 1 HP-UX 11i Version 1: September 2005