CloudMeasurement

CloudMeasurement is a CLI that create multiple Traceroute experiments in different Cloud infrastructures (for now just AWS, but Google Cloud is planned ).

Installation

CloudMeasurement works with Mac OSX and Ubuntu (18.04, 20.04) the installation is straight forward, you have to clone the repository, install the requirements and then the tool.

Update the system and clone the repository (Ubuntu OS)

vagrant@ubuntu-bionic:~$ sudo apt update && sudo apt install awscli git python3-pip -y

vagrant@ubuntu-bionic:~$ git clone https://github.com/Giuseppe1992/CloudMeasurement.git

With MAC OSX make sure to have git and python3-pip and install the awscli via homebrew

Install the dependencies and the software

vagrant@ubuntu-bionic:~$ cd CloudMeasurement/
vagrant@ubuntu-bionic:~/CloudMeasurement$ 

vagrant@ubuntu-bionic:~/CloudMeasurement$ pip3 install -r requirements.txt 

vagrant@ubuntu-bionic:~/CloudMeasurement$ sudo python3 setup.py install

check the installation

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm 
No operation

Configure the Environment

Configure CloudMeasurement

In the configuration the user has to configure the AWS Access key ID and Secret Access Key, if it is using AWS for the first time.

In the last line, the user has to specify the path of the private key that will be used to connect with the virtual instances in the experiments.

Make sure to give a correct path, by default is pointing the default key from ~/.ssh directory

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm --init
AWS Access Key ID [None]: ******************
AWS Secret Access Key [None]: ********************************
Default region name [None]: eu-central-1
Default output format [None]: json
Insert the default private key [default: /home/vagrant/.ssh/id_rsa] : 

View the configuration

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm --configuration
+-------------------------------------------------------+---------------------------------+---------------------------+
| DB_PATH                                               | UTILS_PATH                      | PRIVATE_KEY_PATH          |
+=======================================================+=================================+===========================+
| /home/vagrant/.CloudMeasurement/CloudMeasurementDB.db | /home/vagrant/.CloudMeasurement | /home/vagrant/.ssh/id_rsa |
+-------------------------------------------------------+---------------------------------+---------------------------+

Run the helper

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -h
Usage: cm [options]
(type cm -h for details)

The utility creates experiments  from the command line. It can create
experiments, list them, and manage.

Options:
  -h, --help            show this help message and exit
  -c CREATE_EXPERIMENT, --create_experiment=CREATE_EXPERIMENT
                        possible experiments:  multiregionalTrace
  --init                initialize the environment
  --configuration       initialize the environment
  --purge               purge all the active experiments
  -e, --ls_experiments  list the experiments
...

Run Experiments

Multiregional Traceroute

Regional Traceroute

Create your first experiment

Multiregional Trace creation

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -c multiregional --regions="eu-central-1,eu-west-2"

Regional Trace creation

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -c regional --regions="eu-central-1"

The --key_pair_id parameter

It is very important to be sure that the public key is already imported in all the regions where the user wants to run the experiments. By default --key_pair_id="id_rsa", this means that in every regions there is a key pair named "id_rsa" that is the public part of the keypair imported in the tool during the initial configuration. To specify another key_pair_id, you have to create the experiment like the next example:

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -c multiregional --regions="eu-central-1,eu-west-2" --key_pair_id=YOUR_ID

List the created Experiments

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -e

List the created Instances

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -i

Start your experiment

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -s EXPERIMENT_ID

Retrieve all the data of your experiment

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm --retrieve_data EXPERIMENT_ID

Save the data in a specified path

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm --save_data EXPERIMENT_ID,LOCAL_PATH

Delete an experiment

vagrant@ubuntu-bionic:~/CloudMeasurement$ cm -d EXPERIMENT_ID