vparreset.1m (2010 09)

v
vparreset(1M) vparreset(1M)
NAME
vparreset - reset a virtual partition
SYNOPSIS
vparreset -p vp_name [-h|-t][
-q][-f]
Platform Support Remarks
This
vparreset describes functionality on systems not running Onboard Administrator (OA)
based partition management. For vparreset
on systems with OA based partition management,
refer to vparreset2 (1M) by typing
man vparreset2
.
DESCRIPTION
The
vparreset command simulates, at the virtual partition level, the hard reset (ReSet, RS) and soft
reset (Transfer Of Control, TOC) operations supported by server management processor commands.
vparreset 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 -q (quiet) option is also specified.
Following a soft (TOC) reset, the specified virtual partition is normally rebooted if it has been configured
with the
auto attribute using either the vparcreate
or vparmodify commands. However when a
virtual partition is reset during very early stages of loading, the virtual partition may not be automati-
cally rebooted. Also, on hard-partitionable systems such as the HP Superdome, if there is a pending
reboot for reconfiguration, the specified virtual partition will not be booted until all the virtual partitions
on that hard partition are shut down and the vPars Monitor is rebooted. Refer to the nPartition
Administrator’s Guide , and the section titled "Performing a Reboot for Reconfig for an nPartition" for
further details.
Also if the system is UP and running in vPars mode, and the next boot mode is set to nPars mode, the
specified virtual partition will not be booted until the system’s next boot mode is changed to vPars mode
using
vparenv -m vPars.
Unintentional use of the
vparreset command has serious consequences. Therefore, the user is
prompted to confirm the operation unless the
-f (force) option is specified.
Options
vparreset recognizes the following command line options and arguments:
-p vp_name Specifies the unique name of the virtual partition to be reset. The virtual partition must
be in a state other than Down or Crashing.Required.
-f 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.
-h Simulates a hard (RS) reset instead of a TOC. Displays current PIM data before reset-
ting unless the -q option is also specified. It also inhibits the autoboot behavior, as does
the shutdown -h command. Therefore vparreset -h can be used to break out of a
reboot loop. Because vparreset -h overrides the autoboot setting for the specified
virtual partition, the virtual partition must be manually restarted using vparboot or
vparload.
With the
-h option, the virtual partition operating system is abruptly shutdown and no
operating system crash dump is saved. Therefore, HP recommends using the -t (soft
reset) option instead of the -h option to save a crash dump when resetting.
-q Bypasses the display of current PIM data when resetting the virtual partition.
-t Simulates a TOC reset. Displays current PIM data before resetting unless the -q option
is also specified.
The TOC reset is also the default operation of the command, applied if neither the
-h nor
-t option is specified.
The
-t and -h 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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1