vparmodify.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vparmodify(1M) vparmodify(1M)

NAME

vparmodify - rename a virtual partition or modify the attributes of a virtual partition

SYNOPSIS

vparmodify -p vp_name [-B boot_attr ][

-C sequence_id ][-D db_ﬁle][-S static_attr ]

[

-b kernel_path ][-o boot_opts ][

-P new_vp_name ][-a rsrc]... [-m rsrc]... [-d rsrc ]...

Platform Support Remarks

This

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

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

refer to vparmodify2 (1M) by typing man vparmodify2

DESCRIPTION

The

vparmodify command modiﬁes attributes and resources of the speciﬁed virtual partition (vPar).

The command can also rename the virtual partition. vp_name is a symbolic name for an existing virtual

partition and must be used in all references to it.

vparmodify cannot create a virtual partition. Use

the

vparcreate command for that purpose.

Some CPU resources have special requirements when being added to a virtual partition. These special

CPU resource requirements are described following Table 1.

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

• If the

-D option is speciﬁed, vp_name in db_ﬁle is modiﬁed; otherwise vp_name in the virtual partition

monitor database is modiﬁed. If db_ﬁle speciﬁes the ﬁle currently loaded into the monitor, vp_name

in the monitor database is modiﬁed. If the

-D option is not speciﬁed and the monitor is not running,

vp_name is modiﬁed in the default database ﬁle /stand/vpdb if both exist. Otherwise the command

fails.

• If the

static attribute has been conﬁgured in vp_name , none of its resources may be added,

modiﬁed, or deleted. Attributes (all options except -a, -m, and -d) may be modiﬁed. Refer to the

-S

option description.

• Only the

-S, -a, -m,and/or

-d options may be speciﬁed more than once in a command.

• If any of the following options are speciﬁed:

-B, -P

, -S, -b,or-o, the virtual partition to be modiﬁed

must be in the

Up, Down,orHung state. Refer to the vparstatus (1M) manpage for a complete list of

vPar states and their deﬁnitions.

• Resources allocated with the

-a option must be available, that is, not already assigned to a virtual

partition, and they must not exceed the overall limits of the resources. Addition of CPU resources

must be authorized by the Instant CAPacity (iCAP) product.

• Resources to be modiﬁed (

-m) or deleted (-d) must be currently assigned to vp_name .

Violation of any condition is a command error.

vparmodify recognizes the following command line options and arguments. The options are processed

from left to right.

-p vp_name Speciﬁes the symbolic name of the existing virtual partition which is to be modiﬁed.

Required.

-B boot_attr Speciﬁes the autoboot and autosearch attribute of the virtual partition. boot_attr can

have the following 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.

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

Summary of content (6 pages)

PAGE 1
vparmodify(1M) vparmodify(1M) NAME vparmodify - rename a virtual partition or modify the attributes of a virtual partition SYNOPSIS vparmodify -p vp_name [-B boot_attr ] [-C sequence_id ] [-D db_file ] [-S static_attr ] [-b kernel_path ] [-o boot_opts ] [-P new_vp_name ] [-a rsrc ]... [-m rsrc ]... [-d rsrc ]... Platform Support Remarks This vparmodify describes functionality on systems not running Onboard Administrator (OA) based partition management.
PAGE 2
vparmodify(1M) vparmodify(1M) 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.
PAGE 3
vparmodify(1M) vparmodify(1M) Since command line options are processed left-to-right, you can modify resources in a static partition by specifying -S dynamic on the command line before any resource options, then specifying -S static after all resource options to prevent further resource modifications. -b kernel_path Specifies the absolute path to a bootable kernel for the partition. If the option is omitted, the kernel_path is not changed. The kernel path may be changed while vp_name is running.
PAGE 4
vparmodify(1M) Table 1.
PAGE 5
vparmodify(1M) vparmodify(1M) vparmodify -p Bergen -D /stand/Norway -a cpu::2 Add two processors to the virtual partition Oslo in the running vPar monitor database: vparmodify -p Oslo -a cpu::2 Add two cell-local processors from cell 1 to the virtual partition Oslo: vparmodify -p Oslo -a cell:1:cpu::2 Delete 1 gigabyte of floating cell-local memory (CLM) on cell 0 from the virtual partition Oslo: vparmodify -p Oslo -d cell:0:mem::1024:f ERRORS vparmodify displays error messages on standard error for a
PAGE 6
(Notes) A (Notes) vA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010