summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMaryam Tahhan <maryam.tahhan@intel.com>2015-06-22 16:56:13 +0100
committerMaryam Tahhan <maryam.tahhan@intel.com>2015-06-30 15:39:41 +0000
commit7bb98df23def728ea1090f8082fcbc11b1b7372b (patch)
tree84d49e9f9f66b184cbcccddd5b159080c5885cd2
parent2a3611f29c72bf73a9a940f52ef97b65182280a7 (diff)
docs: update quickstart.md with src build info
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>
-rwxr-xr-xdocs/quickstart.md20
1 files changed, 18 insertions, 2 deletions
diff --git a/docs/quickstart.md b/docs/quickstart.md
index e6fb9b3d..7b2715a0 100755
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -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: