HP-UX Reference (11i v2 03/08) - 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:[passwd] -h
IPaddress|hostname
|
-g [passwd] -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 contains 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
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.
Please refer to the HP System Partitions Guide for a description of the partition management terms used
in this man page.
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 parti-
tion, 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 format 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 pro-
cess, 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:
ri reactivate with memory interleave. Specifies to integrate the cell as it
would normally be integrated. This is the default.
clm_value specifies the amount of the memory that will be configured as local (non-
interleaved) memory for the cell. The clm_value specified using the
-c option takes
precedence over the clm_value specified using the -L option. The command will
Section 1M−−586 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003