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)