Report: Remove cx556a from DPDK
[csit.git] / docs / testing_in_vagrant.rst
1 Running CSIT locally in Vagrant
2 -------------------------------
3
4 1. Download and install latest virtualbox from `official page
5    <https://www.virtualbox.org/wiki/Downloads>`_
6    To verify the installation, run VBoxManage:
7       - on windows:
8         "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
9       - on nix: VBoxManage --version
10    You should see virtualbox manager version printed, eg: 6.0.0r127566
11
12 2. Download and install latest vagrant `from official page
13    <https://www.vagrantup.com/downloads.html>`_
14    To verify the installtion, run:
15       vagrant -v
16    You should see vagrant version printed, eg: Vagrant 2.2.2
17
18 3. Install vagrant plugins
19    From command line run:
20       vagrant plugin install vagrant-vbguest
21       vagrant plugin install vagrant-cachier
22
23    If you are behind a proxy, install proxyconf plugin and update proxy
24    settings in Vagrantfile:
25       vagrant plugin install vagrant-proxyconf
26
27 4. Start the provisioning:
28       vagrant up --provider virtualbox
29
30 Your new VPP Device virtualbox machine will be created and configured.
31 Master branch of csit project will be cloned inside virtual machine into
32       /home/vagrant/csit folder.
33 Once the process is finished, you can login to the box using:
34       vagrant ssh
35
36 From within the box run the tests using:
37       cd /home/vagrant/csit/resources/libraries/bash/entry
38       ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox
39
40 In case you need to completely rebuild the box and start from scratch,
41 run these commands:
42       vagrant destroy -f
43       vagrant up --provider virtualbox
44
45 To run only selected tests based on TAGS, export environment variables before
46 running the test suite:
47       export GERRIT_EVENT_TYPE="comment-added"
48       export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
49       ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox