summaryrefslogtreecommitdiffstats
path: root/docs/testing/developer/requirements
diff options
context:
space:
mode:
authorDeepak S <deepak.s@linux.intel.com>2017-08-21 02:51:33 -0700
committerDeepak S <deepak.s@linux.intel.com>2017-08-21 02:51:33 -0700
commit4a31f76b5f3e1caad12b7cc3bfe97ee1f0dacfc7 (patch)
treed3292bebca6e875d8755fa67a6023bca05fec0a3 /docs/testing/developer/requirements
parentada951272b7d7cc06dd0086276586d1d4032261d (diff)
Added developer user guide draft for samplevnfs
Change-Id: I15a5f7ae8e3aac5d509b7a722f7032fbd2da69d0 Signed-off-by: Deepak S <deepak.s@linux.intel.com>
Diffstat (limited to 'docs/testing/developer/requirements')
-rw-r--r--docs/testing/developer/requirements/03-Requirements.rst88
-rw-r--r--docs/testing/developer/requirements/index.rst5
2 files changed, 88 insertions, 5 deletions
diff --git a/docs/testing/developer/requirements/03-Requirements.rst b/docs/testing/developer/requirements/03-Requirements.rst
new file mode 100644
index 00000000..ce43e06a
--- /dev/null
+++ b/docs/testing/developer/requirements/03-Requirements.rst
@@ -0,0 +1,88 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
+.. OPNFV SAMPLEVNF Documentation design file.
+
+============
+Requirements
+============
+
+**Required Test setup:**
+
+.. _SampleVNF: https://wiki.opnfv.org/samplevnf
+.. _Technical_Briefs: https://wiki.opnfv.org/display/SAM/Technical+Briefs+of+VNFs
+
+Supported Test setup:
+--------------------
+The device under test (DUT) consists of a system following;
+ * A single or dual processor and PCH chip, except for System on Chip (SoC) cases
+ * DRAM memory size and frequency (normally single DIMM per channel)
+ * Specific Intel Network Interface Cards (NICs)
+ * BIOS settings noting those that updated from the basic settings
+ * DPDK build configuration settings, and commands used for tests
+Connected to the DUT is an IXIA* or Software Traffic generator like pktgen or TRex,
+simulation platform to generate packet traffic to the DUT ports and
+determine the throughput/latency at the tester side.
+
+Below are the supported/tested (:term `VNF`) deployment type.
+.. image:: images/deploy_type.png
+ :width: 800px
+ :alt: SampleVNF supported topology
+
+Hardware & Software Ingredients
+-------------------------------
+.. code-block:: console
+ +---------------+------------------+
+ | Item | Description |
+ +---------------+------------------+
+ | Memory | Min 20GB |
+ +---------------+------------------+
+ | NICs | 2 x 10G |
+ +---------------+------------------+
+ | HostOS/Guest | Ubuntu 16.04 LTS |
+ +---------------+------------------+
+ | kernel | >4.4.0-34-generic|
+ +---------------+------------------+
+ |DPDK | >17.02 |
+ +---------------+------------------+
+
+ Boot and BIOS settings
+ +------------------+---------------------------------------------------+
+ | Boot settings | default_hugepagesz=1G hugepagesz=1G hugepages=16 |
+ | | hugepagesz=2M hugepages=2048 isolcpus=1-11,22-33 |
+ | | nohz_full=1-11,22-33 rcu_nocbs=1-11,22-33 |
+ | | Note: nohz_full and rcu_nocbs is to disable Linux*|
+ | | kernel interrupts, and it’s import |
+ +------------------+---------------------------------------------------+
+ |BIOS | CPU Power and Performance Policy <Performance> |
+ | | CPU C-state Disabled |
+ | | CPU P-state Disabled |
+ | | Enhanced Intel® Speedstep® Tech Disabled |
+ | | Hyper-Threading Technology (If supported) Enable |
+ | | Virtualization Techology Enable |
+ | | Coherency Enable |
+ | | Turbo Boost Disabled |
+ +------------------+---------------------------------------------------+
+
+Network Topology for testing VNFs
+---------------------------------
+The ethernet cables should be connected between traffic generator and the VNF server (BM,
+SRIOV or OVS) setup based on the test profile.
+
+The connectivity could be
+1. Single port pair : One pair ports used for traffic
+ ::
+ e.g. Single port pair link0 and link1 of VNF are used
+ TG:port 0 <------> VNF:Port 0
+ TG:port 1 <------> VNF:Port 1
+
+2. Multi port pair : More than one pair of traffic
+ ::
+ e.g. Two port pair link 0, link1, link2 and link3 of VNF are used
+ TG:port 0 <------> VNF:Port 0
+ TG:port 1 <------> VNF:Port 1
+ TG:port 2 <------> VNF:Port 2
+ TG:port 3 <------> VNF:Port 3
+For openstack/Standalone virtualization, installation please refer the openstack guide and ovs-dpdk/sriov github.
+(TBA - Add link to guide)
diff --git a/docs/testing/developer/requirements/index.rst b/docs/testing/developer/requirements/index.rst
deleted file mode 100644
index 8efa8620..00000000
--- a/docs/testing/developer/requirements/index.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) OPNFV, Intel Corporation and others.
-
-.. OPNFV SAMPLEVNF Documentation requirements file.