|
|
Upgrade Ignite and its impact
02-14-2008
|
|
vparboot(1M) vparboot(1M) NAME
vparboot - boot a virtual partition SYNOPSIS
kernel_path] boot_opts] boot_addr] PA-RISC platforms only Itanium(R)-based platforms only name]| server_ip client_ip optional_data]]] DESCRIPTION
The command causes the virtual partition monitor to boot the specified virtual partition. The monitor must be running. The virtual parti- tion must exist in the monitor configuration and be in the 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 (nPartition) are shut down and the virtual partition monitor is rebooted. Refer to "Performing a Reboot for Reconfig for an nPartition" in the for more information. Options recognizes the following command line options and arguments: Specifies the unique name of the virtual partition that is to be booted. The virtual partition must exist in the monitor's database, must be in the state, and must have a configured boot device. Required. 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: the kernel-path is the portion of this string. If this option is omitted, the value is taken from any specified during virtual partition creation or its most recent modification, or if has never been specified. Specifies the command-line options to be applied when the virtual partition is booted. For example, if a non-partitioned system start string at the ISL prompt is: the boot_opts string in this case will be Note that if there is a space included in the string, the string must be quoted. Refer to the virtual partitions administration guide and the chapter titled "Monitor and Shell Commands" for a full list of supported boot option strings. If the option is omitted, the value is taken from any specified during virtual partition creation or its most recent modification, or the empty string if has never been specified. 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 option is omitted. attempts to boot vp_name from the device previously configured with the attribute. It is an error if no device has been so configured. (case-insensitive). attempts to boot vp_name from the device previously configured with the attribute. It is an error if no device has been so configured. (case-insensitive). On PA-RISC platforms attempts to boot from a device previously configured with the 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 from 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). does not check any part of such a specification. If it is not a proper path, the path does not exist, the virtual parti- tion 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 and attributes decides the boot action to be taken. Refer to the vparcreate(1M) or vparmodify(1M) manpage for details. (PA-RISC platforms only) Specifies a path to a cold-install kernel such as This form of the command is used to cold-install 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 is run) or on any other networked sys- tem or virtual partition accessible from that partition. The syntax for ignite_kernel is: If cold-install_kernel begins with a slash, "/", you are specifying an absolute path and looks for it at that location. With Ignite-UX revisions prior to C.6.0, if cold-install_kernel does not begin with "/", the default path is prepended to cold-install_kernel. With Ignite-UX revision C.6.0 or later, there is no cold-install_kernel at the default path Hence it is required to specify an absolute path, such as If the Server name or IP address, is not specified, loads the cold-install kernel from the file space of the local vir- tual 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. (Itanium-based platforms only) Arguments are optional. Once the command exits, you must enter 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 command. Specifies the DB-Profile name from which user specified Direct boot settings are read from the database Specifies the static IP address for the boot server Specifies the static IP address for the client. If client IP information is missing in the DB-Profile, DHCP will be used by default. Specifies the static IP address for the gateway Specifies the subnet mask for the local network 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. 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 command exits with one of the following values: Successful completion. One or more error conditions occurred. EXAMPLES
Boot the virtual partition called Boot the virtual partition specifying an alternate kernel: Cold-install the virtual partition from a file on a remote PA server: Cold-install the virtual partition using DB-Profile settings on a remote Itanium server: 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 Cold-install the virtual partition passing network information on a remote Itanium server: ERRORS
displays error messages on standard error for any of the following conditions: o vp_name does not exist in the monitor. o vp_name is in some state other than and so cannot be booted. Use the command instead. o An error occurs while trying to access an Ignite server or cold-install file. You have specified the or device, but the corresponding device has not been configured in vp_name. NOTE: If the boot device has not been configured properly, the command will complete without error, but the virtual partition will not boot. Possible reasons for this could be: -- The or attribute was assigned to a device other than a disc or DVD. -- The 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. o The command and the virtual partition monitor are at different revision levels. This message is only a warning. The command continues. o When the virtual partition flexible administrative capability is enabled and the local virtual partition is not a Designated-Admin vPar. AUTHOR
was developed by the Hewlett-Packard Company. SEE ALSO
vparadmin(1M), vparcreate(1M), vparconfig(1M), vpardump(1M), vparefiutil(1M), vparenv(1M), vparextract(1M), vparmodify(1M), vparreloc(1M), vparremove(1M), vparreset(1M), vparstatus(1M), vparutil(1M), vpardbprofile(1M), vparresources(5), vpartition(5), vpmon(5). vparboot(1M)