A tenant administrator can send reclamation requests to virtual machine owners. A reclamation request specifies a new lease length in days, the amount of time given for a machine owner’s response, and which machines to target for reclamation.

Prerequisites

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

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

Procedure

  1. Select Administration > Tenant Machines > Reclamation.
  2. Find virtual machines 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 (required for vRealize Operations Manager)

      Select a platform type from the drop-down menu. Select vSphere to view metrics provided by 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.

      Mem 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 current results page, select one or more virtual machines to reclaim.

    For manageability, only machines selected on the current results page are reclaimed.

  4. Click Reclaim Virtual Machine.

    Virtual machines selected on the current results page are included in the request.

    Note:

    The Reclamation 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 machine owner has to respond to the reclamation request in the Wait before forcing lease (days) text box.

    At the end of that time, the machine 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 owner of the virtual machine. If the owner does not respond to the request in the required number of days, the virtual machine 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 virtual machine's lease remains unchanged. If the owner clicks Release for Reclamation, the virtual machine lease expires immediately.

What to do next

Track Reclamation Requests.