HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

v
vparreset(1M) vparreset(1M)
NAME
vparreset - reset a virtual partition
SYNOPSIS
vparreset -p vp_name [-h|-t][
-q][-f]
DESCRIPTION
The
vparreset command simulates, at the virtual partition level, the RS and TOC operations at a
Control-B prompt on the system console.
Only a superuser can execute the vparreset command. In a secure virtual partition environment only a
Primary-Admin
vPar can reset other virtual partitions.
vparreset causes the virtual partition 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, 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 virtual partition monitor is rebooted. Refer to HP Systems Partitions Guide, Administration
for nPartitions, and the section titled "Performing a Reboot for Reconfig for an nPartition" for further
details.
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.
-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.
-h Simulates a hard (RS) reset instead of a TOC. Displays current PIM data before
resetting unless the -q option is also specified. It also inhibits the autoboot behavior
(just like shutdown -h does); therefore -h can be used to break out of a reboot loop.
Because -h overrides the autoboot setting for that partition, the partition must be
manually restarted via vparboot or vparload.
-q Bypasses the display of current PIM data when resetting the virtual partition.
-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.
RETURN VALUE
The vparreset command exits with one of the following values:
0 Successful completion.
1 One or more error conditions occurred.
EXAMPLES
Perform a TOC reset on the virtual partition called Oslo, dumping the PIM data:
vparreset -p Oslo -t
Reset virtual partition Oslo? [n] y
Perform a hard reset on virtual partition Bergen skipping the confirmation dialog:
vparreset -p Bergen -h -f
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−1113