vparenv(1m) [hpux man page]
vparenv(1M) vparenv(1M) NAME
vparenv - display or set the environment for the next boot SYNOPSIS
mode] memtype:size] DESCRIPTION
The command displays or sets appropriate firmware variables on Itanium-based platforms. The variables manage the partition boot mode ( or CLM granularity and ILM granularity. By default, the command displays the current settings of the partition boot mode and memory granular- ities. The command also displays the maximum possible ILM granules for the system and the maximum possible CLM granules per cell. Note: This information is displayed by the command only if the system has been switched to vPars mode atleast once after a system reset. Users should consider these maximums when specifying either granularity. Care should be taken to choose granule sizes which do not result in the total number of granules exceeding the permissible limits for that system. In certain scenarios, the command may not be able to validate if the chosen memory granularities are appropriate for the system. The com- mand will display a warning message. In such cases, the user should validate the granularities against the total memory on the system and the supported number of memory granules on the system. Please refer to manpage for more details. Note: This command does not modify the ILM/CLM granule values in the vPars database file. It only modifies the appropriate EFI variables. This command is not supported on PA-RISC platforms. Options and Arguments recognizes the following command line options and arguments: Specifies the mode for the next system boot. The valid values for mode are case-insensitive If mode is specified as then after the next reboot, the system will be in the vPars mode. If mode is specified as then after the next reboot, the system will be in the nPars mode. Note: The mode setting does not take effect until the next system (hard partition) reboot. Specifies the desired granularity of Cell Local Memory (CLM) or InterLeaved Memory (ILM) to be set in the appropriate EFI variable. memtype specifies the type of memory. The valid values are case insensitive and size specifies the desired granularity in megabytes. Note: The granule settings do not take effect until the next system (hard partition) reboot. WARNINGS
The EFI granule settings must be the same as those in the vPar database loaded into the monitor. If one or both settings do not match, the monitor will not allow any vPar to boot. Refer to the vparcreate(1M) manpage. To correct this, you must either change the EFI variables using this command or change the granularity values in the database file by recreating the database using EXAMPLES
Set the boot mode to Set the CLM granularity to 128 MB. Set the ILM granularity to 128 MB and CLM granularity to 128 MB. SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser. When virtual partition flexible administrative capability is enabled, the boot environment firmware variables can only be set from within a Designated-Admin vPar. RETURN VALUE
The command exits with one of the following values: Successful completion. An error condition occurred. AUTHOR
was developed by the Hewlett-Packard Company. SEE ALSO
vparadmin(1M), vparboot(1M), vparconfig(1M), vparcreate(1M), vpardump(1M), vparefiutil(1M), vparextract(1M), vparmodify(1M), vparreloc(1M), vparremove(1M), vparreset(1M), vparstatus(1M), vparutil(1M), vparresources(5), vpartition(5), vpmon(5). Itanium(R)-based Systems Only vparenv(1M)
Check Out this Related Man Page
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)