HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

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 ]]
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 nParti-
tion.
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. Operation
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. Oth-
erwise 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 Command 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 service
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 maximum 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.
The -h option is required if this option is used.
If this option is specified, the command prompts for a password.
username specifies a configured user name on the target partition.
128 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007