parcreate Command

The parcreate command creates a new nPartition.

This command assigns the specified cells (and any attached I/O chassis) to an nPartition, assigns a number to the new nPartition, and returns the partition number of the newly created nPartition.

Root permission or IPMI LAN access is required to use parcreate.




	NOTE: On servers based on the HP sx1000 chipset or HP sx2000 chipset, when the nPartition Configuration Privilege is restricted the parcreate command cannot create a new nPartition. This restriction does not apply when using the -g... -h... options.

Refer to the parcreate(1M) manpage for complete details.

Synopsis

The parcreate command supports slightly different options for the HP-UX B.11.11 and other releases.

Original nPartition Commands.

parcreate [-P PartitionName] [-I IPaddress]
-c cell:[type]:[use_on_next_boot]:[failure_usage] [-c...] 
[-b path] [-t path] [-s path] [-r cell] [-r...] [-B]

Enhanced nPartition Commands.

parcreate [-P PartitionName] [-I IPaddress] [-L clm_value] 
-c cell:[type]:[use_on_next_boot]:[failure_usage][:clm] [-c...] 
[-b path] [-t path] [-s path] [-r cell] [-r...] [-T flag] [-B] 
[-u username -h IPaddress|hostname |-g -h IPaddress|hostname ]

The -u... -h... set of options may be specified to cause the command to send its management request using WBEM to an nPartition other than the local nPartition (but can also be used as a "loopback access" to the local nPartition).
The -g... -h... options may be specified to cause the command to send its management request using IPMI over LAN to a service processor in another server complex (but can also be used as a "loopback access" to the service processor in the local complex).

The -u and -g options are mutually exclusive.

Options

-P PartitionName

Specifies the name of the new nPartition.

-I IPaddress

Specifies the IP address that can be used by management tools to address this nPartition. This value should be consistent with the IP address used for the nPartition when an operating system is booted.

-L clm_value

Specifies the amount of the memory that will be used as cell local memory per cell. The clm_value specified using the -c option takes precedence over the clm_value specified using the -L option. See the -c option for a description of the clm_value formats.

-c cell:[type]:[use_on_next_boot]:[failure_usage][:clm]

Specifies the cell(s) to be added to the nPartition.

The only valid type value is:
base
Base cell. (The default.)
The valid use_on_next_boot values for cells are:
y
Participate in reboot. (The default.)
n
Do not participate in reboot.
The only valid failure_usage value is:
ri
Reactivate with memory interleave (the default). Specifies to integrate the cell into the nPartition as normally occurs.
Enhanced nPartition Commands only.
The clm value specifies the amount of memory that will be configured as cell local memory for the cell.
The clm value specified using the -c option takes precedence over the clm value specified using the -L option.
You can specify the clm value in either of two forms: percentage or absolute amount of memory. The default is 0 (no cell local memory).
- Percentage cell-local memory (CLM).
  The percent number can be any number in the range 0-100 with a suffix of %.
  This number is rounded to 12.5%, 25%, 37.5%, 50%, 62.5%, 75%, 87.5% or 100%. If the cell contains less than 4 GBytes of memory, then the percentage is rounded to 25%, 50%, 75% or 100%. Percentages are rounded up or down to the nearest value, but are not rounded up to 100%.
- Absolute CLM specification. (The default.)
  The absolute number is interpreted as an absolute number of gigabytes of memory and can optionally have a suffix of GB.
  As needed, an absolute CLM specification is rounded up to the nearest 0.5 GBytes.
If the clm value is rounded, the command reports the final value used.

-b path

Specifies the primary boot path.

For HP 9000 servers, this is the PRI boot path.

For HP Integrity servers, only boot options for the local nPartition can be modified—therefore, boot paths for a newly created nPartition cannot be set using parcreate. Instead use the EFI system boot interface, available through the nPartition console.

-t path

Specifies the alternate boot path.

For HP 9000 servers, this is the ALT boot path.

-s path

Specifies the secondary boot path.

For HP 9000 servers, this is the HAA boot path.

-rcell

Specifies the core cell choices. One to four cells can be specified.

-T flag

Specifies whether Hyper-Threading should be enabled or not (only if cells support this feature). By default Hyper-Threading is disabled.

The valid values for flag are:

y: Enable Hyper-Threading, which allows multiple threads to run concurrently on each processor core.
n: Disable Hyper-Threading. This is the default value.

-B

Specifies to boot the nPartition. The default is not to boot the nPartition and leave it in the shutdown for reconfig state.

-u username

Enhanced nPartition Commands only. Specifies the account and authorization to access an nPartition other than the local nPartition.

The -h option is required if this option is used.

username specifies a configured user name on the target nPartition.

-g

Enhanced nPartition Commands only. Allows access to the complex specified by the -h option. The accessed complex is then considered the target complex. Access is through the service processor LAN port.The -h option is required if this option is used.

-h IPaddress|hostname

Enhanced nPartition Commands only. This option is only used in combination with either the -u or -g option. IPaddress|hostname specifies the IP address or hostname of the target nPartition (-u) or service processor (-g).

parcreate Command

Technical documentation

» Table of Contents

Synopsis

Options