Professional Documents
Culture Documents
Vparboot Manual PDF
Vparboot Manual PDF
vparboot(1M)
NAME
vparboot - boot a virtual partition
SYNOPSIS
-g gateway_ip
Specifies the unique name of the virtual partition that 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:
-o boot_opts
-B boot_addr
Specifies the device from which the virtual partition kernel image is read. It must
be one of the following three forms:
Hewlett-Packard Company
vA
vparboot(1M)
vparboot(1M)
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). On PA-RISC platforms 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. On Itanium(R)-based platforms,
lists all the tape devices assigned to the partition. The user will then be
prompted to select the tape device from which to boot the partition. This will
restore the contents archived using make_tape_recovery from tape. All
the contents on the target disk will be lost.
Boot From Hardware Path:
Any other string is assumed to be the hardware path to the desired boot device
(for example, 10/6.0). vparboot does not check any part of such a
specification. If it is not a proper path, the path does not exist, the virtual partition does not own the device at that path, or there is no bootable device at
that path, the command either fails with an error, or the boot attempt fails
with no error indication.
Boot actions: If the boot from primary path fails, then the combination of autoboot and autosearch attributes decides the boot action to be taken. Refer to the
vparcreate (1M) or vparmodify (1M) manpage for details.
-I ignite_kernel
/opt/ignite/boot/WINSTALL. This form of the command is used to coldinstall an instance of HP-UX on a virtual partition. Most often, this is done on a
newly-created virtual partition, one that has a completely unwritten disk. However, it can be used to cold-install HP-UX over an existing instance.
ignite_kernel can reside either on the local virtual partition (the one on which
vparboot is run) or on any other networked system or virtual partition accessible
from that partition. The syntax for ignite_kernel is:
vA
If the Server name or IP address , is not specified, vparboot loads the cold-install
kernel from the file space of the local virtual partition. Otherwise the command
loads it from the file space of the specified server. The comma is a required part of
the server name syntax.
-I
(Itanium-based platforms only) Arguments are optional. Once the command exits,
you must enter Control-A in a console window until you reach the virtual console
for vp_name . There you are presented with one or more MAC addresses of I/O controllers assigned to vp_name . Select the appropriate address to load the cold-install
kernel.
If no MAC address can be identified, or if the selected MAC address fails to load the
cold-install kernel, you must identify the source of the problem, then retry the
vparboot command.
-d name
2
Specifies the DB-Profile name from which user specified Direct boot settings are
read from the database
Hewlett-Packard Company
vparboot(1M)
vparboot(1M)
-s server_ip
-c client_ip
Specifies the static IP address for the client. If client IP information is missing in
the DB-Profile, DHCP will be used by default.
-g gateway_ip
-m subnet_mask
-b boot_file
Specifies the absolute path to a bootable file on the boot server. If empty then it will
be assumed that the server controls the boot File for the client.
-o optional_data
Specifies the optional command line arguments to pass to the boot file
SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser.
When virtual partition flexible administrative capability is enabled, a virtual partition can only be booted
from within a Designated-Admin vPar.
RETURN VALUE
The vparboot command exits with one of the following values:
Successful completion.
One or more error conditions occurred.
0
1
EXAMPLES
Boot the virtual partition called Oslo:
vparboot -p Oslo
Boot the virtual partition Bergen specifying an alternate kernel:
vpardbprofile -d profile1
Profile Name: profile1
Network Type: IPv4
Server IP address: 15.1.165.152
Client IP address: 15.1.163.92
Gateway IP address: 15.1.165.240
Subnet Mask: 255.255.248.0
Boot File: /opt/ignite/boot/nbp.efi
Optional Data: IINSTALL
A
vparboot displays error messages on standard error for any of the following conditions:
vp_name is in some state other than Down, and so cannot be booted. Use the vparreset command
instead.
Hewlett-Packard Company
vA
vparboot(1M)
vparboot(1M)
NOTE: If the boot device has not been configured properly, the vparboot command will complete
without error, but the virtual partition will not boot. Possible reasons for this could be:
The BOOT or ALTBOOT attribute was assigned to a device other than a disc or DVD.
The TAPE attribute was assigned to a device other than tape.
The file at the default or configured kernel path does not exist or is not a bootable image.
The vparboot command and the virtual partition monitor are at different revision levels. This message is only a warning. The command continues.
When the virtual partition flexible administrative capability is enabled and the local virtual partition
is not a Designated-Admin vPar.
AUTHOR
vA
Hewlett-Packard Company