HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

p
parcreate(1M) parcreate(1M)
created partition.
-s path Specifies the secondary 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 partition.
-r cell Specifies the core cell choices. A core cell choice is a configured cell which has
attached core IO. If the core cell of a partition is deleted then the firmware will
select the first core cell choice as the next core cell. One to four core cell choices can
be specified. The first cell specified is the first core cell choice, the second cell
specified is the second core cell choice, the third cell specified is the third core cell
choice and the fourth cell specified is the fourth core cell choice.
A cell 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.
-k s_lock Specifies a lock key for the Stable Complex Configuration Data provided by
parmgr. Note: The -k option is intended for use by system management tools
which invoke the parcreate command programmatically. Command line users
should avoid this option.
-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 BCH prompt.
-I IPaddress Specifies the IP address that should be used by management tools such as
parmgr
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.
-L clm_value Specifies the amount of the memory that will be used as local (non-interleave)
memory per cell. The clm_value specified using the -c option takes precedence
over the clm_value specified using the -L option. Please refer to the explanation of
the -c option for details of the clm_value formats.
-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. The partition name can have a maxmimum of 64 characters.
Mapping of Global Cell Numbers to Local Cell Numbers
The cabinets in a complex are numbered starting from 0. The cell slots in each cabinet are also numbered
starting from 0. Each cabinet can have a maximum of 8 cells. For example, the cells located in cabinet 0
will have the following cell numbers in global format: 0, 1, 2, 3, 4, 5, 6, 7. The cell numbers in
corresponding local format will be 0/0, 0/1, 0/2, 0/3, 0/4, 0/5, 0/6, 0/7.
Similarly the cells located in cabinet 1 will have the following cell numbers in global format: 8, 9, 10, 11,
12, 13, 14, 15. The cell numbers in corresponding local format will be 1/0, 1/1, 1/2, 1/3, 1/4, 1/5, 1/6, 1/7.
From the above convention the cell located in cabinet 1, slot 0 is identified in the local format as 1/0 or in
the global format as 8. The parstatus (1) command will display the above cell as "cab1,cell0". The cell
located in cabinet 1, slot 4 is identified in the local format as 1/4 or in the global format as 12. The par-
status (1) command will display the above cell as "cab1,cell4".
RETURN VALUE
The
parcreate command exits with one of the following values:
0 Successful completion.
1 Error condition occurred.
EXAMPLES
Create a new partition
myPartition with two cells. One of the cells is located in cabinet 0, slot 4. The
celltype for the cell is base. The failure_usage policy for this cell is ri. The CLM value for this cell is
1GB.
Section 1M−−588 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: August 2003