HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

p
parremove(1M) parremove(1M)
NAME
parremove - remove an existing partition
SYNOPSIS
parremove -p PartitionNumber [
-F][-k
s_lock:p_lock]
[[
-u username [:
] -h IPaddress|hostname
|[
-g -h IPaddress|hostname ]]
DESCRIPTION
The
parremove command removes an existing partition. This will unassign all cells from the partition
and destroy the partition definition. PartitionNumber, the target partition, must be inactive except when
the
-F option is used. Even then, one of the following additional conditions must be satisfied:
• The target partition must be the local partition, the partition executing the
parremove com-
mand. If the
-u and -h
options are specified, the partition they access is considered to be the
local partition.
• The
-g option must be used to access the complex in which the target partition is configured.
By default, the target partition is assumed to be configured in the same complex as the local partition. The
-u and -g options allow the parremove command to remove a partition on the specified target (local or
remote) complex.
Superuser permission is required to run this command on the local partition. If the -u or
-g option is
used to access a remote partition or complex, superuser permission is not required on the local system, and
the local system need not exist on an nPartition. If the
-u option is specified, username on the remote host
must have superuser permission or the command will fail.
By the nature of its operation, the
parremove command modifies the configuration of its target complex.
Operation is affected by the state of the target complex’s nPartition Configuration Privilege. If the nParti-
tion Configuration Privilege is unrestricted (the default), or the complex is accessed using the
-g option, all
operations are allowed. Otherwise the command fails. The
-g option is unaffected by the state of the
nPartition Configuration Privilege. Note: The state of the nPartition Configuration Privilege can only be
changed at the service processor’s Command menu. This should be kept in mind when reading the Options
and Arguments section.
Refer to the nPartition Administrator’s Guide for a description of the partition management terms used in
this man page.
Options and Arguments
parremove recognizes the following command line options and arguments:
-p PartitionNumber
Specifies the partition to be removed. PartitionNumber specifies the unique partition
number (integer) assigned to the partition when it was created. If neither the
-u nor
-g option is specified, the target partition is in the local complex. Otherwise it is in
the complex determined by either of those options.
In either case, the target partition must be inactive unless the -F option has been
specified and one of the following conditions is also satisfied:
• The target partition must be the local partition, the partition executing the par-
remove
command. If the -u and -h options are specified, the partition they
access is considered to be the local partition.
• The -g option must be used to access the complex in which the target partition is
configured.
-F Forcibly remove the partition. This option is required if you are removing your own
local partition, which is active by definition, or if you are using the -g option to
remove an active partition in the target complex. It is ignored otherwise.
If you are removing an active partition, the partition is marked for removal. This
action is irreversible. However, the partition is not actually removed until it is shut-
down using the -R[-H] option of the shutdown command (see shutdown(1M)).
-g Allows access to the complex specified by the -h option. The accessed complex is then
considered the target complex. Access is through the service processor’s LAN port.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 141