The overview provides a glimpse of the installation procedure. The user has to perform the below steps:
- Initially, refer to Prerequisites for Installation to create required IAM roles on AWS.
- Next, follow the Pre-Installation steps and process required for the user to Initiate Infra file to install the tool on your PC.
- Once you complete the installation steps, the installation script will add the below resources to your AWS account.
-
-
- 2 Ubuntu EC2 instances – 1 Jump and 1 private Hive nodes
- 1 EKS cluster with 3 nodes
- 1 RDS instance
- Apart from the above-listed resources, a few other resources are also created for example VPC, Subnet, Internet Gateway, and Node groups
-
- Additionally, the installation script will deploy Dextrus UI and 5 microservices.
- After the installation is completed, Terraform script will return the Dextrus UI endpoint, and then you’re redirected to the Dextrus Log-in page.
- The above-specified process takes 60 minutes time to complete.
Pre-requisites for Installation
The User:
- Should have AWS account access and an IAM user account with administrator access
- Has to create two roles namely
-
-
- Amazon EKS Cluster role
- Amazon Worker Node
-
- To learn steps on how to create these roles, refer:
https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html
- You may face frequent issues while creating infrastructure, refer to the below link to find solutions for those common issues
https://getrightdata.zendesk.com/knowledge/articles/8848585924244/en-us?brand_id=6099312353428
Pre-Installation steps and process required for the user to Initiate Infra file:
The installation steps and processes differ based on your OS.
For Linux environment:
- Download/Clone the provided repository that contains code from Bitbucket/GitHub (found in the repository within the Linux instance).
- Type the below command to enter into the Infra directory.
cd aws_automation/infra
- You have to grant permission to initiate-infra.sh file installation by running the below command with the required permissions. This file can be found inside the Infra folder available in the downloaded Zip file.
chmod +x initiate-infra.sh
- Once the file is downloaded you have to run the file by running the below command on Ubuntu to start the installation process.
./initiate-infra.sh
Refer Installation Process
- The process will install and configure Terraform, AWS CLI, Docker, and Ansible. This process takes 40-60 minutes time to complete.
- Once the process is completed a URI is produced that redirects you to the Dextrus web page. Then copy the URI and paste it into the browser (Google Chrome/Mozilla Firefox) to access the Dextrus application.
- You need to provide login details to get access to the Dextrus application.
For Windows environment:
Pre-requisites:
- AWS CLI and Terraform should be installed
-
- Install Terraform from https://learn.hashicorp.com/tutorials/terraform/install-cli
- Install AWS CLI from https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html
- Configure AWS CLI by running ‘aws configure’ from the command prompt
-
- Download the provided Zip file.
- Extract the Zip file into the Windows machine.
- You have to grant permission to initiate-bat file installation by running the below command with the required permissions. This file can be found inside the Infra folder available in the downloaded Zip file.
chmod +x initiate-infra.bat
- Once the file is downloaded you have to run the file by running the below command on Windows to start the installation process.
./initiate-infra.bat
Refer Installation Process
- The process will install and configure Terraform, AWS CLI, Docker, and Ansible. This process takes 60 minutes time to complete.
- Once the process is completed a URI is produced that redirects you to the Dextrus web page.