RTF Installation for AWS

Author: Vikas Parikh

Objective

Outline the steps of RTF installation for AWS with Ops Center Portal Access

Installing RTF

Anypoint Platform Set Up

1. Sign into Anypoint Platform and then navigate to Runtime Manager ⇒ Runtime Fabrics
2. Click button – Create Runtime Fabric. Below screen would appear:

3. Click Button: Create
4. RTF instance “apisero-rtf” is ready for activation

5. “Download files” as per Step 2 (of the above screenshot)
6. Copy the activation data as mentioned in Step 3 (of the above screenshot)

This would be utilized while installing the RTF into AWS.

AWS Account Set Up

1. Verify the AWS account requirements as mentioned in Step 3 (of the screenshot above)
2. Make sure you can sign into AWS either as ROOT user or IAM user
3. Make sure you possess two values: KEY ID and ACCESS KEY

If you don’t, then perform below tasks:

a) If you are ROOT user/IAM user with sufficient access, then

Navigate to user → My Security Credentials

IAM Management Console would open

Under ‘AWS IAM credentials’, you can ‘Create access key’ under ‘Access keys for CLI, SDK, & API access’

b) If not, then reach out to your AWS admin team

4. Create EC2 Key Pair

a) Go to AWS Console and then to EC2 dashboard

b) Click ‘Key Pairs’ and then ‘Create key pair’

c) Provide key pair name and format

d) PPK file would be downloaded

e) Name of this key pair would be utilized for RTF installation and while SSHing to EC2 RTF controller instances

5. Configure the AWS CLI for windows

a) Download AWS CLI for windows

b) Verify the version command (aws –version) is successful

c) Configure AWS CLI through command (aws configure) as below

Enter KEY ID,  ACCESS KEY and region

For the first time, you need to enter the values

For the subsequent times, it will be pre-populated as below. 

If you are good with the value then you can simply press Enter key

Prepare the Script

1. Extract the downloaded zip file from the earlier step #5
2. Navigate to aws/ directory
3. Find the file – fabric.tf 
4. Apply 6 changes to the default populated script as below

(i) key_pair

• Provide the value “apisero-key-pair” as specified in earlier step #4

(ii) activation_data

• Provide the value as captured in earlier step #6

(iii) anypoint_region

• AWS region under which RTF installation is to be carried out

(iv) mule_license

• Obtain Mulesoft “license.lic” file for your RTF environment
• Convert the entire file to Base 64 output
• This portal could be useful for such conversion apart from Unix base64 command
• Enter this Base 64 license value to the script as below

(v) enable_public_ips

• Configure as true so that Ops Center is accessible over the internet

(vi) ops_center_cidr_blocks

• Configure the Ops Center CIDR block so that firewall rule settings are correctly applied in the AWS
• If this is not configured, you need to configure it manually in AWS

5. Download terraform

• Download from here
• Terraform is a tool that converts its script into AWS cloud formation script
• We are going to execute the Terraform script in next section

Execute the Script

1. Open command prompt and navigate to aws/ directory as per earlier step #2
2. Initial (clean) directory looks like below

3. Initialize the terraform

• Invoke command: terraform init
• One should be connected to internet
• One can expect successful output as below:

• Initialized directory looks like below:

4. Apply the terraform

• Invoke command: terraform apply -state=tf-data/rtf.tfstate
• One should be connected to internet
• Script will ask for the AWS region. Provide as configured in the earlier step #4 (iii) 

• Press Enter Key
• Script gets executed for couple of minutes and asks for the confirmation
• Provide your confirmation by entering ‘yes’
• If script completes successfully, it will yield summary output with:

a) Controller public and private ips [1 controller]

b) Worker’s public and private ips [2 workers]

5. Note: destroy AWS resources when not required (Caution: YOU SHOULD KNOW WHAT YOU ARE DOING)

• Invoke command: terraform destroy -state=./tf-data/rtf.tfstate
• It will release AWS resources for RTF

Verify the RTF Installation

1. Login to AWS Console followed by EC2 dashboard
2. 1 controller and 2 worker instances should be visible as below

3. Click Controller node. Make sure public Ip matches with what has been captured as part of earlier step 4 result. Note down the Public DNS. This would be utilized for subsequent configuration

4. Login to Anypoint platform and verify the RTF instance status

• Status should be active as per below:

• Allocate the environment as per below and click ‘Apply Allocations’

5. SSH into RTF controller instance

• Download the Putty and Pageant apps for windows
• Load the PPK key (Downloaded in earlier step 4-d  ) into Pageant as per below

• Configure Putty as below:

Host name: Public DNS as captured in Step 3 above

Port: 22

Connection: SSH: Auth: Agent Forwarding

• Open the session
• Accept the server key upon prompted
• Login as ec2-user
• You should be able to sign in

• Sign in as Super User: sudo su
• Locate the RTF installation logs: tail -f /var/log/rtf-init.log

• You should see logs as ‘Runtime Fabric installation complete.’ in the output

• Locate Ops Center credentials in the log file: vi /var/log/rtf-init.log

6. Login into the Ops Center 

URL: https://<public-dns>:32009/web/login

Credentials: Captured above

Accept the invalid certificate and move ahead.