Chelsio Communications Terminator Series Installation And User Manual

Network driver for macos
Hide thumbs Also See for Terminator Series:

Advertisement

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Terminator Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Chelsio Communications Terminator Series

  • Page 2 IMPLIED WARRANTIES MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE USE OF THE SOFTWARE AND ANY ASSOCIATED MATERIALS (COLLECTIVELY THE “SOFTWARE”) IS SUBJECT TO THE SOFTWARE LICENSE TERMS OF CHELSIO COMMUNICATIONS, INC. Chelsio (India) Private Limited Chelsio Communications (Headquarters) Subramanya Arcade, Floor 3, Tower B 209 North Fair Oaks Avenue, No.
  • Page 3 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 Chelsio Network Driver for macOS...
  • Page 4: Table Of Contents

    TABLE OF CONTENTS Introduction 1.1. Features 1.2. Hardware Requirements 1.3. Software Requirements 1.4. Package Contents Hardware Installation Software/Driver Installation 3.1. 3.2. Software/Driver Loading Software/Driver Configuration and Fine-tuning 5.1. Important Configurable Parameters 5.2. Kernel Tuning 5.3. Network Device Configuration 5.4. cxgbtool 5.5.
  • Page 5: Introduction

    Network and Storage related requirements. The Terminator series is Chelsio’s next generation of highly integrated, hyper-virtualized 10/25/40/50/100GbE controllers. The adapters are built around a programmable protocol- processing engine, with full offload of a complete Unified Wire solution comprising NIC, TOE, iWARP RDMA, iSCSI, FCoE and NAT support.
  • Page 6 Chapter 1. Introduction • T62100-LP-CR • T62100-SO-CR T5 Adapters • T580-CR • T580-SO-CR • T580-LP-CR • T520-LL-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 •...
  • Page 7: Software Requirements

    Chapter 1. Introduction 1.3. Software Requirements The Chelsio network driver has been developed to run on Intel based platforms in NIC mode. Currently the driver is available 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.
  • Page 8: Hardware Installation

    Chapter 2. Hardware Installation 2. Hardware Installation Follow these steps to install Chelsio adapter in your system: Shutdown/power off your system. ii. Power off all remaining peripherals attached to your system. iii. Unpack the Chelsio adapter and place it on an anti-static surface. iv.
  • Page 9 Chapter 2. Hardware Installation b. For T5 adapters c. For T4 adapters dmesg Once network driver is installed and loaded, examine the output of to see if the card is discovered. • For T6 adapters: Chelsio Network Driver for macOS...
  • Page 10 Chapter 2. Hardware Installation • For T5 adapters: • For T4 adapters: The above outputs indicate the hardware configuration and serial number of the adapter. As observed by the x8, the card is properly installed in an x8 slot on the machine and the card is using MSI interrupts.
  • Page 11: Software/Driver Installation

    Chapter 3. Software/Driver Installation 3. Software/Driver Installation 3.1. The driver must be installed by the administrator. Any attempt in installing the driver as a regular user will fail. If you haven’t done already, download the installer package (dmg file) from Chelsio Download Center.
  • Page 12 Chapter 3. Software/Driver Installation v. The next screen 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”...
  • Page 13 Chapter 3. Software/Driver Installation Figure 4 - EULA acceptance prompt vii. Now, either click “Install” to proceed 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 Note extension), cxgb3 (T3 kernel extension) or cxgbtool (command line utility).
  • Page 14 Chapter 3. Software/Driver Installation viii. The selected components will now be installed. Figure 6 - Installation in progress ix. Click “Close” to exit the installer. Figure 7 - Installation complete Chelsio Network Driver for macOS...
  • Page 15: Cli

    Chapter 3. Software/Driver Installation 3.2. 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: Chelsio Network Driver for macOS...
  • Page 16: Software/Driver Loading

    Chapter 4. Software/Driver Loading 4. Software/Driver Loading 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 Chelsio Network Driver for macOS...
  • Page 17: Software/Driver Configuration And Fine-Tuning

    Chapter 5. Software/Driver Configuration and Fine-tuning 5. Software/Driver Configuration and Fine-tuning 5.1. Important Configurable Parameters 5.1.1. FEC Chelsio T6 Unified Wire adapters support changing Forward Error 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>...
  • Page 18 Chapter 5. Software/Driver Configuration and Fine-tuning • FEC auto-negotiation is not supported on optic link. Note • If auto-negotiation is disabled, ensure that the same FEC is set on both sides of the link, for the link to come up. 5.1.2.
  • Page 19: Kernel Tuning

    Chapter 5. Software/Driver Configuration and Fine-tuning 5.2. Kernel Tuning 5.2.1. Increasing default parameter values /etc/sysctl.conf To increase default parameter values on the client, edit the configuration file. kern.ipc.maxsockbuf < 2097152 For example, if the default value for then set it in /etc/sysctl.conf to be 2097152.
  • Page 20: Firmware Update

    Chapter 5. Software/Driver Configuration and Fine-tuning 5.5. Firmware Update The minimum firmware version matching the driver must be loaded before the new driver installed can load, and the loading is initiated by the post-install phase of the installer. The current driver can load the new firmware using the loadfw command of cxgbtool that came with the currently installed driver.
  • Page 21: Software/Driver Unloading

    Chapter 6. Software/Driver Unloading 6. Software/Driver Unloading • 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 Chelsio Network Driver for macOS...
  • Page 22: Software/Driver Uninstallation

    Chapter 7. Software/Driver Uninstallation 7. Software/Driver Uninstallation 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 Chelsio Network Driver for macOS...
  • Page 23: Software/Driver Update

    Chapter 8. Software/Driver Update 8. Software/Driver 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. Chelsio Network Driver for macOS...
  • Page 24: Appendix

    IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, CLICK THE "DO NOT ACCEPT" BUTTON TO TERMINATE THE INSTALLATION PROCESS. 1. License. Chelsio Communications, Inc. ("Chelsio") hereby grants you, the Licensee, and you hereby accept, a limited, non-exclusive, non-transferable license to install and use the Software with one or more Chelsio network adapters on a single server computer for use in communicating with one or more other computers over a network.
  • Page 25 Chapter 9. Appendix 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.
  • Page 26 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...

Table of Contents