3 title: "Running CSIT locally in Vagrant"
6 # Running CSIT locally in Vagrant
8 ## Install prerequisites
10 Run all commands from command line.
12 1. Download and install virtualbox from
13 [official page](https://www.virtualbox.org/wiki/Downloads).
14 To verify the installation, run VBoxManage
18 "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
23 Tested version: 6.1.16r140961
25 2. Download and install latest vagrant
26 [from official page](https://www.vagrantup.com/downloads.html).
27 To verify the installtion, run
30 Tested version: Vagrant 2.2.15
32 3. Install vagrant plugins::
34 vagrant plugin install vagrant-vbguest
35 vagrant plugin install vagrant-cachier
37 If you are behind a proxy, install proxyconf plugin and update proxy
38 settings in Vagrantfile::
40 vagrant plugin install vagrant-proxyconf
42 ## Set up and run Vagrant virtualbox
44 Before running following commands change working directory to Vagrant specific directory
45 (from within root CSIT directory)
49 This allows Vagrant to automatically find Vagrantfile and corresponding Vagrant environment.
51 Start the provisioning
53 vagrant up --provider virtualbox
55 Your new VPP Device virtualbox machine will be created and configured.
56 Master branch of csit project will be cloned inside virtual machine into
57 /home/vagrant/csit folder.
59 Once the process is finished, you can login to the box using
63 In case you need to completely rebuild the box and start from scratch,
67 vagrant up --provider virtualbox
71 From within the box run the tests using
73 cd /home/vagrant/csit/resources/libraries/bash/entry
74 ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox
76 To run only selected tests based on TAGS, export environment variables before
77 running the test suite
79 export GERRIT_EVENT_TYPE="comment-added"
80 export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
82 # now it will run tests, selected based on tags
83 ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox