+++ title = "Start Your Engines ! " chapter = false weight = 5 +++ ![image](/images/workshop_setup/ad_team_tech_lead.png) {{% notice warning %}} You must **have enough available VPCs, Elastic IPs, and NAT Gatewways in the region you are working in** to successfully **create an EKS Cluster** with a managed node group of 2 nodes. You also need to have space for three S3 Buckets. If you **run into a problem** during the setup, it is **usually associated with insufficient resources or permissions in your AWS account**. You can resolve resource constraints by **requesting a quota increase** for your AWS account. {{% /notice %}} {{% notice warning %}} In order to prevent charges to your AWS account, we recommend cleaning up the infrastructure that gets created with the setup utility. If you plan to keep things running so you can examine the workshop a bit more, please remember to do the cleanup when you are done. It is very easy to leave things running in an AWS account, forget about it, and then accrue charges. {{% /notice %}} Just so you understand ahead of time, you can easily clean up all the resources that get created by the setup utility by using the commands below: ``` cd /home/ec2-user/environment/modernization_workshop ./teardown_workshop.sh ```
## Let's do this !
Now that you've got all the prerequisites out of the way, you can kick off the initial setup steps and go grab a cup of coffee while the setup utility runs. Ensure you are in your home directory by executing the command below: ``` cd /home/ec2-user/environment ``` Clone the GitHub repository for the workshop using the following command: ``` git clone https://github.com/Appdynamics/appd_aws_observability_lab.git modernization_workshop ``` Change directory to where the repository was cloned using the following command: ``` cd /home/ec2-user/environment/modernization_workshop ``` Use five (5) letters of your first, and or, your last name to create your unique workshop user name using the command below: **EXAMPLE:**  export appd_workshop_user=TOMSM ``` export appd_workshop_user= ``` Use the command below to execute the setup script: ``` ./setup_workshop.sh ``` {{% notice info %}} The setup utility takes **approximately 7 minutes to complete**. While you're waiting for the setup to finish you can **go to the AppDynamics Advantage section** where you can **find out why AD Financial selected AppDynamics** as their **preferred observability solution**. {{% /notice %}} The output from the start of the setup script should look like this: ![image](/images/workshop_setup/setup-output-start.png) The output from the setup script when it ends, should look like this: ![image](/images/workshop_setup/setup-output-end.png) ## What the setup utility does **01)** Installs Java JDK 1.8 **02)** Resizes the Disk on your C9 instance **03)** Installs kubectl **04)** Installs eksctl **05)** Installs docker-compose **06)** Installs the AppDynamics Database agent **07)** Creates an EC2 security group for external access to RDS Databases **08)** Creates RDS databases with the security group attached **09)** Creates three S3 buckets **10)** Creates two Application Performance Monitoring apps in the AppDynamics Controller **11)** Creates two Browser Real User Monitoring apps in the AppDynamics Controller **12)** Creates two AppDynamics Database collectors in the AppDynamics Controller **13)** Creates an RBAC User in the AppDynamics Controller **14)** Creates an RBAC Role in the AppDynamics Controller **15)** Adds the RBAC User in the AppDynamics Controller to the appropriate RBAC Roles **16)** Deploys the Pre-Modernization application to your local C9 instance **17)** Creates the teardown file Using a shell script - Using the AWS Java SDK - Using the AppDynamics REST API - ## Additional setup in following sections There will be some additional setup steps in the following sections listed below. There's no need to do them now. Wait until you've reached those sections to perform the steps for each section. Modernize Section - Create the EKS Cluster - Deploy the Application to EKS - Deploy the AppDynamics Agents to EKS ## What the final architecture will look like ![image](/images/workshop_setup/arch_diagram.png)
## Next **While you are waiting** for the setup utility to finish, **go to the AppDynamics Advantage section** where you can **find out why AD Financial selected AppDynamics** as their **preferred observability solution**.