Skip to main content
A newer release of this product is available.

Add compute and controller assets to the management node

Contributors netapp-pcarriga

You can add compute and controller assets to the management node configuration using the REST API UI.

You might need to add an asset if you recently scaled your installation and new assets were not added automatically to your configuration. Use these APIs to add assets that are recent additions to your installation.

What you'll need
  • Your cluster version is running NetApp Element software 11.3 or later.

  • You have deployed a management node running version 11.3 or later.

  • You have created a new NetApp HCC role in vCenter to limit the management node services view to NetApp-only assets.

  • You have the vCenter management IP address and credentials.

  • You have the compute node (ESXi) management IP address and root credentials.

  • You have the hardware (BMC) management IP address and administrator credentials.

About this task

(NetApp HCI only) If you do not see compute nodes in Hybrid Cloud Control (HCC) after scaling your NetApp HCI system, you can add a compute node using the POST /assets/{asset_id}/compute-nodes described in this procedure.

Steps
  1. Get the base asset ID for the installation:

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

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

      1. Enter the cluster user name and password.

      2. Enter the client ID as mnode-client.

      3. Select Authorize to begin a session.

      4. Close the window.

    3. From the REST API UI, select GET ​/installations.

    4. Select Try it out.

    5. Select Execute.

    6. From the code 200 response body, copy the id for the installation.

      {
        "installations": [
          {
            "_links": {
              "collection": "https://10.111.211.111/inventory/1/installations",
              "self": "https://10.111.217.111/inventory/1/installations/abcd01e2-ab00-1xxx-91ee-12f111xxc7x0x"
            },
            "id": "abcd01e2-ab00-1xxx-91ee-12f111xxc7x0x",
      Note Your installation has a base asset configuration that was created during installation or upgrade.
    7. From the REST API UI, select GET /installations/{id}.

    8. Select Try it out.

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

    10. Select Execute.

    11. From the response, copy and save the cluster controller ID ("controllerId") for use in a later step.

  2. (For compute nodes only) Locate the hardware tag for your compute node in vSphere.

  3. To add a controller asset (vCenter), compute node (ESXi), or hardware (BMC) to an existing base asset, select one of the following.

    Option Description

    POST /assets/{asset_id}/controllers

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

      https://<ManagementNodeIP>/mnode
      1. Select Authorize and complete the following:

        1. Enter the cluster user name and password.

        2. Enter the client ID as mnode-client.

        3. Select Authorize to begin a session.

        4. Close the window.

    2. Select POST /assets/{asset_id}/controllers.

    3. Select Try it out.

    4. Enter the parent base asset ID in the asset_id field.

    5. Add the required values to the payload.

    6. Select Execute.

    POST /assets/{asset_id}/compute-nodes

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

      https://<ManagementNodeIP>/mnode
      1. Select Authorize and complete the following:

        1. Enter the cluster user name and password.

        2. Enter the client ID as mnode-client.

        3. Select Authorize to begin a session.

        4. Close the window.

    2. Select POST /assets/{asset_id}/compute-nodes.

    3. Select Try it out.

    4. Enter the parent base asset ID you copied in an earlier step in the asset_id field.

    5. In the payload, do the following:

      1. Enter the management IP for the node in the ip field.

      2. For hardwareTag, enter the hardware tag value you saved in an earlier step.

      3. Enter other values, as required.

    6. Select Execute.

    POST /assets/{asset_id}/hardware-nodes

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

      https://<ManagementNodeIP>/mnode
      1. Select Authorize and complete the following:

        1. Enter the cluster user name and password.

        2. Enter the client ID as mnode-client.

        3. Select Authorize to begin a session.

        4. Close the window.

    2. Select POST /assets/{asset_id}/hardware-nodes.

    3. Select Try it out.

    4. Enter the parent base asset ID in the asset_id field.

    5. Add the required values to the payload.

    6. Select Execute.

Find more information