| United States-English |
|
|
|
![]() |
HP-UX Reference > vvparresources(5)HP-UX 11i Version 1: September 2005 |
|
NAMEvparresources — description of virtual partition resources and their requirements DESCRIPTIONHardware resources are the most important property of a virtual partition (vPar). These resources are divided into three major categories:
CPUs are further subdivided into bound and unbound processors. A bound processor is interrupt-enabled and, at initial release, cannot be de-configured while the vPar is running. An unbound, or floating, processor cannot process interrupts, but can be de-configured from a running vPar, and assigned to another running vPar. Each vPar OS assigns a processor number of zero for its boot processor irrespective of the processor's hardware path or what its processor number would have been if the OS had booted in the nPar. The boot processor is the first processor to be activated when the vPar is booted, and is the one on which all boot time activity takes place. It is assigned this responsibility by the vPar monitor. Each vPar can configure a subset of total system hardware resources such that a given physical resource is assigned to at most one vPar. This job is managed by two of the six virtual partition commands:
Each command has specific resource syntax and semantic requirements. For example, some resource changes can only be made if the target vPar is not running. Some syntax forms can be specified once. Additionally, beginning in vPars version A.02.02, there are specific hardware path format rules to follow that did not exist when using previous versions of vPars. All of these are described in the tables below. The general form of a resource specification is up to five positional fields delimited by colons (":"). No whitespace is allowed within any field.
Table I. Resource Syntax Summary
The first field is always one of the (case-insensitive) strings cpu, io, or mem. The second field, when used, is a hardware path, for example, 10/12/6. num, min, and max are all positive integers. size and range are positive 64-bit integers in units of megabytes. base is an unsigned 64-bit integer in units of bytes. The commands round each of them upward as required to 64 megabyte boundaries. size, range, and base may each be specified in decimal or in hexadecimal. A hex specification should be preceded by 0x, as in 0x8000000. The attributes for the I/O specification are zero, one, or many of the following (case-insensitive) strings: ALTBOOT, BOOT and TAPE. If more than one are specified, separate them with a comma. Each of the attributes can be assigned to no more than one I/O device. If it is already assigned to a device, a new assignment silently de-assigns it from its present device. However, one device can associate with more than one attributes. This means it is possible for one device to own all the ALTBOOT, TAPE and BOOT attributes, but it is not possible for two or more devices to own BOOT. Users must guard against assigning an attribute to an inappropriate device, for example, assigning BOOT to a tty. The commands do not check for this, nor do they prevent it. Table II. Allowed Forms for Each Task
The forms above are subject to the following semantic rules enforced by the commands. Note that according to Table II, except for the cpu::num form, a vPar must be in the Down state (or in an alternate database) to apply any of the changes described below. This requirement may be relaxed or removed in a future release.
EXAMPLESIf more than one task is specified in a command, they are processed in the order (left-to-right) in which they are encountered on the command line. Some tasks will affect the outcome of others. Here is an example of correct usage, as well as counterexamples within the description. vparcreate -p winona2 -a cpu::2 -a cpu:::2:4 -a cpu:41 -a cpu:45 -a mem::1280 -a mem:::0x40000000:128 -a io:0/8 -a io:1/10 -a 0/8/0/0.5.0:boot At creation time, before any options are processed, min is equal to 1, as is num. Assume that the default max is sufficiently high, and that the specified resources are available for allocation.
The following vparmodify(1M) command adds two floating (unbound) CPUs to a vPar that has the Static attribute set. The Static attribute is then restored. vparmodify -p winona3 -S dynamic -a cpu::2 -S static To add a device path to be a tape, the command is:
Table III-A. Detailed Resource SpecificationsTask: -a cpu:path
Table III-B. Detailed Resource SpecificationsTask: -a cpu::num
Table III-C. Detailed Resource SpecificationsTask: -a cpu:::[min][:[max]]
Table III-D. Detailed Resource SpecificationsTask: -a io:path[:attr1[,attr2]]
Table III-E. Detailed Resource SpecificationsTask: -a mem::size
Table III-F. Detailed Resource SpecificationsTask: -a mem:::base:range
Table III-G. Detailed Resource SpecificationsTask: -m cpu::num
Table III-H. Detailed Resource SpecificationsTask: -m cpu:::[min][:[max]]
Table III-I. Detailed Resource SpecificationsTask: -m io:path[:attr1[,attr2]]
Table III-J. Detailed Resource SpecificationsTask: -m mem::size
Table III-K. Detailed Resource SpecificationsTask: -d cpu:path
Table III-L. Detailed Resource SpecificationsTask: -d cpu::num
Table III-M. Detailed Resource SpecificationsTask: -d io:path[:attr1[,attr2]]
Table III-N. Detailed Resource SpecificationsTask: -d mem::size
Table III-O. Detailed Resource SpecificationsTask: -d mem:::base:range
Table IV. Hardware Path SpecificationsBeginning with vPars A.02.02, the way to specify hardware paths has changed. This was done so that older vPars configuration databases remain compatible with additional hardware that is being supported. For example, given a path whose sequential digits are 4 0 1 0 0 0 0, it is not possible to determine whether this path means a device at 4/0/1/0/0.0.0 or a device at 4/0/1/0/0/0/0.0.0.0.0.0.0. The former structure is cell/sba/lba/ dev/function and the latter structure is cell/sba/lba/ pci_bridge/dev/function, where pci_bridge has the format m/n. Therefore, the following rules have been created. These rules apply when using either Virtual Partition Manager or the command-line interface. When entering a hardware path, the sequence and number of slashes (/) and dots (.) in the hardware path that you input determines the resultant hardware path as follows:
In the above table, padding means to pad using ".0" up to six elements after the first dot. For the example shown in the first line of the table, the resulting path, as displayed by vparstatus, will be 0.1.0.0.0.0.0.0. EXAMPLESIf a path was entered using slashes and dots using pre-A.02.02 software, you cannot enter the same path format using A.02.02 or later software. You must enter the path using the exact same digits but with dots instead of slashes as delimiters. For example, if a path using A.02.01 software was entered as vparmodify -p winona2 -m io:4/0/1/0/0.0.0:BOOT then vparstatus would show the path as 4.0.1.0.0.0.0. To do the same vparmodify command above but using A.02.02 or later, the command would be vparmodify -p winona2 -m io:4.0.1.0.0.0.0:BOOT To change the above path to be the ALTBOOT setting, the command is vparmodify -p winona2 -m io:4.0.1.0.0.0.0:ALTBOOT Using vPars A.02.02, when setting a path, you can either use one or more occurrences of the / and . in the path so that the resultant path is the correctly padded path (this path is the same as the path shown in the ioscan output) OR use the exact path, correctly padded, using only dots (this path is the same as the path shown in the vparstatus output). In the former case above, the ioscan output for a combo-card (combination of SCSI and LAN PCI card) may show disk 0 12/0/8/0/0/4/0.0.0 ... SEAGATE ST39103LC. Then, the vPars command would be vparmodify -p winona2 -a io:12/0/8/0/0/4/0.0.0. Note that this path of 12/0/8/0/0/4/0.0.0 becomes correctly padded to 12.0.8.0.0.4.0.0.0.0.0.0.0 according to the table above. Subsequently, the vparstatus output would show this path as 12.0.8.0.0.4.0.0.0.0.0.0.0, which can be used if you wish to cut and paste the path as in vparmodify -p winona2 -m io:12.0.8.0.0.4.0.0.0.0.0.0.0:BOOT. In the latter case above, the vparstatus output for a combo-card may be 12:0.8.0.0.4.0.0.0.0.0.0.0 BOOT. Then, the vPars command would be vparmodify -p winona2 -m io:12.0.8.0.0.4.0.0.0.0.0.0.0:ALTBOOT. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||