diff options
| -rw-r--r-- | doc/book-enea-nfv-access-guide/doc/dpdk.xml | 31 |
1 files changed, 16 insertions, 15 deletions
diff --git a/doc/book-enea-nfv-access-guide/doc/dpdk.xml b/doc/book-enea-nfv-access-guide/doc/dpdk.xml index aa85317..736c8f1 100644 --- a/doc/book-enea-nfv-access-guide/doc/dpdk.xml +++ b/doc/book-enea-nfv-access-guide/doc/dpdk.xml | |||
| @@ -17,7 +17,7 @@ | |||
| 17 | should preferably be done at boot time by passing parameters on the kernel | 17 | should preferably be done at boot time by passing parameters on the kernel |
| 18 | command line. Add the following to the kernel boot parameters:</para> | 18 | command line. Add the following to the kernel boot parameters:</para> |
| 19 | 19 | ||
| 20 | <programlisting>default_hugepagesz=1GB hugepagesz=1GB hugepages=8 hugepagesz=2M hugepages=2048</programlisting> | 20 | <programlisting>default_hugepagesz=512MB hugepagesz=512MB hugepages=20</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-17.08/index.html">http://dpdk.org/doc/guides-17.08/index.html</ulink></para> |
| @@ -25,10 +25,10 @@ | |||
| 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> |
| @@ -53,16 +53,16 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting> | |||
| 53 | </listitem> | 53 | </listitem> |
| 54 | 54 | ||
| 55 | <listitem> | 55 | <listitem> |
| 56 | <para>Load the DPDK igb_uio kernel module:</para> | 56 | <para>Load the DPDK vfio-pci kernel module:</para> |
| 57 | 57 | ||
| 58 | <programlisting>modprobe igb_uio</programlisting> | 58 | <programlisting>modprobe vfio-pci</programlisting> |
| 59 | </listitem> | 59 | </listitem> |
| 60 | 60 | ||
| 61 | <listitem> | 61 | <listitem> |
| 62 | <para>Bind the device to the igb_uio driver:</para> | 62 | <para>Bind the device to the vfio-pci driver:</para> |
| 63 | 63 | ||
| 64 | <para><programlisting>dpdk-devbind --bind=igb_uio <PCI device number></programlisting>The | 64 | <para><programlisting>dpdk-devbind --bind=vfio-pci <PCI device number></programlisting>The |
| 65 | DPDK provides the dpdk-devbind tool to help binding/unbinding devices | 65 | DPDK provides the dpdk-devbind tool to help bind or unbind 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-17.08/tools/devbind.html">http://dpdk.org/doc/guides-17.08/tools/devbind.html</ulink> |
| 68 | for more information.</para> | 68 | for more information.</para> |
| @@ -87,15 +87,15 @@ 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> |
| 95 | <para>On board 1, start the Pktgen application:</para> | 95 | <para>On board 1, start the Pktgen application:</para> |
| 96 | 96 | ||
| 97 | <programlisting>cd /usr/share/apps/pktgen/ | 97 | <programlisting>cd /usr/share/apps/pktgen/ |
| 98 | ./pktgen -c 0x7 -n 4 --socket-mem 1024 -- -P -m "[1:2].0"</programlisting> | 98 | ./pktgen -v -c 0x7 -n 4 --proc-type auto -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 -w <PCI device number> -- -P -m "[1:2].0"</programlisting> |
| 99 | 99 | ||
| 100 | <para>In the Pktgen console, run:</para> | 100 | <para>In the Pktgen console, run:</para> |
| 101 | 101 | ||
| @@ -108,7 +108,8 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting> | |||
| 108 | <listitem> | 108 | <listitem> |
| 109 | <para>On board 2, start the testpmd application:</para> | 109 | <para>On board 2, start the testpmd application:</para> |
| 110 | 110 | ||
| 111 | <programlisting>testpmd -c 0x7 -n 4 -- --txd=512 --rxd=512 --port-topology=chained</programlisting> | 111 | <programlisting>testpmd -v -c 0x3 -n 4 -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 -w <PCI device number> -- -i --disable-hw-vlan-filter --no-flush-rx --port-topology=chained |
| 112 | </programlisting> | ||
| 112 | 113 | ||
| 113 | <para>For more information, refer to the testpmd application user | 114 | <para>For more information, refer to the testpmd application user |
| 114 | guide: <ulink | 115 | guide: <ulink |
| @@ -116,4 +117,4 @@ mount -t hugetlbfs nodev /mnt/huge</programlisting> | |||
| 116 | </listitem> | 117 | </listitem> |
| 117 | </orderedlist> | 118 | </orderedlist> |
| 118 | </section> | 119 | </section> |
| 119 | </chapter> \ No newline at end of file | 120 | </chapter> |
