HP-UX Reference (11i v1 05/09) - 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.
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 sys-
tem 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. 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.
Please refer to the HP System Partitions Guide for a description of the partition management terms used in
this manpage.
Remote Management Options
The
-u and -g options are available only if the NParProvider product is installed.
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 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.
The -u and -g options are mutually exclusive.
username specifies a configured user name on the target partition. If -u username is
specified, the command will prompt for the password associated with the username.
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.
Note: If the commands are used in a script, the user password must be passed in a secured
way. For example,
1. Save the user password in a variable and pass it to the command as,
echo $passwd | parstatus -X -u username -h hostname/IP
2. Save the user password in a file and pass the file as input to the command like,
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−147