Trending: Partially remove 3n-hsw

[csit.git] / docs / testing_in_vagrant.rst

diff --git a/docs/testing_in_vagrant.rst b/docs/testing_in_vagrant.rst
index 60b4cc5..b509e3d 100644 (file)
--- a/docs/testing_in_vagrant.rst
+++ b/docs/testing_in_vagrant.rst
@@ -1,46 +1,88 @@
 Running CSIT locally in Vagrant
 -------------------------------
 
 Running CSIT locally in Vagrant
 -------------------------------
 

-1. Download and install latest virtualbox from `official page <https://www.virtualbox.org/wiki/Downloads>`_
+Install prerequisites
+=====================
+
+Run all commands from command line.
+
+1. Download and install virtualbox from `official page
+   <https://www.virtualbox.org/wiki/Downloads>`_.

    To verify the installation, run VBoxManage:
    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:
+   - on windows::
+
+      "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" --version
+
+   - on nix::
+
+      VBoxManage --version
+
+   Tested version: 6.1.16r140961
+
+2. Download and install latest vagrant `from official page
+   <https://www.vagrantup.com/downloads.html>`_.
+   To verify the installtion, run::
+

       vagrant -v
       vagrant -v

-   You should see vagrant version printed, eg: Vagrant 2.2.2

 
 

-3. Install vagrant plugins
-   From command line run:
+   Tested version: Vagrant 2.2.15
+
+3. Install vagrant plugins::
+

       vagrant plugin install vagrant-vbguest
       vagrant plugin install vagrant-cachier
 
    If you are behind a proxy, install proxyconf plugin and update proxy
       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:
+   settings in Vagrantfile::
+

       vagrant plugin install vagrant-proxyconf
 
       vagrant plugin install vagrant-proxyconf
 

-4. Start the provisioning:
-      vagrant up --provider virtualbox
+Set up and run Vagrant virtualbox
+======================================
+
+Before running following commands change working directory to Vagrant specific directory
+(from within root CSIT directory) ::
+
+    cd csit.infra.vagrant
+
+This allows Vagrant to automatically find Vagrantfile and corresponding Vagrant environment.
+
+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
 
 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
+   /home/vagrant/csit folder.
+
+Once the process is finished, you can login to the box using::
+
+   vagrant ssh

 
 In case you need to completely rebuild the box and start from scratch,
 
 In case you need to completely rebuild the box and start from scratch,

-run these commands:
-      vagrant destroy -f
-      vagrant up --provider virtualbox
+run these commands::
+
+   vagrant destroy -f
+   vagrant up --provider virtualbox
+
+
+Run tests
+==============================
+
+From within the box run the tests using::
+
+   cd /home/vagrant/csit/resources/libraries/bash/entry
+   ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox

 
 To run only selected tests based on TAGS, export environment variables before
 
 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
+running the test suite::
+
+   export GERRIT_EVENT_TYPE="comment-added"
+   export GERRIT_EVENT_COMMENT_TEXT="devicetest memif"
+
+   # now it will run tests, selected based on tags
+   ./bootstrap_vpp_device.sh csit-vpp-device-master-ubuntu2004-1n-vbox
+
+