Logging in to a Failed Instance

Important

The AWS OpsWorks Stacks service reached end of life on May 26, 2024 and has been disabled for both new and existing customers. We strongly recommend customers migrate their workloads to other solutions as soon as possible. If you have questions about migration, reach out to the AWS Support Team on AWS re:Post or through AWS Premium Support.

If a recipe fails, the instance will end up in the setup_failed state instead of online. Even though the instance is not online as far as AWS OpsWorks Stacks is concerned, the EC2 instance is running and it's often useful to log in to troubleshoot the issue. For example, you can check whether an application or custom cookbook is correctly installed. The AWS OpsWorks Stacks built-in support for SSH and RDP login is available only for instances in the online state. However, if you have assigned an SSH key pair to the instance, you can still log in, as follows:

• Linux instances – Use the SSH key pair's private key to log in with a third-party SSH client, such as OpenSSH or PuTTY.

  You can use an EC2 key pair or your personal SSH key pair for this purpose.

• Windows instances – Use the EC2 key pair's private key to retrieve the instance's Administrator password.

  Use that password to log in with your preferred RDP Client. For more information, see Logging in As Administrator. You cannot use a personal SSH key pair to retrieve an Administrator password.