Emulex Driver Version 10.2 for FreeBSD User Manual
Contents
1. 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 Version 10 2 for FreeBSD User Manual P010085 01A Rev A2. gt G EMULEX Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A Emulex Connects Servers Storage and People gt EMULEX EMULEX CONFIDENTIAL Copyright 2012 2014 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 wi
3. 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 FreeBSD operating systems and their associated Emulex firmware and drivers see the Emulex website for the specific adapter The FreeBSD operating system supports the Emulex OneConnect OCe11102 universal converged network adapter UCNA the LightPulse LPe16202 converged fabric adapter CFA and the OneConnect OCe14000 series adapters The driver and adapters support Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A PCle bus standard Generation 2 or later 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 from 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 offloads 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 dest
4. O only for NIC interfaces type ifconfig oce lt if id gt tso To disable TSO only for NIC interfaces type ifconfig oce lt if_id gt tso Note lt if_id gt is the interface identification number Configuring LSO To enable LSO type ifconfig oce lt if id gt lso To disable LSO type ifconfig oce lt if id gt lso Note lt if_id gt is the interface identification number Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A gt G EMULEX 3 Configuration Q Configuring Jumbo Frame Transmit Configuring J umbo Frame Transmit To enable Jumbo frames transmission type ifconfig oce lt if_id gt mtu lt mtu gt Note lt if_id gt is the interface identification number and lt mtu gt should be less than or equal to 9000 Configuring Adaptive Interrupt Coalescing AIC Note AIC configuration is only available on OneConnect OCe11102 UCNAs and OCe14000 series adapters To enable AIC type sysctl dev oce lt if_id gt aic_enable 1 To disable AIC type sysctl dev oce lt if_id gt aic_enable 0 Viewing Device Driver Statistics To view device driver statistics type sysctl a grep oce To view statistics for a single interface type sysctl dev oce lt if_id gt Note if_idcan be any of the interface values that correspond to the Emulex interfaces in the ifconfig output Updating the Firmware To update the firmware 1 Copy the code below to the makefile KMOD elxflash FIRMWS imag
5. e 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 Checking the FreeBSD Driver Version To check the currently installed FreeBSD driver version 1 Log on as root 2 Type pkg_info grep i oce driver For example pkg_info grep i oce driver Output oce 4 4 130 0 oce driver for freebsd 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 Version 10 2 for FreeBSD User Manual P010085 01A Rev A 3 Configuration DG EMULEX NIC Driver Configuration 3 Configuration NIC Driver Configuration Kernel Module Parameters Table 3 1 Kernel Module Parameters Parameter Description max_rsp_handled Default 512 Allowed values 1 1024 kenv name 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 Configuring TSO TSO can be configured globally affects all controllers in the system or individually for Emulex adapters To enable TSO globally type sysctl net inet tcp tso 1 To disable TSO globally type sysctl net inet tcp tso 0 To enable TS
6. ename 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 the directory This generates an elxflash ko file Copy the elxflash ko file to boot modules Run the command ONO oi sysctl dev oce lt if_id gt fw_upgrade elxflash Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A 3 Configuration 1Q gt lt EMULEX Extracting an SFP Module s VPD Information Note lt if_id gt can be any of the interface values that correspond to the Emulex interfaces in the ifconfig output If multiple Emulex NIC adapters exist in the same system the firmware download procedure must be repeated on one lt if_id gt for each adapter 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 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 Fora hexadecimal dump type sysctl x dev oce lt if id gt sfp vpd_dump_ buffer e Fora
7. ination Debugging capability 5 gt lt EMULEX 2 Installing and Uninstalling 6 General Installation Requirements 2 Installing and Uninstalling General Installation Requirements Prior to driver installation you must e Install a supported 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 Intel x86 or AMD64 architecture and MSI X support e Usea supported operating system See the Emulex website for a list of supported FreeBSD operating systems Installing the FreeBSD Driver Kit To install the FreeBSD driver kit 1 Download the appropriate driver kit from the Emulex website 2 Log onas root and type pkg_add oce lt VERSION gt lt ARCH gt tbz For example pkg_add oce 4 1 86 0 amd64 tbz 3 Type echo oce_ load YES gt gt boot loader conf 4 Extract the tbz driver package and copy the oce ko file to the boot kernel directory 5 Reboot the system Uninstalling the FreeBSD Driver Kit To uninstall the FreeBSD driver kit 1 Log on as root and type pkg_ delete oce lt VERSION gt lt ARCH gt For example pkg_delete oce 4 1 86 0 amd64 2 Remove the oce_load YES entry from the boot loader conf file 3 Reboot the system Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A o 2 Installing and Uninstalling 7 gt EMULEX Updating th
8. nnnnn 7 Loading and Unloading the Driver sssssssnnnsnnsnnsnunnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnn 7 3 Configuratii scsidiccersss ais eertpcOAieie MERRIE aaia ii aaia 8 NIC Driver CONTIQUIATION sicciiisssdtcisisccsdcsciensirncsersdseedatemnasnedsserdsandiantenanadaenas 8 Kernel Module Parameters iccriicersscssese nated rine rivelin sare iaeeeees tacos 8 Configuring TSO ssssssssssnsnnnnnnnnnnnnnnnnnnnnnnnnnnunnnnuuunnnnnnnnnnnnnnnnnnnnnnnnnnnn nnana 8 CONTIGUMING LSO sirarsirarsrririsrrariiinsist ninan kannski nnna Nasa anA Nan Anania 8 Configuring J umbo Frame Transmit s sssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnan 9 Configuring Adaptive Interrupt Coalescing AIC sssssssssssssnsssnnnnnnnnnnnnnnnnnnnnnnnnn 9 Viewing Device Driver StatisticS sssssssssnrnnssnsnnnnnnnnnnnnnunnunnnnnnnnnnnunnnnnnnnnnn 9 Updating the Firmware siiscsiiscsiiccsitcestcstsecsevensdvedscssdsderdscttesenissenessnessaraenensd 9 Extracting an SFP Module s VPD Information ccccccecscceescceeccceeesueeesueeesueeeagee 10 Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A gt G EMULEX List of Tables 4 List of Tables Table 3 1 Kernel Module Parameters ccce 8 Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A gt lt EMULEX Overview 1 Introduction 1 Introduction Overview This document provides installing uninstalling updating and configuring procedures for an Emulex
9. thout any notice 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 Note References to OCe11100 series products also apply to OCe11100R series products Emulex Driver Version 10 2 for FreeBSD User Manual P010085 01A Rev A DE EMULEX Table of Contents 3 Table of Contents List OF Tables siciitciudt tid aaa aa ia ia iaaiiai 4 1 introducti N isitcisttiuiedrinicdsrece aaaea aa a aiana 5 OVGIVIGW iissirsnini raiekin aiaia EEEREN 5 Supported Versions and AdapterS ssssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnuunnnnnnnnnnnnnn 5 2 Installing and Uninstalling s ssssssssunnnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnunnnnnnnnnnnnn 6 General Installation Requirements sssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnan 6 Installing the FreeBSD Driver Kit ssasssssnnnnnnsnnsnunnnnnnnnnnnunnunnnnnnnnnnnunnnnnnnnnnn 6 Uninstalling the FreeBSD Driver Kit ssssssssnsnnsnnsnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 6 Updating the FreeBSD Driver K t ssssssssnnnsnnsnnnnunnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnn 7 Checking the FreeBSD Driver VerSion s ssssssusnnnnnnnsnnnnunnnnnnnnnnnnnnunnunnnnnnnn
Download Pdf Manuals
Related Search