parremove(1M) parremove(1M)
NAME [Toc] [Back]
parremove - remove an existing partition
SYNOPSIS [Toc] [Back]
parremove -p PartitionNumber [-F] [-k s_lock:p_lock]
[ -u username:[passwd] -h IPaddress|hostname
| -g [passwd] -h IPaddress|hostname]
DESCRIPTION [Toc] [Back]
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 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.
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.
Root 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, root 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 root
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 nPartition 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.
Please refer to the HP System Partitions Guide for a description of
the partition management terms used in this man page.
Options and Arguments [Toc] [Back]
parremove recognizes the following command line options and arguments:
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: Sep 2004
parremove(1M) parremove(1M)
-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
parremove 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.
-u username:[passwd]
Specifies the required authorization to access a
partition other than the local system (but can
also be used as a loopback access to the local
partition). The complex to be modified is the one
in which this target partition resides.
The -h option is required if this option is used.
username specifies a configured user name on the
target partition.
passwd specifies the password associated with the
username. If this field is empty, the command
prompts for the password.
Note: This command is a Web-Based Enterprise
Management (WBEM) Client Application. The -u
option accesses the target partition using a
Secure Sockets Layer (SSL) connection. If errors
are reported, check that the conditions described
in the DEPENDENCIES section are satisfied.
SECURITY WARNING: Specifying the password directly
on the command line may pose a security risk in
your environment. The ps(1) or other related
commands can be invoked in such a way as to
display the command line of a process. In this
situation, any authenticated user on the system
can potentially see the password while the process
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: Sep 2004
parremove(1M) parremove(1M)
is executing. Hence, it is highly recommended not
to specify the password on the command line, and
instead allow the command to prompt for the
password.
-h IPaddress|hostname
This option should only be used in combination
with either the -u or -g option.
IPaddress|hostname specifies the IP address or
hostname of the target partition (-u) or complex
(-g).
-g [passwd] Allows access to the complex specified by the -h
option. The accessed complex is then considered
the target complex. Access is via the service
processor's LAN port.
The -h option is required if this option is used.
passwd specifies the IPMI password of the service
processor. If this field is omitted, the command
prompts for the password.
If an error is reported when you attempt to
connect using this option, check to see that IPMI
LAN access has not been disabled on the remote
service processor. Access to the complex via IPMI
over LAN can be enabled or disabled by logging on
to the service processor and using the SA command
from the Command Menu.
The -u and -g options are mutually exclusive.
SECURITY WARNING: Specifying the password directly
on the command line may pose a security risk in
your environment. The ps(1) or other related
commands can be invoked in such a way as to
display the command line of a process. In this
situation, any authenticated user on the system
can potentially see the password while the process
is executing. Hence, it is highly recommended not
to specify the password on the command line, and
instead allow the command to prompt for the
password.
-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.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: Sep 2004
parremove(1M) parremove(1M)
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 shutdown using the
-R[-H] option of the shutdown(1M) command.
-k s_lock:p_lock Note: The -k option is intended for use by system
management tools which invoke the parremove
command programmatically. Command line users
should avoid this option.
The -k option specifies the lock keys provided by
Partition Manager (parmgr) for Complex
Configuration Data and Partition Configuration
Data.
Lock keys should always be specified in pairs. If
either lock key is not available, enter -1 as a
placeholder. For example, if the s_lock key is
available but the p_lock key is not, then the
option should be specified as -k s_lock:-1.
RETURN VALUE [Toc] [Back]
The parremove command exits with one of the following values:
0 Successful completion.
1 Error condition occurred.
EXAMPLES [Toc] [Back]
Remove the inactive partition whose PartitionNumber is 2:
parremove -p 2
Remove an inactive partition in the same complex as the remote host
Penzance. The command prompts for the root password:
parremove -p 0 -u root: -h Penzance
DEPENDENCIES [Toc] [Back]
This command uses the Web-Based Enterprise Management (WBEM) product
and certain of its configuration settings. If you encounter
connection errors when using the -u option, check that the following
two conditions are satisfied:
+ Use the cimconfig(1M) command to verify (and correct if necessary)
the setting of the following two variables:
+ enableRemotePrivilegedUserAccess=true
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: Sep 2004
parremove(1M) parremove(1M)
+ enableHttpsConnection=true
+ You must have appended the target partition's digital certificate
to the local partition's Trust Store file. For the nPartition
commands, the Trust Store file is /var/opt/wbem/client.pem.
Note: You must have appended the target partition's digital
certificate to the local partition's Trust Store file. For the
npartition commands, the Trust Store file is
/var/opt/wbem/client.pem. This file is used by the commands that
come with WBEM installation. Hence, if the commands that come with
the WBEM installation trust a target partition, then npartition
commands will also trust the target partition.
Refer to the WBEM documents specified in the SEE ALSO section below
for further information.
AUTHOR [Toc] [Back]
parremove was developed by the Hewlett-Packard Company.
SEE ALSO [Toc] [Back]
cplxmodify(1M), fruled(1), frupower(1M), parcreate(1M), parmgr(1M),
parmodify(1M), parstatus(1), parunlock(1M), partition(5),
HP System Partitions Guide on docs.hp.com,
HP WBEM Services for HP-UX System Administrator's Guide on
docs.hp.com,
HP WBEM Services for HP-UX 11i v2.0 on Integrity Servers Version
A.01.05 Release Notes on docs.hp.com.
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: Sep 2004 [ Back ] |
