Skip to main content
Version: v10.15

Preparing Infrastructure on AWS


Prerequisites

  • AWS (Amazon Web Service) account with access to launch instances and to create security groups.
  • For information on creating infrastructure in AWS, see AWS documentation for creating EC2 Linux instance.
  • Users need IAM (Identity and Access Management) policies and user permissions to view and work to create and manage Amazon EC2 (Amazon Elastic Compute Cloud) instances and security groups in a specified VPC (Virtual Private Cloud) resource in the Amazon EC2 console.
  • For IAM permissions and details, see AWS IAM policies.

Creating Security Groups

Creation of WME-SG-Platform-Public Security Group

  • Provide necessary details for creating the security group and select your desired VPC.

basic

  • Select inbound rules and edit rules for developer network access. You can specify your developer network range in the source.

ports public access

Creating WME-SG-Platform-Internal Security Group

  • Provide essential details for creating the security group and select the previously selected VPC.

basic

  • Select inbound rules and edit rules to access from the StudioWorkspace Instance / AppDeployment Instance. At the source field, provide WME-SG-Workspace-Internal security group ID.

ports internal

Creating WME-SG-Workspace-Internal Security Group

  • Provide essential details for creating the security group and select the previously selected VPC.

basic

  • Select inbound rules and edit rules to access from the Platform Instance. At the source field, provide WME-SG-Platform-Internal security group ID.

ports internal

Launch Platform Instance

  • Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.
  • Choose Launch Instance, choose an ubuntu 16.04 Amazon Machine Image (AMI), or if you have any ubuntu 16.04 AMI, select it.

ami

  • Choose 16 GiB memory instance types from desired family and type.

instance type

  • Choose Next:
    1. Configure Instance Details.
    2. For Network, choose the same VPC that you created for security groups.
    3. For Subnet, select the desired Subnet in any Availability Zone.

instance configurations

  • Add storage 50 GiB for the root volume.
  • 50 GiB for wm-runtime
  • 150 GiB for wm-data.

storage

  • If you want to add any tags, add tags to the instance.

tags

  • To Configure Security Group:
    • Select an existing security group.
    • Select WME-SG-Platform-Internal.
    • After creating the instance, select instance.
    • At actions, the open networking section.
    • Choose change security groups.
    • Add security group WME-SG-Platform-Public.

security group

  • Next, review your instance details and launch the instance.

Launch Studio Workspace Instance / AppDeployment Instance

  • Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.
  • Choose Launch Instance, choose an ubuntu 16.04 Amazon Machine Image (AMI), or if you have any ubuntu 16.04 AMI, select it.

ami

  • Choose 16 GiB memory instance types from desired family and type.

instance type

  • Choose Next:
    1. Configure Instance Details.
    2. For Network, choose the same VPC that you created for security groups.
    3. For Subnet, select the desired Subnet in any Availability Zone.

instance configuration

  • Add storage 150 GiB for data.

storage

  • Next, if you want to add any tags, add tags to the instance.

tags

  • Next, Configure the Security Group. Select the existing security group, and select the WME-SG-Workspace-Internal security group.

security groups

  • Next, review your instance details and launch the instance.

Mounting storage volumes in EC2 Instances

Mounting storage in Platform Instance

  • Login into the EC2 instance. For logging into the EC2 instance, open the terminal, use the below example command.
ssh -i path/to/accesskey.pem ubuntu@ipaddress
note

Accesskey will generate during the creation of the instance. You have to select an existing .pem file or create a new .pem file for accessing the EC2 instance.

lsblk
  • New volumes are raw block devices, and you must create a file system on them before you can mount and use them. For creating file systems, use the following command.
Command : mkfs -t ext4 /dev/<block-device-name_1>
mkfs -t ext4 /dev/<block-device-name_2>
Example :
mkfs -t ext4 /dev/xvdb
mkfs -t ext4 /dev/xvdc
  • Use the mkdir command to create a mount point directory for the volume. The mount point is where the volume is located in the file system tree and where you read and write files after you mount the volume. For WME-Setup, create two directories using the following commands.
mkdir /wm-data /wm-runtime
  • Use the following command to mount the volume at the directory.
Command :  
mount /dev/<block-device-name_1> /wm-data
mount /dev/<block-device-name_2> /wm-runtime
Example :
mount /dev/xvdc /wm-data
mount /dev/xvdb /wm-runtime

mounting volumes

  • To mount an attached EBS (Elastic Block Store) volume on every system reboot, add an entry for the device to the /etc/fstab file.
  • Take UUID of disks for identification by using the following command.
blkid
  • To entry the UUID of the disks in .fstab, use the following format.
UUID=<block-device_1-UUID>    /wm-data     ext4   defaults ,nofail  0  2
UUID=<block-device_2-UUID> /wm-runtime ext4 defaults ,nofail 0 2

fstab

Mounting storage StudioWorkspace Instance / AppDeployment Instance

note

Applies for StudioWorkspace Instance/AppDeployment Instance

  • Login into EC2 instance. For logging into EC2 instance, open the terminal, use the below example command.
ssh -i path/to/accesskey.pem ubuntu@ipaddress
note

Accesskey will generate during the creation of the instance. You have to select an existing pem file or create a new pem file for accessing the ec2 instance.

lsblk
  • New volumes are raw block devices, and you must create a file system on them before you can mount and use them. For creating file systems, use following command.
Command : mkfs -t ext4 /dev/<block-device-name>
Example : mkfs -t ext4 /dev/xvdb
  • Use the mkdir command to create a mount point directory for the volume. The mount point is where the volume is located in the file system tree and where you read and write files after you mount the volume. For WME-Setup, create two directories using the following commands.
mkdir /data
  • Use the following command to mount the volume at the directory.
Command : mount /dev/<block-device-name>   /data
Example : mount /dev/xvdb /data

mounting volumes

  • To mount an attached EBS volume on every system reboot, add an entry for the device to the /etc/fstab file.
  • Take UUID of disks for identification by using the following command.
blkid
  • To enter the UUID of the disks in .fstab, use the following format.
UUID=<your-block-device-UUID>    /data     ext4     defaults ,nofail  0  2

fstab

What's next