English

Add an asset to the management node

Contributors netapp-dbagwell netapp-mwallis Download PDF of this page

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.

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://[management node IP]/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 window.

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

    4. Click Try it out.

    5. Click 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",
      Your installation has a base asset configuration that was created during installation or upgrade.
    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 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:

    1. Select the host in the vSphere Web Client navigator.

    2. Click the Monitor tab, and click Hardware Health.

    3. The node BIOS manufacturer and model number are listed. Copy and save the value for tag for use in a later step.

  3. To add a compute node or controller sub-asset to an existing base asset, click one of the following.

    Option Description

    POST /assets/{asset_id}/controllers

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

      https://[management node IP]/mnode
      1. 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 window.

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

    3. Click Try it out.

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

    5. Add the required values to the payload.

    6. Click Execute.

    POST /assets/{asset_id}/compute-nodes

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

      https://[management node IP]/mnode
      1. 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 window.

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

    3. Click 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. Click Execute.

Find more information