QLogic 3400, 8400, and 45000 Series Ethernet Adapters
83840-546-02 B
Page 2
User’s Guide—OpenStack Deployment with SR-IOV Configuration
QLogic 3400, 8400, and 45000 Series Ethernet Adapters
This document is provided for informational purposes only and may contain errors. QLogic reserves the right, without
notice, to make changes to this document or in product design or specifications. QLogic disclaims any warranty of any
kind, expressed or implied, and does not guarantee that any results or performance described in the document will be
achieved by you. All statements regarding QLogic’s future direction and intent are subject to change or withdrawal
without notice and represent goals and objectives only.
Document Revision History
Rev 01, May 15, 2015
Rev 02, May 22, 2015
Rev 03, March 22, 2016
Rev A, April 19, 2016
Rev B, August 29, 2016
ChangesSections Affected
Added Liberty and Mitaka to the applicable Open-
“Intended Audience” on page vii
Stack platforms.
Added a footnote associating 3400/8400/45000
Series Adapters with the 57800 Series Adapters
and QL4521x adapters.
Added Liberty and Mitaka to the applicable Open-
“Audience” on page 1
Stack platforms.
Added a NOTE indicating that support for the
45000 Series is limited to the QL4521x adapters.
In the first bullet, added a NOTE indicating that
“Prerequisites” on page 3
support for the 45000 Series is limited to the
QL4521x adapters.
In the second bullet, added links to information
about OpenStackinstallation for Linux for Liberty
and Mitaka.
Added new steps 8, 9, and 10.“Enabling SR-IOV on the 3400/8400/45000 Series
Creating a VM with the SR-IOV Network . . . . . . . . . . . . . . . . . . . . . . . . . . .14
v83840-546-02 B
Page 6
User’s Guide—OpenStack Deployment with SR-IOV Configuration
QLogic 3400, 8400, and 45000 Series Ethernet Adapters
6Testing
7Known Issues
vi83840-546-02 B
Page 7
Preface
Intended Audience
This guide is intended for OpenStack® (Juno, Kilo, Liberty, and Mitaka) users who
want to configure single root input/output virtualization (SR-IOV) with the QLogic
3400/8400/45000 Series Adapters
What Is in This Guide
This preface specifies the intended audience, explains the typographic
conventions used in this guide, lists related documents, and provides technical
support and contact information.
The remainder of this guide is organized into the following chapters:
Chapter 1 Introduction describes the audience for this guide and outlines the
OpenStack architecture.
Chapter 2 Example Architecture describes the OpenStack 3 node
architecture.
®
1
.
Chapter 3 Prerequisites describes what you need to use OpenStack with
SR-IOV configuration using the QLogic 3400/8400/45000 Series Adapters.
Chapter 4 SR-IOV Configuration Using the 3400/8400/45000 Series
Adapters describes how to configure SR-IOV using the QLogic
3400/8400/45000 Series Adapters.
Chapter 5 Configuration Deployment with SR-IOV describes how to deploy
OpenStack with SR-IOV.
Chapter 6Te sti ng provides a sample testing procedure.
Chapter 7Known Issues describes a known issue with open virtual search
(OVS) and OpenStack.
Related Materials
For information about downloading documentation from the QLogic Web site, see
“Downloading Updates” on page x.
1
Includes 578xx-based Adapters and FastLinQ™ QL4521x 25-gigabit Ethernet (GbE) Adapters
vii83840-546-02 B
Page 8
Preface
Documentation Conventions
Documentation Conventions
This guide uses the following documentation conventions:
Tex t i n blue font indicates a hyperlink (jump) to a figure, table, or section in
this guide, and links to Web sites are shown in underlined blue
example:
Table 9-2 lists problems related to the user interface and remote agent.
See “Installation Checklist” on page 6.
. For
For more information, visit www.qlogic.com
.
Tex t i n bold font indicates user interface elements such as a menu items,
buttons, check boxes, or column headings. For example:
Click the Start button, point to Programs, point to Accessories, and
then click Command Prompt.
Under Notification Options, select the Warning Alarms check box.
Tex t i n Courier font indicates a file name, directory path, or command line
text. For example:
To return to the root directory from anywhere in the file structure:
Type
cd /root and press ENTER.
Enter the following command: sh ./install.bin
Key names and key strokes are indicated with UPPERCASE:
Press CTRL+P.
Press the UP ARROW key.
Tex t i n italics indicates terms, emphasis, variables, or document titles. For
example:
For a complete listing of license agreements, refer to the QLogic
Software End User License Agreement.
What are shortcut keys?
To enter the date type mm/dd/yyyy (where mm is the month, dd is the
day, and yyyy is the year).
Topic titles between quotation marks identify related topics within this
manual.
viii83840-546-02 B
Page 9
Preface
License Agreements
Command syntax conventions include the following:
Plain text indicates items that you must type as shown. For example:
qaucli -pr nic -ei
< > (angle brackets) indicate a variable whose value you must specify.
For example:
<serial_number>
[ ] (square brackets) indicate an optional parameter. For example:
[<file_name>] means specify a file name, or omit it to select
the default file name.
| (vertical bar) indicates mutually exclusive options; select one option
only. For example:
on|off
1|2|3|4
... (ellipsis) indicates that the preceding item may be repeated. For
example:
x... means one or more instances of x.
[x...] means zero or more instances of x.
( ) (parentheses) and { } (braces) are used to avoid logical ambiguity.
For example:
a|b c is ambiguous
{(a|b) c} means a or b, followed by c
{a|(b c)} means either a, or b c
License Agreements
Refer to the QLogic Software End User License Agreement for a complete listing
of all license agreements affecting the QLogic 3400/8400/45000 Series Adapters.
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic products. QLogic-direct customers may contact QLogic
Technical Support; others will be redirected to their authorized maintenance
provider. Visit the QLogic support Web site listed in Contact Information for the
latest firmware and software updates.
For details about available service plans, or for information about renewing and
extending your service, visit the Service Program Web page at
www.qlogic.com/Support/Pages/ServicePrograms.aspx
.
ix83840-546-02 B
Page 10
Preface
Technical Support
Downloading Updates
The QLogic Web site provides periodic updates to product firmware, software,
and documentation.
To download firmware, software, and documentation:
1.Go to the QLogic Downloads and Documentation page:
driverdownloads.qlogic.com
2.Type the QLogic model name in the search box.
3.In the search results list, locate and select the firmware, software, or
documentation for your product.
4.View the product details Web page to ensure that you have the correct
firmware, software, or documentation. For additional information, click
Read Me and Release Notes under Support Files.
5.Click Download Now.
6.Save the file to your computer.
.
Training
7.If you have downloaded firmware, software, drivers, or boot code, follow the
installation instructions in the Readme file.
Instead of typing a model name in the search box, you can perform a guided
search as follows:
1.Click the product type tab: Adapters, Switches, Routers, or ASICs.
2.Click the corresponding button to search by model or operating system.
3.Click an item in each selection column to define the search, and then click
Go.
4.Locate the firmware, software, or document you need, and then click the
item’s name or icon to download or open the item.
QLogic Global Training maintains a Web site at www.qlogictraining.com offering
online and instructor-led training for all QLogic products. In addition, sales and
technical professionals may obtain Associate and Specialist-level certifications to
qualify for additional benefits from QLogic.
x83840-546-02 B
Page 11
Preface
Technical Support
Contact Information
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays. For customers with
extended service, consult your plan for available hours. For Support phone
numbers, see the Contact Support link at support.qlogic.com
Support Headquarters
QLogic Web Site
Technical Support Web Site
.
QLogic Corporation
12701 Whitewater Drive
Minnetonka, MN 55343 USA
www.qlogic.com
support.qlogic.com
Technical Support E-mail
Technical Training E-mail
Knowledge Database
The QLogic knowledge database is an extensive collection of QLogic product
information that you can search for specific solutions. QLogic is constantly adding
to the collection of information in the database to provide answers to your most
urgent questions. Access the database from the QLogic Support Center:
support.qlogic.com.
support@qlogic.com
training@qlogic.com
xi83840-546-02 B
Page 12
1Introduction
NOTE
This chapter describes the audience for this guide and outlines the OpenStack
architecture.
Audience
This guide is intended for OpenStack (Juno, Kilo, Liberty, and Mitaka) users who
want to configure single root input/output virtualization (SR-IOV) with the QLogic
3400/8400/45000 Series Adapters.
At the time of publication, support for the 45000 Series Adapters is limited to
the FastLinQ
What is OpenStack?
The OpenStack project is an open source cloud computing platform that supports
all types of cloud environments and works as infrastructure as a service (IAAS).
™ QL4521x 25GbE Adapters.
The technology consists of a series of interrelated projects that control pools of
processing, storage, and networking resources throughout a data center, which
users manage through a web-based dashboard, command line tools, or
representational state transfer (REST) APIs.
OpenStack (starting with Juno) adds inbox support to request virtual machine
(VM) access to the virtual network through SR-IOV NIC. With the introduction of
SR-IOV-based NICs, each SR-IOV port is associated with virtual functions (VFs).
SR-IOV ports are provided by hardware-based virtual Ethernet bridging (HW
VEB).
183840-546-02 B
Page 13
2Example Architecture
This chapter describes the OpenStack 3 node architecture.
OpenStack Nodes
This guide is intended for use with OpenStack 3 node architecture, which consists
of the following nodes:
Controller
Compute
Network
These nodes are described in the following sections.
Controller Node
In the example architecture used in this guide, the Controller node runs the
Identity service (Keystone), Image Service (Glance), management portions of the
Compute service (Nova Management) and Networking service (Neutron
Server/modular layer 2 (ML2) plug-in), networking plug-in, and the dashboard
(Horizon). The architecture also includes supporting services such as a database
(mysql), message broker (Rabbitmq), and network time protocol (NTP).
Compute Node
The Compute node runs the hypervisor portion of Compute, which operates
tenant virtual machines.
In this architecture, the Compute node uses a kernel-based virtual machine (KVM)
as the hypervisor (KVM is the default hypervisor). The Compute node runs the
Networking node plug-in (ML2), layer 2 agent open virtual search (OVS), and NIC
switch agent (SR-IOV switch).
Network Node
The Network node runs the Networking plug-in (ML2), layer 3 agent, and DHCP
agent. This node also handles external (Internet) connectivity for tenant VMs or
the Compute node.
283840-546-02 B
Page 14
3Prerequisites
NOTE
This chapter describes what you need to use OpenStack with SR-IOV
configuration using the QLogic 3400/8400/45000 Series Adapters.
You need the following knowledge and equipment:
One or more QLogic 3400/8400/45000 Series Adapters
At the time of publication, support for the 45000 Series Adapters is
limited to the FastLinQ QL4521x 25GbE Adapters.
An understanding of OpenStack deployment and experience with
OpenStack 3 node configuration using flat mode networking with virtual LAN
(VLAN) with the ML2/OVS plug-in for public and private (that is, net1)
networks.
More information about OpenStack 3 node configuration on Red Hat
be found at the following locations:
The Compute node must have one or more QLogic 3400/8400/45000 Series
Adapters present in system with SR-IOV support enabled.
1
The OpenStack configuration described in this link uses VXLAN and Linux Bridge agent.
However, the QLogic SR-IOV configuration uses and has been tested only with OpenStack 3 node
configuration with VLAN and open vSwitch (OVS). Furthermore, be sure to configure the
OpenStack 3 node configuration with kernel-based virtual machine (KVM).
1
1
®
7 can
383840-546-02 B
Page 15
3–Prerequisites
For the VM instance, QLogic uses a Red Hat 7 KVM Guest image to test
SR-IOV configurations that support the 3400/8400/45000 Series Adapters’
inbox or out-of-box driver, as described here:
Since the Neutron server is running on the Controller node, the file configuration
for the Neutron server must be changed to enable SR-IOV, as described in the
following procedure.
To configure SR-IOV on the Controller node:
1.Modify the ML2 Neutron plug-in by editing the
/etc/neutron/plugins/ml2/ml2_conf.ini file on Controller node as
follows:
2.Add the supported PCI vendor VF devices defined by
vendor_id:product_id according to the PCI ID Repository by editing
the /etc/neutron/plugins/ml2/ml2_conf_sriov.ini file as
follows:
[ml2_sriov]
supported_pci_vendor_devs = 14e4:16xx (3400 and 8400 Series
Adapters)
supported_pci_vendor_devs = 1077:16xx (45000 Series Adapters)
3.Modify the ml2_conf_sriov.ini file to add the following statement:
[ml2_sriov]
Agent_required=True
783840-546-02 B
Page 19
4–SR-IOV Configuration Using the 3400/8400/45000 Series Adapters
Configuring SR-IOV on the Controller Node
4.On the controller node running nova-scheduler, modify the
/etc/nova/nova.conf file [DEFAULT] section to add the following:
PciPassthroughFilter to the scheduler_default_filters
parameter
A new line for the scheduler_available_filters parameter:
5.For Juno and Kilo only—To run the Neutron SR-IOV NIC agent service,
first navigate to the configuration file location by issuing the following
command:
# cd /usr/lib/systemd/system
983840-546-02 B
Page 21
4–SR-IOV Configuration Using the 3400/8400/45000 Series Adapters
Configuring SR-IOV on the Compute Node
6.For Juno and Kilo only—Edit the
neutron-sriov-nic-agent.service file and add the
ml2_conf_sriov.ini configuration file as follows:
2.Issue the following command to view the subnet network:
# neutron subnet-list
Following is a sample output.
The values in the name column are described in the following paragraphs.
subnet1A private subnet that uses DHCP
Private subnets are configured in the prerequisite
section.
subnet2An SRI-OV subnet
public-subnetA subnet for external connectivity
1283840-546-02 B
Page 24
5–Configuration Deployment with SR-IOV
Creating the SR-IOV Port
Creating the SR-IOV Port
To create the SR-IOV port:
1.Issue the following command to create an SR-IOV port:
# neutron port-create <sriov net id> --name <port_name>
--binding:vnic-type direct --device_owner network:dhcp
Following is a sample output.
2.To show the port information, issue the following command:
# neutron port-show <ID>
Following is a sample output.
Make sure the output shows the correct vif_type and vnic_type.
1383840-546-02 B
Page 25
5–Configuration Deployment with SR-IOV
Creating a VM with the SR-IOV Network
Creating a VM with the SR-IOV Network
This section describes how to create a VM with multiple networks: a private
network for a floating IP address and an SR-IOV network with direct VM access
using a VF.
To create a VM with the SR-IOV network:
1.Issue the following command to create a VM:
# nova boot --flavor m1.medium --image <image-id> --nic
net-id=<net id of private network net1> --nic
port-id=<port id of sriov network from port-create command in
“Configuring SR-IOV on the Compute Node” on page 9> <VM name>
In this command, a –nic net-id is given for the private network (net1)
and a –nic port-id is given for the SR-IOV network with a Red Hat 7
KVM guest image.
Following is a sample output.
2.Issue the following command to ensure that the VM is up and running:
# nova list
Following is a sample output.
1483840-546-02 B
Page 26
5–Configuration Deployment with SR-IOV
Creating a VM with the SR-IOV Network
3.Assign a floating IP address to the private network to access using ssh.
Following is a sample output.
1583840-546-02 B
Page 27
6Testing
This chapter provides a sample testing procedure.
To verify SR-IOV configuration with OpenStack:
1.Create two VMs with different ports using the procedures in “Creating the
SR-IOV Port” on page 13 and “Creating a VM with the SR-IOV Network” on
page 14.
This example creates VMs named VNM3 and VNM4.
2.Log in to the VMs using the floating IP address, which has been assigned to
the private network net1 port. For the 45000 Series Adapters, ensure that
the correct version of the qede/qed driver has been loaded (see “Enabling
SR-IOV on the 3400/8400/45000 Series Adapters (Compute Node)” on
page 6).
3.Ideally, the SR-IOV port should get DHCP IP address 11.0.0.x in the VM, but
in this case it is not getting the IP address automatically.
Assign an IP address to the SR-IOV port in the VMs using the ifconfig
command, as follows:
VNM3—SR-IOV port IP address 11.0.0.8
VNM4—SR-IOV port IP address 11.0.0.9
Following is a sample output for VNM3.
1683840-546-02 B
Page 28
6–Testing
Following is a sample output for VNM4.
1783840-546-02 B
Page 29
7Known Issues
This chapter describes a known issue with OVS and OpenStack.
Sometimes OVS version 2.1.2-2 generates a segfault with the OpenStack (Kilo)
release.
QLogic has installed latest version OVS-2.3.1 from the following location: