Manually removing a Cloud Proxy from Aria Operations
search cancel

Manually removing a Cloud Proxy from Aria Operations

book

Article ID: 326397

calendar_today

Updated On:

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:

  1. Select Administration -> CloudProxies

    Note: In versions 8.17 or lower, select Data Sources -> Cloud Proxies

  2. 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:

  1. Log in to the primary node as root via SSH or vSphere Console

  2. 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)

  3. 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"}'
  4. Provide the Aria Operations local admin password when prompted

  5. 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.