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
ERRORS
vparreset
displays error messages on stderr for any of the following conditions:
A required option is omitted.
An unknown option is specified.
A value is omitted for an argument that requires one, or a value is
specified for an argument which does not take one.
vp_name
does not exist in the monitor database, or is in the wrong state.
Both the
-h
and
-t
options are specified.
The
vparreset
command and the virtual partition monitor are at different revision
levels. This message is only a warning. The command continues.
AUTHOR
vparreset
was developed by the Hewlett-Packard Company.
Printable version
