Emulex Driver for FreeBSD User Manual
Contents
1. gt G EMULEX Emulex Driver for FreeBSD User Manual P007635 01A Rev A Emulex Connects Servers Storage and People gt G EMULEX Copyright Trademarks and Disclaimer EMULEX CONFIDENTIAL Copyright 2012 Emulex All rights reserved worldwide Unpublished work No part of this document may be reproduced by any means or translated to any electronic medium without a the prior written consent of Emulex and b the preservation of this notice on all copies and partial copies Copying access use or distribution requires an applicable written agreement approved by 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 trade secret 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 documentation as is without any warranty of any kind eith2. 0 0x00010000 0x00020000 0x00000000 OxF FFFFFFF P007635 01A Rev A 9 3 Configuration 10 gt G EMULEX Updating the Firmware Updating the Firmware To update the firmware 1 D gi w Copy the code below to the makefile KMOD elxflash FIRMWS imagename ufi elxflash include lt bsd kmod mk gt 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 Execute a make command in the directory This generates an elxflash ko file Copy the elxflash ko file to lib modules Execute the command sysctl dev oce lt if_id gt fw_upgrade elxflash Reboot the machine One of the following errors codes will be displayed if the firmware update failed e Invalid BE3 firmware image e Invalid Cookie Firmware image corrupted e cmd to write to flash rom failed FreeBSD Device Driver User Manual P007635 01A Rev A
3. ation e 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 FreeBSD Device Driver User Manual P007635 01A Rev A 5 SC EMULEX 2 Installing and Uninstalling 6 General Installation Requirements 2 Installing and Uninstalling General Installation Requirements Prior to driver installation follow these requirements e Install a supported Emulex OneConnect CNA 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 o FreeBSD 8 1 o FreeBSD 8 2 Installing the FreeBSD Driver Kit To install the FreeBSD driver kit 1 Download 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 amd64 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 Type remove oce_load YES entry in boot loader conf 4 Reboot the syste
4. er 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 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 documentation Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 FreeBSD Device Driver User Manual P007635 01A Rev A Supported Driver Versions 3 gt G 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 1 377 0 v FreeBSD 8 1 4 1 377 0 v FreeBSD 8 2 FreeBSD Device Driver User Manual P007635 01A Rev A DE EMULEX Table of Contents 4 Table of Contents Supported Driver VersSionS ssssssssssssssunnnnnnnnnnnnnnnnsunnnnnnnnnnnnnnnnnnnnnnnnn nnmnnn 3 1 introducti ssi rssiri anniari aaea a a aana 5 OVGIVIOW sacniacindiasatcasaiaceensdcasnsandsasadsaaiweleecaidiucssaseiaiiuadaniue
5. he network layers above the driver that the adapter is capable of performing TCP UDP and IP Checksum offload O disables this parameter This parameter is not available via sysctl P007635 01A Rev A 8 gt EMULEX Table 3 1 Kernal Module Parameters 3 Configuration NIC Driver Configuration Parameter trace_enable Description Default 0x00000001 Allowed values 0 Oxffffffff kenv name hw oce trace_enable sysctl name dev ocex trace_enable Each bit corresponds to a trace flag Each trace flag turns on a separate set of trace messages Bit 0 corresponds to ERROR so it should always be enabled to show unexpected errors Trace messages are displayed on the console and the var log messages file The following are different sets of trace messages OCE_TRACE_ERROR OCE_TRACE_ENTRY_EXIT OCE_TRACE_IOCTL OCE_TRACE_MAILBOX OCE_TRACE_INIT OCE_TRACE_INTR OCE_TRACE_FAST_INTR OCE_TRACE_TX OCE_TRACE_RX OCE_TRACE_PC OCE_TRACE_UNHANDLED OCE_TRACE_IF OCE_TRACE_RING_BUF OCE_TRACE_FUNC OCE_TRACE_STRUCT OCE_TRACE_STATS OCE_TRACE_HEXDUMPS OCE_TRACE_FLAGS OCE_TRACE_NONE OCE_TRACE_ALL Viewing Device Driver Statistics To view device driver statistics type sysctl a FreeBSD Device Driver User Manual grep oce 0x00000001 0x00000002 0x00000004 0x00000008 0x00000010 0x00000020 0x00000040 0x00000080 0x00000100 0x00000200 0x00000400 0x00000800 0x00001000 0x00002000 0x00004000 0x0000800
6. m FreeBSD Device Driver User Manual P007635 01A Rev A 2 Installing and Uninstalling 7 gt EMULEX General Installation Requirements 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 FreeBSD Device Driver User Manual P007635 01A Rev A gt EMULEX 3 Configuration 3 Configuration NIC Driver Configuration NIC Driver Configuration Kernel Module Parameters Table 3 1 Kernal Module Parameters Parameter disable_msix Description Default 0 Allowed values 1 kenv name hw oce disable_msix sysctl name not applicable 0 allows MSIx interrupts to be used if available 1 causes the INTx interrupt to be used even if MSIx is available This parameter is not available via sysctl 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 enable_csum FreeBSD Device Driver User Manual Default 1 Allowed values 1 kenv name hw oce enable_csum sysctl name not applicable 1 reveals to t
7. rsiaeeasiidesenendatens 5 Supported Versions and Adapters sssssssssssssrrrnnrrtrrt tritri tirna nrnna anunn eines 5 POGUUEGS xccatxvacaweineaaas uti E ETEN A EE ESE E EE EET EEA 5 KNOWN SSUES cccevick cirerine vevcevauren an MiS aae NEA AANA arni EETA oe Te d 5 2 Installing and Uninstalling ssssssssunnnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnunnnnnnnnnnnnn 6 General Installation RequirementS sssssnsnnssnsnnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnn 6 Installing the FreeBSD Driver KIt sssssssssssssrsrrrerrerererrrrrrrrrrrrrrerrrrrrrereree 6 Uninstalling the FreeBSD Driver Kit sssssssrssrresrrersrrrrrrrrerrerrrrrrrrrrrererr rrn 6 UpdatingUpdating the FreeBSD Driver Kit ccccccceeceeeeeeeeeeeee erent eneenenennees 7 Loading and Unloading the Driver i 12 iacesciecksnseacvensdiereareeciennavesiataerereeeebieass 7 3 Configuration sssssssunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn DR 8 NIC Driver CONFIQUIATION ciciiicicitseciscedcrctensctetsersinsrsdteasdesncdisnnenandcssnenensdaanes 8 Viewing Device Driver StatiStiCS cccccccce eee eee eee eee tenant enna tee nat enna t es 9 Updating the Firmware viccccccscsscsctstcscsccccsscccsacccsdescesesssseccevescrsansssecsrsassseces 10 OneConnect 0Ce11102 Series UCNAs Installation Manual P007009 01A Rev A 1 1 Introduction Overview gt G EMULEX 1 Introduction Overview This FreeBSD NIC Driver User Manual provides installing
8. 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 e For a list of supported Emulex drivers for FreeBSD and their associated compatible operations systems see Supported Driver Versions on page 3 e 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 converged network adapter CNA The driver and CNA support e PCI e bus standard e Statistics Ethernet statistics provided for the number of packets received and sent as well as errors encountered e Jumbo Packets Packets greater than 1500 bytes e VLAN Virtual Local Area Network e Multicast Packets sent from a source to a group of destinations e RSS load balancing on Rx traffic across multiple Rx queues e TSO LSO TCP Segmentation Offload Large Segment Offload off loads Tx traffic to hardware to improve performance e CSO Check sum computation offload to hardware e Bonding Ethernet bonding across multiple ports for load balancing and fail over e PXE Preboot eXecution Environment for network boot e MSI x Message Signal Interrupts e Promiscuous mode Configuring an Ethernet interface to accept traffic from any destin
Download Pdf Manuals
Related Search