Chelsio Communications Terminator N310E Installation And User Manual Download Page 19

 Chapter 5. Software/Driver Configuration and Fine-tuning 

Chelsio Network Driver for macOS

 

 19

 

5.2. 

Kernel Tuning 

5.2.1.  Increasing default parameter values 

To increase default parameter values on the client, edit the 

/etc/sysctl.conf 

configuration file

For  example,  if  the  default  value  for 

kern.ipc.maxsockbuf  <  2097152

  then  set  it  in 

/etc/sysctl.conf

 to be 2097152.

 

5.2.2.  Increasing mbuf cluster 

If dmesg output contains 

outputPacket() zero segments

, it means in order to support the workload, 

the number of mbuf clusters available should be increased as packet drops are occurring. This 
can be achieved by increasing the number of mbuf clusters using boot-args parameter 

ncl

See 

http://support.apple.com/kb/HT3512

 for more information. 

 

5.3. 

Network Device Configuration 

Please  refer  to  the  operating  system  documentation  for  administration  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 Port 0. The 

cxgbtool

 

command with no parameters will list the master physical function BSD interface name. 

For more information, use 

cxgbtool

 help: 

 

host:root# sudo cxgbtool -h 

 

Some  operating  systems  may  attempt  to  auto-configure  the  detected  hardware 
and some may not detect all ports on a multi-port adapter. If this happens, please 
refer the operating system documentation for manually configuring the   network 
device. 

Note 

 

Network preferences panel should be used for changing interface properties such 
as active/inactive or MTU size. 

Note 

 

 cxgbtool supports filtering settings on the Chelsio T3 based adapters only. 

Note 

 

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: