User Manual
Contents
1. 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 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 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 6 for FreeBSD User Manual P011387 01B Rev A D6 EMULEX 2 Installing and Uninstalling 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 oce2. 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 6 for FreeBSD User Manual P011387 01B Rev A gt lt EMULEX 3 Configuration An Avago Technologies Company NIC Driver Configuration 3 Configuration This section provides information on configuring the FreeBSD NIC driver updating the firmware and extracting an SFP module s VPD information NIC Driver Configuration This section lists the kernel module parameters and how to configure the FreeBSD NIC driver Kernel Module Parameters Table 3 1 Kernel Module Parameters Parameter Description max_rsp_handled Default 64 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 TSO for NIC interfaces only type ifconfig oce lt if_id gt tso To disable TSO for NIC interfaces only type ifconfig oce lt if_id gt tso Not
3. fail over PXE Preboot eXecution Environment for network boot MSI x Message signal interrupts extended Promiscuous mode configuring an Ethernet interface to accept traffic from any destination Debugging capability Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A 5 gt G EMULEX An Avago Technologies Company Abbreviations AIC CARP CFA CSO LSO MSI X NIC PCIe PXE RSS SFP TCP TSO UCNA VHID VLAN VPD Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A 1 Introduction Abbreviations adaptive interrupt coalescing Common Address Redundancy Protocol converged fabric adapter Checksum Offload large segment offload message signaled interrupts extended network interface card or controller Peripheral Component Interconnect Express Preboot eXecution Environment receive side scaling small form factor pluggable Transmission Control Protocol TCP segmentation offload universal converged network adapter virtual host ID virtual local area network vital product data 6 D6 EMULEX 2 Installing and Uninstalling 7 2 Installing and Uninstalling This section provides installation and removal instructions for the FreeBSD driver kit 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
4. gt G EMULEX An Avago Technologies Company Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A Connect Monitor Manage gt G EMULEX An Avago Technologies Company Copyright 2012 2015 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 Emulex BladeEngine Emulex InSpeed Emulex LightPulse Emulex OneCommand Emulex OneConnect and Emulex SLI are registered trademarks and Emulex Advanced 8 Emulex Connect Emulex CrossLink Emulex Engine Emulex Edge Emulex ExpressLane Emulex GreenState Emulex OneCore Emulex Pilot Emulex SURF Emulex Universal Multi Channel Emulex vEngine Emulex Virtual Fabric Emulex Virtual Network Exceleration Emulex vPath and Emulex vScale 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 in
5. cluding 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 manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A An Avago Technologies Company XG EMULEX Table of Contents 3 Table of Contents List OF Tables siciisciudt triste ia aaan 4 1 IB OGUCUON iiitcisdiierincscs EINER ii aana 5 Supported Versions and AdapterS sssssssssssssunsnnnnnnnnnnnnnnnnnnnnnnnnnnnnunnnnnunnnnnnnn 5 Abbreviations cc iciaes catasceassenaancaaiscosmscdes neepeacedeouamonmeaanmanandeccnneventesatedpeneancouen 6 2 Installing and Uninstalling sists mien 7 General Installation Requirements sssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnan 7 Installing the FreeBSD Driver Kit sssssssunnnnnnsnnnnunnnnnnnnnnnunnunnnnnnnnnnnnnnnnnnnnnnn 7 Uninstalling the FreeBSD Driver Kit sssssssnnnnnsnssnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 7 Updating the FreeBSD Driver Kit ssssssssnnnsnnsnnsn
6. dvskew is set to ensure that the backup host advertises later than the main host server since advskew controls the order of precedence when there are multiple backup servers hostname hostc example org ifconfig em0 inet 192 168 1 5 netmask 255 255 255 0 ifconfig em0O_alias0O vhid 1 advskew 100 pass testpass alias 192 168 1 50 32 ifconfig _em0O_aliasl vhid 2 advskew 100 pass testpass alias 192 168 1 51 32 Having two CARP VHIDs configured enables hostc example org to recognize if either of the main host servers becomes unavailable If a main host server fails to respond before the backup server the backup server will pick up the shared IP address until the main host server becomes available again 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 Note For information on using the Elxflash management utility to update firmware see the Elxflash and LpCfg Management Utilities User Manual To update the firmware 1 Copy the code below to the makefile KMOD elxflash FIRMWS imagename ufi elxflash include lt bsd kmod mk gt Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A 11 gt lt EMULEX 3 Configuration 12 An Avago Tech
7. e 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 Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A 9 gt lt EMULEX 3 Configuration 1Q An Avago Technologies Company NIC Driver Configuration ifconfig oce lt if id gt lso Note lt if_id gt is the interface identification number 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 AIC Note AIC configuration is available on OneConnect OCe11102 and OCe14000 series adapters only 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 Configuring CARP Note CARP is supported in FreeBSD 10 0 and later only ll o CARP enables multiple hosts to share the same IP address and VHID in order to provide high availability for one or more services If one or more host servers fail the other host servers will transparently continue operations so a service failure is not observed In addition to the shared IP address each host server has its own IP address for management and configuration All of the systems that share an IP address have the same VHID The VHID for each virtual IP address m
8. echnologies Company Supported Versions and Adapters 1 Introduction This document provides installing uninstalling updating and configuring procedures for an Emulex supported FreeBSD network interface card 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 converged network adapter CNA The driver and adapters support Peripheral Component Interconnect Express PCIe bus standard Generation 2 or later Statistics Ethernet statistics provided for the number of packets received and sent and errors encountered Jumbo packets greater than 1500 bytes Virtual local area network VLAN Multicast packets sent from a source to a group of destinations Receive side scaling 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 Checksum Offload to hardware Bonding Ethernet bonding across multiple ports for load balancing and
9. ing dump options e Fora 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 Version 10 6 for FreeBSD User Manual P011387 01B Rev A
10. nologies Company Extracting an SFP Module s VPD Information 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 Oy Ole sysctl dev oce lt if_id gt fw_upgrade elxflash 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 If one of the messages above appears verify that you have the latest firmware update by checking the Emulex website and then attempt to update the firmware again If you continue to have issues contact your Emulex Technical Support representative Extracting an SFP Module s VPD Information To dump an SFP module s VPD 1 Trigger the dump by typing sysctl dev oce lt if_id gt sfp vpd_dump 0 2 Choose one of the follow
11. unnnnnnnnnnnunnunnnnnnnnnnnunnnnnnnnnnn 8 Checking the FreeBSD Driver VerSion s s ssssssusnnnnnnnsnnnnunnnnnnnnnnnnnnunnunnnnnnnnnnnnn 8 Loading and Unloading the Driver sssasssssnsnnsnnnnunnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnn 8 3 Configuratii sisiiiriroiiitisppasiiiokiia iaaa aaia iii aaa ia 9 NIC Driver CONTIQUIATION sicciiisssdcsisisccsdcssiessssacsensnseeditensnsdnetscrndssredsentenanadeanes 9 Kernel Module Parameters sic cicerticessecv acridine nentasieeepdiarsewstinieeacs 9 Configuring TSO serron a ARE EEEE R E E RENEE A 9 Configuring LSO irssi ramin uranni luce ari aae aaa E A EEE ANET ENER 9 Configuring J umbo Frame Transmit sssssssssssrrrrrrrrerrrrrrrrrrrerrerrrrrrrrrrrn 10 Contouring Al er aa E EE N E EEEE EEE 10 Configuring CARP 2 ceaccsidiuerapcnietvesteiced inveselaiddivsiaienerevelndeawetvsapiaresiuesets 10 Viewing Device Driver StatisticS cccccecccceceeceeeeceeeeneeeenaeeenaeeenaeeenaeeenaeeeeaeees 11 Updating The FInMWANe sncecsatecsicac sien tancevannntannedanievennanedentenressiacsannmnsdininanens 11 Extracting an SFP Module s VPD Information ccccccccssceescceeesceeecueeesueeeageeeager 12 Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A gt lt EMULEX List of Tables 4 An Avago Technologies Company List of Tables Table 3 1 Kernel Module Parameters Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A gt G EMULEX 1 Introduction An Avago T
12. ust be unique across the broadcast domain of the network interface To enable boot time support for CARP you must add an entry for the carp ko kernel module in boot loader conf by typing carp_load YES To immediately load the module without rebooting type kldload carp The host name management IP address and subnet mask shared IP address and VHID are all set by adding entries to etc rc conf This example is for hosta example org hostname hosta example org ifconfig em0 inet 192 168 1 3 netmask 255 255 255 0 ifconfig _em0 aliasO0 vhid 1 pass testpass alias 192 168 1 50 32 Emulex Driver Version 10 6 for FreeBSD User Manual P011387 01B Rev A gt lt EMULEX 3 Configuration An Avago Technologies Company Viewing Device Driver Statistics The next set of entries are for hostb example org Since it represents a second main host server it uses a different shared IP address and VHID However the passwords specified with pass must be identical as CARP only responds to systems with the correct password hostname hostb example org ifconfig em0 inet 192 168 1 4 netmask 255 255 255 0 ifconfig _em0 alias0 vhid 2 pass testpass alias 192 168 1 51 32 The third system hostc example org is configured to handle failover from either main host server This system is configured with two CARP VHIDs one to handle the virtual IP address for each of the main host servers The CARP advertising skew a
Download Pdf Manuals
Related Search