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, the Cloud Proxy is listed as inaccessible.
Attempts to gracefully remove the Cloud Proxy from either of the scenarios do 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 the Aria Operations Product UI, remove it from the 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 using one of the following methods

Note: The UUID will be in format #######-####-####-####-############# where # is any hexadecimal character (a-f or 0-9)
1. Method 1
```
curl --insecure -s -u "admin" https://localhost/casa/onprem/v1/cloudproxies | python -m json.tool
```
  Provide the Aria Operations local admin password when prompted. The UUID will precede the additional details for each cloud proxy.
2. Method 2
```
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.

Use the CaSA API to remove the cloud proxy

curl --insecure 'https://localhost/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 <UUID> with the UUID found in step 2

Example

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

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 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 Snapshot Creation in VMware Aria Operations for more information.