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

p
parcreate(1M) parcreate(1M)
NAME
parcreate - create a new partition
SYNOPSIS
parcreate
-c
cell:[celltype]:
[use_on_next_boot]
:[failure_usage][
:clm_value]
[
-c...] [-b path][
-t path][-s path][-r cell][-r...]
[
-k s_lock][-B][
-I IPaddress][-L clm_value][-P
PartitionName]
[
-u username -h IPaddress|hostname
| -g -h IPaddress|hostname ]
DESCRIPTION
The
parcreate command creates a new partition. By default the new partition is created on the local
complex. Either the -u or the -g option can be specified to create a partition on the specified target (local
or remote) complex. The command takes the specified cells (and any attached I/O chassis) and assigns
them to the new partition. At least one of the cells specified must be attached to an I/O chassis that con-
tains core I/O. The command finds an available partition ID and assigns it to the new partition. It displays
the partition ID of the newly created partition on stdout.
By the nature of its operation, this command modifies the configuration of its target complex. Operation
can be 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, crea-
tion of new partitions is 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.
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 sys-
tem 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.
Please refer to the HP System Partitions Guide for a description of the partition management terms used in
this man page.
Remote Management Options
The
-u, -g and -L options will be available only if NParProvider and NPartition products are installed.
The clm_value value can be used only if NParProvider and NPartition products are installed. The
cplxmodify command exist only if NPartition product is installed.
Options and Arguments
parcreate recognizes the following command line options and arguments:
-c cell:[celltype]:[use_on_next_boot]
:[failure_usage][:clm_value]
Identifies a cell to be assigned to the partition. To assign multiple cells to the partition,
multiple
-c options should be used.
cell specifies the cell ID. It can be specified either in the local (cabinet#/slot#) or global
(cell#) format. For example, the cell located in cabinet 0, slot 1 is identified in the local for-
mat as 0/1 or in the global format as 1.
celltype specifies the type of the cell. The valid celltype value for cells is:
base This is the default if celltype is not specified.
use_on_next_boot specifies whether the cell will participate in a reboot. The valid values for
use_on_next_boot are:
y participate in reboot. This is the default. However if the slot is missing or the cell
does not exist or the cell is powered off then it defaults to n.
n do not participate in reboot.
At least one of the cells specified using the -c option must contain core I/O with the
use_on_next_boot flag set to y.
failure_usage field is used by system firmware when a partition is booted. If a CPU selftest
failure or a DIMM de-allocation occurs during the power-on self-test process, then this flag
is used by the system firmware to determine whether or not and how the cell should be
integrated into the partition at boot time. The valid failure_usage value for cells is:
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−639