From: Maryam Tahhan <maryam.tahhan@intel.com>
Date: Mon, 24 Aug 2015 12:51:20 +0000 (+0100)
Subject: docs: Add Gotchas to quickstart guide.
X-Git-Tag: brahmaputra.1.0~106
X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=commitdiff_plain;h=65fe266e99de3746372e633794c07ad95c1e383e;p=vswitchperf.git

docs: Add Gotchas to quickstart guide.

JIRA: VSPERF-60
Change-Id: I63695f8fa8a86cf1e64fd959658e11f3d827a3c4
Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com>
Reviewed-by: Al Morton <acmorton@att.com>
---

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index fe04cb7d..5c5b7625 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -155,6 +155,30 @@ For all available options, check out the help dialog:
 
     ./vsperf --help
 
+
+GOTCHAs:
+--------
+
+OVS with DPDK and QEMU
+~~~~~~~~~~~~~~~~~~~~~~~
+If you encounter the following error: "before (last 100 chars):
+'-path=/dev/hugepages,share=on: unable to map backing store for
+hugepages: Cannot allocate memory\r\n\r\n" with the PVP deployment
+scenario, check the amount of hugepages on your system:
+
+.. code:: bash
+
+    cat /proc/meminfo | grep HugePages
+
+
+By default the vswitchd is launched with 1Gb of memory, to  change
+this, modify --socket-mem parameter in conf/02_vswitch.conf to allocate
+an appropriate amount of memory:
+
+.. code:: bash
+
+    VSWITCHD_DPDK_ARGS = ['-c', '0x4', '-n', '4', '--socket-mem 1024,0']
+
 --------------
 
 .. |Alt text| image:: images/TCLServerProperties.png