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[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.

                        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).