Skip to main content
HCI
1.10

Edit Baseboard Management Controller connection information

Contributors netapp-dbagwell netapp-pcarriga amgrissino

You can change Baseboard Management Controller (BMC) administrator credentials in NetApp Hybrid Cloud Control for each of your compute nodes. You might need to change credentials prior to upgrading BMC firmware or to resolve a Hardware ID not available or Unable to Detect error indicated in NetApp Hybrid Cloud Control.

What you'll need

Cluster administrator permissions to change BMC credentials.

Note If you set BMC credentials during a health check, there can be a delay of up to 2 minutes before the change is reflected on the Nodes page.
Options

Choose one of the following options to change BMC credentials:

Use NetApp Hybrid Cloud Control to edit BMC information

You can edit the stored BMC credentials using the NetApp Hybrid Cloud Control Dashboard.

Steps
  1. Open the IP address of the management node in a web browser. For example:

    https://<ManagementNodeIP>
  2. Log in to NetApp Hybrid Cloud Control by providing the NetApp HCI storage cluster administrator credentials.

  3. In the left navigation blue box, select the NetApp HCI installation.

    The NetApp Hybrid Cloud Control Dashboard appears.

  4. In the left navigation, click Nodes.

  5. To view compute inventory information, click Compute.

    A list of your compute nodes appears. The BMC Connection Status column shows the result of BMC connection attempts for each compute node. If the connection attempt fails for a compute node, an error message is displayed in this column for that node.

  6. To add or edit the stored BMC credentials for a compute node with BMC connection errors, click Edit connection settings in the error message text.

  7. In the dialog that appears, add the correct administrator user name and password for the BMC of this compute node.

  8. Click Save.

  9. Repeat steps 6 through 8 for any compute node that has missing or incorrect stored BMC credentials.

Note Updating BMC information refreshes the inventory and ensures that management node services are aware of all hardware parameters needed to complete the upgrade.

Use the REST API to edit BMC information

You can edit the stored BMC credentials using the NetApp Hybrid Cloud Control REST API.

Steps
  1. Locate the compute node hardware tag and BMC information:

    1. Open the inventory service REST API UI on the management node:

      https://<ManagementNodeIP>/inventory/1/
    2. Click Authorize and complete the following:

      1. Enter the cluster user name and password.

      2. Enter the client ID as mnode-client.

      3. Click Authorize to begin a session.

      4. Close the authorization window.

    3. From the REST API UI, click GET /installations.

    4. Click Try it out.

    5. Click Execute.

    6. From the response, copy the installation asset ID (id).

    7. From the REST API UI, click GET /installations/{id}.

    8. Click Try it out.

    9. Paste the installation asset ID into the id field.

    10. Click Execute.

    11. From the response, copy and save the node asset id (id), BMC IP address (bmcAddress), and node serial number (chassisSerialNumber) for use in a later step.

      "nodes": [
        {
          "bmcDetails": {
            "bmcAddress": "10.117.1.111",
            "credentialsAvailable": false,
            "credentialsValidated": false
          },
          "chassisSerialNumber": "221111019323",
          "chassisSlot": "C",
          "hardwareId": null,
          "hardwareTag": "00000000-0000-0000-0000-ac1f6ab4ecf6",
          "id": "8cd91e3c-1b1e-1111-b00a-4c9c4900b000",
  2. Open the hardware service REST API UI on the management node:

    https://<ManagementNodeIP>/hardware/2/
  3. Click Authorize and complete the following:

    1. Enter the cluster user name and password.

    2. Enter the client ID as mnode-client if the value is not already populated.

    3. Click Authorize to begin a session.

    4. Close the window.

  4. Click PUT /nodes/{hardware_id}.

  5. Click Try it out.

  6. Enter the node asset id that you saved earlier in the hardware_id parameter.

  7. Enter the following information in the payload:

    Parameter Description

    assetId

    The installation asset id (id) that you saved in step 1(f).

    bmcIp

    The BMC IP address (bmcAddress) that you saved in step 1(k).

    bmcPassword

    An updated password to log into the BMC.

    bmcUsername

    An updated user name to log into the BMC.

    serialNumber

    The chassis serial number of the hardware.

    Example payload:

    {
      "assetId": "7bb41e3c-2e9c-2151-b00a-8a9b49c0b0fe",
      "bmcIp": "10.117.1.111",
      "bmcPassword": "mypassword1",
      "bmcUsername": "admin1",
      "serialNumber": "221111019323"
    }
  8. Click Execute to update BMC credentials.
    A successful result returns a response similar to the following:

    {
      "credentialid": "33333333-cccc-3333-cccc-333333333333",
      "host_name": "hci-host",
      "id": "8cd91e3c-1b1e-1111-b00a-4c9c4900b000",
      "ip": "1.1.1.1",
      "parent": "abcd01y3-ab30-1ccc-11ee-11f123zx7d1b",
      "type": "BMC"
    }

Find more information