Doc

Note: This page is a draft!

Overview diagrams

Diagrams can be found at:

• UML Class Diagram detailed

• UML Class Diagram simplified

• UML Activity Diagram (workflow)

Diagrams edited with: https://app.genmymodel.com/welcome

Another Activity Diagram can be found at: https://www.dropbox.com/s/v0u0lcvklv1qdgp/activity-overview.pdf

First time setup

Generate a ssh key pair with ssh-keygen and save the private key as vmrootfs/root/.ssh/id_rsa, where vmrootfs is the home folder for VMs. It is recommended, but not mandatory to put the public key in the same directory. Also, the public key must be added to authorized_keys file in the same folder.

How to run vLab

1. Set PYTHONPATH to the folder where vlab tree resides e.g.: export PYTHONPATH='home/costash/workspace/vlab'
2. Go to bin directory from vlab tree
3. Run: sudo PYTHONPATH=$PYTHONPATH ./v

Note: For using ssh to connect to send commands to VMs use ssh root@10.0.5.2 '. $HOME/.bashrc; YOUR_COMMAND'

Using SSH to connect to VMs

To be able to use the same PATH defined inside the VM you need to source $HOME/.bashrc before sending any command over ssh. E.g.: ssh root@10.0.1.2 . $HOME/.bashrc; echo $PATH. This way you will avoid problems with different PATH variable when running over ssh.

Thesis link

Thesis

Config file drafts

• The vm config file can be found here: vm.json
• The topology config draft can be found here: topo.json