The 6WIND Virtual Accelerator Plugin for Fuel Documentation

1 The 6 WIND Virtual Accelerator Pluginfor fuel DocumentationRelease SAJuly 13, 2016 CONTENTS1 terms, acronyms and abbreviations .. platforms .. information ..32 New features in Plugin version Limitations54 Installation .. 6 WIND Virtual Accelerator Plugin .. 6 WIND Virtual Accelerator Plugin ..75 User 6 WIND Virtual Accelerator parameters .. updated libvirt and qemu packages .. hugepages support for Virtual machines .. checks after deployment ..116 Known issues137 Appendix14iCHAPTERONEINTRODUCTIONThis document contains instructions for installing and configuring 6 WIND Virtual Accelerator Plugin for Key terms, acronyms and abbreviations6 WIND Virtual AcceleratorVA6 WIND Virtual AcceleratorMOSM irantis OverviewVirtual Accelerator is a product of the 6 WIND speed series that provides packet processing acceleration for virtualnetwork Accelerator runs inside the hypervisor and removes the performance bottlenecks by offloading Virtual switchingfrom the networking stack.

2 The cpu resources necessary for packet processing are drastically reduced, so that less coresare required to process network traffic at higher rates and Linux stability is addition to simple Virtual switching (using OVS or the Linux bridge), Virtual Accelerator supports an extensive setof networking protocols to provide a complete Virtual networking Accelerator is fully integrated with Linux and its environment, so that existing Linux applications do not needto be modified to benefit from packet processing Accelerator is available for Intel x86-based servers and supports major Linux Accelerator is provided in three flavors according to the required feature set: baseline: simple Virtual switching and ip forwarding L3: baseline + advanced L3 features such as vrf, filtering and nat ipsec: L3 + ipsec FeaturesHigh performance I/Os leveraging dpdk, with multi-vendor nic support from Intel, Mellanox and Emulex Intel 10G/40G XL710 Intel 10G 82598, 82599, X5401 The 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release Mellanox 10G/40G connectx -3 EN and connectx -3 Pro EN series Mellanox 10G/25G/50G/100G connectx - 4 en and connectx -4 Lx EN series Emulex 10G/40G OneConnect OCe14000 family Intel 1G 82575, 82576, 82580, I210, I211, I350, I354 High performance Virtual switching OVS acceleration Linux BridgeHigh performance Virtual networkingIn addition to Virtual switching, Virtual Accelerator supports a complete set of networking protocols, based on the6 WIND Gate technology, that can be used to design innovative Virtual networking infrastructures.

3 Virtual Accelerator baseline Forwarding (ipv4 and ipv6) vxlan vlan gre Linux bridge filtering Virtual Accelerator L3 vrf Filtering (ipv4 and ipv6) nat Tunneling (IPinIP) Virtual Accelerator ipsec Intel Multi-Buffer and QuickAssist crypto ipsec (ipv4 and ipv6) ike (v1 and v2)Support of standard Virtio driversVirtual Accelerator comes with a high performance Virtio back-end driver for communication with any guest runningVirtio front-end drivers (can be based on dpdk, Linux, or other OSes).Seamless integration with management and orchestration toolsVirtual Accelerator is fully integrated with Linux and its environment, so that existing Linux applications do not needto be modified to benefit from packet processing acceleration. Standard Linux APIs are preserved, including iproute2,iptables, brctl, ovs-ofctl, ovs-vsctl, Features2 The 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release Accelerator is also validated with the Mirantis Openstack cloud operating system: Supports Mirantis Openstack Supported platformsVirtual Accelerator is provided as a set of binary packages and is validated on the following distributions: redhat-7 centos-7 See also.

4 Refer to the Virtual Accelerator Release Notes for detailed information about the latest validated versions of the Licensing information6 WIND Virtual Supported platforms3 CHAPTERTWONEW FEATURES IN Plugin VERSION Added support for 6 WIND Virtual Accelerator Support for VxLAN tunneling Removed apparmor libvirt profile configuration for hugepages VLAN interface for Private network no more needs to use a dedicated NIC Removed a Plugin advanced parameter (CORE_PER_PORT) now deprecated Changed default value for FP_MEMORY advanced parameter. It is now set to auto . Documentation update to describe new features4 CHAPTERTHREELIMITATIONS Plugin only supports KVM as hypervisor Nodes using 6 WIND Virtual Accelerator role needs at least 2 CPU cores and 6 GB of RAM5 CHAPTERFOURINSTALLATION PrerequisitesThis guide assumes that you have installed fuel and all the nodes of your future environment are discovered andfunctional.

5 Note, the 6 WIND Virtual Accelerator fuel Plugin will download Virtual Accelerator packages from aremote repository. Make sure that nodes can correctly reach correctly deploy the 6 WIND Virtual Accelerator fuel Plugin you will need a credentials package (in base64 format).If you have already purchased 6 WIND software you should have this package, otherwise contact 6 WIND supportteam. On the other hand, if you just want to evaluate the 6 WIND Virtual Accelerator you still need to contact RequirementsThis Plugin is intended to be installed on nodes running fuel (version ) Verify this typing the followingcommand: fuel --versionIn order to correctly install the 6 WIND Virtual Accelerator Plugin on fuel compute(s) the following requirements aremandatory:1. Use KVM as hypervisor virtualization driver2.

6 Deploy on compute node(s) withat least 4GB of RAM and 2 CPU cores3. Internet connectivity on Master node (since the Plugin will download software from 6 WIND remote repositories)This version of Plugin supports VLAN and VxLAN as networking tunneling 6 WIND Virtual Accelerator needs qemu and libvirt supporting vhostuser and multiqueue features to correclty runits fast packet processing stack. In particular on the compute nodes the following packages are needed:1. libvirt-bin ( )2. qemu ( +dfsg-5ubuntu6)Note that Mirantis official repositories do not provide these packages. For this reason the default behavior for the pluginis to retrieve the 6 WIND libvirt and qemu packages and replace the Mirantis ones in the early stages of Installing 6 WIND Virtual Accelerator Plugin1. Download 6 WIND Virtual Accelerator Plugin from the fuel Plugins 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release Copy the downloaded rpm to the fuel Master node:scp < fuel Master node ip>:/tmp/3.

7 Log into the fuel Master node and install the pluginssh <the fuel Master node ip> fuel plugins --install / Now verify that the Plugin is correctly installedfuel plugins3 | 6WIND - Virtual - Accelerator | | Configuring 6 WIND Virtual Accelerator Plugin1. First you have to create environment in fuel Web Please select KVM hypervisor type for your Please select Neutron networking. The 6 WIND Virtual Accelerator supports VLAN and VxLAN Configuring 6 WIND Virtual Accelerator Plugin7 The 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release Activate the Plugin in the fuel Web UI Settings tab5. Configure fields with correct values: Provide base64 credentials package you received from 6 WIND support team Provide the license file to be used for 6 WIND Virtual Accelerator activation Refer to next chapter for the description of Advanced Paramaters Add nodes and assign them the following roles: At least 1 Controller At least one node with both Compute and 6 WIND Virtual Accelerator roles.

8 Make sure that the chosennode hasat least 2 CPU cores and 6 GB of Configuring 6 WIND Virtual Accelerator Plugin8 The 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release Verify nodes network connectivity (in the fuel Web UI Network tab)8. PressDeploy changesto deploy the Configuring 6 WIND Virtual Accelerator Plugin9 CHAPTERFIVEUSER GUIDEThis section provides a deeper explanation of Plugin parameters and a description of required steps to verify thateverything is working fine after that this User Guide provides information on 6 WIND Virtual Accelerator Plugin for fuel (and not on the 6 WINDV irtual Accelerator software itself). Contact 6 WIND to obtain more details on how to retrieve the Virtual Acceleratorsoftware and its configuring the 6 WIND Virtual Accelerator fuel Plugin , you have to provide credentials for Virtual Acceleratorsoftware download.

9 The Plugin will then install and run the Virtual Accelerator using its default configuration Configuring 6 WIND Virtual Accelerator parametersThe 6 WIND Virtual Accelerator Plugin makes possible to modify these default configuration parameters before de-ployment. In order to do this you need to activate theAdvanced parameterscheckbox in the 6 WIND Virtual Accel-erator fuel Plugin section in the Web UI Settings this point some additional fields will show up and you will be able to edit with your desired particular you can modify the following: FP_MEMORY10 The 6 WIND Virtual Accelerator Plugin for fuel Documentation , Release parameter defines the amount of memory (in MB) you want to reserve for Virtual Accelerator . Samplevalues are 1024, 512 or auto . VM_MEMORYThis parameter defines the total amount of memory (in MB) you want to reserve for accelerated Virtual values are 2048, 4096, auto.

10 For all these parameters you can always set value to auto (default value). In this case the Plugin will compute themost suitable value according to your system some cases you may already have a Virtual Accelerator configuration file. You can upload it to the nodes having the6 WIND Virtual Accelerator role enabled using the dedicatedExternal configuration file for VAfield. Note, this filewill replace the default Virtual Accelerator configuration file and overload all the defined configuration isstrongly recommendedto provide a license file if you have one. Without license the Plugin will still correcltyinstall the 6 WIND Virtual Accelerator but it will run in evaluation mode (48 hours). At the end of the evaluationperiod you will experience significant performance degradation and loss of connectivity for your instances since therewill be nomore any hugepages Use updated libvirt and qemu packagesAs briefly described in the installation section, in order to correctly spawn Virtual machines using the acceleratednetwork stack 6 WIND Virtual Accelerator provides, the compute nodes need to run recent versions of libvirt andqemu default the 6 WIND Virtual Accelerator fuel Plugin retrieves and installs its updated libvirt and qemu packagesfrom a remote repository maintained by 6 WIND.