vpmon(5)

Booting the vPars Monitor

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

With vPars installed, vpmon is loaded as follows:

Options

vpmon may be invoked with the following arguments:

vPars Monitor Commands

The commands that may be issued from the vpmon command prompt are classified as either vPars monitor management commands or vPars monitor information lookup commands.

vPars Monitor Management Commands

vparload [-p partition_name [-B [boot_device|tape] | -E disk_index ] [-b kernel_path] [ -o boot_options ]] | [-auto|all]

The vparload command can be used to load and activate one or more partitions. If vparload 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 options -B, -E, -b or -o should be used only with the -p option. Each options are detailed as follows:

clear_pending

The clear_pending 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 clear_pending command can be used to clear it thus enabling virtual partition boots.

readdb filename

The readdb 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 a HFS file system.

This command may only be used when the vpmon /stand/vpmon is booted and the default partition database (/stand/vpdb) does not exist, the alternate partition database as specified in the -D option of /stand/vpmon does not exist, or the database file read is corrupt.

reboot [mode]

The reboot 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, but if you accept confirmation of the reboot while any virtual partitions are running, the reboot command will bring down the running partitions ungracefully.

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

This optional argument is applicable for Integrity platforms only.

toddriftreset

The toddriftreset 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 vPars, the vpmon emulates the time of day clock for each virtual partition. To do this, the vpmon keeps track of the drift value, which indicates how much the real time of day clock differs from each virtual partition's current 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.

settime [MM DD YYYY hh mm ss]

Sets the system's real time clock. Acceptable date range is 1-1-1970 00:00:00 to 12-31-2034 23:59:59.

time

Displays system real time clock and OS time of all the virtual partitions in GMT (Greenwich Mean Time). The OS time displayed will consider the RTC and clock drift for the virtual partition. However, if the partition is up, there may be difference in the OS time displayed.

monadmin [-S on|off] | [-a|-d vpar_name] | [-l]

This 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 (Designated-Admin vPars). 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. It cannot create, boot, reset, modify, or remove another vPar. The monadmin command may be invoked with one of the following mutually-exclusive options:

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

mon_bootpath mon_boot_path

This command adds a new boot path or updates the existing boot path (with the description vPars monitor boot path) in the hard partition EFI Boot Manager menu. This command can be used 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 provided must be of 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

bootpath

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

cat filename [openonly]

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

This command is applicable for PA-RISC platforms only.

cbuf part_name

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

This command is applicable for PA-RISC platforms only.

getauto

The getauto 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, we can set this file with "hpux /stand/vpmon -a" to make the system boot all the vpars whose autoboot is set on.

This command is applicable for PA-RISC platforms only.

lifls [directory name]

The lifls 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.

log

The log command can be used to view the event log.

ls [-alniFH] [ directory name]

The ls command is similar to the HP-UX ls 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, /stand directory) are listed.

This command is applicable for PA-RISC platforms only.

release

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

scan

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

vparinfo [ vpar_name]

The vparinfo 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 unspecified. 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 information also includes the memory ranges that were assigned to the partition by the vpmon when the partition was activated.