vFunction Logo

Setup AWS workshop environment

In this section, you will create and deploy the necessary AWS services required for this workshop by running a Terraform package.

Prerequisites

  1. AWS Account

    • You must have an AWS account with sufficient permissions to:
      • Run Terraform
      • Create EC2 instances
      • Create VPCs and Subnets

  2. Bash Shell Environment

    • A bash shell authorized to run commands on your AWS account, with at least 1 GB of available disk space.
    • Options include:
      • AWS CloudShell (accessible via the icon in the top-right toolbar of the AWS Console, provided you have sufficient quota)
      • Linux machine with AWS CLI configured and access to your AWS account

    • To confirm that your shell can access AWS and that your credentials are valid (not expired), run the following command:

      aws sts get-caller-identity

Run the installation package to deploy the Workshop resources

Perform the following in the Bash Shell Environment:

  1. Download the workshop installation package from the vFunction portal using the command:

    curl -o vfunction-workshop-aws-installation.tgz https://portal.vfunction.com/file/51a5b730a4115c35378c4d3a42690555/55406770-e7b7-4482-9892-8174fbd096c9/vfunction-workshop-aws-installation.tgz

  2. Unpack the installation package

    tar zxvf vfunction-workshop-aws-installation.tgz

  3. Edit the file ./config/installation.yaml file:

    vim ~/vfunction-workshop/config/installation.yaml

    1. Set the region to which the resources will be deployed- you can use any US region

    2. Fill in your org_name (must be shorter than 50 chars) and email (e.g., “my company” as org_name and “myname@company.net” as email)

    3. Set distributed_mode flag to false and monolith_mode to true

  4. Run the installation and wait for the script to complete

    bash ~/vfunction-workshop/install.sh

Setup Remote Desktop to Workshop Windows VM

  1. Switch to the EC2 Instances page in the region you set to deploy the workshop

  2. Open the EC2 instance with the name starting with workshop-windows (should be in running state) and copy its public IPv4 Address

  3. Open your Remote Desktop Protocol (RDP) client and paste the IP as the Host Name or Address

  4. Start the RDP session. The user name is workshop the password is vFunction2021!

  5. If prompted, approve the certificate to access the remote machine

  6. You should now see the Windows Desktop running on the Dev VM.

Access the Workshop Linux VM

  1. Copy the private IP address of the Workshop-Linux VM from the AWS console

  2. In the Windows VM (Remote Desktop), run PuTTY (icon is on the desktop)

  3. In the PuTTY dialog, enter the private IP address of the Linux VM and click Open

  4. Login using the same credentials (login: workshop password:vFunction2021!)

Login to the vFunction server

The vFunction platform installation was automated by the Workshop Installation package.

To login to the platform:

  1. Open Chrome in the Windows VM (Remote Desktop)

  2. Go to the following URL: http://[IP Address of the Linux VM]

  3. Login with the e-mail you entered in the installation.yaml file. The password is vFunction2021!

You should see a screen similar to:

vFunction Server

You are now ready to proceed to Learning.

vFunction Logo