cplxmodify.1m (2010 09)

c
cplxmodify(1M) cplxmodify(1M)
NAME
cplxmodify - modify an attribute of a system complex
SYNOPSIS
cplxmodify [-N ComplexName ]
[[ -u username [:
] -h IPaddress|hostname ]
|[
-g -h IPaddress|hostname ]]
Platform Support Remarks
cplxmodify is not supported on systems with Onboard Administrator (OA) based partition
management.
DESCRIPTION
The
cplxmodify command modifies attributes of the complex of a partitionable system. The command
is the equivalent, at the complex level, of the
parmodify command, which modifies attributes of an
nPartition.
The complex to be modified defaults to the local complex, the one on which the command is run. A remote
complex can be identified by specifying either the
-u or -g option in combination with the -h option.
Superuser permission is required to run this command on the local partition. If the
-u or -g option is
used to access a remote partition or complex, superuser permission is not required on the local system,
and the local system need not exist on an nPartition. If the
-u option is specified, username on the
remote host must have superuser permission or the command will fail.
By the nature of its operation, this command can modify the configuration of its target complex. Opera-
tion can be affected by the state of the target complex’s nPartition Configuration Privilege. If this
privilege is unrestricted (the default), or the complex is accessed using the
-g option, all operations are
allowed. Otherwise the command fails. The -g option is unaffected by the state of the nPartition
Configuration Privilege. Note: This privilege state can only be changed at the service processor’s Com-
mand menu.
Refer to the nPartition Administrator’s Guide for a description of the partition management terms used
in this man page.
Options and Arguments
cplxmodify recognizes the following command line options and arguments:
-g 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’s LAN port.
The
-h option is required if this option is used.
If this option is specified, the command prompts for a password.
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 ser-
vice processor and using the
SA command from the Command Menu.
The
-u and -g options are mutually exclusive.
-h IPaddress|hostname
This option should only be used in combination with either the -u or -g option.
IPaddress|hostname specifies the IP address or hostname of the target partition (-u)
or complex (-g).
-N ComplexName Changes the name of the target complex to ComplexName. This option may also be
used to name a complex for the first time.
The characters which can appear in a valid complex name are
a-z, A-Z, 0-9, - (dash),
_ (underscore), " " (space) and . (period). If the complex name includes a space, then
the name should be enclosed in double quotes. The complex name can have a max-
imum of 20 characters; it should not start with a dash (-).
-u username[:] 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 complex to be
modified is the one in which this target partition resides.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1