In Application Services, you can start the teardown process to remove the vCloud Director vApp and associated virtual machines,vRealize Automation virtual machine and the associated virtual machine in vCenter Server, or Amazon EC2 instances from the cloud environment.

About this task

You can tear down a deployed application from the Application Services user interface or the command-line interface. See Using CLI to Tear Down a Deployment. In the 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 that are part of an application, or if an application is not used, you can use Application Services to tear down the application. All virtual machines in the application are removed from their hosts in the cloud.

Deployment tear down from the cloud 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 Application Services as an application publisher and deployer.

  • 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. On the Application Services title bar, click the drop-down menu and select Deployments.
  2. Enter the name of the deployment to tear down in the search text box.
  3. From the search result list, select the deployment to tear down.

    The deployment summary page opens.

  4. In the toolbar above the deployment summary, select Operations > Teardown.
    • In the Teardown Deployment dialog box, select Quick Teardown to remove the virtual machines for this deployment and click Teardown.

    • In the Teardown Deployment dialog box, select Assisted Teardown to open the Teardown wizard and click Teardown.

    For the quick tear down process, the TEARDOWN life cycle stage script does not run.

    A composite application deployment supports only the quick tear down process, and all of its application deployments must be torn down at the same time.

    For the assisted tear down process, the Teardown wizard displays the TEARDOWN life cycle stage script that you can configure. You can also view the order in which the tasks in the script run, and review the changes in the script before you run the script to remove the virtual machines for this deployment.

  5. (Optional) : If the teardown process fails, repeat the process.

Results

Above the task status windows, the task time line shows the status of the teardown process. After the virtual machines are deleted successfully from their hosts in the cloud, the status appears in the Task Summary section and in the overall deployment status.

After a teardown process starts, you cannot update the deployed virtual machines even if the teardown process fails and the virtual machines exist in the cloud environment. Ask your cloud administrator to tear down the deployment from the cloud.

What to do next

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