background image

 Chapter 9. Appendix 

Chelsio Network Driver for macOS

 

 26

 

restrictions  of  this  Agreement  in  accordance  with  48  C.F.R.  12.212  of  the  Federal 
Acquisition  Regulations  and  its  successors  and  49  C.F.R.  227.7202-1  of  the  DoD    FAR 
Supplement and its successors. 

12. General. You acknowledge that you have read this Agreement, understand it, and that 
by  using  the  Software  you  agree  to  be  bound  by  its  terms  and  conditions.  You  further 
agree that it is the complete and exclusive statement of the agreement between Chelsio 
and you, and supersedes any proposal or prior agreement, oral or written, and any other 
communication between Chelsio and you relating to the subject matter of this Agreement.  
No additional or any different terms will be enforceable against Chelsio unless Chelsio 
gives its express consent, including an express waiver of the terms of this Agreement, 
in  writing  signed  by  an  officer  of  Chelsio.    This  Agreement  shall  be  governed  by 
California law, except as to copyright matters, which are covered by Federal law. You 
hereby  irrevocably  submit  to  the  personal  jurisdiction  of,  and  irrevocably  waive 
objection  to  the  laying  of  venue  (including  a  waiver  of  any  argument  of  forum  non 
conveniens or other principles of like effect) in, the state and federal courts located 
in  Santa  Clara  County,  California,  for  the  purposes  of  any  litigation  undertaken  in 
connection  with  this  Agreement.  Should  any  provision  of  this  Agreement  be  declared 
unenforceable in any jurisdiction, then such provision shall be deemed severable from 
this Agreement and shall not affect the remainder hereof. All rights in the Software not 
specifically granted in this Agreement are reserved by Chelsio. You may not assign or 
transfer this Agreement (by  merger, operation of law or in any  other manner) without 
the  prior  written  consent  of  Chelsio  and    any  attempt  to  do  so  without  such  consent 
shall be void and shall constitute a material breach of this Agreement. 

Should  you  have  any  questions  concerning  this  Agreement,  you  may  contact  Chelsio  by 
writing to: 

Chelsio Communications, Inc. 
209 North Fair Oaks Avenue, 
Sunnyvale, CA 94085 
U.S.A 

Summary of Contents for Terminator N310E

Page 1: ......

Page 2: ...CTIVELY THE SOFTWARE IS SUBJECT TO THE SOFTWARE LICENSE TERMS OF CHELSIO COMMUNICATIONS INC Sales For all sales inquiries please send email to sales chelsio com Support For all support related questions please send email to support chelsio com Copyright 2019 Chelsio Communications All Rights Reserved Chelsio is a registered trademark of Chelsio Communications All other marks and names mentioned he...

Page 3: ...Chelsio Network Driver for macOS iii Document History Version Revision Date 1 0 7 05 05 2017 1 0 8 06 08 2017 1 0 9 10 25 2017 1 1 0 12 29 2017 1 1 1 08 13 2018 1 1 2 09 26 2018 1 1 3 04 17 2019 ...

Page 4: ...Installation 11 3 1 GUI 11 3 2 CLI 15 4 Software Driver Loading 16 5 Software Driver Configuration and Fine tuning 17 5 1 Important Configurable Parameters 17 5 2 Kernel Tuning 19 5 3 Network Device Configuration 19 5 4 cxgbtool 19 5 5 Firmware Update 20 6 Software Driver Unloading 21 7 Software Driver Uninstallation 22 8 Software Driver Update 23 9 Appendix 24 9 1 Chelsio End User License Agreeme...

Page 5: ... fabric over a single wire by simultaneously running all unmodified IP sockets Fibre Channel and InfiniBand applications over Ethernet at line rate Designed for deployment in virtualized data centers cloud service installations and high performance computing environments Chelsio Terminator adapters bring a new level of performance metrics and functional capabilities to the computer networking indu...

Page 6: ... CR T520 SO CR T520 CR T520 BT T540 CR T540 LP CR T540 SO CR T4 Adapters T420 CR T440 CR T404 BT T422 CR T420 SO CR T420 LL CR T440 LP CR T420 CX T3 Adapters N310E N310E CXA N320E GEN2 S310E SR S310E SR S310E CXA S310E CR N320E CXA S320E CR S320E LP CR S302E S320E CXA Only port 0 first port supported Spider cables not supported Note ...

Page 7: ...ailable for following version s macOS 10 14 Mojave 64 bit macOS 10 13 High Sierra 64 bit macOS 10 12 x Sierra 64 bit Macintosh OS X 10 11 x El Capitan 64 bit Other versions have not been tested and are not guaranteed to work 1 4 Package Contents The Chelsio network driver package for macoS consists of the following cxgtool rtf cxgbtool help file cxgb pkg driver package firmware firmware binary fil...

Page 8: ...he PCI connector on the motherboard Apply even pressure on both edges until the card is firmly seated It may be necessary to remove the SFP transceiver modules prior to inserting the adapter viii Secure the Chelsio adapter with a screw or other securing mechanism as described by the system manufacturer s instructions Replace the case cover ix After securing the card ensure that the card is still f...

Page 9: ...ardware Installation Chelsio Network Driver for macOS 9 b For T5 adapters c For T4 adapters Once network driver is installed and loaded examine the output of dmesg to see if the card is discovered For T6 adapters ...

Page 10: ...n the machine and the card is using MSI interrupts Network device names for Chelsio s physical ports are assigned using the following convention the port farthest from the motherboard will appear as the first network interface However for T5 40G adapters the association of physical Ethernet ports and their corresponding network device names is opposite For these adapters the port nearest to the mo...

Page 11: ... file from Chelsio Download Center ii Mount the disk image cxgb x y z dmg file by double clicking on it The disk image should mount as a new device and place you in the base directory of the cxgb device If the disk image is downloaded using Safari browser it will mount automatically iii Locate the cxgb pkg installer package inside the mounted device and double click on it to start the installer iv...

Page 12: ...en displays important information regarding the drivers for Chelsio adapters Please read carefully and click Continue to proceed Figure 2 Readme window vi Click Continue and then click Read License to read Chelsio s End User License Agreement or Agree to proceed Figure 3 Chelsio EULA window ...

Page 13: ...roceed with complete package installation or Customize to select the components to be installed Figure 5 Customize installation In custom installation user can choose between cxgb T6 T5 T4 kernel extension cxgb3 T3 kernel extension or cxgbtool command line utility In standard installation all three components will be selected installed Note ...

Page 14: ...tware Driver Installation Chelsio Network Driver for macOS 14 viii The selected components will now be installed Figure 6 Installation in progress ix Click Close to exit the installer Figure 7 Installation complete ...

Page 15: ...twork Driver for macOS 15 3 2 CLI i Mount the disk image cxgb x y z dmg host root hdiutil mount cxgb x y z dmg The disk image will be mounted to Volumes directory ii Install the driver host root installer pkg Volumes cxgb x y z cxgb pkg target Example ...

Page 16: ...The installer will copy the signed KEXT into Library Extensions directory To load the T6 T5 T4 network driver run the following command host root sudo kextload Library Extensions cxgb kext To load the T3 network driver run the following command host root sudo kextload Library Extensions cxgb3 kext ...

Page 17: ...rror Correction FEC The current FEC settings can be viewed using host root sudo cxgbtool cxgbX fec Below is a sample output on T6 25G port To set FEC host root sudo cxgbtool cxgbX fec value Here value can be rs Reed Solomon FEC baser Base R Reed Solomon FEC auto Use standard FEC settings as specified by IEEE 802 3 interpretations of Cable Transceiver Module parameters off Turn off FEC Example Chan...

Page 18: ... or disabled use host root sudo cxgbtool cxgbX qset In the output the LRO field should display 0 if disabled and 1 if enabled 5 1 3 TCP Segmentation Offload Support TCP Segmentation Offload has been supported since Snow Leopard and enabled by default It can be disabled globally by using host root sysctl net inet tcp tso 0 FEC auto negotiation is not supported on optic link If auto negotiation is d...

Page 19: ...ministration and configuration of network devices 5 4 cxgbtool The app cxgbtool is used to display or change Chelsio network card settings Loading firmware and setting hardware registers can only be done using the master physical function which restricts the BSD interface name that can be used as a parameter to cxgbtool for those commands By default the master physical function is associated with ...

Page 20: ... of cxgbtool that came with the currently installed driver Follow the steps mentioned below i If not done already mount the new disk image cxgb x y z file by double clicking on it The cxgb disk image should mount as a new device and place you in the base directory of the cxgb device ii Browse to the firmware directory For example if the disk image was mounted to Volumes run the following commands ...

Page 21: ...To unload the T6 T5 T4 Network driver run the following command host root sudo kextunload Library Extensions cxgb kext To unload the T3 Network driver run the following command host root sudo kextunload Library Extensions cxgb3 kext Unloading the driver while traffic is running is not recommended Note ...

Page 22: ...Before proceeding refer Software Driver Unloading chapter and unload the driver depending on the driver type To uninstall the T6 T5 T4 driver run the following command host root rm rf Library Extensions cxgb kext To uninstall the T3 driver run the following command host root rm rf Library Extensions cxgb3 kext ...

Page 23: ...Update For any distribution specific problems please check README and Release Notes included in the release for possible workaround Please visit Chelsio Download Center for regular updates on various software drivers You can also subscribe to our newsletter for the latest software updates ...

Page 24: ...f or ii make available the Software or any portion thereof in any form on the Internet The Software contains trade secrets and in order to protect them you may not decompile reverse engineer disassemble or otherwise reduce the Software to a human perceivable form You assume full responsibility for the use of the Software and agree to use the Software legally and responsibly 3 Ownership of Software...

Page 25: ... ANTICIPATED PROFITS EVEN IF CHELSIO HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES IN NO EVENT SHALL CHELSIO S LIABILITY ARISING OUT OF OR RELATED TO THE LICENSE OR USE OF THE SOFTWARE EXCEED THE AMOUNTS PAID BY YOU FOR THE LICENSE GRANTED HEREUNDER THESE LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY 9 High Risk Activities The Software is not ...

Page 26: ...xcept as to copyright matters which are covered by Federal law You hereby irrevocably submit to the personal jurisdiction of and irrevocably waive objection to the laying of venue including a waiver of any argument of forum non conveniens or other principles of like effect in the state and federal courts located in Santa Clara County California for the purposes of any litigation undertaken in conn...

Reviews: