Troubleshoot AWS Launch Wizard for Active Directory

Each deployment in your account in the same AWS Region can be uniquely identified by the name specified at the time of a deployment. The deployment name can be used to view the details related to the deployment on the Deployments page of the Launch Wizard console.

This section describes steps to help you troubleshoot deploying domain controllers with Launch Wizard for Active Directory.

Launch Wizard provisioning events

Launch Wizard captures events from AWS CloudFormation to track the status of an ongoing application deployment. If an application deployment fails, you can view the deployment events for this application by selecting Deployments from the navigation pane. A failed event shows a status of Failed along with a failure message.

CloudWatch Logs

Launch Wizard streams provisioning logs from all of the AWS log sources, such as AWS CloudFormation and PowerShell DSC scripts to CloudWatch Logs. You can view the CloudWatch Logs for a given application name on the CloudWatch console for the log group name LaunchWizard-APPLICATION_NAME and log stream ApplicationLaunchLog.

AWS CloudFormation stack

Launch Wizard uses AWS CloudFormation to provision the infrastructure resources of an application. CloudFormation stacks can be found in your account using the CloudFormation describe-stacks API. Launch Wizard launches various stacks in your account for validation and application resource creation. The following are the relevant filters for the describe-stacks API.

• Application Resources

  • LaunchWizard-APPLICATION_NAME. This stack includes all of the resource creation events for resources created by the deployment.

  • LaunchWizard-STACK_NAME-TEMPLATE_NAME. This log includes all of the logs from each PowerShell script run from within the instance.

You can view the status of these CloudFormation stacks. If any of them fail, you can view the cause of failure.