Skip to content

Latest commit

 

History

History
95 lines (77 loc) · 2.89 KB

README.md

File metadata and controls

95 lines (77 loc) · 2.89 KB

ixgbevf-cookbook

This cookbook will use dkms to install an updated version of the ixgbevf kernel module. Most linux distributions are still distributing version 2.12 with their kernels. For AWS the minimum recommended version is 2.14.2. Having this version is necessary to ensure that "Enhanced Networking" can be activated on the instance types that support it (C3/4, D2, I2, M4, R3)

This driver may also be useful for other virtualized environments

For more info on the application to EC2 instance types, see: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enhanced-networking.html

Additionally this cookbook will be disable by default Predictable Network Interface Names.

Prior works this is based on: https://gist.github.com/CBarraford/8850424 https://gist.github.com/vdm/6af55e1a568de0b61882 https://github.com/jhohertz/buri/blob/develop/playbooks/roles/base_buri/tasks/update-ixgbevf.yml

Supported Platforms

Tested on:

  • Centos 6.7, 7.1
  • Ubuntu 14.04
  • Debian 8.1

Attributes

Key Type Description Default
['ixgbevf']['version'] String Version of exgbevf to install 2.16.1
['ixgbevf']['package'] String Package file name ixgbevf-2.16.1.tar.gz
['ixgbevf']['package_url'] String URL for package file download. (Yes, there is a space in the upstream URL) http://sourceforge.net/projects/e1000/files/ixgbevf stable/2.16.1/ixgbevf-2.16.1.tar.gz
['ixgbevf']['dir'] String Directory for the driver sources. (Changing this a bad idea, will confuse DKMS) /usr/src/ixgbevf-2.16.1
['ixgbevf']['module_flags'] String Parameters for the kernel module InterruptThrottleRate=1,1,1,1,1,1,1,1
['ixgbevf']['disable_ifnames'] String If true, will disable predictable network interface names on platforms it is enabled. true

Usage

This recipe is intented to be incorporated into a base cookbook or as a part of your build's run list.

It is recommended to invoke this cookbook PRIOR to running package updates, so that is is applied to a currently running kernel. Afterwards, run the upgrades, and DKMS should ensure the driver carries over to the new kernel.

ixgbevf::default

Include ixgbevf in your node's run_list:

{
  "run_list": [
    "recipe[ixgbevf::default]"
  ]
}

License and Authors

Author:: Joe Hohertz ([email protected])