diff mbox

[ovs-dev,v3] INSTALL.DPDK: Add notes regarding vhost multiq configuration.

Message ID 1456335057-873-1-git-send-email-ian.stokes@intel.com
State Accepted
Headers show

Commit Message

Stokes, Ian Feb. 24, 2016, 5:30 p.m. UTC
Linux kernel network devices in a guest should have the number of
multi-purpose channels configured when used with DPDK multiqueue on the host.
This commit adds an example of how this can be done. Also add QEMU 2.5
requirements for multiqueue with DPDK in NEWS.

Signed-off-by: Ian Stokes <ian.stokes@intel.com>
---
V3:

*INSTALL.DPDK.md
- Remove reference to packets becoming stuck in unused queues if the same
  number of queues are not configured in the guest operating system.
  This issue will be resolved in a separate patch found at
  http://openvswitch.org/pipermail/dev/2016-February/066696.html
---
 INSTALL.DPDK.md |   16 ++++++++++++++++
 NEWS            |    2 +-
 2 files changed, 17 insertions(+), 1 deletions(-)

Comments

Flavio Leitner Feb. 24, 2016, 5:44 p.m. UTC | #1
On Wed, 24 Feb 2016 17:30:57 +0000
Ian Stokes <ian.stokes@intel.com> wrote:

> Linux kernel network devices in a guest should have the number of
> multi-purpose channels configured when used with DPDK multiqueue on the host.
> This commit adds an example of how this can be done. Also add QEMU 2.5
> requirements for multiqueue with DPDK in NEWS.
> 
> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
> ---
> V3:
> 
> *INSTALL.DPDK.md
> - Remove reference to packets becoming stuck in unused queues if the same
>   number of queues are not configured in the guest operating system.
>   This issue will be resolved in a separate patch found at
>   http://openvswitch.org/pipermail/dev/2016-February/066696.html
> ---

Acked-by: Flavio Leitner <fbl@sysclose.org>

Thanks again Ilya!
Daniele Di Proietto Feb. 24, 2016, 9:55 p.m. UTC | #2
I applied this to master and branch-2.5, thanks

On 24/02/2016 09:30, "dev on behalf of Ian Stokes"
<dev-bounces@openvswitch.org on behalf of ian.stokes@intel.com> wrote:

>Linux kernel network devices in a guest should have the number of
>multi-purpose channels configured when used with DPDK multiqueue on the
>host.
>This commit adds an example of how this can be done. Also add QEMU 2.5
>requirements for multiqueue with DPDK in NEWS.
>
>Signed-off-by: Ian Stokes <ian.stokes@intel.com>
>---
>V3:
>
>*INSTALL.DPDK.md
>- Remove reference to packets becoming stuck in unused queues if the same
>  number of queues are not configured in the guest operating system.
>  This issue will be resolved in a separate patch found at
>  http://openvswitch.org/pipermail/dev/2016-February/066696.html
>---
> INSTALL.DPDK.md |   16 ++++++++++++++++
> NEWS            |    2 +-
> 2 files changed, 17 insertions(+), 1 deletions(-)
>
>diff --git a/INSTALL.DPDK.md b/INSTALL.DPDK.md
>index ca49106..dca79bd 100644
>--- a/INSTALL.DPDK.md
>+++ b/INSTALL.DPDK.md
>@@ -590,6 +590,22 @@ Follow the steps below to attach vhost-user port(s)
>to a VM.
>    -device 
>virtio-net-pci,mac=00:00:00:00:00:02,netdev=mynet2,mq=on,vectors=$v
>    ```
> 
>+   If one wishes to use multiple queues for an interface in the guest,
>the
>+   driver in the guest operating system must be configured to do so. It
>is
>+   recommended that the number of queues configured be equal to '$q'.
>+
>+   For example, this can be done for the Linux kernel virtio-net driver
>with:
>+
>+   ```
>+   ethtool -L <DEV> combined <$q>
>+   ```
>+
>+   A note on the command above:
>+
>+   `-L`: Changes the numbers of channels of the specified network device
>+
>+   `combined`: Changes the number of multi-purpose channels.
>+
> DPDK vhost-cuse:
> ----------------
> 
>diff --git a/NEWS b/NEWS
>index 57a250e..4b17ca7 100644
>--- a/NEWS
>+++ b/NEWS
>@@ -70,7 +70,7 @@ v2.5.0 - xx xxx xxxx
>    - DPDK:
>      * Requires DPDK 2.2
>      * Added multiqueue support to vhost-user
>-
>+     * Note: QEMU 2.5+ required for multiqueue support
> 
> v2.4.0 - 20 Aug 2015
> ---------------------
>-- 
>1.7.4.1
>
>_______________________________________________
>dev mailing list
>dev@openvswitch.org
>http://openvswitch.org/mailman/listinfo/dev
diff mbox

Patch

diff --git a/INSTALL.DPDK.md b/INSTALL.DPDK.md
index ca49106..dca79bd 100644
--- a/INSTALL.DPDK.md
+++ b/INSTALL.DPDK.md
@@ -590,6 +590,22 @@  Follow the steps below to attach vhost-user port(s) to a VM.
    -device virtio-net-pci,mac=00:00:00:00:00:02,netdev=mynet2,mq=on,vectors=$v
    ```
 
+   If one wishes to use multiple queues for an interface in the guest, the
+   driver in the guest operating system must be configured to do so. It is
+   recommended that the number of queues configured be equal to '$q'.
+
+   For example, this can be done for the Linux kernel virtio-net driver with:
+
+   ```
+   ethtool -L <DEV> combined <$q>
+   ```
+
+   A note on the command above:
+
+   `-L`: Changes the numbers of channels of the specified network device
+
+   `combined`: Changes the number of multi-purpose channels.
+
 DPDK vhost-cuse:
 ----------------
 
diff --git a/NEWS b/NEWS
index 57a250e..4b17ca7 100644
--- a/NEWS
+++ b/NEWS
@@ -70,7 +70,7 @@  v2.5.0 - xx xxx xxxx
    - DPDK:
      * Requires DPDK 2.2
      * Added multiqueue support to vhost-user
-
+     * Note: QEMU 2.5+ required for multiqueue support
 
 v2.4.0 - 20 Aug 2015
 ---------------------