summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSona Sarmadi <sona.sarmadi@enea.com>2018-04-04 07:46:13 +0200
committerSona Sarmadi <sona.sarmadi@enea.com>2018-04-16 08:58:57 +0200
commit55d49ab0f01f22a55f2a140b2c0087a2ef97e2ba (patch)
treec21cb5c60d890c3a65d54a16c6860e2e0764723f
parent8078887d7239b638b6dcb1bdb798643a09d56b2d (diff)
downloadnfv-access-documentation-55d49ab0f01f22a55f2a140b2c0087a2ef97e2ba.tar.gz
dpdk: Remove obsolet options, update DPDK version
'txqflags=0xf00' & 'disable-hw-vlan' options have been removed in DPDK 18.02 Reference: LXCR-8388 DPDK has been updated to 18.02, updated references. Reference: LXCR-8409 Since we build DPDK with static library, -d option should be removed: testpmd -c 0x3 -n 2 -d librte_pmd_virtio.so.1.1 <<<< remove -d Reference: LXCR-88220 Signed-off-by: Sona Sarmadi <sona.sarmadi@enea.com>
-rw-r--r--doc/book-enea-nfv-access-guide-intel/doc/benchmarks.xml40
-rw-r--r--doc/book-enea-nfv-access-guide-intel/doc/dpdk.xml20
2 files changed, 30 insertions, 30 deletions
diff --git a/doc/book-enea-nfv-access-guide-intel/doc/benchmarks.xml b/doc/book-enea-nfv-access-guide-intel/doc/benchmarks.xml
index 3279601..38dc327 100644
--- a/doc/book-enea-nfv-access-guide-intel/doc/benchmarks.xml
+++ b/doc/book-enea-nfv-access-guide-intel/doc/benchmarks.xml
@@ -346,9 +346,9 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
346-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd 346-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd
347 application in Docker:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci / 347 application in Docker:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci /
348--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 / 348--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 /
349-d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan / 349/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
350--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 / 350--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 /
351--rxq=1 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>To 351--rxq=1 --txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>To
352 start traffic <emphasis role="bold">forwarding</emphasis>, run the 352 start traffic <emphasis role="bold">forwarding</emphasis>, run the
353 following command in testpmd CLI:<programlisting>start</programlisting>To 353 following command in testpmd CLI:<programlisting>start</programlisting>To
354 start traffic but in <emphasis role="bold">termination</emphasis> 354 start traffic but in <emphasis role="bold">termination</emphasis>
@@ -604,9 +604,9 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
604-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd 604-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd
605 application in Docker1:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci / 605 application in Docker1:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci /
606--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 / 606--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 /
607-d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan / 607/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
608--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 / 608--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 /
609--rxq=1 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>Configure 609--rxq=1 --txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>Configure
610 it in termination mode:<programlisting>set fwd rxonly</programlisting>Run 610 it in termination mode:<programlisting>set fwd rxonly</programlisting>Run
611 the testpmd application:<programlisting>start</programlisting>Open a 611 the testpmd application:<programlisting>start</programlisting>Open a
612 new console to the host and start the second Docker 612 new console to the host and start the second Docker
@@ -614,13 +614,13 @@ ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
614-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>In the second 614-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>In the second
615 container start testpmd:<programlisting>testpmd -c 0x0F --file-prefix prog2 --socket-mem 512 --no-pci / 615 container start testpmd:<programlisting>testpmd -c 0x0F --file-prefix prog2 --socket-mem 512 --no-pci /
616--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 / 616--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
617-d /usr/lib/librte_pmd_virtio.so.1.1 -- -i --disable-hw-vlan</programlisting>Run 617/usr/lib/librte_pmd_virtio.so.1.1 -- -i</programlisting>Run the TestPmd
618 the TestPmd application in the second Docker:<programlisting>testpmd -c 0x3 -n 2 --file-prefix prog2 --socket-mem 512 --no-pci / 618 application in the second Docker:<programlisting>testpmd -c 0x3 -n 2 --file-prefix prog2 --socket-mem 512 --no-pci /
619--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 / 619--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
620-d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan / 620/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
621--disable-rss -i --portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 / 621--disable-rss -i --portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 /
622--txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>In 622--txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>In the
623 the testpmd shell, run:<programlisting>start</programlisting>Start 623 testpmd shell, run:<programlisting>start</programlisting>Start
624 pktgen traffic by running the following command in pktgen 624 pktgen traffic by running the following command in pktgen
625 CLI:<programlisting>start 0</programlisting>To record traffic 625 CLI:<programlisting>start 0</programlisting>To record traffic
626 results:<programlisting>show port stats 0</programlisting>This 626 results:<programlisting>show port stats 0</programlisting>This
@@ -945,10 +945,10 @@ processor.max_cstate=0 mce=ignore_ce audit=0'</programlisting>Inside QEMU,
945mount -t hugetlbfs nodev /mnt/huge 945mount -t hugetlbfs nodev /mnt/huge
946modprobe igb_uio 946modprobe igb_uio
947dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Inside QEMU, run 947dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Inside QEMU, run
948 testpmd: <programlisting>testpmd -c 0x3 -n 2 -d librte_pmd_virtio.so.1.1 / 948 testpmd: <programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
949-- --burst 64 --disable-hw-vlan --disable-rss -i --portmask=0x1 / 949-- --burst 64 --disable-rss -i --portmask=0x1 /
950--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 --rxd=512 / 950--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 --rxd=512 /
951--txqflags=0xf00 --port-topology=chained</programlisting>For the <emphasis 951--port-topology=chained</programlisting>For the <emphasis
952 role="bold">Forwarding test</emphasis>, start testpmd 952 role="bold">Forwarding test</emphasis>, start testpmd
953 directly:<programlisting>start</programlisting>For the <emphasis 953 directly:<programlisting>start</programlisting>For the <emphasis
954 role="bold">Termination test</emphasis>, set testpmd to only 954 role="bold">Termination test</emphasis>, set testpmd to only
@@ -1243,20 +1243,20 @@ processor.max_cstate=0 mce=ignore_ce audit=0'</programlisting>Configure DPDK
1243mount -t hugetlbfs nodev /mnt/huge 1243mount -t hugetlbfs nodev /mnt/huge
1244modprobe igb_uio 1244modprobe igb_uio
1245dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside 1245dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside
1246 VM1:<programlisting>testpmd -c 0x3 -n 2 -d librte_pmd_virtio.so.1.1 / 1246 VM1:<programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
1247-- --burst 64 --disable-hw-vlan --disable-rss -i / 1247-- --burst 64 --disable-rss -i /
1248--portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 / 1248--portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 /
1249--txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>Start 1249--txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>Start
1250 testpmd inside VM1:<programlisting>start</programlisting>Configure 1250 testpmd inside VM1:<programlisting>start</programlisting>Configure
1251 DPDK inside VM2:<programlisting>mkdir -p /mnt/huge 1251 DPDK inside VM2:<programlisting>mkdir -p /mnt/huge
1252mount -t hugetlbfs nodev /mnt/huge 1252mount -t hugetlbfs nodev /mnt/huge
1253modprobe igb_uio 1253modprobe igb_uio
1254dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside 1254dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside
1255 VM2:<programlisting>testpmd -c 0x3 -n 2 -d librte_pmd_virtio.so.1.1 / 1255 VM2:<programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
1256-- --burst 64 --disable-hw-vlan --disable-rss -i --portmask=0x1 / 1256-- --burst 64 --disable-rss -i --portmask=0x1 /
1257--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 / 1257--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 /
1258--rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>Set VM2 for 1258--rxd=512 --port-topology=chained</programlisting>Set VM2 for termination and
1259 termination and start testpmd:<programlisting>set fwd rxonly 1259 start testpmd:<programlisting>set fwd rxonly
1260start</programlisting>On target 1, start pktgen traffic:<programlisting>start 0</programlisting>Use 1260start</programlisting>On target 1, start pktgen traffic:<programlisting>start 0</programlisting>Use
1261 this command to refresh testpmd display in VM1 and VM2 and note the 1261 this command to refresh testpmd display in VM1 and VM2 and note the
1262 highest values:<programlisting>show port stats 0</programlisting>To 1262 highest values:<programlisting>show port stats 0</programlisting>To
@@ -1634,4 +1634,4 @@ start</programlisting><table>
1634 </section> 1634 </section>
1635 </section> 1635 </section>
1636 </section> 1636 </section>
1637</chapter> \ No newline at end of file 1637</chapter>
diff --git a/doc/book-enea-nfv-access-guide-intel/doc/dpdk.xml b/doc/book-enea-nfv-access-guide-intel/doc/dpdk.xml
index aa85317..fce0da4 100644
--- a/doc/book-enea-nfv-access-guide-intel/doc/dpdk.xml
+++ b/doc/book-enea-nfv-access-guide-intel/doc/dpdk.xml
@@ -20,15 +20,15 @@
20 <programlisting>default_hugepagesz=1GB hugepagesz=1GB hugepages=8 hugepagesz=2M hugepages=2048</programlisting> 20 <programlisting>default_hugepagesz=1GB hugepagesz=1GB hugepages=8 hugepagesz=2M hugepages=2048</programlisting>
21 21
22 <para>For DPDK documentation, see <ulink 22 <para>For DPDK documentation, see <ulink
23 url="http://dpdk.org/doc/guides-17.08/index.html">http://dpdk.org/doc/guides-17.08/index.html</ulink></para> 23 url="http://dpdk.org/doc/guides-18.02/index.html">http://dpdk.org/doc/guides-18.02/index.html</ulink></para>
24 24
25 <section id="pktgen"> 25 <section id="pktgen">
26 <title>Pktgen</title> 26 <title>Pktgen</title>
27 27
28 <para>In addition to DPDK, Enea NFV Access includes Pktgen, a 28 <para>In addition to DPDK, Enea NFV Access includes Pktgen, a software
29 software traffic generator that is powered by the DPDK packet processing 29 traffic generator that is powered by the DPDK packet processing framework.
30 framework. Pktgen can act as a transmitter or receiver and is capable of 30 Pktgen can act as a transmitter or receiver and is capable of generating
31 generating 10Gbit wire rate traffic with 64 byte frames.</para> 31 10Gbit wire rate traffic with 64 byte frames.</para>
32 32
33 <para>Pktgen is installed in <literal>/usr/share/apps/pktgen/</literal> 33 <para>Pktgen is installed in <literal>/usr/share/apps/pktgen/</literal>
34 and needs to be executed from this directory.</para> 34 and needs to be executed from this directory.</para>
@@ -64,7 +64,7 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting>
64 <para><programlisting>dpdk-devbind --bind=igb_uio &lt;PCI device number&gt;</programlisting>The 64 <para><programlisting>dpdk-devbind --bind=igb_uio &lt;PCI device number&gt;</programlisting>The
65 DPDK provides the dpdk-devbind tool to help binding/unbinding devices 65 DPDK provides the dpdk-devbind tool to help binding/unbinding devices
66 from specific drivers. See <ulink 66 from specific drivers. See <ulink
67 url="http://dpdk.org/doc/guides-17.08/tools/devbind.html">http://dpdk.org/doc/guides-17.08/tools/devbind.html</ulink> 67 url="http://dpdk.org/doc/guides-18.02/tools/devbind.html">http://dpdk.org/doc/guides-18.02/tools/devbind.html</ulink>
68 for more information.</para> 68 for more information.</para>
69 </listitem> 69 </listitem>
70 </orderedlist> 70 </orderedlist>
@@ -87,8 +87,8 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting>
87 87
88 <orderedlist> 88 <orderedlist>
89 <listitem> 89 <listitem>
90 <para>Setup DPDK on both boards, following the instructions in 90 <para>Setup DPDK on both boards, following the instructions in <xref
91 <xref linkend="dpdk-setup"/>.</para> 91 linkend="dpdk-setup" />.</para>
92 </listitem> 92 </listitem>
93 93
94 <listitem> 94 <listitem>
@@ -112,8 +112,8 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting>
112 112
113 <para>For more information, refer to the testpmd application user 113 <para>For more information, refer to the testpmd application user
114 guide: <ulink 114 guide: <ulink
115 url="http://dpdk.org/doc/guides-17.08/testpmd_app_ug/index.html">http://dpdk.org/doc/guides-17.08/testpmd_app_ug/index.html</ulink>.</para> 115 url="http://dpdk.org/doc/guides-18.02/testpmd_app_ug/index.html">http://dpdk.org/doc/guides-18.02/testpmd_app_ug/index.html</ulink>.</para>
116 </listitem> 116 </listitem>
117 </orderedlist> 117 </orderedlist>
118 </section> 118 </section>
119</chapter> \ No newline at end of file 119</chapter>