Skip to main content
If onboarding fails, the AWS CloudFormation stack shows failures in the Status column and the final status should display ROLLBACK_COMPLETE. Before trying to onboard your AWS account again, you must remove the CloudFormation template, two IAM roles, and a policy created in AWS by the template.
  1. In AWS console, go to CloudFormation > Stacks. screenshot of AWS cloudformation stacks page
  2. Select the failed stack. The default name is aviatrix-onboard-aws, but the name could have been modified.
  3. In the pane that displays to the right, click the Events tab. screenshot of AWS cloudformation events tab
  4. Scroll through the Events table and look for messages in the Status reason column. Examples of some root cause descriptions: screenshot of AWS cloudformation events with security group error screenshot of AWS cloudformation events with rules and policy errors
  5. Resolve the issues mentioned. If the problem is due to existing roles or policies, you will resolve those in the following steps.
  6. Click Delete to permanently remove the failed stack.
  7. Read the AWS warning and click Delete. Stack status changes to DELETE_COMPLETE after several seconds. If you refresh the Stacks pane, the stack name disappears.
  8. To remove the roles, go to AWS IAM > Access Management > Roles and select and delete the following:
  • aviatrix-platform-app
  • aviatrix-role-ec2-<long-id> screenshot of aws roles page
  1. To remove the policy, go to Access Management > Policies and then search for and delete the following:
  • aviatrix-platform-app-policy screenshot of aws roles page
You can now onboard the same account in the Aviatrix PaaS console, if you choose to do so.