NAME
parcreate — create a new partition
SYNOPSIS
parcreate
[-P
PartitionName]
[-I
IPaddress]
-c cell
:[cellType]:[use_on_next_boot
]:[failure_usage]
[-c...]
[-b
path]
[-t
path]
[-s
path]
[-r
cell]
[-r...]
[-B]
[-k
s_lock]
DESCRIPTION
The
parcreate
command creates a new partition. This command takes the specified
cells (and any attached I/O chassis) from the free cell list
and assigns them to the partition.
This command finds an available partition id and assigns it to
the new partition. It returns the partition id of the newly created
partition.
Options and Arguments
parcreate
recognizes the following command line options and arguments:
- -P PartitionName
Specifies the name of the new partition. The characters which can appear in
a valid partition name are
a-z,
A-Z,
0-9,
-
(dash),
_
(underscore),
" " (space) and
.
(period). If
the partition name includes space then the name should be enclosed within
double quotes.
- -I IPaddress
Specifies the IP address that should be used by management tools (like SAM)
to address this partition. This value must be consistent with the IP address
that is assigned to the partition once HP-UX is installed and
networking is configured.
- -c cell:[cellType]:[use_on_next_boot]:[failure_usage]
Specifies the cell(s) to be assigned to the partition.
cell
specifies the cell id. It can be specified either in the local
(cabinet#/slot#)
or global
(slot#)
format. For example, the cell located
in cabinet 2, slot 4 is locally identified as 2/4 or globally as
simply 20.
cellType
specifies the cell type.
The current valid
cellType
value is:
base,
which is the default if
cellType
is not specified.
use_on_next_boot
specifies whether the cells will participate
in a reboot.
The current valid values for
use_on_next_boot
are:
- y
participate in reboot. Default.
- n
do not participate in reboot.
The valid value for
failure_usage
is:
- ri
reactivate with interleave. This is the default. Other values will be
supported in future releases.
- -b path
Specifies the primary boot path.
path
specifies the physical hardware path.
- -t path
Specifies the alternate boot path.
path
specifies the physical hardware path.
- -s path
Specifies the secondary boot path.
path
specifies the physical hardware path.
- -r cell
Specifies the root alternates. One to four cells can be specified.
The first cell specified is the first root alternate cell, the second
cell specified is the second root alternate cell, the third cell specified
is the third root alternate and the fourth cell specified is the fourth root
alternate.
A
cell
can be specified either in the local
(cabinet#/slot#)
or global
(slot#)
format. For example, the cell located in cabinet 2, slot 4 is locally
identified as 2/4 or globally as simply 20.
- -B
Specifies to boot the partition. The default is not to boot.
- -k s_lock
Specifies a lock key for the Stable Complex Configuration Data provided by
SAM. This option is not available to the command line user.
At least one of the cells specified must contain core I/O with the
use_on_next_boot
flag set to "y".
Root permissions are required to run this command.
EXIT STATUS
The
parcreate
utility exits with one of the following values:
- 1
Error condition occurred.
EXAMPLES
Create a new partition
myPartition
with 2 cells. One of the cells is located in cabinet 2, slot 4.
The
cellType
for the cell is
base.
The
failure_usage
policy for this cell is
ri
- reactivate with interleave.
The other cell is located in cabinet 2, slot 6. The
cellType
is
base
and
failure_usage
policy for this cell is
ri
- reactivate with memory
interleave. The
use_on_next_boot
for both cells is
y.
parcreate -P myPartition -c 2/4:base:y:ri -c 2/6:base:y:ri
-b 0/0/52/2.6 -t 0/0/52/3.6 -s 0/0/52/4.6 -r 2/4
Create a new partition
nextPartition
with 2 cells. The cells are located in cabinet 0, slot 4 and slot 6.
This example uses the default values for the cells.
parcreate -P nextPartition -c 4::: -c 6:::
AUTHOR
parcreate
was developed by the Hewlett-Packard Company.
Printable version
