Skip to main content

manage device

This command manages a discovered device.

The devices must be discovered using the discover command before running this command

This command starts a job to perform the management action. If successful, the job ID is returned. You can use the job ID in the tasks –j command or the manage job_status command to determine the status of the job.

Syntax​

manage device -h

manage device -i <IP_address> [-f <boolean>] [-r <recovery password>]
             {-u <device_user_ID> -p <device_password> | -s <stored credential ID>]
             [-v <filter>]

Options​

{-h | --help}
Displays the syntax and brief usage information for this command.
{-f | --force} <boolean>
If specified, the devices are force managed by this XClarity Administrator server.
Note
Use this force-management option only if you previously attempted to manage the device and management was not successful due to one of the following error conditions.

  • If the managing XClarity Administrator failed and cannot be recovered.

    Note
    If the replacement XClarity Administrator instance uses the same IP address as the failed XClarity Administrator, you can manage the device again using the RECOVERY_ID account and password (if applicable) and the Force management option.

  • If the managing XClarity Administrator was taken down before the devices were unmanaged.

  • If the devices were not unmanaged successfully.

Attention
Devices can be managed by only one XClarity Administrator instance at a time. Management by multiple XClarity Administrator instances is not supported. If a device is managed by one XClarity Administrator, and you want to manage it with another XClarity Administrator, you must first unmanage the device from the original XClarity Administrator, and then manage it with the new XClarity Administrator.
{-i | --ip} <IP_address>
Specifies the IP address of the device to be managed.
{-p | --pw} <device_password>
Specifies the password for the device user account.
{-r | --rpw} <recovery password>
Specifies the recovery-ID password for the device.

When you manage a chassis, the CMM is configured to authenticate users with XClarity Administrator. Local CMM user accounts are no longer valid. If there are issues with XClarity Administrator, you can use the RECOVERY_ID to access the CMM directly. Ensure that you write down the password that you specify and store it in a secure location.

When you manage a Converged, NeXtScale, or System x server, the baseboard management controller is configured to authenticate users with the XClarity Administrator server. Local management-controller user accounts are no longer valid. If there are issues with the XClarity Administrator server, you can use the RECOVERY_ID to access the management controller directly. Ensure that you write down the password that you specify and store it in a secure location.

{-s | --storedcredential_id} <stored_credential_ID>
Specifies the ID of the stored-credential account to use to manage the device.
{-u | --user} <device_user_ID>
Specifies a user account with lxc-supervisor authority for the device. If the device to be managed is a chassis, specify a user account for the CMM in that chassis.
{-v | --view} <filter>
Identifies the view to use for the returned data. If a filter is not specified, the default view is used.

You can also create custom views (see Creating custom views).

Examples​

The following example manages a device using a user account.
connect --url https://192.0.2.0 --user ADMIN --noverify
manage device -i 192.0.2.22 -u USERID -p xxxxxxxx -r xxxxxxxx
The following example manages a device using a stored-credential account.
connect --url https://192.0.2.0 --user ADMIN --noverify
manage device -i 192.0.2.23 -s AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA -r xxxxxxxx