vparenv.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vparenv(1M) vparenv(1M)

(Itanium-based Systems Only)

NAME

vparenv - display or set the environment for the next boot

SYNOPSIS

vparenv [-m mode][-g

memtype:size ]

DESCRIPTION

The

vparenv command displays or sets appropriate ﬁrmware variables on Itanium-based platforms. The

variables manage the partition boot mode ( vPars

or nPars), CLM granularity and ILM granularity. By

default, the command displays the current settings of the partition boot mode and memory granularities.

The command also displays the maximum possible ILM granules for the system and the maximum possi-

ble 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 command 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

vparresources.5

manpage for more details.

Note: This command does not modify the ILM/CLM granule values in the vPars database ﬁle. It only

modiﬁes the appropriate EFI variables.

This command is not supported on PA-RISC platforms.

Options and Arguments

vparenv recognizes the following command line options and arguments:

-m mode Speciﬁes the mode for the next system boot. The valid values for mode are

case-insensitive

vPars and nPars.Ifmode is speciﬁed as vPars, then after the

next reboot, the system will be in the vPars mode. If mode is speciﬁed as

nPars, then

after the next reboot, the system will be in the nPars mode.

Note: The current boot mode setting does not change until the next system (hard par-

tition) reboot. However on systems not running Onboard Administrator (OA) based

partition management, once the next boot mode has been changed from vPars to

nPars, further booting and loading of virtual partitions will fail even though the vPars

monitor has not been rebooted. To boot or load virtual partitions, change the boot

mode back to vPars mode.

-g memtype:size Speciﬁes the desired granularity of Cell Local Memory (CLM) or InterLeaved Memory

(ILM) to be set in the appropriate EFI variable. memtype speciﬁes the type of

memory. The valid values are case insensitive ilm and clm. size speciﬁes 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 ﬁle by recreating the database using

vparcreate.

EXAMPLES

Set the boot mode to

vPars.

vparenv -m vPars

Set the CLM granularity to 128 MB.

vparenv -g clm:128

Set the ILM granularity to 128 MB and CLM granularity to 128 MB.

vparenv -g ilm:128 -g clm:128

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
vparenv(1M) vparenv(1M) (Itanium-based Systems Only) NAME vparenv - display or set the environment for the next boot SYNOPSIS vparenv [-m mode] [-g memtype:size ] DESCRIPTION The vparenv command displays or sets appropriate firmware variables on Itanium-based platforms. The variables manage the partition boot mode ( vPars or nPars), CLM granularity and ILM granularity. By default, the command displays the current settings of the partition boot mode and memory granularities.
PAGE 2
vparenv(1M) vparenv(1M) (Itanium -based Systems Only) 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 vparenv command exits with one of the following values: 0 1 Successful completion. An error condition occurred. AUTHOR vparenv was developed by the Hewlett-Packard Company.