vparcreate2.1m (2010 09)

v
vparcreate2(1M)
For OA Based Partition Management Systems
vparcreate2(1M)
NAME
vparcreate - create a virtual partition
SYNOPSIS
Invoked from operating system (OS):
vparcreate
[-a rsrc]...
[-p vpar_id | -p vpar_id -Z parspec_name]
[
-P vpar_name]
Invoked from Onboard Administrator (OA):
vparcreate
[-a rsrc]...
[-p vpar_id -N npar_id | -p npar_id
:vpar_id | -p vpar_id -Z parspec_name]
[
-P vpar_name]
Platform Support Remarks
This
vparcreate describes functionality on systems with Onboard Administrator (OA) based par-
tition management. For vparcreate on systems not running OA based partition management,
refer to vparcreate1 (1M) by typing man vparcreate1
.
DESCRIPTION
The
vparcreate command creates a new virtual partition using the specified hardware resources. If a
virtual partition number is not specified, the command finds an available virtual partition number and
assigns it to the new virtual partition. Likewise if a virtual partition name is not specified, a default
name of the format vParNNNN is given to the new virtual partition.
The
vparcreate command accepts resource path for all resource specifications. Resource path can be
specified in short, medium, or long format. For example, CPU number 2 located in enclosure
3, blade 6,
socket
0 is identified in the short format as 3/6/0/2, in the medium format as
cpucore-3/6/0/2,or
in the long format as
enclosure3/blade6/cpusocket0/cpucore2
. See resourcepath (5).
On platforms that support OA-based partition management, virtual partitions can be created from the OA
also. Users can switch the nPartition to vPars mode and poweron the nPartition before creating virtual
partitions from the OA. This will allow better resource validation checks for the virtual partition being
created.
Options and Arguments
Only the
-a (add resource) option may be specified more than once. Resources allocated with the
-a
option must be available, that is, not already allocated to a virtual partition, nor exceeding the overall
limits of the resources. Some CPU resources have special requirements; these are described in the follow-
ing Table 1. Resources assigned with multiple -a options must not conflict. Violation of any condition is
a command error.
The
vparcreate command recognizes the following command line options and arguments:
-a rsrc Adds resources to a virtual partition. rsrc is a hardware resource specification using
resource path.
A summary of resource syntax forms is shown in Table 1 below. Multiple
-a rsrc
specifications in the same command are allowed, but some syntax forms are only allowed
once. This is indicated in Table 1. In all cases, resources in multiple specifications must
not repeat or conflict with each other.
-p vpar_id Specifies the number or name for the virtual partition (vPar) to be created. If -
p number is specified, the specified number is used as the vPar number for the vPar. If
-p number is not specified, a vPar number is automatically assigned to the created vPar.
Valid partition numbers range from 1-255. If -p name is specified, the specified name is
used as the name for the vPar to be created.
Note that the user can also use the
-P option to specify the name of the vPar. Attempts
to specify the vPar name using both -p and -P options in the same command line will be
considered invalid.
A vPar name should at least have one of the following non-numeric character
a-z, A-Z,
dash (-), underscore (_), or period (.). No other non-numeric character is allowed in a
vPar name. The maximum length of a vPar name is 255 characters, including the null
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1