Emulex Driver for FreeBSD User Manual
Contents
1. Emulex assumes no responsibility for its use nor for any infringements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 Emulex Driver for FreeBSD User Manual P008018 01A Rev A Supported Driver Versions 3 gt EMULEX Supported Driver Versions The following table lists the Emulex supported Ethernet drivers that are applicable in this manual A checkmark v indicates the type of driver distribution that is supported Driver Distribution Driver Version Out of Box Operating System Version Ethernet Drivers 4 2 313 0 v FreeBSD 9 0 4 2 313 0 v FreeBSD 8 2 4 2 313 0 v FreeBSD 8 1 Emulex Driver for FreeBSD User Manual P008018 01A Rev A gt lt EMULEX Table of Contents 4 Table of Contents Supported Driver VEFSIONS ic sacccvcssaievedeavsacsvessdcaveasavdveDansiecseasesersecesvensananees 3 List of Tables coxissvccsuncwcdianiecduessavanessaverdansshacaiadanasmdveaeutinestadsveotanvigauntes 5 1e INCPOMUCEION xicanccensanctacsavndesdeuss vecks sl iieventekessacniaweovandenduisaudavesdeienedaennes 6 OVGIVICW sirens cisineniad censsiekdd serip ASES n EESE ETE EEE ETE EEEE E 6 Supported Versions and Adapters cessccccccsccccccccscccccsss2. the directory This generates an elxflash ko file Copy the elxflash ko file to lib modules Run the command Sy Ol gt p sysctl dev oce lt if id gt fw_upgrade elxflash Note if_id can be any of the interface values that correspond to the Emulex interfaces in the ifconfig output 7 Check if the sysctl command execution for the firmware update was successful If it was successful reboot the system Otherwise you should see one of the following errors codes e Invalid BE3 firmware image e Invalid Cookie Firmware image corrupted e cmd to write to flash rom failed Emulex Driver for FreeBSD User Manual P008018 01A Rev A is 3 Configuration 11 DG EMULEX Extracting an SFP Module s VPD Information Extracting an SFP Module s VPD Information To dump an SFP module s vital product data VPD 1 Trigger the dump by typing sysctl dev oce lt if id gt sfp vpd_dump 0 2 Choose one of the following dump options e For a hexadecimal dump type sysctl x dev oce lt if id gt sfp vpd_dump_ buffer e Fora binary dump type sysctl b dev oce lt if_ id gt sfp vpd_dump buffer gt lt filename gt where filename is the file into which the output should be redirected For example sysctl b dev oce lt if id gt sfp vpd dump buffer gt sfp bin Emulex Driver for FreeBSD User Manual P008018 01A Rev A
3. J gt lt EMULEX Emulex Driver for FreeBSD User Manual P008018 01A Rev A Emulex Connects Servers Storage and People gt G EMULEX EMULEX CONFIDENTIAL Copyright 2012 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product described in this manual at any time and without any notice
4. ame hw oce max_rsp_handled sysctl name dev oceX max_rsp_handled max_rsp_handled indicates the maximum number of received frames that are processed during a single receive frame interrupt TSO can be configured globally affects all controllers in the system or individually for Emulex adapters To enable TSO global sysctl net ine ly type t tcp tso 1 To disable TSO globally type sysctl net ine t tcp tso 0 To enable TSO only for NIC interfaces type ifconfig oceX CSO To disable TSO only for NIC interfaces type ifconfig oceX tso Configuring LSO To enable LSO type ifconfig oceX lso To disable LSO type ifconfig oceX lso Emulex Driver for FreeBSD User Manual P008018 01A Rev A 9 gt lt EMULEX 3 Configuration 10 Configuring Jumbo Frame Transmit Configuring Jumbo Frame Transmit To enable Jumbo frames transmission type ifconfig oceX mtu lt mtu gt where mtu should be less than or equal to 9000 Viewing Device Driver Statistics To view device driver statistics type sysctl a grep oce Updating the Firmware To update the firmware 1 Copy the code below to the makefile KMOD elxflash FIRMWS imagename ufi elxflash include lt bsd kmod mk gt 2 Replace imagename in the copied code with the actual firmware file name The format is lt filename gt ufi Copy this makefile and the firmware file to a temporary directory Run a make command in
5. cccccccccnccccccccccccccccccscccccccccsescsccscceccccsssssseees 10 Extracting an SFP Module s VPD Information sscccccsccccccsscccccccsscccecssscees 11 Emulex Driver for FreeBSD User Manual P008018 01A Rev A gt G EMULEX List of Tables 5 List of Tables Table 3 1 Kernel Module Parameters cccccce cece cc cceccceeccceuceceuceceucecevceceuceceucs 9 Emulex Driver for FreeBSD User Manual P008018 01A Rev A gt G EMULEX 1 Introduction Overview 1 Introduction Overview This document provides installing uninstalling updating and configuring procedures for an Emulex supported FreeBSD NIC driver release Supported Versions and Adapters This manual is applicable to several versions of FreeBSD NIC drivers operating systems firmware and adapters For a list of supported Emulex drivers for FreeBSD and their associated compatible operations systems see Supported Driver Versions on page 3 For supported firmware versions and their latest release see the Downloads page on the Emulex website for the specific adapter The FreeBSD operating system supports the Emulex OCe11102 universal converged network adapter UCNA The driver and UCNA support PCI e bus standard Statistics Ethernet statistics provided for the number of packets received and sent as well as errors encountered Jumbo Packets Packets greater than 1500 bytes Virtual Local Area Network VLAN Multicast Packets sent f
6. d the appropriate driver kit from the Emulex website 2 Log on as root and type pkg_add oce lt VERSION gt lt ARCH gt tbz For example pkg_add oce 4 1 86 0 amdo4 tbz 3 Type echo oce load YES gt gt boot loader conf 4 Reboot the system Uninstalling the FreeBSD Driver Kit To uninstall the FreeBSD driver kit 1 Log on as root 2 Type pkg_ delete oce lt VERSION gt lt ARCH gt For example pkg delete oce 4 1 86 0 amd64 3 Remove the oce_load YES entry from the boot loader conf file 4 Reboot the system Emulex Driver for FreeBSD User Manual P008018 01A Rev A 7 2 Installing and Uninstalling amp DG EMULEX Updating the FreeBSD Driver Kit Updating the FreeBSD Driver Kit To update the FreeBSD driver 1 Type pkg _ update oce lt VERSION gt lt ARCH gt tbz For example pkg_update oce 4 1 86 0 amd64 tbz 2 Reboot the system Loading and Unloading the Driver To load the kernel module type kldload oce ko To unload the kernel module type kldunload oce ko To verify that the driver loaded properly type kldstat grep oce Emulex Driver for FreeBSD User Manual P008018 01A Rev A gt G EMULEX 3 Configuration NIC Driver Configuration 3 Configuration NIC Driver Configuration Kernel Module Parameters Table 3 1 Kernel Module Parameters Parameter max_rsp_handled Configuring TSO Description Default 512 Allowed values 1 1024 kenv n
7. rom a source to a group of destinations RSS Load balancing on Rx traffic across multiple Rx queues TSO LSO TCP Segmentation Offload Large Segment Offload off loads Tx traffic to hardware to improve performance CSO Check sum computation offload to hardware Bonding Ethernet bonding across multiple ports for load balancing and fail over PXE Preboot eXecution Environment for network boot MSI x Message Signal Interrupts Promiscuous mode Configuring an Ethernet interface to accept traffic from any destination Debugging capability Known Issues Known issues are defined in the Emulex Drivers for FreeBSD Release Notes which are available on the driver s Downloads page on the Emulex website Emulex Driver for FreeBSD User Manual P008018 01A Rev A 6 7 2 Installing and Uninstalling 7 DG EMULEX General Installation Requirements 2 Installing and Uninstalling General Installation Requirements Prior to driver installation follow these requirements e Install a supported Emulex OneConnect UCNA adapter in the system Refer to the adapter s installation manual for specific hardware installation instructions e Install the FreeBSD NIC driver on a dual core or better server with AMD 64 architecture and MSI X support e Usea supported operating system See Supported Driver Versions on page 3 for a complete list Installing the FreeBSD Driver Kit To install the FreeBSD driver kit 1 Downloa
8. scccscscsccssessscsseesseees 6 KNOWN ISSUCS sssssesiecssssrsesessssnneesssnss senn a a a 6 2 Installing and Uninstalling ssessessessecsecsecsecsecsecsecsececcsecsecsecseceeceecseo 7 General Installation Requirements sseesssssescsseccsssecosssescosscesosessosssesosssesoeo 7 Installing the FreeBSD Driver Kitisis is ciesscccnscdevscasascdnkiveccacdewssescitdendceserideececsatcx 7 Uninstalling the FreeBSD Driver Kit ccccccccesscsccccscccccccsssccccsssscccesssscceees 7 Updating the FreeBSD Driver Kit sssesesssssssssseccsosseccsoescesosescosesesoessssssseeoe 8 Loading and Unloading the Driver ccccscccccescccccccccsccccsssssccesssscccecessscees 8 3 GONMBUNALION scias ciasiws ses veddeseavaiaavawiseccdviassndsvsvavasceceatecaviwaniaavoieveaseutanse 9 NIC Driver ComfiSuration iis iceed cdi d cick cacddcancdsetsdes ced i cndatienseetididiatacnes Mawdeavee eden 9 Kernel Module Parameters sesessssesssesseesesscsssecosesseecsesccosesscessescssseeooo 9 CONTISUMING WSO secece esses ecntsccasesceceveus secu sesteacasseivess secs vacin uses sesecaevassseseseseesees 9 Configuring ESO suc cccs ove sddnssdecsevocsesesececness ecnedoveesececedaeasevenvenessedecbevesssvecveeess 9 Configuring Jumbo Frame Transmit ssssesssssceccsesccossecosseeccosececoeeseossseeoo 10 Viewing Device Driver Statistics cccccccccccssssscccccccccceccccsssssseeesccesesseeesees 10 Updating the Firmware cc
Download Pdf Manuals
Related Search