Skip to main content
Element Software

Add a controller asset to the management node

Contributors netapp-pcarriga netapp-yvonneo
PDFs

You can add a controller asset 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. See Create a NetApp HCC role in vCenter

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. To add a controller sub-asset to an existing base asset, select:

    POST /assets/{asset_id}/controllers

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

      https://<ManagementNodeIP>/mnode

    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. Select POST /assets/{asset_id}/controllers.

    4. Select Try it out.

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

    6. Add the required values to the payload.

    7. Select Execute.

Find more information