HP-UX Reference (11i v3 07/02) - 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 cell:[celltype]
:[use_on_next_boot]
:[failure_usage][
:clm_value] ]...
[
-b path][-t
path][-s path][-r cell][-r cell]... [
-T flag]
[
-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.
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.
Please refer to the nPartition Administrator’s 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:
-B Specifies that the new partition be booted. The default is not to boot. Note: On
Itanium-based platforms this option has no effect, because boot paths cannot be set on
the new partition. Therefore, the partition cannot boot automatically. You must
manually boot up the partition from the SP console interface.
-b path Specifies the primary boot path. path specifies a physical hardware path. Note: On
Itanium-based platforms, boot paths cannot be set or modified on a non-local partition.
You must use the SP console interface to set any boot path of the newly created parti-
tion.
-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 glo-
bal (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 values for a cell are:
base This is the default if celltype is not specified. A base cell in a partition
participates in interleaved memory.
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.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 129