From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 476C747CD for ; Wed, 26 Apr 2017 16:49:27 +0200 (CEST) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 26 Apr 2017 07:49:26 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.37,254,1488873600"; d="scan'208";a="94081852" Received: from irsmsx104.ger.corp.intel.com ([163.33.3.159]) by fmsmga005.fm.intel.com with ESMTP; 26 Apr 2017 07:49:25 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.241]) by IRSMSX104.ger.corp.intel.com ([163.33.3.159]) with mapi id 14.03.0319.002; Wed, 26 Apr 2017 15:49:24 +0100 From: "Mcnamara, John" To: John Daley CC: "dev@dpdk.org" , "Yigit, Ferruh" Thread-Topic: [PATCH] doc: enic SR-IOV configurations Thread-Index: AQHSvlHtUOBp5NfXX0OVpS8GqMTdl6HXtasA Date: Wed, 26 Apr 2017 14:49:23 +0000 Message-ID: References: <20170426055619.16452-1-johndale@cisco.com> In-Reply-To: <20170426055619.16452-1-johndale@cisco.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_IC x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiN2IwZTVkMjktNzcxNi00MTEwLTk1NWEtNGFiNmQzMmY3Njk5IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE1LjkuNi42IiwiVHJ1c3RlZExhYmVsSGFzaCI6IlBLUjA5bEZcL1NPMFNjWUFMcXh6MUMrVWRvZnhqcmZISGp2UEpheVFUcVZjPSJ9 dlp-product: dlpe-windows dlp-version: 10.0.102.7 dlp-reaction: no-action x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH] doc: enic SR-IOV configurations X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 26 Apr 2017 14:49:27 -0000 > -----Original Message----- > From: John Daley [mailto:johndale@cisco.com] > Sent: Wednesday, April 26, 2017 6:56 AM > To: Mcnamara, John > Cc: dev@dpdk.org; John Daley > Subject: [PATCH] doc: enic SR-IOV configurations >=20 > Document SR-IOV passthrough setup and limitations for enic PMD. >=20 Hi John, Thanks for the doc updates. Some comments below. > Without advanced filter support, the flow director is limited to IPv4 > perfect filtering of the 5-tuple with no masking of fields supported. >=20 > +SR-IOV mode utilization > +----------------------- > + > +UCS blade servers configured with dynamic vNIC connection policies in > +UCS manager are capable of supporting assigned devices on virtual > +machines (VMs) through a KVM hypervisor. Assigned devices, also known as > 'passthrough' > +devices, are SR-IOV virtual functions (VFs) on the host which are > +exposed to VM instances. > + > +The Cisco Virtual Machine Fabric Extender (VM-FEX) gives the VM a > +dedicated interface on the Fabric Interconnect (FI). Layer 2 switching > +is done at the FI. This may eliminate the requirement for software > +switching on the host to route intra-host VM traffic. > + > +Please refer to `Creating a Dynamic vNIC Connection Policy > + +mware/gui/config_guide/b_GUI_VMware_VM-FEX_UCSM_Configuration_Guide/b_G > +UI_VMware_VM-FEX_UCSM_Configuration_Guide_chapter_010.html#task_433E016 > +51F69464783A68E66DA8A47A5>`_ for information on configuring SR-IOV > +Adapter policies using UCS manager. > + > +Once the policies are in place and the host OS is reboot, VFs should be s/reboot/rebooted/ > +visible on the host, E.g.: > + > +.. code-block:: c This should be "code-block:: console" or just plain "::" since it defaults to console. > + > +.. code-block:: c > + > + > + > + > +
function=3D'0x1'/> > + > + This should be "code-block:: xml". Using "c" causes the parse warning that Ferruh pointed out. =20 > +This configuration method is explained in more detail `here > +`_. > +Alternatively, the configuration can be done in a separate file using > +the ``network`` keyword. This method is described here: > +`https://libvirt.org/formatnetwork.html > +`_ If the url target and text are the same then you don't have to repeat it: ``_ > + > +When the VM instance is started, the enic KVM driver will bind the host s/enic/ENIC/ ? Here and elsewhere. > +Follow the normal DPDK install proceedure, binding the VF to either > +``igb_uio`` or ``vfio`` in non-IOMMU mode. s/procedure/procedure/ >=20 > +- **SR-IOV** > + > + - KVM hypervisor support only. VMware has not been tested. > + - Requires VM-FEX, and so is only available on UCS managed servers > connected > + to Fabric Interrconnects. It is not on standalone C-Series servers. s/Interrconnects/Interconnects/ > + - VF devices are not usable directly from the host. They can only be > used > + as assigned devices on VM instances. > + - Currently, unbind of the enic kernel mode driver 'enic' on the VM > instance > + may hang. As a workaround, enic.ko should blacklisted or removed fro= m > the > + boot process. > + - pci_generic cannot be used as the uio module in the VM. igb_uio or > + vfio in non-IOMMU mode can be used. > + - The number of RQs in UCSM dynamic vNIC configurations must be at > least 2. > + - The number of SR-IOV devices is limited to 256. Components on target > system > + might limit this number to fewer than 256. > + > + > How to build the suite? > ----------------------- > The build instructions for the DPDK suite should be followed. By default There was a new chapter added recently in the NICs section that has generic build and testing instructions for PMDs. So you could change this section t= o something like the following: =20 How to build the suite ---------------------- Refer to the document :ref:`compiling and testing a PMD for a NIC ` for details. By default the ENIC PMD library will be built into the DPDK library. For configuring and using UIO and VFIO frameworks, please refer the documentation that comes with DPDK suite. Regards, John