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)