vparmodify2.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vparmodify2(1M)

For OA Based Partition Management Systems

vparmodify2(1M)

NAME

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

SYNOPSIS

Invoked from operating system (OS):

vparmodify -p vpar_id

[-a rsrc]...

[-d rsrc]...

[-m rsrc]...

[-P new_vpname]

Invoked from Onboard Administrator (OA):

vparmodify {-pvpar_id -N npar_id |

-p npar_id:vpar_id }

[

-a rsrc]...

[-d rsrc]...

[-m rsrc]...

[-P new_vpname]

Platform Support Remarks

This

vparmodify describes functionality on systems with Onboard Administrator (OA) based par-

tition management. For vparmodify on systems not running OA based partition management,

refer to vparmodify1 (1M) by typing man vparmodify1.

DESCRIPTION

The

vparmodify command modiﬁes resources of the speciﬁed virtual partition. The command can also

rename the virtual partition. vparmodify cannot create a virtual partition; use the vparcreate com-

mand for that purpose.

The

vparmodify command accepts resource path for all resource speciﬁcation. Resource path can be

speciﬁed in short, medium, or long format. For example, CPU number 2

located in enclosure 3, blade 6,

socket

0 is identiﬁed 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).

Options and Arguments

• Only the

-a, -m,and/or-d

options may be speciﬁed more than once in a command. But some syntax

forms are restricted. Refer to table 1 for detailed information.

• The

-a and -d options cannot be used on the same command line when the vPar is UP.

• 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.

• Resources to be modiﬁed (

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

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 vpar_id Speciﬁes the virtual partition to be modiﬁed. vpar_id can be speciﬁed either as a number

or name. Required.

When invoked from the OS, the command modiﬁes the speciﬁed virtual partition in the

local nPartition.

When invoked from the OA, the vpar_id should be speciﬁed either using the

npar_id

:vpar_id format or by using the -N option. When speciﬁed in the

npar_id :vpar_id format, npar_id and vpar_id can either be a number or name. The

command modiﬁes the speciﬁed virtual partition in the speciﬁed nPartition.

-a rsrc -a adds resources to a virtual partition.

-d rsrc -d deletes resources from a virtual partition.

-m rsrc -m modiﬁes existing resources in a virtual partition.

rsrc is a hardware resource speciﬁcation, as described in detail in the vparresources(5)

manpage.

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

Summary of content (6 pages)

PAGE 1
vparmodify2(1M) For OA Based Partition Management Systems vparmodify2(1M) NAME vparmodify - rename a virtual partition or modify the resources of a virtual partition SYNOPSIS Invoked from operating system (OS): vparmodify -p vpar_id [-a rsrc]... [-d rsrc]... [-m rsrc]... [-P new_vpname] Invoked from Onboard Administrator (OA): vparmodify { -p vpar_id -N npar_id | -p npar_id :vpar_id } [-a rsrc]... [-d rsrc]... [-m rsrc]...
PAGE 2
vparmodify2(1M) For OA Based Partition Management Systems vparmodify2(1M) A summary of resource syntax forms is shown in Table 1. Multiple resource specifications in the same command are allowed, but some syntax forms are restricted to specific options, and some are allowed only once. Both are indicated in Table 1. In any case, resources in multiple specifications must not repeat or conflict with each other. -N npar_id Specifies the nPartition to which the virtual partition belongs.
PAGE 3
vparmodify2(1M) For OA Based Partition Management Systems vparmodify2(1M) NOTE: When using socket local syntax (socket :socket_id :cpu::num), only the number of cores on the given socket may be entered, not the hardware paths of the individual cores.
PAGE 4
vparmodify2(1M) For OA Based Partition Management Systems vparmodify2(1M) vparmodify -p Oslo -a socket:3/6/0:cpu::2 vparmodify -p Oslo -a socket:3/6/0:core::2 Delete two socket-local processors of enclosure 3, blade 6, socket 0 from virtual partition Oslo (cpu and core syntax): vparmodify -p Oslo -d socket:3/6/0:cpu::2 vparmodify -p Oslo -d socket:3/6/0:core::2 Delete processor 1 of enclosure 3, blade 6, socket 0 from virtual partition Oslo (cpu and core syntax): vparmodify -p Oslo -d cpu:3/6/0/1 vparm
PAGE 5
vparmodify2(1M) For OA Based Partition Management Systems vparmodify2(1M) The state of the modified virtual partition following an error depends on the following factors: • If the error is detected during syntax and semantic checks of the command line, the virtual partition is not changed. • If the error is detected while modifying the virtual partition, then any changes made to the point of the error (working left-to-right on the command line) will be reverted.
PAGE 6
(Notes) A (Notes) vA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012