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.
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.
Chapter I. Chelsio Unified Wire 1.3. Software Requirements The Chelsio Unified Wire software has been developed to run on Windows based platforms. To know more about the complete list of versions supported by each driver/software, please refer their respective sections. Drivers are WHQL certified for Windows Server 2016, 2012 R2 and 10 Client.
Chapter I. Chelsio Unified Wire 2. Hardware Installation 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. Remove the system case cover according to the system manufacturer’s instructions. v.
Chapter I. Chelsio Unified Wire 3. Software/Driver Installation Chelsio Unified Wire can be installed using the Installer or the zip package. Refer the relevant section below depending on the method of installation selected. If you are planning to install Unified Wire in a cluster, it should be done on all Important the members.
Page 10
Chapter I. Chelsio Unified Wire Figure 1 - Unified Wire installer welcome window iii. Select the radio button I accept the terms of the license agreement and click Next Figure 2 - Chelsio EULA window Chelsio Unified Wire for Windows...
Page 11
Chapter I. Chelsio Unified Wire iv. Select Complete for complete package installation. Figure 3 - Select setup (installation) type v. Click Install to start the installation. Figure 4 - Start installation Chelsio Unified Wire for Windows...
Page 12
Chapter I. Chelsio Unified Wire vi. FCoE Storport Miniport and NIC drivers will now be installed. Figure 5 - Installation in progress vii. Click Finish to exit from the Unified Wire Installer. Figure 6 - Finishing Unified Wire installation Chelsio Unified Wire for Windows...
Chapter I. Chelsio Unified Wire CLI mode (Silent Installation) To install the driver using this feature, open command prompt and execute the following command: C:\Users\Administrator> ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.exe –in all The above command will install NIC and FCoE Storport Miniport drivers. To know more about other parameters and options, execute the following command: C:\Users\Administrator>...
Page 14
Chapter I. Chelsio Unified Wire Drivers location The driver files should be manually picked from: • ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\drivers\Win10 for Server 2016 and 10 Client. • ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\drivers\Win7 for Server 2012 R2. Manual • The driver components need to be installed strictly in the order described Important here.
Page 15
Chapter I. Chelsio Unified Wire ii. Under Driver tab, select Update Driver… iii. Select Browse my computer for driver software. iv. Select Let me pick from a list of device drivers on my computer and click Next. v. Click on Have Disk Button and on the next screen, browse for csiofcoe.inf file in the zip package.
Chapter I. Chelsio Unified Wire 4. Firmware Update The driver will auto-load the firmware if an update is required. The firmware version can be verified using cxgbtool: C:\Users\Administrator>cxgbtool nic0 debug version In case of installer, the firmware binaries will be copied to <system_drive>\ChelsioUwire \Firmware\ folder during installation.
Chapter I. Chelsio Unified Wire 5. cxgbtool help The cxgbtool command queries or sets various aspects of Chelsio network interface cards. It complements standard tools used to configure network settings and provides functionality not available through such tools. Some of the commands provided can be used to query running statistics to aid in debugging. Syntax cxgbtool <vbdIface|nicIface|iSCSIIface|rdma>...
Page 18
Chapter I. Chelsio Unified Wire FCoE Description: Display FCoE information. cxgbtool fcoe -a [FCoEAdapterIndex] <options> Syntax: Examples: o Scanning for available Chelsio adapters. o Printing adapter status and parameters. Chelsio Unified Wire for Windows...
Page 19
Chapter I. Chelsio Unified Wire o Printing adapter statistics. Chelsio Unified Wire for Windows...
Page 20
Chapter I. Chelsio Unified Wire o Printing physical port statistics of adapter. Chelsio Unified Wire for Windows...
Page 21
Chapter I. Chelsio Unified Wire o Printing DCB parameters. Chelsio Unified Wire for Windows...
Page 22
Chapter I. Chelsio Unified Wire o Printing driver parameters. o Printing SCSI statistics. Chelsio Unified Wire for Windows...
Page 23
Chapter I. Chelsio Unified Wire o Printing FCFs information connected to the adapter. Chelsio Unified Wire for Windows...
Page 24
Chapter I. Chelsio Unified Wire o Printing local nodes information. Chelsio Unified Wire for Windows...
Page 25
Chapter I. Chelsio Unified Wire o Printing local nodes statistics. Chelsio Unified Wire for Windows...
Page 26
Chapter I. Chelsio Unified Wire o Printing remote nodes information. Chelsio Unified Wire for Windows...
Page 27
Chapter I. Chelsio Unified Wire o Printing remote nodes statistics. o Displaying FCoE statistics. Chelsio Unified Wire for Windows...
Page 28
Chapter I. Chelsio Unified Wire o Displaying internal memory information. Chelsio Unified Wire for Windows...
Page 29
Chapter I. Chelsio Unified Wire o Displaying firmware debug logs. o Creating NPIV ports for the parent WWN. o Deleting NPIV ports for the parent WWN. o Printing NPIV ports for the parent WWPN. Chelsio Unified Wire for Windows...
Page 30
Chapter I. Chelsio Unified Wire Debug ▪ version Description: Display adapter information like part number, serial number, device ID, firmware version, TP, etc. cxgbtool <vbdIface|nicIface|iscsiIface> debug version Syntax: Example: ▪ inst Description: Install driver package specified in the setup information file (.inf). cxgbtool debug inst <file>...
Page 31
Chapter I. Chelsio Unified Wire ▪ uninst Description: Uninstall driver package specified in the setup information file (.inf). Syntax: cxgbtool debug uninst <file> Example: ▪ rescan Description: Scan for hardware changes in the device manager. cxgbtool debug rescan Syntax: Example: ▪...
Page 32
Chapter I. Chelsio Unified Wire txpd Tx PacketDirect queue statistics. rxpd Rx PacketDirect queue statistics. * not supported on T6 adapters Qstats Parameter Description BcBytes Broadcast packet size in bytes. BcPkts Number of broadcast packets. CoalBytes Coalesced packet size in bytes. CoalPkts Number of coalesced packets.
Page 33
Chapter I. Chelsio Unified Wire Example of rxeth qstats hardware ▪ sensor Description: Display sensor data. cxgbtool <nicIface> hardware sensor Syntax: Example: ▪ Description: Set/Display Forward Error Correction (FEC) parameters. Syntax: cxgbtool <nicIface> hardware fec [<config params>] Example: o Displaying currently set FEC mode. Chelsio Unified Wire for Windows...
Page 34
Chapter I. Chelsio Unified Wire o Setting FEC mode: ▪ link_cfg Description: Set/Display link configuration parameters. Syntax: cxgbtool <nicIface> hardware link_cfg <options> Example: o Displaying link configuration information: o Enabling/Disabling auto-negotiation: Auto-negotiation is enabled by default. To disable it, use the autoneg off parameter on all connected machines of the link.
Page 35
Chapter I. Chelsio Unified Wire o Changing link speed: 25G port can be set to 10G and 100G port can be set to 25G/40G/50G. Auto-negotiation should be disabled on all connected machines while changing link speed. Before setting 40G or 10G speeds, FEC should be disabled on the port using: Important C:\Users\Administrator>cxgbtool nic0 hardware fec off cudbg...
Chapter I. Chelsio Unified Wire 6. Software/Driver Uninstallation Similar to installation, Chelsio Unified Wire can be uninstalled using the Installer or zip package. Refer the relevant section depending on the method of installation used to install drivers. 6.1. Installer Chelsio Unified Wire Installer can be uninstalled using two methods: GUI or CLI mode. GUI mode requires user interaction and uninstallation occurs with options specified by the user.
Page 37
Chapter I. Chelsio Unified Wire Figure 8 - Repairing previous installation using ‘Repair’ option Figure 9 – Uninstalling Unified Wire using ‘Remove’ option Chelsio Unified Wire for Windows...
Page 38
Chapter I. Chelsio Unified Wire iii. Click on the Finish button to exit from the installer. Figure 10 - Finishing uninstallation This method of uninstallation is possible only if the drivers were installed using Note Unified Wire Installer. CLI Mode To uninstall FCoE Storport Miniport driver, execute the following command: C:\Users\Administrator>...
Chapter I. Chelsio Unified Wire 6.2. Zip Package If the driver components were installed using the zip package, they will have to be uninstalled manually. The following section lists the various components and their respective methods of uninstallation. The driver components need to be uninstalled strictly in the order described Important here.
Chapter II. FCoE Storport Miniport 1. Introduction Fibre Channel over Ethernet (FCoE) is a mapping of Fibre Channel over selected full duplex IEEE 802.3 networks. The goal is to provide I/O consolidation over Ethernet, reducing network complexity in the Datacenter. Chelsio FCoE initiator maps Fibre Channel directly over Ethernet while being independent of the Ethernet forwarding scheme.
Chapter II. FCoE Storport Miniport 2. Configuration and Fine-tuning 2.1. Configuring Cisco Nexus 5010 switch Configuring the DCBX parameters By default, the Cisco Nexus switch enables DCBX functionality and configures Note PFC for FCoE traffic making it no drop with bandwidth of 50% assigned to FCoE class of traffic and another 50% for the rest (like NIC).
Page 43
Chapter II. FCoE Storport Miniport iv. Configure network-qos class-maps. Switch(config)#class-map type network-qos class-nic Switch(config-cmap-nq)#match qos-group v. Configure qos policy-maps. Switch(config)#policy-map type qos policy-test Switch(config-pmap-qos)#class type qos class-nic Switch(config-pmap-c-qos)#set qos-group 2 vi. Configure queuing policy-maps and assign network bandwidth. Divide the network bandwidth between FCoE and NIC traffic.
Page 44
Chapter II. FCoE Storport Miniport Configuring the FCoE/FC ports In this procedure, you may need to adjust some of the parameters to suit your environment, such as VLAN IDs, Ethernet interfaces, and virtual Fibre Channel interfaces Following steps will enable FCoE services on a particular VLAN and does a VSAN-VLAN mapping.
Chapter II. FCoE Storport Miniport iv. On the FC Ports, if a FC target is connected then perform the following steps - Switch(config)#vsan database Switch(config-vsan-db)#vsan 2 Switch(config-vsan-db)# vsan 2 interface fc 2/2 Switch(config-vsan-db)#exit Switch(config)interface fc 2/2 Switch(config-if)# switchport mode auto Switch(config-if)# switchport speed auto Switch(config-if)# no shutdown.
Page 46
Chapter II. FCoE Storport Miniport iii. To bring the LUNs online, launch disk management by going to Start->Run- >diskmgmt.msc. Right click on the LUN and select online. Figure 12 - Bringing LUNs online iv. Now format the LUN by right clicking on it and choosing any of the volume types. In this example, we will choose New Simple Volume.
Page 47
Chapter II. FCoE Storport Miniport v. Enter the volume size (the entire volume size is selected by default), and in the subsequent windows assign a driver letter to the volume and choose the file system. Figure 14 - Specifying Volume size Figure 15 - Assigning drive letter or path Chelsio Unified Wire for Windows...
Page 48
Chapter II. FCoE Storport Miniport Figure 16 - Formatting the partition vi. Click Finish to close the wizard. Figure 17 - Completing Simple Volume Wizard Chelsio Unified Wire for Windows...
Page 49
Chapter II. FCoE Storport Miniport vii. The volume should appear in My Computer. Figure 18 - The newly created volume in My Computer Troubleshooting Always enable LLDP on the interfaces as there won’t be FCoE link up until and unless a successful LLDP negotiation happens.
Chapter III. Appendix 1. Troubleshooting Installer issues In case of any failures while running the Chelsio Unified Wire Installer, please collect the below: • Screenshot of the failure • Installer Log file from C:\Windows\Temp\ChelsioUwire_x.x.x.x_WIN_y.y.y_devlog.log Logs collection In case of any driver/firmware issues, follow the below procedure to collect the standard logs: •...
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 53
Chapter III. Appendix 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.
Page 54
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...
Need help?
Do you have a question about the Terminator Series and is the answer not in the manual?
Questions and answers