docs: update quickstart.md with src build info 98/898/3
authorMaryam Tahhan <maryam.tahhan@intel.com>
Mon, 22 Jun 2015 15:56:13 +0000 (16:56 +0100)
committerMaryam Tahhan <maryam.tahhan@intel.com>
Tue, 30 Jun 2015 15:39:41 +0000 (15:39 +0000)
Update quickstart.md to add information on how one can clone and build
OVS and DPDK.

Change-Id: I02365c4cdbdde6426008672a7ed7c6402be3c046
Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com>
Reviewed-by: Mark B Kavanagh <mark.b.kavanagh@intel.com>
Reviewed-by: TV Rao <tv.rao@freescale.com>
docs/quickstart.md

index e6fb9b3..7b2715a 100755 (executable)
@@ -3,8 +3,20 @@
 ## Installation
 
 Follow the [installation instructions] to install.
-
 ---
+## Cloning and building src dependencies
+In order to run VSPERF, you will need to download DPDK and OVS. You can do this manually and build them in a preferred location, or you could use vswitchperf/src. The vswitchperf/src directory contains makefiles that will allow you to clone and build the libraries that VSPERF depends on, such as DPDK and OVS. To clone and build simply:
+
+```bash
+cd src
+make
+```
+
+To delete a src subdirectory and its contents to allow you to re-clone simply use:
+
+```bash
+make cleanse
+```
 
 ## Configure the `./conf/10_custom.conf` file
 
@@ -13,7 +25,6 @@ The supplied `10_custom.conf` file must be modified, as it contains configuratio
 The configuration items that can be added is not limited to the initial contents. Any configuration item mentioned in any .conf file in `./conf` directory can be added and that item will be overridden by the custom
 configuration value.
 
-
 ## Using a custom settings file
 
 Alternatively a custom settings file can be passed to `vsperf` via the `--conf-file` argument.
@@ -31,6 +42,11 @@ Note that configuration passed in via the environment (`--load-env`) or via anot
 ---
 
 ## Executing tests
+Before running any tests make sure you have root permissions by adding the following line to /etc/sudoers:
+```
+username ALL=(ALL)       NOPASSWD: ALL
+```
+username in the example above should be replaced with a real username.
 
 To list the available tests: