You can view and manage deployments and send reclamation requests to deployment owners. A reclamation request specifies a new lease length in days, the amount of time given for a deployment owner’s response, and which machines to target for reclamation.

Before you begin

  • Log in to the vRealize Automation console as a tenant administrator.

  • To see health badges or view metrics provided by vRealize Operations Manager, see Configure a Metrics Provider.

Procedure

  1. Select Administration > Reclamation > Deployments.
  2. Find virtual machine deployments that match your search criteria.

    You must select platform type vSphere to view metrics provided by vRealize Operations Manager.

    1. Click the Advanced Search down arrow to open the search box.
    2. Enter or select one or more search values.

      Option

      Action

      Virtual Machine name contains

      Enter one or more characters in the text box to find virtual machine names that match.

      Owner name contains

      Enter a name in the text box to find owner names that match.

      Business group names contains

      Enter a name in the text box to find business group names that match.

      Platform Type

      Select a platform type from the drop-down menu. Select vSphere to view metrics provided by vRealize Operations Manager.

      Required for vRealize Operations Manager.

      Power State

      Select a power state value from the drop-down menu to find virtual machines with a matching power state.

      Expiration date between

      Click the calendar icons and select start and end dates to find expiration dates inside the range.

      CPU usage

      Select a value from the drop-down menu to find virtual machines with High CPU use, above 80%, Low CPU use below 5%, or None, no value.

      If you are querying vRealize Operations Manager metrics, you cannot use this filter to query, and you cannot sort results by CPU usage.

      Memory usage

      Select a value from the drop-down menu to find virtual machines with High Memory use, above 80%, Low Memory use, below 10%, or None, no value.

      If you are querying vRealize Operations Manager metrics, you cannot use this filter to query, and you cannot sort results by memory usage.

      Disk usage

      Select a value from the drop-down menu to find virtual machines with Low Hard Disk use, less than 2 KBs per second or None, no value.

      If you are querying vRealize Operations Manager metrics, you cannot use this filter to query, and you cannot sort results by disk usage.

      Network usage

      Select a value from the drop-down menu to find virtual machines with Low Network use, less than 1 KB per second, or None, no value.

      If you are querying vRealize Operations Manager metrics, you cannot use this filter to query, and you cannot sort results by network usage.

      Complex metric

      Select a value from the drop-down menu to find virtual machines based on complex metrics. For example, select idle to find machines that have CPU, network, memory, and disk usage values all under 20%.

      You cannot use this filter if you are querying vRealize Operations Manager metrics.

    3. Click the search icon (Browse).
  3. From the Deployments page, select one or more machines whose parent deployment is to be reclaimed.

    Only selected machines that are visible on the current results page are reclaimed.

  4. Click Reclaim.

    The deployments that contain virtual machines that are selected on the current page are included in the request.

    Note:

    The Reclaim Deployment page can list machines that are not available for reclamation, such as machines for which the lease has expired. If you specify a machine that is not available for reclamation, you receive the following error:

    Selection Error: Virtual machine name is not in valid state for reclamation.

  5. Enter the duration of the new lease in the New lease length (days) text box.

    The minimum is 1 day, the maximum is 365 days, and the default is 7 days.

  6. Enter how many days the deployment owner has to respond to the reclamation request in the Wait before forcing lease (days) text box

    At the end of that time, the deployment gets a new lease with the new lease length. The minimum waiting period is 1 day, the maximum is 365 days, and the default is 3 days.

  7. Enter a reason for the request in the Reason for request text box.
  8. Click Submit.
  9. Click OK.

Results

When you send a reclamation request, it appears in the Inbox of the deployment owner. If the owner does not respond to the request in the required number of days, the deployment gets a new lease of the specified length, unless its current lease is shorter. If the owner clicks Item in Use on the reclamation request, the deployment's lease remains unchanged. If the owner clicks Release for Reclamation, the deployment lease expires immediately.

What to do next

Track Reclamation Requests.