parmodify Command

You can use the parmodify command to modify the following attributes of an existing nPartition:

Partition name
Cell assignments (add cells or remove cells)
Attributes of existing cells:
- Cell type
- Use-on-next-boot value
- Failure usage
- Enhanced nPartition Commands only: Cell local memory (CLM) value
Core cell choices
Enable or disable Hyper-Threading (only on supported cells)
Boot paths (the primary, alternate, and HA alternate paths)
IP address (if set, this value should be consistent with the IP address assigned to the nPartition when HP-UX is booted)

Root permission or IPMI LAN access is required to use this command.




	NOTE: On servers based on the HP sx1000 chipset or HP sx2000 chipset, when the nPartition Configuration Privilege is restricted the parmodify command cannot add or remove cells from an nPartition and cannot modify the CLM value of any cell. These restrictions do not apply when using the -g... -h... options.

Refer to the parmodify(1M) manpage for complete details.

Synopsis

The parmodify command supports slightly different options for the Original nPartition Commands and Enhanced nPartition Commands.

Original nPartition Commands.

parmodify -p PartitionNumber 
-a cell:[type]:[use_on_next_boot]:[failure_usage] [-a...] | 
-m cell:[type]:[use_on_next_boot]:[failure_usage] [-m...] | 
-I IPaddress | -r cell [-r...] | -d cell [-d...] | -b path | -t path | 
-s path | -P PartitionName | -B

Enhanced nPartition Commands.

parmodify -p PartitionNumber 
-a cell:[type]:[use_on_next_boot]:[failure_usage][:clm] [-a...] | 
-m cell:[type]:[use_on_next_boot]:[failure_usage][:clm] [-m...] | 
-I IPaddress | -r cell [-r...] | -d cell [-d...] | -b path | -t path | 
-s path | -P PartitionName | -B | -T flag |
[-u username -h IPaddress|hostname | -g -h IPaddress|hostname ]

The -u... -h... set of options may be specified to cause the command to send its management request using WBEM to an nPartition other than the local nPartition (but can also be used as a "loopback access" to the local nPartition).
The -g... -h... options may be specified to cause the command to send its management request using IPMI over LAN to a service processor in another server complex (but can also be used as a "loopback access" to the service processor in the local complex).

The -u and -g options are mutually exclusive.

The -p option is required.

Options

The parmodify command supports the following command-line options.

-p PartitionNumber

Specifies the nPartition to be modified. PartitionNumber specifies the unique number (integer) assigned to the nPartition.

The -p option is required.

Note that you must also to specify any one or more of the following options.

-a cell:[type]:[use_on_next_boot]:[failure_usage][:clm]

Specifies the cell(s) to be added to the nPartition.

The only valid type value is:
base
Base cell. (The default.)
The valid use_on_next_boot values for cells are:
y
Participate in reboot. (The default.)
n
Do not participate in reboot.
The only valid failure_usage value is:
ri
Reactivate with memory interleave (the default). Specifies to integrate the cell into the nPartition as normally occurs.
Enhanced nPartition Commands only. The clm value specifies the amount of memory that will be configured as cell local memory for the cell.
You can specify the clm value in either of two forms: percentage or absolute amount of memory. The default is 0 (no cell local memory).
- Percentage cell-local memory (CLM).
  The percent number can be any number in the range 0-100 with a suffix of %.
  This number is rounded to 12.5%, 25%, 37.5%, 50%, 62.5%, 75%, 87.5% or 100%. If the cell contains less than 4 GBytes of memory, then the percentage is rounded to 25%, 50%, 75% or 100%. Percentages are rounded up or down to the nearest value, but are not rounded up to 100%.
- Absolute CLM specification. (The default.)
  The absolute number is interpreted as an absolute number of gigabytes of memory and can optionally have a suffix of GB.
  As needed, an absolute CLM specification is rounded up to the nearest 0.5 GBytes.
If the clm value is rounded, the command reports the final value used.

-m cell:[type]:[use_on_next_boot]:[failure_usage][:clm]

Modifies attributes of a cell already assigned to the nPartition.

See the -a option descriptions for details on the type, use_on_next_boot, failure_usage, and clm cell attributes.

-I IPaddress

Specifies the IP address that can be used by management tools to address this nPartition. This value should be consistent with the IP address used by the nPartition when an operating system is booted.

-r cell

Specifies the core cell choices. One to four core cell choices can be specified.

-d cell

Remove the specified cell from the nPartition.

-b path

Specifies the primary boot path.

For HP 9000 servers, this is the PRI boot path.

For HP Integrity servers -b sets the first item in the boot options list displayed by the EFI Boot Manager, and only boot options for the local nPartition can be modified.

-t path

Specifies the alternate boot path.

For HP 9000 servers, this is the ALT boot path.

For HP Integrity servers -t sets the third item in the boot options list displayed by the EFI Boot Manager, and only boot options for the local nPartition can be modified.

-s path

Specifies the secondary boot path.

For HP 9000 servers, this is the HAA boot path.

For HP Integrity servers -s sets the second item in the boot options list displayed by the EFI Boot Manager, and only boot options for the local nPartition can be modified.

-P PartitionName

Specifies the name of the nPartition.

-B

Specifies whether to boot the nPartition. The default is not to boot.

When you modify an inactive nPartition and specify the -B option, the nPartition is booted (and becomes active) immediately after it is modified.

When you modify an active nPartition and specify the -B option, you must perform a reboot for reconfig of the modified nPartition. You must perform this reboot for reconfig before any other cell assignments can take place in the server complex.

-T flag

Specifies whether Hyper-Threading should be enabled or not (only if cells support this feature). If this option is not specified, the Hyper-Threading property will not be changed.

The valid values for flag are:

y: Enable Hyper-Threading, which allows multiple threads to run concurrently on each processor core.
n: Disable Hyper-Threading.

-u username

Enhanced nPartition Commands only. Specifies the account and authorization to access an nPartition other than the local nPartition.

The -h option is required if this option is used.

username specifies a configured user name on the target nPartition.

-g

Enhanced nPartition Commands only. Allows access to the complex specified by the -h option. The accessed complex is then considered the target complex. Access is through the service processor LAN port.The -h option is required if this option is used.

-h IPaddress|hostname

Enhanced nPartition Commands only. This option is only used in combination with either the -u or -g option. IPaddress|hostname specifies the IP address or hostname of the target nPartition (-u) or service processor (-g).

parmodify Command

Technical documentation

» Table of Contents

Synopsis

Options