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 modies attributes and resources of the specied 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 specication 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 command cannot detect when a legacy hardware path and an agile hardware path identify the same device. Options If the -D option is specied, vp_name in db_le is modied; otherwise vp_name in the virtual partition monitor database is modied. If db_le species the le currently loaded into the monitor, vp_name in the monitor database is modied. If the -D option is not specied and the monitor is not running, vp_name is modied in the default database le /stand/vpdb if both exist. Otherwise the command fails. If the static attribute has been congured in vp_name , none of its resources may be added, modied, or deleted. Attributes (all options except -a, -m, and -d) may be modied. Refer to the -S option description. Only the -S, -a, -m, and/or -d options may be specied more than once in a command. If any of the following options are specied: -B, -P, -S, -b, or -o, the virtual partition to be modied must be in the Up, Down, or Hung state. Refer to the vparstatus (1M) manpage for a complete list of vPar states and their denitions. 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 modied (-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 -B boot_attr
Species the symbolic name of the existing virtual partition which is to be modied. Required. Species 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 specied. 1 Hewlett-Packard Company 1

HP-UX 11i Version 3: September 2010

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. 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 autoboot and autosearch has changed for systems that support hardware partitions. Refer to setboot (1M) for details.

search

nosearch Clears the autosearch attribute.

On hard partitioned systems with vPars the boot action corresponds to the autoboot and autosearch ags in the following manner: AutoBoot off on on off AutoSearch off off on on Boot Action Halt the virtual partition for manual boot. Attempt the primary path; on failure halt the virtual partition. Attempt the primary path; on failure try the alternate path. Skip the primary path and try the alternate path. If the alternate path is not congured to boot or the boot fails then halt the virtual partition.

If the iCAP product has detected that the total of CPUs assigned to all vPars exceeds the amount indicated by iCAPs Intended Active number, it prevents any vPar from rebooting, regardless of the setting of this attribute. The vparboot command is also disabled. Refer to the Instant CAPacity (iCAP) Users Guide available at http://docs.hp.com, and to the icod (5) manpage for more information. Boot attributes may be changed while vp_name is running. If the -B option is omitted, the attributes are not changed.

-C sequence_id

Cancel a pending Resource OL* operation. sequence_id species the Resource OL* operation to cancel. Information about the unique sequence_id associated with different OL* operation can be obtained using the vparstatus command. See vparstatus (1M). Apply changes to the vp_name contained in db_le . The virtual partition monitor need not be running. If it is, and db_le is its database, changes are made to the live database. If db_le is a different database, the monitor is not notied of the modication. Although db_le can reside in any path when accessed as an alternate database, it must be placed in the /stand directory before it can be loaded by the virtual partition monitor as its live database. If the -D option is omitted, either the virtual partition monitor must be running, or the default vPar database le, /stand/vpdb, must exist and contain a congured vp_name . If the monitor is running, changes are applied to vp_name in the monitors database.

-D db_file

v
-S static_attr

Species the static virtual partition attribute. static_attr can have the following values:

static dynamic

sets the static attribute. resets the static attribute.

The static/dynamic attribute may be changed while vp_name is running. If the -S option is omitted, the attribute is not changed. No hardware resource changes can be made to a static virtual partition, that is, the -a, -m, and -d options are not allowed. This restriction applies to all virtual partitions, whether in an alternate database le, or in the monitors database.

Hewlett-Packard Company

HP-UX 11i Version 3: September 2010

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

-b kernel_path

Species 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. Species the command-line string, except for the kernel path, applied when the virtual partition is booted. For example, if a non-partitioned system start string at the ISL prompt is:

-o boot_opts

ISL> hpux -iS /stand/vmunix

the boot_opts string is the -iS portion of this string. Note that if the string includes a space, the string must be quoted. Refer to "Monitor and Shell Commands" in Installing and Managing HP-UX Virtual Partitions for a full list of supported boot option strings. The boot options may be changed while vp_name is running. If the -o option is omitted, boot_opts is not changed.

-P new_vp_name Species a new name for the virtual partition being modied, that is, after all
modications are successfully applied to vp_name , it is renamed to new_vp_name , assuming no virtual partition with that name already exists in the monitor database, the specied alternate database le, or the default database le /stand/vpdb. The name can consist of alpha-numeric characters A-Z, a-z, 0-9, the underbar character (_), and period (.). The maximum length of the name is 239 characters. The vPar name may be changed while vp_name is running. If the -P option is omitted, vp_name is not changed.

-a rsrc -d rsrc -m rsrc

-a adds resources to a virtual partition. -d deletes resources from a virtual partition. -m modies existing resources in a virtual partition.
rsrc is a hardware resource specication, as described in detail in the vparresources(5) manpage. You should refer to the section "CPUs and Instant CAPacity (iCAP)" in that manpage when adding CPU resources. The iCAP product will not allow CPU activation in excess of that shown by iCAPs Intended Active number. The underlying nPartition is said to be compliant. vparmodify fails if you attempt to add one or more processors such that the total processors assigned to all vPars would exceed Intended Active . Refer to the Instant CAPacity (iCAP) Users Guide available at http://docs.hp.com, and to the icod (5) manpage for more information. A summary of resource syntax forms is shown in Table 1. Multiple resource specications in the same command are allowed, but some syntax forms are restricted to specic options, and some are only allowed once. Both are indicated in Table 1. In any case, resources in multiple specications must not repeat or conict with each other.

HP-UX 11i Version 3: September 2010

Hewlett-Packard Company

vparmodify(1M)

vparmodify(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)

Options -a, -d -a, -m, -d -m -a, -m, -d -a, -m, -d -a, -m, -d -a, -d -a, -m, -d

# 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 specic cell. InterLeaved Memory (ILM) refers to memory address ranges whose adjacent addresses are on different cells. size must be in units of granularity for the specied memory type. The vparstatus command shows memory granularities. Refer to the vparstatus (1M) manpage.

NOTE: Online memory addition/deletion is not supported for the default (base) memory type. In order to delete oating memory (ILM or CLM) the keyword "oating", "oat" or "f" should be explicitly specied on the command line. Refer to the vparresources(5) man page for syntax details.
On PA-RISC platforms, a vPar whose memory consists entirely of CLM will not boot. The vPar needs ILM in the rst 2 GB of memory to load and launch its kernel. You should always retain sufcient ILM in your vPar to accommodate this requirement. Refer to the section "Memory" and the subsection "Recommendations for ILM and CLM granularity specications" in the vparresources(5) man page for details. A vp_name in the monitor database must be in the Down state to add or delete resources, with one exception: CPU resources can be added to or deleted from a running virtual partition. This restriction may be relaxed for other types of resource management in a future release. Certain tasks can affect the outcome of others. To avoid errors, see the detailed description of the dependencies in the vparresources(5) manpage. Dynamically increasing or decreasing the number of CPUs in a running virtual partition results in an asynchronous request to the OS. The OS requires an indeterminate time to complete the operation, based on overall system load and (for CPU deletion) the time required to migrate all threads on that CPU on to one or more of the remaining CPUs. During this time, the CPU is said to be undergoing migration into or out of the vPar. The CPU is assigned to its vPar throughout the migration process. For migration out, the CPU is not available for assignment to another vPar until the migration has completed. The vparstatus command shows migrating CPUs. Refer to the vparstatus (1M) manpage. SECURITY RESTRICTIONS This command is restricted to processes owned by superuser. When virtual partition exible administrative capability is enabled, only a Designated-Admin vPar can rename, modify resources and attributes on other virtual partitions.

RETURN VALUE The vparmodify command exits with one of the following values:

0 1 2

Successful completion. One or more error conditions occurred. A warning condition occurred.

EXAMPLES Change the name of the virtual partition called Oslo to Bergen:

vparmodify -p Oslo -P Bergen

Turn on the autosearch attribute for the virtual partition Bergen:

vparmodify -p Oslo -B search

Turn off the autoboot and autosearch attributes for the virtual partition Oslo:

vparmodify -p Oslo -B manual

Add two processors to the virtual partition Bergen in alternate database le /stand/Norway: 4 Hewlett-Packard Company 4 HP-UX 11i Version 3: September 2010

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 oating 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 any of the following conditions:
An invalid option is specied. An invalid value is specied for an option or a value is omitted. The specied db_le does not exist, cannot be accessed, or has been corrupted. vp_name does not exist in the specied db_le or in the monitor database. new_vp_name already exists in the monitor database or specied db_le . vp_name is static and you have attempted to change a resource. One or more options other than -S, -a, -d is specied more than once. For the -a or -m option, an unavailable resource (allocated to another virtual partition or exceeding the available resource limit) is specied. For the -m or -d option, the specied resource is not presently assigned to vp_name . The vparmodify command and the virtual partition monitor are at different revision levels. When the virtual partition exible administrative capability is enabled and the local virtual partition is not a Designated-Admin vPar. The state of the modied vPar following an error depends on the following factors: If the error is detected during syntax and semantic checks of the command line, or if CPU addition is not authorized by iCAP, the vPar is not changed. If the error is detected while actually modifying the vPar, and you are modifying an alternate database, the vPar is not changed. This is because changes are not committed until the end of the command. If the error is detected while modifying the vPar, and you are modifying the database currently loaded into the monitor, then any changes made to the point of the error (working left-to-right on the command line) will remain. This is because changes to the live database are made incrementally, as they are requested.

AUTHOR

vparmodify was developed by the Hewlett-Packard Company.

SEE ALSO insf(1M), rmsf(1M), vparadmin(1M), vparboot(1M), vparcong(1M), vparcreate(1M), vpardump(1M), vpareutil(1M), vparenv(1M), vparextract(1M), vparreloc(1M), vparremove(1M), vparreset(1M), vparstatus(1M), vparutil(1M), icod(5), vparresources(5), vpartition(5), vpmon(5), intro(7).

HP-UX 11i Version 3: September 2010

Hewlett-Packard Company

(Notes)

(Notes)

Hewlett-Packard Company

HP-UX 11i Version 3: September 2010