manageChassis command

Operands

You can specify the chassis to be managed as an operand.

Options

-c | –- chassis chassis_credentials

Specifies one or more chassis to be managed. Specify each chassis as follows:

userID:password@IPaddress

where:

userID:password

User ID and password with permissions to log in to the CMM of the chassis to be managed.

Note: The user ID and password are optional. If you do not specify a user ID, the user ID used to run the command will be used to log in to the CMM.

IPaddress

The IP address of the CMM to be managed.

Tip: Use the lsChassis command to find the IP address of all discovered chassis.

-C | --centralized

If specified, the chassis will be managed through centralized user management. In centralized user management mode, a management node controls a single user repository for user accounts across multiple chassis and compute nodes; users are authenticated against a user registry that is hosted on, and configured by, the management node. Each chassis that is managed by the management node can be configured for centralized user management.

Chassis that are not in centralized user mode can have local CMM user accounts defined; a decentralized chassis can also authenticate with external LDAP servers. The CMM list of external LDAP servers can be mass-configured through the management software web interface (on the User Management page), or through the Configuration Manager page in the web interface. Local CMM users can be mass-configured through the Configuration Manager page in the management software web interface.

For more information about centralized management, see Using centralized user management.

--Cu | -–centralizedUserid userid

Specify the user ID of an administrator with supervisor authority. This account is use to request access to the management node on behalf of the CMM and managed nodes after the CMM is centrally managed.

Note: --Cu (--centralizedUserid) and --Cp (--centralizedPassword) are the management node administrator account that is used to request access to the CMM once the CMM user registry is pointing to management node user registry. These are only used when the -C | -- centralized and --Uc | --UpdateToCentralized options are used.

--Cp | -–centralizedPassword password

Specify the password of an administrator with supervisor authority.

Note: --Cu (--centralizedUserid) and --Cp (--centralizedPassword) are the management node administrator account that is used to request access to the CMM once the CMM user registry is pointing to management node user registry. These are only used when the -C | -- centralized and --Uc | --UpdateToCentralized options are used.

--Rp | -–recoveryPassword recovery account password

Specify the password for the CMM recovery account, which can be used if the chassis loses access to the management node. The user ID for the account is RECOVERY_ID.

Note: By default, the recovery password is expired. You must change the password during your first login with RECOVERY_ID, and consider storing the password where you can locate it if you need it in the future. For more information about centralized management and the RECOVERY_ID account, see Using centralized user management.

--Uc | --UpdateToCentralized

Update a chassis to centralized management. If the chassis is already centrally managed, this option will fail. After this operation, you might have to manually request access to components in the chassis because the credentials used to manage the chassis initially might not exist on the management node (under centralized management, the CMM is using the management node user registry).

The following options must be used with the --Uc | --UpdateToCentralized option:

• The -c | --chassis option is require to specify which chassis will be updated.
• The --Cu (--centralizedUserid) and --Cp (--centralizedPassword) options are required to specify the management node administrator account that is used to request access to the CMM after the CMM user registry is pointing to management node user registry.
• The --Rp | -–recoveryPassword option is required.

-F | --force

Ignores already managed errors on a manage attempt.

-h | -?

Displays the syntax and a brief description of the command.

Tip: If you specify additional options other than -h | -? | --help, the options are ignored.

--help

Displays detailed information about the command, including the syntax, a description of the command, a description of the options and operands, error codes, and examples.

Tips:

• If you specify additional options other than -h | -? | --help, the options are ignored.
• You can also display detailed help in the form of man pages using the man command_name command.

-p | --prefix

Specifies the 64-bit prefix that is used to generate the unique local address (ULA) for chassis elements. For example, a valid prefix would be similar to the following: FD87:8999:7654:6543

Note: A ULA prefix usually starts with FD.

-v | --verbose

Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

-W | --wait

Waits the specified time for output messages from the task.

• -1 specifies an indefinite wait.
• 0 specifies no wait.

Exit status

• 0: The operation completed.
• 1: A usage error occurred.
• 110: Command could not complete because an internal error occurred.

Examples

smcli manageChassis -c userid:password@1.1.1.1

smcli manageChassis -W -1 1.1.1.1

smcli manageChassis -c quest:passw0rd@1.1.1.1 -C --Cu userid --Cp passw0rd

smcli manageChassis -c quest:passw0rd@1.1.1.1 --Uc

This command updates a managed chassis with the IP address 1.1.1.1, CMM credentials of quest and passw0rd, and the RECOVERY_ID account password P@ssword from decentralized to centralized

manageChassis --Uc -c quest:passw0rd@1.1.1.1 --Cu quest --Cp passw0rd --Rp P@ssword