1 files changed, 231 insertions, 18 deletions

diff --git a/doc/book-enea-nfv-access-platform-guide/doc/benchmarks.xml b/doc/book-enea-nfv-access-platform-guide/doc/benchmarks.xml
index 7155e44..fa461fa 100644
--- a/doc/book-enea-nfv-access-platform-guide/doc/benchmarks.xml
+++ b/doc/book-enea-nfv-access-platform-guide/doc/benchmarks.xml
@@ -4,18 +4,231 @@
 <chapter id="benchmarks">
   <title>Benchmarks</title>
 
-  <para></para>
-
   <section id="hw-setup">
     <title>Hardware Setup</title>
 
-    <para></para>
+    <para>The following table describes all the needed prequisites for an apt
+    hardware setup:</para>
+
+    <table>
+      <title>Hardware Setup</title>
+
+      <tgroup cols="2">
+        <colspec align="left" />
+
+        <thead>
+          <row>
+            <entry align="center">Item</entry>
+
+            <entry align="center">Description</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry align="left">Server Platform</entry>
+
+            <entry align="left">Supermicro X10SDV-4C-TLN2F
+            http://www.supermicro.com/products/motherboard/xeon/d/X10SDV-4C-TLN2F.cfm</entry>
+          </row>
+
+          <row>
+            <entry align="left">ARCH</entry>
+
+            <entry>x86-64</entry>
+          </row>
+
+          <row>
+            <entry align="left">Processor</entry>
+
+            <entry>1 x Intel Xeon D-1521 (Broadwell), 4 cores, 8
+            hyper-threaded cores per processor</entry>
+          </row>
+
+          <row>
+            <entry align="left">CPU freq</entry>
+
+            <entry>2.40 GHz</entry>
+          </row>
+
+          <row>
+            <entry align="left">RAM</entry>
+
+            <entry>16GB</entry>
+          </row>
+
+          <row>
+            <entry align="left">Network</entry>
+
+            <entry>Dual integrated 10G ports</entry>
+          </row>
+
+          <row>
+            <entry align="left">Storage</entry>
+
+            <entry>Samsung 850 Pro 128GB SSD</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+
+    <para>Generic tests configuration:</para>
+
+    <itemizedlist>
+      <listitem>
+        <para>All tests use one port, one core and one Rx/TX queue for fast
+        path traffic.</para>
+      </listitem>
+    </itemizedlist>
   </section>
 
   <section id="bios">
-    <title>Bios</title>
+    <title>BIOS Settings</title>
+
+    <para>The table below details the BIOS settings for which the default
+    values were changed when doing performance measurements.</para>
+
+    <table>
+      <title>BIOS Settings</title>
+
+      <tgroup cols="4">
+        <colspec align="left" />
+
+        <thead>
+          <row>
+            <entry align="center">Menu Path</entry>
+
+            <entry align="center">Setting Name</entry>
+
+            <entry align="center">Enea NFV Access value</entry>
+
+            <entry align="center">BIOS Default value</entry>
+          </row>
+        </thead>
+
+        <tbody>
+          <row>
+            <entry align="left">CPU Configuration</entry>
+
+            <entry align="left">Direct Cache Access (DCA)</entry>
+
+            <entry>Enable</entry>
+
+            <entry>Auto</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management
+            Configuration</entry>
+
+            <entry align="left">EIST (P-States)</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management Configuration
+            / CPU C State Control</entry>
+
+            <entry align="left">CPU C State</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management Configuration
+            / CPU Advanced PM Turning / Energy Perf BIAS</entry>
+
+            <entry align="left">Energy Performance Tuning</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management Configuration
+            / CPU Advanced PM Turning / Energy Perf BIAS</entry>
+
+            <entry align="left">Energy Performance BIAS Setting</entry>
+
+            <entry>Performance</entry>
+
+            <entry>Balanced Performance</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management Configuration
+            / CPU Advanced PM Turning / Energy Perf BIAS</entry>
+
+            <entry align="left">Power/Performance Switch</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>CPU Configuration / Advanced Power Management Configuration
+            / CPU Advanced PM Turning / Program PowerCTL _MSR</entry>
+
+            <entry align="left">Energy Efficient Turbo</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>Chipset Configuration / North Bridge / IIO
+            Configuration</entry>
+
+            <entry align="left">EV DFX Features</entry>
+
+            <entry>Enable</entry>
+
+            <entry>Disable</entry>
+          </row>
+
+          <row>
+            <entry>Chipset Configuration / North Bridge / Memory
+            Configuration</entry>
+
+            <entry align="left">Enforce POR</entry>
+
+            <entry>Disable</entry>
+
+            <entry>Enable</entry>
+          </row>
+
+          <row>
+            <entry>Chipset Configuration / North Bridge / Memory
+            Configuration</entry>
+
+            <entry align="left">Memory Frequency</entry>
+
+            <entry>2400</entry>
+
+            <entry>Auto</entry>
+          </row>
+
+          <row>
+            <entry>Chipset Configuration / North Bridge / Memory
+            Configuration</entry>
+
+            <entry align="left">DRAM RAPL Baseline</entry>
+
+            <entry>Disable</entry>
 
-    <para></para>
+            <entry>DRAM RAPL Mode 1</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
   </section>
 
   <section id="use-cases">
@@ -25,14 +238,14 @@
       <title>Docker related benchmarks</title>
 
       <section>
-        <title>Use Case - Forward traffic in docker</title>
+        <title>Forward traffic in Docker</title>
 
         <para>Benchmarking traffic forwarding using testpmd in a Docker
         container.</para>
 
         <para>Pktgen is used to generate UDP traffic that will reach testpmd,
-        running in a docker image. It will then be forwarded back to source on
-        the return trip (Forwarding). </para>
+        running in a Docker image. It will then be forwarded back to source on
+        the return trip (Forwarding).</para>
 
         <para>This test measures:</para>
 
@@ -92,7 +305,7 @@ processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
 intel_iommu=on  hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
 hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>
 
-          <para>It is expected to have docker/guest image on target. Configure
+          <para>It is expected to have Docker/guest image on target. Configure
           the OVS bridge:<programlisting># OVS old config clean-up
 killall ovsdb-server ovs-vswitchd
 rm -rf /etc/openvswitch/*
@@ -286,8 +499,8 @@ start</programlisting><table>
       </section>
 
       <section id="usecase-three-four">
-        <title>Use Case - Forward traffic from Docker to another Docker on the
-        same host</title>
+        <title>Forward traffic from Docker to another Docker on the same
+        host</title>
 
         <para>Benchmark a combo test using testpmd running in two Docker
         instances, one which Forwards traffic to the second one, which
@@ -396,13 +609,13 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
 --rxq=1 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>Configure
           it in termination mode:<programlisting>set fwd rxonly</programlisting>Run
           the testpmd application:<programlisting>start</programlisting>Open a
-          new console to the host and start the second docker
+          new console to the host and start the second Docker
           instance:<programlisting>docker run -it --rm --cpuset-cpus=0,1 -v /var/run/openvswitch/:/var/run/openvswitch/ /
 -v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>In the second
           container start testpmd:<programlisting>testpmd -c 0x0F --file-prefix prog2 --socket-mem 512 --no-pci /
 --vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
 -d /usr/lib/librte_pmd_virtio.so.1.1 -- -i --disable-hw-vlan</programlisting>Run
-          the TestPmd application in the second docker:<programlisting>testpmd -c 0x3 -n 2 --file-prefix prog2  --socket-mem 512 --no-pci /
+          the TestPmd application in the second Docker:<programlisting>testpmd -c 0x3 -n 2 --file-prefix prog2  --socket-mem 512 --no-pci /
 --vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
 -d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan /
 --disable-rss  -i --portmask=0x1 --coremask=0x2  --nb-cores=1 --rxq=1 /
@@ -414,7 +627,7 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
           should be used in testpmd applications.</para>
 
           <table>
-            <title>Results </title>
+            <title>Results</title>
 
             <tgroup cols="5">
               <tbody>
@@ -495,15 +708,15 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
       <title>VM related benchmarks</title>
 
       <section id="usecase-four">
-        <title>Use Case - Forward/termination traffic in one VM</title>
+        <title>Forward/termination traffic in one VM</title>
 
         <para>Benchmarking traffic (UDP) forwarding and termination using
-        testpmd in a virtual machine. </para>
+        testpmd in a virtual machine.</para>
 
         <para>The Pktgen application is used to generate traffic that will
         reach testpmd running on a virtual machine, and be forwarded back to
         source on the return trip. With the same setup a second measurement
-        will be done with traffic termination in the virtual machine. </para>
+        will be done with traffic termination in the virtual machine.</para>
 
         <para>This test case measures:</para>
 
@@ -778,7 +991,7 @@ show port stats 0</programlisting><table>
       </section>
 
       <section id="usecase-six">
-        <title>Use Case - Forward traffic between two VMs</title>
+        <title>Forward traffic between two VMs</title>
 
         <para>Benchmark a combo test using two virtual machines, the first
         with traffic forwarding to the second, which terminates it.</para>