parmodify(1M)

NAME

parmodify — modify an existing partition

SYNOPSIS

parmodify -p PartitionNumber

{ -a cell:[cellType]:[use_on_next_boot ]:[failure_usage] [-a...]
| -m cell:[cellType]:[use_on_next_boot]:[failure_usage] [-m...]
| -I IPaddress | -r cell [-r...] | -d cell [-d...]
| -b path | -t path | -s path | -P PartitionName | -B
| -k s_lock:p_lock }

DESCRIPTION

The parmodify command is used to modify the attributes of an existing partition. This command can modify the following attributes:

Partition name

Cell assignment:

Add cells to this partition
Delete cells from this partition

Attributes of existing cells:

cellType
use_on_next_boot
failure_usage

Root alternates

Primary boot path

HA Alternate boot path

Secondary boot path

Partition's IP address

Options and Arguments

parmodify recognizes the following command line options and arguments:

-p PartitionNumber: Specifies the partition to be modified. PartitionNumber specifies the unique number (integer) assigned to the partition.

Note: The user has to specify any one or more of the following options.

-a cell:[cellType]:[use_on_next_boot]:[failure_usage]

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

cell specifies the cell id. It can be specified either in the local (cabinet#/slot#) or global (slot#) format. For example, the cell located in cabinet 2, slot 4 is locally identified as 2/4 or globally as simply 20.

cellType specifies the cell type. The valid cellType value is: base, which is the default if cellType is not specified.

The valid use_on_next_boot values are:

y: participate in reboot. Default.
n: do not participate in reboot.

The valid failure_usage value for cells is:

ri: reactivate with memory interleave. This is the default. Other values will be supported in future releases.

-m cell:[cellType]:[use_on_next_boot]:[failure_usage]

Modify attributes of a cell already assigned to this partition.

The valid cellType value is: base.

The valid use_on_next_boot values are:

y: participate in reboot.
n: do not participate in reboot.

The valid failure_usage value for cells is:

ri: reactivate with memory interleave. Other values will be supported in future releases.

-I IPaddress

Specifies the IP address that should be used by management tools (like SAM) to address this partition. This value must be consistent with the IP address that is assigned to the partition once HP-UX is installed and networking is configured.

-r cell

Specifies the root alternates. One to four cells can be specified. The first cell specified is the first root alternate cell, the second cell specified is the second root alternate cell, the third cell specified is the third root alternate and the fourth cell specified is the fourth root alternate. Use of this option will override previous root alternates selections. So, if the order of a given cell is changing, all of the alternate cells should be specified in the new order.

A cell can be specified either in the local (cabinet#/slot#) or global (slot#) format. For example, the cell located in cabinet 2, slot 4 is locally identified as 2/4 or globally as simply 20.

-d cell

Delete the specified cells from the partition.

-b path

Specifies the primary boot path. path specifies the physical hardware path.

-t path

Specifies the alternate boot path. path specifies the physical hardware path.

-s path

Specifies the secondary boot path. path specifies the physical hardware path.

-P Partition Name

Specifies the name of the partition. The characters which can appear in a valid partition name are a-z, A-Z, 0-9, - (dash), _ (underscore), " " (space) and . (period). If the partition name includes space then the name should be enclosed within double quotes.

-B

Specifies to reboot the partition now. The default is not to boot. If this option is specified and the partition to be modified is not the current partition, then the command proceeds only if the specified partition is not active. Also this option is necessary only if -a or -d option has been specified. Note: The partition in which the command is executing is called the current partition.

-k s_lock:p_lock

Specifies the lock keys provided by SAM for Stable Complex Configuration Data and Partition Configuration Data. The lock keys should always be specified in pairs. If any lock key is not available -1 should be specified. For example: if the s_lock is available but the p_lock is not available, then it should be specified as -k s_lock:-1.

Note: The -k option is not available to the command line user.

Root permissions are required to run parmodify.

EXIT STATUS

The parmodify utility exits with one of the following values:

0: Successful completion.

1: Error condition occurred.

EXAMPLES

Add a new cell to the existing partition with Partition Number 2.

parmodify -p 2 -a 2/5:base:y:ri  

Delete a cell from the existing partition with Partition Number 2.

parmodify -p 2 -d 2/5  

AUTHOR

parmodify was developed by the Hewlett-Packard Company.

parmodify(1M)

Technical documentation

» Table of Contents

» Index