You can request the teardown of standard and composite applications and their virtual machines from the vRealize Automation console.

About this task

You can also tear down a deployed application from the Application Services user interface or the command-line interface. See Tear Down an Application from the Cloud and Using CLI to Tear Down a Deployment. In the Application Services user interface you can define a TEARDOWN life cycle stage script for a service version and application component to remove an application and associated virtual machines or an updated application.

If a deployment fails after installing one or more virtual machines in vCenter Server and vRealize Automation that are part of an application, or if an application is not used, you can use vRealize Automation to tear down the application. All virtual machines in the application are removed from their hosts.

Deployment tear down with vRealize Automation does not remove the deployment record from the Deployments page in Application Services. To remove the deployment record from the Deployments page, see Delete an Application Deployment from Application Services.

Prerequisites

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

  • Verify that you have access to at least one deployed application in vRealize Automation.

  • Verify that the virtual machines that are part of the application still exist in the cloud. If, for example, your environment has a policy of deleting virtual machines after a certain number of days, the virtual machines might already be deleted.

Procedure

  1. Select Items > Application Deployment.
  2. Enter the name of the deployment to tear down in the search text box and click the magnifying glass icon (Browse) or press Enter.
  3. Select the deployment to tear down from the search result list.

    The Item Details page appears.

  4. Select Destroy from the Actions menu.

    The Request Information tab on the Destroy dialog box appears.

  5. Enter a description in the Description text box.

    This required description helps you monitor the progress of the request after submission.

  6. (Optional) : Enter the reasons for the request in the Reasons text box.
  7. Click Next.
  8. Select a Choose a teardown option radio button on the Teardown Deployment tab.

    Option

    Description

    Assisted Teardown

    Destroy all virtual machines deployed with the application and execute the TEARDOWN life cycle stage script.

    Quick Teardown

    Destroy all virtual machines deployed with the application, but do not execute the TEARDOWN life cycle stage script.

  9. Click Submit.

    The Request confirmation box appears.

  10. Click OK.

What to do next

You can monitor the status of your teardown request on the Requests tab on the vRealize Automation console.

To delete the record of a deployment from the Deployments page, see Delete an Application Deployment from Application Services.