Add compute and controller assets to the management node

12/15/2021 Contributors

PDFs

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.

When manually adding compute nodes, make sure that you also add the BMC assets otherwise an error is returned.

Steps

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",
  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.
(For compute nodes only) Locate the hardware tag for your compute node in vSphere.

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

Option Description

Option	Description
POST /assets/{asset_id}/controllers	Open the mNode service REST API UI on the management node: https://<ManagementNodeIP>/mnode Select Authorize and complete the following: Enter the cluster user name and password. Enter the client ID as `mnode-client`. Select Authorize to begin a session. Close the window. Select POST /assets/{asset_id}/controllers. Select Try it out. Enter the parent base asset ID in the asset_id field. Add the required values to the payload. Select Execute.
POST /assets/{asset_id}/compute-nodes	Open the mNode service REST API UI on the management node: https://<ManagementNodeIP>/mnode Select Authorize and complete the following: Enter the cluster user name and password. Enter the client ID as `mnode-client`. Select Authorize to begin a session. Close the window. Select POST /assets/{asset_id}/compute-nodes. Select Try it out. Enter the parent base asset ID you copied in an earlier step in the asset_id field. In the payload, do the following: Enter the management IP for the node in the `ip` field. For `hardwareTag`, enter the hardware tag value you saved in an earlier step. Enter other values, as required. Select Execute.
POST /assets/{asset_id}/hardware-nodes	Open the mNode service REST API UI on the management node: https://<ManagementNodeIP>/mnode Select Authorize and complete the following: Enter the cluster user name and password. Enter the client ID as `mnode-client`. Select Authorize to begin a session. Close the window. Select POST /assets/{asset_id}/hardware-nodes. Select Try it out. Enter the parent base asset ID in the asset_id field. Add the required values to the payload. Select Execute.

POST /assets/{asset_id}/controllers

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.
Select POST /assets/{asset_id}/controllers.
Select Try it out.
Enter the parent base asset ID in the asset_id field.
Add the required values to the payload.
Select Execute.

POST /assets/{asset_id}/compute-nodes

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.
Select POST /assets/{asset_id}/compute-nodes.
Select Try it out.
Enter the parent base asset ID you copied in an earlier step in the asset_id field.
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.
Select Execute.

POST /assets/{asset_id}/hardware-nodes

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.
Select POST /assets/{asset_id}/hardware-nodes.
Select Try it out.
Enter the parent base asset ID in the asset_id field.
Add the required values to the payload.
Select Execute.

Add compute and controller assets to the management node

Creating your file...

Find more information