Chapter 11. Uninstalling

This chapter describes how to uninstall Ansible Automation Platform.

11.1. Removing extension nodes

If you have deployed extension nodes, you must take the following steps to remove the extension nodes before uninstalling the stack.

If you have added extension nodes, follow the procedures in Removing extension nodes to remove them.

11.2. Uninstalling Ansible Automation Platform

Procedure

  1. In the AWS UI, navigate to the cloudformation page. Ensure you are in the correct region.
  2. Select the stack for your Ansible Automation Platform deployment.
  3. Click Delete.
  4. Click Delete to confirm the deletion.

It can take some time to complete the deletion.

11.3. Removing upgrade resources

The following procedures describes how to delete any resources left behind after an upgrade.

Note

These actions cannot be reversed.

You must only perform these actions if your deployment has been deleted.

11.3.1. Removing the launch configurations

Use the following procedure to remove the old launch configurations.

Procedure

  1. In the AWS UI, navigate to the Launch configurations page. Ensure you are in the same region as your stack.

    1. Click View launch configurations in the popup that appears.
  2. Identify the Launch Configuration corresponding to your Ansible Automation Platform deployment.

    1. Search for your deployment name. These are named <deployment_name>-hubautoscalegroup-<sufix> for the hub autoscalegroup launch configuration and <deployment_name>-controllerautoscalegroup-<sufix> for the controller autoscalegroup launch configuration.
  3. Delete the resources.

    1. Select the checkbox next to the Launch Configurations.
    2. Click Actions.
    3. Click Delete launch configurations.
    4. Confirm the deletion.

11.3.2. Removing the hub IAM role

Use the following procedure to remove the hub IAM role. This step is necessary if you are uninstalling your Ansible Automation Platform environment after an upgrade and your CloudFormation stack has a status of DELETE_FAILED

Procedure

  1. In the AWS UI, navigate to the CloudFormation page. Ensure you are in the same region as your stack.
  2. Select the stack for your Ansible Automation Platform deployment.
  3. Click Delete.
  4. If a popup appears listing your hub IAM role as failing to delete, click the link below the hub IAM role open the role in a tab.
  5. Delete the hub role.

    1. Click Delete.
    2. Confirm the deletion.
    3. Ensure the deletion is successful.
  6. Return to your CloudFormation page in the previous tab.

    1. Ensure the checkbox next to the hub IAM role is unchecked.
    2. Click Delete to confirm the stack deletion.
    3. Confirm the deletion.

11.4. Removing backup resources

The following procedures describe how to delete any resources left behind when uninstalling your Ansible Automation Platform deployment, after having run a backup on it.

Note

These actions cannot be reversed.

You must only perform these actions if your deployment has been deleted.

11.4.1. Removing the S3 bucket

The following procedure removes the S3 bucket used for backup.

Procedure

  1. In the AWS UI, navigate to the S3 Bucket page. Ensure you have selected the same region as your stack.
  2. Identify the S3 Bucket associated with your backup.

    1. Search for the bucket name. The bucket name must be the same the name used during the backup procedure.
  3. Delete the bucket.

    1. Select the radio button next to the bucket name.
    2. Click Empty.
    3. Confirm all objects have been deleted.
    4. Select the radio button next to the bucket name.
    5. Click Delete.
    6. Confirm the deletion.

11.4.2. Removing AWS backup recovery points

The following procedure deletes AWS backup files left after backup.

Procedure

  1. In the AWS UI, navigate to the AWS Backup page. Ensure you have selected the same region as your stack.
  2. Navigate to the Backup Vaults in the sidebar.
  3. Identify the Backup Vault associated with your backup.
  4. Search for the vault name. This must be the same as the name used during the backup procedure.
  5. Delete the resource.

    1. Select the checkboxes of all recovery points you want to delete.
    2. Click Actions, then click Delete.
    3. Confirm the deletion.