parcreate2.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

parcreate(1M)

For OA Based Partition Management Systems

parcreate(1M)

determines whether the OA can automatically modify a parspec in order to enable a

partition operation (such as booting). In some scenarios, it is possible that the sys-

tem cannot meet the customer requested resource or attribute speciﬁcations in the

parspec for an nPartition or virtual partition. This can be due to non-existent

resources or degraded resources or other restrictions in hardware architecture.

Under these circumstances, the partition conﬁguration in the parspec may need to

be modiﬁed to make forward progress. The parspec change policy attribute of the

nPartition gives the customer the ability to choose the behavior in these cases. If

the parspec change policy is enabled (default), the affected partition operation is

continued with available or modiﬁed resources or attributes after making the

required changes in the parspec. If the parspec change policy is disabled, the

affected partition operation fails and no changes are made to the parspec.

-Z parspec_name Creates an nPartition from a partition speciﬁcation (parspec). On successful nParti-

tion creation, the parspec speciﬁed with the

-Z option will be made the current par-

spec for the nPartition. When the

-Z option is not speciﬁed, a default parspec of

the format

psNNNN is created and made the current parspec (where NNNN is a 4

digit nPartition number). If a parspec with the same name exists, it is overwritten.

When this option is speciﬁed, any other option specifying resource assignments or

nPartition attributes is not allowed.

Note: the

-Z and -C options are mutually exclusive.

RETURN VALUE

The

parcreate command exits with one of the following values:

0 Successful completion.

1 Error condition occurred.

ERRORS

syslog contains additional description of errors encountered during partition operations. Users can

view the OA syslog from the OA using the "SHOW SYSLOG OA" command.

Error: System unable to accept partition commands

The above error message is printed out under the following circumstances:

• Attempting to run command from an OA other than the active OA in enclosure 1.

• System has been shut down (e.g. with POWEROFF XFABRIC, or ambient overtemp).

• The OA has not ﬁnished initializing.

In the above scenarios, please ensure the system and OA are completely up and you are running the com-

mand from the active OA in enclosure 1.

EXAMPLES

Create a new nPartition

nextPartition with two blades. The blades are located in enclosure 1, slot 1

and slot 2. This example uses the default values for the blades. The default blade_type will be base.

The default failure_usage policy will be ri. The default use_on_next_boot will be

y. By default there will

be no SLM for the blades.

parcreate -p nextPartition -a blade:1/1:::: -a blade:1/2::::

Create the new two-blade nPartition nextPartition from the previous example that uses IO slots in

IOX enclosure 5, bay 1.

parcreate -p nextPartition -a blade:1/1:::: -a blade:1/2:::: \

-a io:5/1:

Create a new nPartition myPartition with two blades. One of the blades is located in enclosure 1, slot

3. The blade_type for the blade is base. The failure_usage policy for this blade is ri. The SLM value

for this blade is 1 GB. The other blade is located in enclosure 2, slot 6. The blade_type and failure_usage

are not speciﬁed for this blade. The use_on_next_boot for both blades is y.

parcreate -p myPartition -a blade:1/3:base:y:ri:1GB \

-a blade:2/6::y::

Re-create the two-blade nPartition nextPartition from the saved parspec nextPartition_copy.

HP-UX 11i Version 3: March 2012 − 5 − Hewlett-Packard Company 5