Manually removing a Cloud Proxy from Aria Operations

Products

VMware Aria Suite

Issue/Introduction

The purpose of this article is to explain how to remove a Cloud Proxy manually via CLI.

A Cloud Proxy may be duplicated on the Administration > Cloud Proxies page.
A Cloud Proxy is powered off and deleted without removing it from Aria/vRealize Operations Operations, the Cloud Proxy is listed as inaccessible.
Attempts to gracefully remove the Cloud Proxy from either of the scenarios does not succeed.
As of Aria Operations 8.16, converted remote collectors must be removed and replaced with full cloud proxies.

Upgrade Assessment Tool (APUAT) reports

Checking Existence of Remote Collectors
       Validation Failed. At least one Remote Collector found
       Replace all Remote Collectors with generic Cloud Proxies

Environment

Aria Operations 8.x
VMware vRealize Operations 8.x

Cause

Occasionally there can be a duplicate cloud proxy listed in the Product/Admin UI.
This can occur during cluster upgrades or failed Cloud Proxy deployments.

Resolution

When the Cloud Proxy is available in Aria Operations Product UI, remove it from Product UI:

Select Administration -> CloudProxies

Note: In versions 8.17 or lower, select Data Sources -> Cloud Proxies
Click the three vertical dots (ellipsis), and select Delete

When the cloud proxy only appears in Admin UI, it must be removed using the CaSA API:

Log in to the primary node as root via SSH or vSphere Console
Find the UUID of the cloud proxy to be removed
```
sed -nre "/CLOUD_PROXY/ s/^[^']+'([^']+)','([^']+)'.*/\1 \2/p" /storage/db/casa/webapp/hsqldb/casa.db.script
```
The UUID will be the first column in the results and should be in format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx where x is any hexadecimal character (a-f or 0-9)

Use the CaSA API to remove the cloud proxy

curl --insecure 'https://<OPS_IP>/casa/onprem/v1/cloudproxy/remove' -i -u 'admin' -X DELETE -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"cloud_proxy_uuid":"<UUID>"}'

Replace <OPS_IP> with the IP or FQDN of the Aria Operations primary node

Replace <UUID> with the UUID found in step 2

Example

curl --insecure 'https://10.1.2.3/casa/onprem/v1/cloudproxy/remove' -i -u 'admin' -X DELETE -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"cloud_proxy_uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}'

Provide the Aria Operations local admin password when prompted
Verify the cloud proxy has been removed from the Admin UI

Additional Information

The above steps will only be successful if the cluster is in a clean Online or Offline state.
Do not attempt the below steps if the cluster is in any other state (i.e. Failed, Expanding, Shrinking)
Ensure you have a valid snapshot or backup of the vRealize Operations cluster before proceeding.
See How to take a Snapshot of VMware Aria Operations for more information.