vparcreate.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vparcreate(1M) vparcreate(1M)

NAME

vparcreate - create a virtual partition

SYNOPSIS

vparcreate -p vp_name [-B boot_attr ][

-S static_attr ][-b kernel_path ]

[

-o boot_opts ][-a

rsrc]... [-D db_ﬁle]

[

-g memtype:size[

:update_fw]]

Platform Support Remarks

This

vparcreate describes functionality on systems not running Onboard Administrator (OA)

based partition management. For vparcreate on systems with OA based partition management,

refer to vparcreate2 (1M) by typing man vparcreate2

DESCRIPTION

The

vparcreate command creates a new virtual partition (vPar) using the speciﬁed hardware

resources. vp_name is a symbolic name for the virtual partition and must be used in all references to it.

If the -D option is speciﬁed, the vPar is created in db_ﬁle. Otherwise it is created in the vPar monitor

database. In either case, a vPar named vp_name must not already exist in the database. Any error ter-

minates the command without creating a virtual partition except if the command was terminated because

the vPars database lock was unavailable. In this case, any changes made till the point of the error (work-

ing left-to-right on the command line) will remain. Run

vparremove before retrying.

In certain scenarios, the command may not be able to validate if the chosen memory granularities are

appropriate for the system. The command will display a warning message. In such cases, the user should

validate the granularities against the total memory on the system and the supported number of memory

granules on the system. Refer to vparresources(5) manpage for more details.

Note: Older versions of the vparcreate and vparmodify commands allowed speciﬁcation of IO

resources using the legacy hardware path only (see intro (7)). Starting with the A.05.03 version of the

Virtual Partitions product, agile (lunpath) hardware paths are also supported. This functionality means

that you can now create a virtual partition with legacy mode disabled (see insf(1M) and rmsf (1M)), but

only if all virtual partitions have been updated to A.05.03 or later.

Note that the mixing of legacy and agile hardware paths within one vPar is not recommended. This com-

mand cannot detect when a legacy hardware path and an agile hardware path identify the same device.

Options

No option except

-a (add resource) and -g (memory granularity) may be speciﬁed more than once. The

-g option may be speciﬁed at most once for each memtype . 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 following Table 1. All

CPUs to be added to the new vPar must be fully licensed. Resources assigned with multiple

-a options

must not conﬂict. Violation of any condition is a command error.

The

vparcreate command recognizes the following command line options and arguments:

-p vp_name Speciﬁes the symbolic name of the vPar. The name can consist of alpha-numeric char-

acters A-Z, a-z, 0-9, the underbar character (_), and the period (.). The maximum

length of the name is 239 characters. Required.

-B boot_attr Speciﬁes the autoboot and autosearch attribute of the vPar. boot_attr can have the fol-

lowing case-insensitive values:

auto Sets the autoboot attribute. If the autoboot attribute is set to auto, the

vPar is rebooted following a successful vparreset command or when

the monitor is ﬁrst loaded, if appropriate monitor options have been

speciﬁed.

manual Clears the autoboot and autosearch attributes. If the attribute is set to

manual, the vPar halts after a vparreset, and does not boot when the

monitor is loaded. It must then be booted manually with the vparboot

command.

search Sets the autosearch attribute. If the autosearch attribute is set to

search, then the combination of autoboot (auto) and autosearch

(search) decides the boot action to be taken. The interpretation of auto-

boot and autosearch has changed for systems that support hardware

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
vparcreate(1M) vparcreate(1M) NAME vparcreate - create a virtual partition SYNOPSIS vparcreate -p vp_name [-B boot_attr ] [-S static_attr ] [-b kernel_path ] [-o boot_opts ] [-a rsrc ]... [-D db_file ] [-g memtype :size[:update_fw]] Platform Support Remarks This vparcreate describes functionality on systems not running Onboard Administrator (OA) based partition management. For vparcreate on systems with OA based partition management, refer to vparcreate2 (1M) by typing man vparcreate2.
PAGE 2
vparcreate(1M) vparcreate(1M) partitions. Refer to setboot (1M) for details. nosearch Clears the autosearch attribute. On hard partitioned systems with vPars the boot action corresponds to the autoboot and autosearch flags in the following manner: AutoBoot off on on AutoSearch off off on off on Boot Action Halt the vPar for manual boot. Attempt the primary path; on failure halt the vPar. Attempt the primary path; on failure try the alternate path. Skip the primary path and try the alternate path.
PAGE 3
vparcreate(1M) vparcreate(1M) syntactically correct if specified. If it is specified on an Itanium-based platform with the value y, the specified size is also written to system firmware storage. This setting does not take effect until the underlying hard partition is rebooted. update_fw should only be specified with a value of y if you intend to use the newly created database in the current hard partition.
PAGE 4
vparcreate(1M) Table 1. Resource syntax summary Resource Forms CPU cpu:path cpu::num cpu:::[min][:[max]] cell:cell_id:cpu::num (CLP) I/O io:path[:attr1[,attr2]] Memory mem::size (ILM) mem:::base:range cell:cell_id:mem::size (CLM) vparcreate(1M) # times/command Multiple Once Once Once per cell_id Multiple Once Multiple Once per cell_id Cell Local Memory (CLM), as its name implies, refers to memory address ranges on a specific cell.
PAGE 5
vparcreate(1M) vparcreate(1M) • An invalid value is specified for an option or a value is omitted. • vp_name already exists in the monitor database or specified db_file . Use the vparmodify command instead. • One or more options other than -a has been specified more than once or the same resource was allocated more than once. • An unavailable resource (allocated to another vPar or exceeding the available resource limit) was specified.
PAGE 6
(Notes) A (Notes) vA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010