background image

 Chapter 9. Appendix 

Chelsio Network Driver for macOS

 

 25

 

6. Limited Warranty. If Chelsio furnishes the Software to you on media, Chelsio warrants 
only that the media upon which the Software is furnished will be free from defects in 
material or workmanship under normal use and service for a period of thirty (30) days 
from the date of delivery to you. 

CHELSIO DOES NOT AND CANNOT WARRANT THE PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING 
THE  SOFTWARE  OR  ANY  PART  THEREOF.  EXCEPT  FOR  THE  FOREGOING  LIMITED  WARRANTY,  CHELSIO 
MAKES NO OTHER WARRANTIES, EXPRESS OR IMPLIED, AND HEREBY DISCLAIMS ALL OTHER WARRANTIES, 
INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT OF THIRD PARTY RIGHTS, MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE.  Some states do not allow the exclusion of implied 
warranties  or  limitations  on  how  long  an  implied  warranty  may  last,  so  the  above 
limitations may not apply to you. This warranty gives you specific legal rights and you 
may also have other rights which vary from state to state. 

7. Remedy for Breach of Warranty. The sole and exclusive liability of Chelsio and its 
distributors, and your sole and exclusive remedy, for a breach of the above warranty, 
shall be the replacement of any media furnished by Chelsio not meeting the above limited 
warranty and which is returned to Chelsio.  If Chelsio or its distributor is unable to 
deliver replacement media which is free from defects in materials or workmanship, you 
may terminate this Agreement by returning the Software. 

8. Limitation of Liability. IN NO EVENT SHALL CHELSIO HAVE ANY LIABILITY TO YOU OR ANY 
THIRD PARTY FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE   DAMAGES, 
HOWEVER CAUSED, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR RELATED TO THE LICENSE 
OR USE OF THE SOFTWARE, INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR LOSS OF 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  fault-tolerant  and  is  not  designed, 
manufactured  or  intended  for  use  or  resale  as  online  equipment  control  equipment  in 
hazardous  environments  requiring  fail-safe  performance,  such  as  in  the  operation  of 
nuclear facilities, aircraft navigation or communication systems, air traffic control, 
direct life support machines, or weapons systems, in which the failure of the Software 
could  lead  directly  to  death,  personal  injury,  or  severe  physical  or  environmental 
damage. Chelsio specifically disclaims any express or implied warranty of fitness for 
any high risk uses listed above. 

10. Export. You acknowledge that the Software is of U.S. origin   and subject to U.S. 
export jurisdiction. You acknowledge that the laws and regulations of the United States 
and  other  countries  may  restrict  the  export  and  re-export  of  the  Software.  You  agree 
that  you  will  not  export  or  re-export  the  Software  or  documentation  in  any  form  in 
violation  of  applicable  United  States  and  foreign  law.  You  agree  to  comply  with  all 
applicable  international  and  national  laws  that  apply  to  the  Software,  including  the 
U.S. 

Export  Administration  Regulations,  as  well  as  end-user,  end-use,  and  destination 
restrictions issued by U.S. and other governments. 

11.  Government  Restricted  Rights.  The  Software  is  subject  to  restricted  rights  as 
follows. If the Software is acquired under the terms of a GSA contract: use, reproduction 
or disclosure is subject to the restrictions set forth in the applicable ADP Schedule 
contract.  If  the  Software  is  acquired  under  the  terms  of  a  DoD  or    civilian  agency 
contract,  use,  duplication  or  disclosure  by  the  Government  is  subject    to  the 

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: