Use our prebuilt virtual machine image

Introduction

We built a vagrant box ([introduction] (https://www.vagrantup.com/docs/boxes.html)), which is a minimal virtual machine image with all dependencies installed to help users to conveniently create a VirtualBox VM and run centinel experiment in it. It is also a breeze to bring up as many VMs as you want to run as parallel VPN walkers.

We hope this could save you sometime to get started if your are interested in centinel and is willing to try it without too much trouble. This is much easier than installing all dependencies manually.

Usage

1. Install VirtualBox on your host. Download VirtualBox [here] (https://www.virtualbox.org/wiki/Downloads);

2. Install vagrant. Follow instructions [here] (https://www.vagrantup.com/docs/installation/);

3. Import our prebuilt vagrant box:

    $ vagrant box add https://iclab.org/PleaseCheckBackForTheURL
   

4. Create a directory for your VM;

5. Write your Vagrantfile in the directory to tell vagrant how you want to create your VM or VMs. You could find a example at https://iclab.org/PleaseCheckBackForTheURL. The example will create 8 VMs as HMA walkers, pull newest centinel code from GitHub, and create a shell script for each VM to start the walker. Please pay attention to NIC setting in the file. We found that a few NIC types will disconnect under heavy load after a while. So do not forget to change NIC to 'virtio' for your VM.

6. Now all you need to do is to bring up your VM:

    $ vagrant up
   

7. You could ssh into your VM:

    $ vagrant ssh
   

   You will need to specify VM name if you have multiple VMs running;

8. Please refer to vagrant [documentation] (https://www.vagrantup.com/docs/) if you want to know more about vagrant and its powerful commands.