aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorLudovit Mikula <ludovit.mikula@pantheon.tech>2019-02-06 15:47:23 +0100
committerĽudovít Mikula <ludovit.mikula@pantheon.tech>2019-04-09 15:10:12 +0200
commit374ea2f45d17f361aa612becba657ecaade0d0b5 (patch)
treeca29e9c804c52aa14cc577299443958491f4e994 /docs
parent42e6c422a5ce4f58813a8c3a44ba0e9ac9238c9a (diff)
Add vagrant setup for testing VPP device locally
Fixed trailing whitespaces Fixed tabs vs. spaces Removed dead code Changed network interface naming Changed default number of retries for VPP startup to 120 Updated number of hugepages during provisioning Externalized CSIT related sysctl settings to 90-csit.conf Removed hardcoded local docker image name. Added new interface required for honeycomb device testing. Change-Id: I5eb38c8b1a4d96e4220dbd2e202e94f1d47e804e Signed-off-by: Ludovit Mikula <ludovit.mikula@pantheon.tech>
Diffstat (limited to 'docs')
-rw-r--r--docs/testing_in_vagrant16
-rw-r--r--docs/testing_in_vagrant.rst46
2 files changed, 46 insertions, 16 deletions
diff --git a/docs/testing_in_vagrant b/docs/testing_in_vagrant
deleted file mode 100644
index 1007621874..0000000000
--- a/docs/testing_in_vagrant
+++ /dev/null
@@ -1,16 +0,0 @@
-HOWTO (will create a wiki page once one is created for CSIT project):
- - copy Vagrantfile to separate dir on host
- - vagrant up --parallel
- sit-back-and-relax
- - from VM that has access to the same host-only network (192.168.255.0 above)
- - copy your ssh-key to csit@192.168.255.{101,102,250}
- - cd ${csit_dir}
- - virtualenv & pip as in README
- - PYTHONPATH=`pwd` resources/tools/topology/update_topology.py \
- topologies/available/vagrant.yaml \
- -o topologies/available/vagrant_pci.yaml
- - PYTHONPATH=`pwd` pybot -L TRACE \
- -v TOPOLOGY_PATH:topologies/available/vagrant_pci.yaml -s \
- "bridge domain" tests
- - see tests results
-
diff --git a/docs/testing_in_vagrant.rst b/docs/testing_in_vagrant.rst
new file mode 100644
index 0000000000..60b4cc553e
--- /dev/null
+++ b/docs/testing_in_vagrant.rst
@@ -0,0 +1,46 @@
+Running CSIT locally in Vagrant
+-------------------------------
+
+1. Download and install latest virtualbox from `official page <https://www.virtualbox.org/wiki/Downloads>`_
+ To verify the installation, run VBoxManage:
+ - on windows: "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
+ - on nix: VBoxManage --version
+ You should see virtualbox manager version printed, eg: 6.0.0r127566
+
+2. Download and install latest vagrant `from official page <https://www.vagrantup.com/downloads.html>`_
+ To verify the installtion, run:
+ vagrant -v
+ You should see vagrant version printed, eg: Vagrant 2.2.2
+
+3. Install vagrant plugins
+ From command line run:
+ vagrant plugin install vagrant-vbguest
+ vagrant plugin install vagrant-cachier
+
+ If you are behind a proxy, install proxyconf plugin and update proxy
+ settings in Vagrantfile:
+ vagrant plugin install vagrant-proxyconf
+
+4. Start the provisioning:
+ vagrant up --provider virtualbox
+
+Your new VPP Device virtualbox machine will be created and configured.
+Master branch of csit project will be cloned inside virtual machine into
+ /home/vagrant/csit folder.
+Once the process is finished, you can login to the box using:
+ vagrant ssh
+
+From within the box run the tests using:
+ cd /home/vagrant/csit/resources/libraries/bash/entry
+ ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox
+
+In case you need to completely rebuild the box and start from scratch,
+run these commands:
+ vagrant destroy -f
+ vagrant up --provider virtualbox
+
+To run only selected tests based on TAGS, export environment variables before
+running the test suite:
+ export GERRIT_EVENT_TYPE="comment-added"
+ export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
+ ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu1804-1n-vbox \ No newline at end of file