vpmon(5)							File Formats Manual							  vpmon(5)

NAME

       vpmon - vPars Monitor Management or Information Lookup Commands

SYNOPSIS

       database_filename] [vPars Monitor Management Commands]

DESCRIPTION

       The  vPars  (Virtual  Partitions) product allows a user with superuser or with DEVOPS privilege to divide hardware resources on a supported
       whole system or a single hard partition (nPartition) into one or more This is accomplished through a software layer called the  that  logi-
       cally resides between the operating system and the firmware.

       The  controls  the  management of the hardware resources and their assignment to the virtual partitions.  To be operational, each partition
       must contain at least one CPU, a boot hard disk, and enough memory to run HP-UX.  At least one PCI slot is required if an external LAN con-
       nection is needed.  Each partition will run its own copy of the operating system, providing software fault and namespace isolation.

       User-specified partition information is stored in a file called the (default is This information is read by the during boot.

       There are several arguments that may be passed to the when it is booted from the Initial System Loader (ISL) prompt on PA-RISC platforms or
       booted from the HPUX prompt on Itanium(R)-based platforms.  Depending on the arguments, can either enter the interactive mode, indicated by
       the prompt, or continue with loading the virtual partitions.  This prompt is also called the

       Any  options entered after vPars Monitor Management Commands at the ISL prompt will be treated as arguments to the vPars monitor management
       commands.

   Booting the vPars Monitor
       In a system without vPars installed, (the file containing the HP-UX kernel to be booted) is loaded as follows:

	    For PA-RISC platforms:

	    For Itanium-based platforms:

       In a system with vPars installed, is loaded as follows:

	    For PA-RISC platforms:

	    For Itanium-based platforms:

   Options
       may be invoked with the following arguments:

       Boots all virtual partitions that have the autoboot attribute set.

       Causes the
		 to enter into interactive mode.  The interactive mode is the default when no options are given.  The interactive mode	will  also
		 occur	without the option if none of the virtual partitions that are active are assigned the system boot processor, if no virtual
		 partitions are specified, or if no valid partition database is found.

       Boots the virtual partitions configured in an alternate partition database file.
		 The default partition database file is

       vPars Monitor Commands
		 See the section for information about the commands for vPars monitor management and vPars monitor information lookup.

   vPars Monitor Commands
       The commands that may be issued from the command prompt are classified as either vPars monitor management commands or vPars monitor  infor-
       mation lookup commands.

   vPars Monitor Management Commands
       This section explains the vPars monitor management commands.

       The command has two formats:

       {boot_device|tape} ]]

       An error occurs if no options are specified for

       The command can be used to load and activate one or more partitions.  If fails to boot a virtual partition from the primary boot path, then
       further boot actions will be decided based on the settings of autoboot and autosearch flags.  This may result in automatically booting that
       virtual	partition  from  the alternate boot path.  The or options can only be used with the option.  Do not use the or options with the or
       options.  Each option is explained as follows:

       Boots all the virtual partitions that have their autoboot attribute set to

       Boots all virtual partitions regardless of the autoboot attribute.

       Boots the virtual partition specified by
			   vpar_name.

       Boots the virtual partition using the kernel
			   kernel_path, such as instead of the default kernel The option is mutually exclusive with the and options.

       Boots the virtual partition using the specified boot options.
			   See boot(1M) and hpux(1M).

       Boots the virtual partition using the boot device at the legacy hardware path
			   boot_device.  The option is mutually exclusive with the and options.

       On PA-RISC platforms, boots the virtual partition using the tape device.
			   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.  The option is mutually exclusive with the and options.

       Launches the install kernel from the CD/DVD specified by the disk index.
			   If disk index is "X," the install EFI application is launched from the disk "fsX:".

			   The	order in which firmware assigns the indices for the disks is unknown.  If the installable CD/DVD media is present,
			   install kernel is automatically launched.  If installable CD/DVD media is not present at the index specified, vPar will
			   be shutdown automatically and the user must select a different disk_index.

			   This option is available on Itanium-based platforms only.  It is mutually exclusive with the and options.

			   This option is provided as a tool to install or recover a vPar.

       Launches the vPar boot helper EFI application from the disk specified by the disk index.
			   If disk index is "X", the vPar boot helper EFI application is launched from the disk "fsX:".

			   The	boot helper EFI application prints the EFI paths of all the bootable disks belonging to the target vPar and inter-
			   actively prompts the user to select a disk to boot from.  If the disk selected is a CD or DVD device, then install ker-
			   nel	from  the  media is launched instead of the regular kernel. And any boot options specified on the command line are
			   ignored.

			   The order in which firmware assigns the indices for the disks is unknown.  However, trying to boot the boot helper from
			   a  random disk is usually harmless.	If the boot helper is present, the user will be interactively prompted to select a
			   disk.  If the boot helper application is not present on the disk, then the vPar will be shutdown automatically and  the
			   user must select a different disk_index.  The vPar boot helper gets installed as part of vPars product installation.

			   This option is available on Itanium-based platforms only.  It is mutually exclusive with the and options.

			   This  option  is provided as a tool to boot a vPar only if a valid HP-UX h/w path to EFI path mapping is not present in
			   the virtual partition database for a boot disk.  Refer to vparefiutil(1M) for additional information on HP-UX h/w  path
			   to EFI path mappings.

			   This  option  is  not  recommended for general purpose use.	If virtual partitions are configured as per the documented
			   procedure, there may not be a need to use this option to boot a vPar.

       The command can be used to clear the pending reboot for reconfiguration flag. If the pending reboot for reconfiguration flag  is  set,  the
       user  will  not be able to boot any virtual partition until the monitor is rebooted. If this flag has been set in error, the command can be
       used to clear it thus enabling virtual partition boots.

       The command will display, enable, or disable hyperthreading.  With no arguments, the command displays the current state	of  hyperthreading
       and  what  the  state  will be after an nPartition reset.  When or is given as an argument, the command changes the hyperthreading setting.
       However, an nPartition reset is required before any change takes effect.

       The command can be used to read an alternate valid partition database filename for partition configuration information.

       filename must be an absolute path and reside on an HFS file system.

       This command may only be used when the is booted and one or more of the following conditions exist:

	  o  The default partition database does not exist, or

	  o  The alternate partition database as specified in the option of does not exist, or

	  o  The database file read is corrupt.

       [mode]

       The command will reboot the entire hard partition.  Other hard partitions are not affected.

       Each virtual partition should be shut down prior to invoking the reboot command.  A confirmation  prompt  is  provided.	 However,  if  you
       accept  confirmation  of  the  reboot while any virtual partitions are running, the command will bring down the running partitions ungrace-
       fully.

       The valid values for the optional argument mode are If mode is specified as after the reboot, the system will be in  the  vPars	mode.	If
       mode is specified as after the reboot, the system will be in the nPars mode.

       The argument is case-insensitive.

       This optional argument is applicable for Itanium-based platforms only.

       The command resets to zero the time of day drift value of all the virtual partitions.

       On  a standalone system, the OS will own the real time of day clock.  In the emulates the time of day clock for each virtual partition.	To
       do this, the keeps track of the drift value, which indicates how much the real time of day clock differs from each virtual partition's cur-
       rent  time  value.   If the user were to make any changes to the real time of day clock at the BCH prompt, the drift value becomes invalid.
       In this situation, the user may use this command to set to zero the drift values for all of the partitions.

       | vpar_name] |

       The command enables the MP (Management Processor) user of an nPartition to enable or disable the virtual partition flexible  administrative
       capability  and also to designate zero, one or more virtual partitions to have administration capabilities ().  A Designated-Admin vPar can
       create, boot, reset, modify, and remove vPars other than itself.  A non Designated-Admin vPar is  restricted  to  modifying  only  its  own
       resources  and  attributes.   A	non  Designated-Admin vPar cannot create, boot, reset, modify, or remove another vPar.	The command may be
       invoked with one of the following mutually-exclusive options:

       Enables the virtual partition flexible administrative capability
		 and allows the MP user of an nPartition to set a new virtual partition flexible administrative password.  By default, all  exist-
		 ing partitions are not Designated-Admin vPars.

       Disables the virtual partition flexible administrative capability
		 and  clears the virtual partition flexible administrative password and the Designated-Admin vPars list.  By default, all existing
		 partitions are Designated-Admin vPars.

		 The and arguments are case-insensitive.

       Specifies the name of the existing virtual partition
		 which is to be added to the Designated-Admin vPars list.  The virtual partition name is added to the list when the virtual parti-
		 tion flexible administrative capability is enabled.

       Specifies the name of the existing virtual partition
		 which	is  to be deleted from the Designated-Admin vPars list.  The virtual partition name is deleted from the list when the vir-
		 tual partition flexible administrative capability is enabled.

       List all the Designated-Admin vPars.

       If no arguments are supplied, displays whether the virtual partition flexible administrative capability is enabled or  disabled.   The  and
       options are used only when the virtual partition flexible administrative capability is enabled.

       mon_boot_path

       The  command adds a new boot path or updates the existing boot path (with the description in the hard partition EFI Boot Manager menu.  Use
       this command to boot from a disk if the disk does not have an entry in the EFI Boot Manager menu.

       The mon_boot_path hardware path must be a valid hardware path format (see ioscan(1M) for the correct format) and a valid  EFI  device  path
       mapping must exist for the hardware path in the vPars database.	Refer to vparefiutil(1M) for additional information on HP-UX hardware path
       to EFI path mappings.

   vPars Monitor Information Lookup Commands
       This section explains the vPars monitor information lookup commands.

       The bootpath command can be used to display monitor boot path.

       The command is similar to the HP-UX command.  However, only one filename may be specified.  When the optional string is given, the  command
       will return after printing if it was able to open the file in read-only mode.

       This command is applicable for PA-RISC platforms only.

       The command can be used to dump contents of console buffer for the virtual partition vpar_name.

       This command is applicable for PA-RISC platforms only.

       The  command lists the contents of the AUTO file in the LIF directory.  When the system is booting up and when the global automatic booting
       is true, the ISL reads the contents of this file to load the appropriate OS.  For vpars, set this file with the command to make the  system
       boot all the vpars whose autoboot is set on.

       This command is applicable for PA-RISC platforms only.

       The command can be used to list the contents of the LIF directory on the boot device.

       This command is applicable for PA-RISC platforms only.

       The command can be used to view the event log.

       The  command  is  similar to the HP-UX command.	However, only one target directory may be given.  If more than one directory is given, the
       contents of the last directory are listed.  If no target directory is given, the contents of the current directory (for example, the direc-
       tory) are listed.

       This command is applicable for PA-RISC platforms only.

       The command can be used to display release version information for the monitor.

       The  command  does a scan of the system bus.  For each resource on the bus, it prints the legacy hardware path of the resource, the type of
       resource, and the name of the partition that owns the resource.

       The command displays a list of resources that have been assigned to a particular partition or that are not yet unassigned.

       Unassigned resources are displayed when vpar_name is not specified.  These  unassigned  resources  include  free  local	bus  adapters  and
       resources  shared  between  more than one partition such as memory controller and system bus adapters.  Also displayed information includes
       partition names, size of free memory, and the ranges of free memory.

       When vpar_name is specified, information about that virtual partition is displayed.  This information includes the  amount  of  memory  the
       partition  owns,  any  explicitly specified memory ranges that have been assigned to the partition, boot device path, the kernel path, boot
       options, the state of the autoboot flag, and whether the partition is marked as static or dynamic.  If the partition is active, the  infor-
       mation also includes the memory ranges that were assigned to the partition by the vpmon when the partition was activated.

   SECURITY RESTRICTIONS
       This  command  is restricted to processes owned by superuser or with DEVOPS privilege.  See privileges(5) for more information about privi-
       leged access on systems that support the fine-grained privilege feature.

AUTHOR

       was developed by the Hewlett-Packard Company.

SEE ALSO

       ioscan(1M), vparadmin(1M), vparboot(1M), vparconfig(1M), vparcreate(1M), vpardump(1M), vparefiutil(1M), vparenv(1M), vparextract(1M), vpar-
       modify(1M), vparreloc(1M), vparremove(1M), vparreset(1M), vparstatus(1M), vparutil(1M), vparresources(5), vpartition(5).

																	  vpmon(5)