Software Install

This reference will help you install software necessary to setup your workshop environment

  1. AWS CLI
  2. jq

Install AWS CLI v2

The AWS Command Line Interface (AWS CLI) is a unified tool that provides a consistent interface for interacting with all parts of AWS.

Linux

This includes:

  • AWS CloudShell
  • All native Linux installs
  • Windows Subsystem for Linux (WSL)

Verify existing version:

  • Run the following command aws --version Step1

If the version number is less than 2.1.12 or you get “command not found”

You need to install or upgrade. Follow these steps:

  • curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
  • unzip awscliv2.zip
  • sudo ./aws/install --update

After typing the commands, you should see the following in your console: Upgrade1

For additional troubleshooting, see the detailed installation instructions here

MacOS

See the detailed MacOS installation instructions here

Windows

See the detailed Windows installation instructions here

STOP HERE and return to the Lab Guide

jq

jq is a command-line JSON processor. is like sed for JSON data. It is used in the workshop bash scripts to parse AWS CLI output.

  • Run the following command

      $ jq --version
  jq-1.6

  • Any version is fine.

  • If you instead got command not found then you need to install jq.

Install jq

  • If you are using Amazon Linux (or Red Hat Enterprise Linux) run the following:

      sudo yum install jq

  • If using another Linux distro, then follow the instructions at https://stedolan.github.io/jq/download/

  • If that succeeded, then you are finished. Return to the Lab Guide

Alternate instructions for Linux

If the steps above did not work, and you are running Linux, then try the following

  1. Download the jq executable

     $ wget https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64

 [...lots of output...]
 jq-linux64                    100%[=================================================>]   3.77M  1.12MB/s    in 3.5s

 2019-10-11 17:41:42 (1.97 MB/s) - ‘jq-linux64’ saved [3953824/3953824]

  2. You can find out what your execution path is with the following command.

     $ echo $PATH
 /usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/opt/aws/bin:/home/ec2-user/.local/bin:/home/ec2-user/bin

  3. If you have sudo rights, then copy the executable to /usr/local/bin/jq and make it executable.

     $ sudo cp jq-linux64 /usr/local/bin/jq
 $ sudo chmod 755 /usr/local/bin/jq

  4. If you do not have sudo rights, then copy it into your home directory under a /bin directory.

     $ cp jq-linux64 ~/bin/jq
 $ chmod 755 ~/bin/jq

STOP HERE and return to the Lab Guide