NAME
cplxmodify — modify an attribute of a system complex
SYNOPSIS
cplxmodify
[-N
ComplexName]
[ [ -u
username:[passwd]
-h IPaddress|hostname ]
| [ -g
[passwd]
-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 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.
Root 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, root 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 root 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. 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 Command menu.
Refer to the
HP System Partitions Guide
for a description of the partition management terms used in this man
page.
Refer to
partition(5)
for a list of partition management commands.
Options and Arguments
cplxmodify
recognizes the following command line options and arguments:
- -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 space, then the name should be
enclosed within double quotes. The complex name can have a maximum of
20 characters.
- -u username:[passwd]
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.
username
specifies a configured user name on the target partition.
passwd
specifies the password associated with the
username.
If this field is empty, the command prompts for the password.
Note: This
command is a Web-Based Enterprise Management (WBEM) Client Application.
The
-u
option accesses the target partition using a Secure Sockets Layer (SSL)
connection. If errors are reported, check that the conditions described
in the
DEPENDENCIES
section are satisfied.
SECURITY WARNING:
Specifying the password directly on the command line may pose a
security risk in your environment. The
ps
or other related commands can be invoked in such a way as to display the
command line of a process. In this situation, any authenticated user on
the system can potentially see the password while the process is
executing. Hence, it is highly recommended not to specify the password on the
command line, and instead allow the command to prompt for the password.
Note:
Specifying
passwd
on the command line will not be supported in future releases.
- -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).
- -g [passwd]
Allows access to the complex specified by the
-h
option. The accessed complex is then considered the target complex.
Access is via the service processor's LAN port.
The
-h
option is required if this option is used.
passwd
specifies the IPMI password of the service processor. If this field is
omitted, the command prompts for the 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 via 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.
SECURITY WARNING:
Specifying the password directly on the command line may pose a
security risk in your environment. The
ps
or other related commands can be invoked in such a way as to display the
command line of a process. In this situation, any authenticated user on
the system can potentially see the password while the process is
executing. Hence, it is highly recommended not to specify the password on the
command line, and instead allow the command to prompt for the password.
Note:
Specifying
passwd
on the command line will not be supported in future releases.
RETURN VALUE
The
cplxmodify
command exits with one of the following values:
- 0
Successful completion.
- 1
Error condition occurred.
EXAMPLES
Change the name of the local complex to "Basingstoke".
cplxmodify -N Basingstoke
Change the name of a remote complex to "Ploverleigh". The command
prompts for the password.
cplxmodify -N Ploverleigh -g -h RemoteComplex
WARNINGS
HP-UX 11i Version 2 is the last HP-UX release on which passing
passwd
for the
-u
and
-g
options is supported.
Specifying
passwd
on the command line will not be supported in future releases.
The command will prompt for the password.
DEPENDENCIES
This command uses the
Web-Based Enterprise Management (WBEM)
product and certain of its configuration settings. If you encounter
connection errors when using the
-u
option, check that the following two conditions are satisfied:
Use the
cimconfig
command (see
cimconfig(1M)
in the WBEM product documentation) to verify (and correct if necessary)
the setting of the following two variables:
enableRemotePrivilegedUserAccess=true
enableHttpsConnection=true
You must have appended the target partition's digital certificate to the
local partition's Trust Store file. For the nPartition commands, the
Trust Store file is
/var/opt/wbem/client.pem.
Note:
You must have appended the target partition's digital certificate to the local
partition's Trust Store file.
For the npartition commands, the Trust Store file is
/var/opt/wbem/client.pem.
This file is used by the commands that
come with WBEM installation. Hence, if the commands that come with the WBEM
installation trust a target partition, then npartition commands will also
trust the target partition.
Refer to the WBEM documents specified in the
SEE ALSO
section below for further information.
AUTHOR
cplxmodify
was developed by the Hewlett-Packard Company.
SEE ALSO
fruled(1),
parstatus(1),
frupower(1M),
parcreate(1M),
parmgr(1M),
parmodify(1M),
parremove(1M),
parunlock(1M),
partition(5).
HP System Partitions Guide
on
http://docs.hp.com,
HP WBEM Services for HP-UX System Administrator's Guide
on
http://docs.hp.com,
HP WBEM Services for HP-UX 11i v2.0 on Integrity Servers Version A.01.05 Release Notes
on
http://docs.hp.com.