Remove VMware Infrastructure Health adapter instance through API

Products

• VMware Aria Suite

Issue/Introduction

• You receive an adapter alert, saying Infrastructure Health adapter instance is down
• This issue may be present following changes to a nodes IP address or following removal of a node from the cluster.
• You receive an alert "Objects are not receiving data from adapter instance" triggered on a VMware Infrastructure Health adapter

Environment

Aria Operations 8.12.x and above

Cause

The VMware Infrastructure Health adapters are hidden in the Administration > Integrations page since version 8.18 and the adapters must be deleted via API.

Resolution

Prerequisite: Take a snapshot of all nodes in the cluster (including cloud proxies) -  How to take a Snapshot of VMware Aria Operations

1. Obtain the ID of the adapter to Delete
   1. Log in to Aria Operations and navigate to Operations > Configurations > Inventory Management
   2. Click Deselect All
      
      
      
      
   3. Click Click here to apply filters and add VMware Infrastructure Health Adapter Instance to the Object Type: field then click APPLY
      
      
   4. In the Status Bar at the bottom of the screen, click Show Columns, place a check next to ID, and click OK
      
      
      
      
   5. Right Click the ID of the adapter to delete and click Copy Cell
2. Authenticate to the Aria Operations API
   1. Navigate to Home > Launchpad > Developer Center
   2. Click API documentation
   3. Click Authorize and enter credentials for a user with the necessary rights to delete an adapter instance
3. Delete the adapter via API
   1. Click on Adapters /api/adapters to expand
   2. Click on DELETE /api/adapters/{adapterId} to expand
   3. Click Try it out
   4. Enter the Id copied in step 1.e. into the adapterId field
   5. Set deleteResources to appropriate value (default value: false)
   6. Click Execute
   7. Verify the Response Code received is 204
4. Verify the adapter instance is removed
   1. Use steps 1.a. through 1.c. and verify the adapter instance is removed
      Note: It can take a few minutes for the adapter to be deleted if the deleteResources value was set to "true". Verify the Collection State for the adapter instance is "Marked for Deletion" and the Collection Status is "Removing"
5. Recreate the VMware Infrastructure Health adapter instance
   1. Log in to the node that the adapter instance was removed from as root via SSH or vSphere Console
   2. Restart the collector service

      systemctl restart collector

6. Verify the new VMware Infrastructure Health adapter was created

Additional Information

It is expected that one (and only one) VMware Infrastructure Health adapter is present on every node - including cloud proxies - in the Aria Operations cluster.