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
vparreset(1M) vparreset(1M) NAME
vparreset - reset a virtual partition SYNOPSIS
vp_name DESCRIPTION
The command simulates, at the virtual partition level, the hard reset (ReSet, RS) and soft reset (Transfer Of Control, TOC) operations sup- ported by server management processor commands. causes the vPars Monitor to simulate a hard (RS) reset or soft (TOC) reset of the specified virtual partition. Either operation gathers new Processor Information Module (PIM) data, which is displayed unless the (quiet) option is also specified. Following a soft (TOC) reset, the specified virtual partition is normally rebooted if it has been configured with the attribute using either the or commands. However when a virtual partition is reset during very early stages of loading, the virtual partition may not be automatically rebooted. Also, on hard-partitionable systems such as the HP Superdome, if there is a pending reboot for reconfiguration, the specified virtual partition will be booted until all the virtual partitions on that hard partition are shut down and the vPars Monitor is rebooted. Refer to the and the section titled "Performing a Reboot for Reconfig for an nPartition" for further details. Unintentional use of the command has serious consequences. Therefore, the user is prompted to confirm the operation unless the (force) option is specified. Options recognizes the following command line options and arguments: Specifies the unique name of the virtual partition to be reset. The virtual partition must be in a state other than or Required. The force option. Omits the confirmation dialog before resetting the virtual partition. This option is intended for use by scripts and other non-interactive applications. Simulates a hard (RS) reset instead of a TOC. Displays current PIM data before resetting unless the option is also specified. It also inhibits the autoboot behavior, as does the command. Therefore can be used to break out of a reboot loop. Because overrides the autoboot setting for the specified virtual partition, the virtual partition must be manually restarted using or With the option, the virtual partition operating system is abruptly shutdown and no operating system crash dump is saved. Therefore, HP recommends using the (soft reset) option instead of the option to save a crash dump when resetting. Bypasses the display of current PIM data when resetting the virtual partition. Simulates a TOC reset. Displays current PIM data before resetting unless the option is also specified. The TOC reset is also the default operation of the command, applied if neither the nor option is specified. The and options cannot both be specified in the same command. SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser. When virtual partition flexible administrative capability is enabled, a virtual partition can only be reset from within a Designated-Admin virtual partition. RETURN VALUE
The command exits with one of the following values: Successful completion. One or more error conditions occurred. WARNINGS
The option causes an abrupt system shutdown and no operating system crash dump is saved. Refer to the option explanation for more informa- tion. EXAMPLES
Perform a TOC reset on the virtual partition called dumping the PIM data: Perform a hard reset on virtual partition skipping the confirmation dialog: ERRORS
displays error messages on standard error for any of the following conditions: o A required option is omitted. o An unknown option is specified. o A value is omitted for an argument that requires one, or a value is specified for an argument which does not take one. o vp_name does not exist in the monitor database, or is in the wrong state. o Both the and options are specified. o The command and the vPars Monitor are at different revision levels. This message is only a warning. The command continues. o When the virtual partition flexible administrative capability is enabled and the local virtual partition is not a Designated-Admin vir- tual partition. AUTHOR
was developed by the Hewlett-Packard Company. SEE ALSO
vparadmin(1M), vparboot(1M), vparconfig(1M), vparcreate(1M), vpardump(1M), vparefiutil(1M), vparenv(1M), vparextract(1M), vparmodify(1M), vparreloc(1M), vparremove(1M), vparstatus(1M), vparutil(1M), vparresources(5), vpartition(5), vpmon(5). vparreset(1M)