vparboot


vparboot

vparboot - graphics/vparboot_icon.gif Boots (starts) a virtual partition.

 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 example, not running. For this reason, it is not      possible to boot the current partition using this command.  The      partition in which the command is executing is called the current      partition.      Only a superuser can execute the vparboot command.    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 monitor's 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 any whitespace is 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 -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[ernateboot]                              (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.                         Boot From Hardware Path:                              Any other string is assumed to be the                              hardware path (for example, 10/6.0) to the                              desired boot device.  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.         -I ignite_kernel  Specifies a path to a cold-install kernel such as                         /opt/ignite/boot/WINSTALL.  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 current                         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:                         [Server name or IP addr,]cold-install_kernel                         If cold-install_kernel begins with a slash, "/",                         you are specifying an absolute path and vparboot                         looks for it at that location.  If cold-                         install_kernel does not begin with "/", the                         default path /opt/ignite/boot/ is prepended to                         cold-install_kernel.         If the Server name or IP address, is not specified, vparboot loads the         cold-install kernel from the filespace of the current virtual         partition.  Otherwise the command loads it from the filespace of the         specified server. The comma is a required part of the server name         syntax. RETURN VALUE      The vparboot command exits with one of the following values:      0   Successful completion.      1   One or more error conditions occurred. EXAMPLES      Boot the virtual partition called Oslo   vparboot -p Oslo      Boot the virtual partition Bergen specifying an alternate kernel   vparboot -p Bergen -b /stand/vmunix_debug      Cold-install the virtual partition Trondheim from a file on a remote      server   vparboot -p Trondheim -I mysys.myserver.mydomain.com,/mypath/myinst      Cold-install the virtual partition Sandefjord from a file at the      default path /opt/ignite/boot on the current virtual partition   vparboot -p Sandefjord -I WINSTALL ERRORS      vparboot displays error messages on stderr for any of the following      conditions:      vp_name does not exist in the monitor.      vp_name is in some state other than Down, and so cannot be      booted.  Use the vparreset(1M) command instead.      An error occurs while trying to access an Ignite server or cold-      install file.      You have specified the BOOT or ALTBOOT device, but the      corresponding device has not been configured in vp_name.      NOTE: If the boot device has not been configured properly the      vparboot command will complete without error, but the virtual      partition will not boot.  Two possible reasons for this could be:   +  The BOOT or ALTBOOT attribute was assigned to a device      other than a disc or tape.   +  The file at the default or configured kernel path does      not exist or is not a bootable image.    AUTHOR         vparboot was developed by the Hewlett-Packard Company.    SEE ALSO  vparcreate(1M)  ,  vparmodify(1M)  ,  vparremove(1M)  ,  vparreset(1M)  ,  vparstatus(1M)  ,  vparresources(5)  ,  vpartition(5)  . 


HP-UX 11i Systems Administration Handbook and Toolkit
HP-UX 11i Systems Administration Handbook and Toolkit (2nd Edition)
ISBN: 0131018833
EAN: 2147483647
Year: 2003
Pages: 301

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net