parconfig(1M)parconfig(1M)NAMEparconfig - provides a recommended nPartition configuration
SYNOPSIS
mode] policy]
PartitionNumber]
[celltype]use_on_next_boot]failure_usage]
N | N | N }
DESCRIPTION
is an advisory command. The command runs a set of the Locality-Opti‐
mized Resource Alignment (LORA) rules and provides recommended configu‐
ration of the nPartition. See lora(7) for information about Locality-
Optimized Resource Alignment.
By default gives advice in the form of a command for the new local par‐
tition and the advice is displayed on the standard output. The option
can be specified to get advice in the form of a command for an existing
partition. Either the or option can be specified to get the advice for
the specified target (local or remote) complex. The resulting advice
in the form of or command can be redirected to a text file; the user
can then modify the command if needed and explicitly execute the com‐
mand to create new recommended nPartition or to modify an existing
nPartition.
Superuser permission is required to run this command on the local par‐
tition. If the or option is used to access a remote partition or com‐
plex; superuser permission is not required on the local system, and the
local system need not exist on an nPartition. If the option is speci‐
fied, username on the remote host must have superuser permission or the
command will fail.
Please refer to the for a description of the partition management terms
used in this man page.
Options and Arguments
recognizes the following command line options and arguments:
Identifies a cell to be assigned to the partition. To assign multiple
cells to the partition, multiple options should be used.
cell specifies the cell ID. It can be specified either in the
local (cabinet#/slot#) or global (cell#) format. For example,
the cell located in cabinet 0, slot 1 is identified in the local
format as 0/1 or in the global format as 1.
celltype specifies the type of the cell. The valid celltype
values for a cell are:
A base cell in a partition participates in interleaved
memory.
A floating cell in a partition does not participate in inter‐
leaved memory
(all of the cell's memory is used as CLM).
Note: If no celltype is specified, policy rules (specified
through the option) will be applied to the cell to determine the
type of the cell.
use_on_next_boot specifies whether the cell will participate in
a reboot. The valid values for use_on_next_boot are:
participate in reboot. This is the default. However if the
slot is missing
or the cell does not exist or the cell is powered off then
it defaults to
do not participate in reboot.
failure_usage field is used by system firmware when a partition
is booted. If a CPU selftest failure or a DIMM deallocation
occurs during the power-on self-test process, then this flag is
used by the system firmware to determine whether or not and how
the cell should be integrated into the partition at boot time.
The valid failure_usage values for a cell are:
reactivate with memory interleave. Specifies to integrate the
cell as it
would normally be integrated. This is the default
for base cells.
this is the default value for floating cells.
If the user specifies ri for a floating cell, the
command displays an error and exits.
deconfigure.
no interleave.
clm_value specifies the amount of the memory that will be con‐
figured as local (non-interleaved) memory for the cell. The
command will issue a warning if the specified clm_value exceeds
the total memory of the cell.
Note: On PA-RISC platforms, the amount of memory allocated for
CLM may not match the amount of CLM requested due to some memory
being reserved exclusively by the operating system.
If no clm_value is specified, policy rules (specified through
option) will be applied to the cell to determine the amount of
Interleaved memory and Local Memory for the cell. The command
will issue a warning if 100% CLM is specified for all the cells
in the partition. The clm_value can be expressed in two forms:
· As a percentage (ratio).
The percent number can be any number in the range 0 - 100
with a suffix of This number will be rounded up to 12.5%,
25%, 37.5%, 50%, 62.5%, 75%, 87% or 100%. If the cell con‐
tains less than 4 GB memory, then the percentage will be
rounded to 25%, 50%, 75% or 100%. The specified percentage
is applied each time the partition boots, thus resulting in a
different value if the working memory in the cell is differ‐
ent. For example, a cell in a partition has 8 GB memory and
the user specifies 50% CLM. When the partition boots, 4 GB
of that cell's memory will be used as CLM. Later the user
shuts down the partition, adds another 8 GB memory to that
cell. When the partition is booted again, the cell now has
16 GB of memory, so 8 GB (50%) is allocated as CLM.
· As an absolute number (default).
This can also be optionally suffixed by "GB". The clm_value
is interpreted as an absolute number of gigabytes of memory.
Numbers other than integers and halves are rounded up to the
nearest 0.5 GB. For example, 2.5 GB will not be rounded up.
However 2.3 GB will be rounded up to 2.5 GB. For example, a
cell in a partition has 8 GB memory and the user specifies 4
GB CLM. When the partition boots 4 GB of that cell's memory
will be used as CLM. Later the user shuts down the parti‐
tion, adds another 8 GB memory to that cell. When the parti‐
tion is booted again, the cell now has 16 GB of memory, but
the CLM is still 4 GB.
Note: The optional cell attribute celltype and/or clm_value, if
specified, should be in line with the policy rules (specified
through the option).
Allows access to the complex specified by the
option. The accessed complex is then considered the target com‐
plex. Access is through the service processor's LAN port.
The option is required if is used.
If the option is specified, the command prompts for the pass‐
word.
If an error is reported when you attempt to connect using this
option, check to see that IPMI LAN access has not been disabled
on the remote service processor. Access to the complex through
IPMI over LAN can be enabled or disabled by logging on to the
service processor and using the command from the Command Menu.
The and options are mutually exclusive.
This option should only be used in combination with either the
or option. IPaddress|hostname specifies the IP address or host‐
name, respectively, of the target partition or complex
At least one of the following
option must be specified:
Specifies the minimum number of CPUs to be present in the parti‐
tion.
keyword indicates that the command will select cells such
that the partition has at least N number of CPUs.
N specifies the minimum number of CPUs and does not take
into account the CPUs attached to the cell specified
through the option.
Note: The keyword can be specified only once and is mutu‐
ally exclusive with the keyword.
Specifies the minimum amount of memory to be present in the par‐
tition.
keyword indicates that the command will select cells such
that the partition has at least N GB amount of memory.
N specifies the minimum amount of memory and does not
take into account the memory attached to the cell speci‐
fied through the option. The amount of memory can be
optionally suffixed by "GB".
Note: The keyword can be specified only once and is mutu‐
ally exclusive with the keyword.
Specifies both the minimum number of CPUs and the minimum amount
of memory
to be present in the partition.
Specifies the number of cells to be present in the partition.
keyword indicates that the command will select specific
number of cells.
N specifies the number of cells and does not take into
account the cells specified through the option.
Note: The keyword can be specified only once and is mutu‐
ally exclusive with keywords and
Specifies the name and configuration type of the operating system run‐
ning on
the local partition or target partition option specified). The
valid values for OSname are:
HP-UX is the operating system name and 11iV3 is the operating
system configuration type.
Note: Currently, the command is supported only on HP-UX 11iV3.
Specifies the partition to be modified.
PartitionNumber specifies the unique number (integer) assigned
to the partition when it was created.
Note: By default, the core cell of the partition will be
retained back in the recommended configuration of the partition
and the other cells might be deleted. If you wish to retain
back other cells of the partition, use the option for each cell
that has to be retained.
Specifies the required authorization to access a partition other than
the local system (but can also be used as a loopback access to
the local partition).
The option is required if is used. The colon is optional and is
present for Linux compatibility reasons.
If the option is specified, the command prompts for the pass‐
word.
username specifies a configured user name on the target parti‐
tion.
Note: This command is a Web-Based Enterprise Management (WBEM)
Client Application. The option accesses the target partition
using a Secure Sockets Layer (SSL) connection. If errors are
reported, check that the conditions described in the section are
satisfied.
Specifies the mode for configuring the memory of the cell as Cell Local
Memory and Interleaved
Memory. The valid values for mode are:
The memory of the cell is configured as a mix of Cell Local Mem‐
ory and Interleaved Memory.
The exact mix and layout is determined by the option.
This is the default.
All of the cell's memory is configured as Interleaved Memory (no
clm).
Specifies the resulting
or command to be executed.
Note: If option is not specified, by default the command dis‐
plays the or command on the standard output. You can capture
the command displayed on standard output, edit the command if
needed and explicitly execute it.
Specifies the policy for determining type of the cell.
This option should only be used in combination with option and
mode value as The valid values for policy are:
75% of the cells are assigned base and remaining 25% of the
cells are assigned float as the cell type. This is the default.
All the cells are assigned base as the cell type.
25% of the cells are assigned base and remaining 75% of cells
are
assigned float as the cell type.
A base cell in the partition participates in Interleaved Memory.
87.5% (7/8) of the base cell's memory is used as CLM.
A float cell in the partition does not participate in inter‐
leaved memory. All of the float cell's memory is used as CLM.
Mapping of Global Cell Numbers to Local Cell Numbers
The cabinets in a complex are numbered starting from 0. The cell slots
in each cabinet are also numbered starting from 0. Each cabinet can
have a maximum of 8 cells.
For example, the cells located in cabinet 0 will have the following
cell numbers in global format: 0, 1, 2, 3, 4, 5, 6, 7. The cell num‐
bers in corresponding local format will be 0/0, 0/1, 0/2, 0/3, 0/4,
0/5, 0/6, 0/7.
Similarly the cells located in cabinet 1 will have the following cell
numbers in global format: 8, 9, 10, 11, 12, 13, 14, 15. The cell num‐
bers in corresponding local format will be 1/0, 1/1, 1/2, 1/3, 1/4,
1/5, 1/6, 1/7.
From the above convention the cell located in cabinet 1, slot 0 is
identified in the local format as 1/0 or in the global format as 8.
The command displays the above cell as "cab1,cell0". The cell located
in cabinet 1, slot 4 is identified in the local format as 1/4 or in the
global format as 12. The command displays the above cell as
"cab1,cell4". See parstatus(1).
RETURN VALUE
The command exits with one of the following values:
Successful completion.
Error condition occurred.
EXAMPLES
Get a recommended configuration for the new local nPartition. Cells of
the new partition should be cells with no CLM. A cell located in cabi‐
net 0, slot 0 is a core capable cell and should be included in the new
partition. The partition should have at least 8 CPUs (excluding CPUs
attached to the cells specified through the option).
Cell located in cabinet 0, slot 1 is free and has 8 CPUs, the output of
the command will be:
Get a recommended configuration for existing local nPartition. An
existing partition 0 has to be modified. A cell is located in cabinet
0, slot 1 and belongs to partition 0, has to be retained back in the
recommended configuration of the partition with celltype as Another
cell is located in cabinet 0, slot 6 belongs to partition 0 with just 1
CPU. There should be 5 cells (except the one specified through option)
in the recommended configuration of the partition.
By default, the core cell of partition 0 will be retained back in the
recommended configuration of the partition. Assuming cell located in
cabinet 0, slot 0 is core cell of partition 0 and cells located in cab‐
inet 0 at slot 2,3,4,5 are free, the output of the command will be:
Get a recommended configuration for existing local nPartition. An
existing partition 1 has to be modified. Cells in the recommended con‐
figuration of the partition should have at least 16 CPUs and 64GB mem‐
ory. Cell type should be for both the cells.
By default, the core cell of partition 1 will be retained back in the
recommended configuration of the partition. Cell located in cabinet 0,
slot 0 is the core cell of partition 1 and has 8 CPUs, 32GB memory.
Another cell located in cabinet 0, slot 1 has 8 CPUs and 32GB memory.
The output of the command will be:
DEPENDENCIES
This command uses the Web-Based Enterprise Management (WBEM) product
and some of its configuration settings. If you encounter connection
errors when using the option, check that the following two conditions
are satisfied:
· Use the command (see cimconfig(1M) in the WBEM product documenta‐
tion) to verify (and correct if necessary) the setting of the fol‐
lowing two variables:
·
·
· The target partition's digital certificate has been appended to the
local partition's Shared Authentication Store. For the nPartition
commands, the Shared Authentication Store is stored in the file:
This file is used by all the clients, which use SSL based certifi‐
cates. If these clients trust a target partition, then the nParti‐
tion commands will also trust the target partition.
Refer to the WBEM documents specified in the section below for further
information.
AUTHOR
was developed by the Hewlett-Packard Company.
SEE ALSOfruled(1), parstatus(1), cplxmodify(1M), frupower(1M), parcreate(1M),
parmgr(1M), parmodify(1M), parolrad(1M), parremove(1M), parunlock(1M),
partition(5).
on
on
on
parconfig(1M)
