Chapter I. Chelsio Unified Wire 1. Introduction Thank you for choosing Chelsio T5/T4 Unified Wire adapters. These high speed, single chip, single firmware cards provide enterprises and data centers with high performance solutions for various Network and Storage related requirements.
6. For maximum performance, it is highly recommended to install the adapter into a PCIE x8 slot. 7. Holding the Chelsio adapter by the edges, align the edge connector with the 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.
Chapter I. Chelsio Unified Wire 3. Software/Driver Installation Chelsio Unified Wire Installer provides two methods of installation: GUI and CLI mode. GUI mode provides an interactive GUI installer with customizable options. Whereas, CLI mode enables unattended installation of Chelsio drivers and software thereby relieving the user from monitoring the installation process and providing input via dialog boxes.
Installing Unified Wire 3.2.1. GUI mode (Installer) 1. Run the ChelsioUwire-x.x.x.x.exe installer application. 2. Click the Next button for the Chelsio End User License Agreement Window. Figure 3.2 (a) – Unified Wire Installer welcome window Chelsio T5/T4 Unified Wire for Windows...
Page 12
Chapter I. Chelsio Unified Wire 3. Select the radio button I accept the terms of the license agreement and click Next. Figure 3.2 (b) – Chelsio EULA window Chelsio T5/T4 Unified Wire for Windows...
Page 13
Chapter I. Chelsio Unified Wire 4. Now, either select Complete for complete package installation or else select Custom radio button to customize the installation. Figure 3.2 (c) – Select setup (installation) type Chelsio T5/T4 Unified Wire for Windows...
Page 14
Chapter I. Chelsio Unified Wire If you select Custom, you can choose whether to install Network driver or not. Figure 3.2 (d) – Customizing the installation Chelsio T5/T4 Unified Wire for Windows...
Page 15
Chapter I. Chelsio Unified Wire 5. Click Install to start the installation. Figure 3.2 (e) – Start Installation Chelsio T5/T4 Unified Wire for Windows...
Page 16
Chapter I. Chelsio Unified Wire 6. Selected drivers will now be installed. Figure 3.2 (f) – Installation in progress Chelsio T5/T4 Unified Wire for Windows...
Page 17
Chapter I. Chelsio Unified Wire 7. After successful installation of driver(s), the Unified Wire Manager installer will be invoked. Click the Next button for the Chelsio End User License Agreement Window. Figure 3.2 (g) – UM installer welcome window Chelsio T5/T4 Unified Wire for Windows...
Page 18
Chapter I. Chelsio Unified Wire 8. Select the radio button I accept the terms of the license agreement and click Next. Figure 3.2 (h) – Chelsio EULA window Chelsio T5/T4 Unified Wire for Windows...
Page 19
9. The next window will display the pre-requisites for various UM components. Ensure that they are met before proceeding. Click Next. Figure 3.2 (i) – UM prerequisites window If prerequisites mentioned are not met, installation of UM will fail. Driver Note installation will however continue. Chelsio T5/T4 Unified Wire for Windows...
Page 20
Chapter I. Chelsio Unified Wire 10. Now, either select Complete for complete package installation or else select Custom radio button to customize the installation. Click Next. Figure 3.2 (j) – Select setup (installation) type Chelsio T5/T4 Unified Wire for Windows...
Page 21
If you selected Custom, the next window will display the location where UM will be installed by default. You can change the location by using the Change button or click Next to continue with the default path. Figure 3.2 (k) – Changing UM installation path Chelsio T5/T4 Unified Wire for Windows...
Page 22
Figure 3.2 (l) – Selecting UM components to install If Management Station is selected, please make sure that all related Note prerequisites are met before proceeding (See Pre-requisites) or else the component will be skipped during installation. Chelsio T5/T4 Unified Wire for Windows...
Page 23
Chapter I. Chelsio Unified Wire 11. Click Install to start the installation. Unified Wire Manager will now be installed with the selected options. Figure 3.2 (m) – Starting UM installation Chelsio T5/T4 Unified Wire for Windows...
Page 24
Chapter I. Chelsio Unified Wire 12. Select Finish to exit the UM Installer. Figure 3.2 (n) – Finishing UM installation Chelsio T5/T4 Unified Wire for Windows...
Page 25
3.2.2. CLI mode (Silent Installation) To install drivers using this feature, open command prompt and execute the following command: C:\Users\Administrator>ChelsioUwire-x.x.x.x.exe –in <driver(s)> E.g.: C:\Users\Administrator>ChelsioUwire-x.x.x.x.exe –in all The above command will install all the drivers/software. Chelsio T5/T4 Unified Wire for Windows...
Page 26
CLI operations. A log file, ChelsioUwire-x.x.x.x.log, is created in the same directory which keeps Note a record of all the commands executed and their results. Chelsio T5/T4 Unified Wire for Windows...
PS C:\Users\Administrator> .\ChelsioUwire-x.x.x.x.exe -sampleconfig The above command will generate a sample configuration file, RemoteMachineconfig.txt. It contains the following directives: StartShareMachineInfo ExecutablePath:\\<Machine-IP>\<Shared directory>\ChelsioUwire-x.x.x.x.exe User:<user> Password:<password> EndShareMachineInfo StartOfCluster <user>:<Password> <IPAddress1> <IPAddress2> <IPAddress3> <IPAddressN> EndOfCluster StartOfNonCluster <IPAddress1>:<user1>:<Password1> Chelsio T5/T4 Unified Wire for Windows...
Page 28
10.193.184.78:admin:pass_456 4. Save the file to a desired location. For successful deployment of UM components and flashing/erasing option ROM, Note please ensure that the host machine and remote nodes are in the same domain. Chelsio T5/T4 Unified Wire for Windows...
Deploying components and Flashing Option ROM together. Deploying components and Flashing Option ROM separately. Both methods mentioned above will flash option ROM only onto the first Chelsio Note adapter present in the remote node. If you plan to flash more adapters in the same node or add new nodes to the cluster, they will have to be added as members to a group and flashed using UM’s CLI component.
Page 30
Chapter I. Chelsio Unified Wire 2. Click the Next button for the Chelsio End User License Agreement Window. Figure 4.2.1 (a) – UM Installer welcome window Chelsio T5/T4 Unified Wire for Windows...
Page 31
Chapter I. Chelsio Unified Wire 3. Select the radio button I accept the terms of the license agreement and click Next. Figure 4.2.1 (b) – Chelsio EULA Window Chelsio T5/T4 Unified Wire for Windows...
Page 32
Chapter I. Chelsio Unified Wire 4. The next window will display the pre-requisites for various UM components. Ensure that they are met before proceeding. Click Next. Figure 4.2.1 (c) – UM prerequisites window Chelsio T5/T4 Unified Wire for Windows...
Page 33
Chapter I. Chelsio Unified Wire 5. Now, select Custom radio button to customize the installation. Click Next. Figure 4.2.1 (d) – Select setup (installation) type Chelsio T5/T4 Unified Wire for Windows...
Page 34
The next window will display the location where UM will be installed by default. You can change the location by using the Change button or click Next to continue with the default path. Figure 4.2.1 (e) – Changing UM installation path Chelsio T5/T4 Unified Wire for Windows...
Page 35
Chapter I. Chelsio Unified Wire Next, ensure that only Client is selected under features to be installed. Click Next. Figure 4.2.1 (f) – Selecting UM components to install Chelsio T5/T4 Unified Wire for Windows...
Page 36
Chapter I. Chelsio Unified Wire 6. Click Finish to complete Client installation. Figure 4.2.1 (g) – Finishing UM installation Chelsio T5/T4 Unified Wire for Windows...
Page 37
7. Now, installation of UM Agent component on remote nodes will commence. Figure 4.2.1 (h) – Starting Agent installation 8. Click Agree on the PsExec License Agreement Window that appears. This window will appear only during first installation. Figure 4.2.1 (i) – PsEXec License Agreement Chelsio T5/T4 Unified Wire for Windows...
Page 38
Option ROM to fail on remote nodes. UM components will have to be deployed again to fix this issue. 10. Option ROM will now be flashed onto adapters on remote nodes present in the OptionROM group. Figure 4.2.1 (k) – Flashing option ROM Chelsio T5/T4 Unified Wire for Windows...
Page 39
Deploying UM Components 1. Run the following command to invoke the Unified Wire Installer. PS C:\Users\Administrator> .\ChelsioUwire-x.x.x.x.exe -action deployagent –config <config_file.txt> 2. Follow steps 2-9 in the Deploying UM components and Flashing Option ROM together section. Chelsio T5/T4 Unified Wire for Windows...
Page 40
PS C:\Users\Administrator> .\ChelsioUwire-x.x.x.x.exe –action flashoptionrom 2. Flashing Option ROM is possible only if UM Agents were installed on nodes using this installer. Click Yes to continue. Figure 4.2.2 (b) – Starting option ROM flashing Chelsio T5/T4 Unified Wire for Windows...
Installer. 4.3. Erasing Option ROM Unified Wire Installer will erase option ROM only from the first Chelsio adapter Note present in the remote node. If you plan to erase from more adapters in the same node or add new nodes to the cluster, they will have to be added as members to a group and erased using UM’s CLI component.
Note location where UM Client is installed. Typically, this will be C:\Program Files (x86)\Chelsio Communications\UnifiedWireManager\client. To avoid this and run the command from any path, you will need to reboot the host. The following examples assume that the host machine was rebooted before running commands.
Page 43
To add a member to a group, run the following command: PS C:\Users\Administrator> chelsio_uwcli.exe –m addmember grpname=<group_name> details=”<IP_address>;<user_id>;<password>;*;*,*,<adapter_index>,*,*,*,*,*>” E.g. PS C:\Users\Administrator> chelsio_uwcli.exe –m addmember grpname=OptionROM details=”10.193.185.107;administrator;cdrom888;*;*,*,0,*,*,*,*,*>” Figure 4.4.1 (b) – Adding member to group Chelsio T5/T4 Unified Wire for Windows...
Page 44
Figure 4.4.1 (c) – Viewing group and member details Delete member from a group To delete a member from a group, run the following command: PS C:\Users\Administrator> chelsio_uwcli.exe –m deletemember grpname=<group_name> index=<member_index> E.g. PS C:\Users\Administrator> chelsio_uwcli.exe –m deletemember grpname=OptionROM index=1 Chelsio T5/T4 Unified Wire for Windows...
Page 45
Figure 4.4.1 (d) – Deleting member from group Delete Group To delete a group, run the following command: PS C:\Users\Administrator> chelsio_uwcli.exe –m deletegroup grpname=<group_name> E.g. PS C:\Users\Administrator> chelsio_uwcli.exe –m deletegroup grpname=OptionROM Figure 4.4.1 (e) – Deleting group Chelsio T5/T4 Unified Wire for Windows...
Page 46
Unified Wire Installer. Viewing status You can list the adapters on local host and verify if Option ROM was successfully flashed using the following command: PS C:\Users\Administrator> chelsio_uwcli.exe chelsio listadapters –B <group_name> Chelsio T5/T4 Unified Wire for Windows...
Page 47
In addition to flashing and erasing Option ROM, you can perform additional bulk operations on remote nodes like setting MTU and VLAN ID, changing adapter and port parameters, etc. To know more about these options available, run the following command: PS C:\Users\Administrator>chelsio_uwcli.exe -B Chelsio T5/T4 Unified Wire for Windows...
Page 48
Chapter I. Chelsio Unified Wire Figure 4.4.2 (c) – Erasing option ROM using UM CLI 4.4.3. Help To view Unified Wire Manager’s CLI help, run the following command: PS C:\Users\Administrator>chelsio_uwcli.exe –m Chelsio T5/T4 Unified Wire for Windows...
Chapter I. Chelsio Unified Wire 5. Firmware Update The driver will auto-load the T5 and T4 firmwares if an update is required. The firmware version can be verified using cxgbtool: C:\Users\Administrator> cxgbtool nic0 version Chelsio T5/T4 Unified Wire for Windows...
Chapter I. Chelsio Unified Wire 6. Software/Driver Uninstallation Similar to installation, Chelsio Unified Wire can be uninstalled using two methods: GUI and CLI mode. GUI mode requires user interaction and uninstallation occurs with options specified by the user. Whereas, CLI mode does not require any user input.
Page 51
Note Unified Wire Manager. You will have to manually uninstall it using “Programs and Features” in the Control Panel. 6.1.2. CLI Mode To uninstall all the drivers, execute the following command: C:\Users\Administrator>ChelsioUwire-x.x.x.x.exe –un all Chelsio T5/T4 Unified Wire for Windows...
For any distribution specific problems, please check README and Release Notes included in the release for possible workaround. Please visit Chelsio support web site http://service.chelsio.com/ for regular updates on various software/drivers. You can also subscribe to our newsletter for the latest software updates. Chelsio T5/T4 Unified Wire for Windows...
Chapter II. NDIS Function 1. Introduction Chelsio’s T5/T4 series of Unified Wire Adapters provide extensive support for NIC operation, including all stateless offload mechanisms for both IPv4 and IPv6 (IP, TCP and UDP checksum offload, LSO - Large Send Offload aka TSO - TCP Segmentation Offload, Network Direct and assist mechanisms for accelerating LRO - Large Receive Offload).
2.1. Assigning IP address to the Chelsio Network Adapter 1. Double click on the Network Connections icon and choose the Chelsio card entry and double click it. 2. Click on the Properties button from the Local Area Connection X Status.
Page 56
To see all tunable NDIS Miniport Driver parameters, open the Device Manager (Control Panel - > System & Security-> System -> Device Manager), click on the Network adapters, double click on any Chelsio Network Adapter, and then click the Advanced tab. Flow Control: ...
Page 57
Receive Side Scaling (RSS): Description: This parameter controls the RSS functions. If on, the Microsoft RSS function is enabled. If off, the Chelsio RSS function is enabled. Value: Enabled | Disabled Default: Enabled Chelsio T5/T4 Unified Wire for Windows...
Page 58
Description: This parameter is used to set different Offload Rx Queue sizes. Driver ships with reasonable defaults. Value: 256-2048 Default: 512 This feature is not fully tested and available for experimental usage only. Note Chelsio T5/T4 Unified Wire for Windows...
Page 59
Description: This parameter is used to set different Offload Tx Queue sizes. Driver ships with reasonable defaults. Value: 256-4096 Default: 512 This feature is not fully tested and available for experimental usage only. Note Chelsio T5/T4 Unified Wire for Windows...
Page 60
VMQ VLAN ID Filtering: Description: Enable or disable the ability to filter network packets by using the VLAN identifier in the media access control (MAC) header. Value: Enabled | Disabled Default: Enabled Chelsio T5/T4 Unified Wire for Windows...
Enabling SMB Direct SMB Direct is installed and enabled by default on Windows Server 2012 R2 systems. RDMA functionality on Chelsio adapters will be enabled after installing the driver from the package. You can use the following PowerShell command Get-NetAdapterRdma to get a list of RDMA capable interfaces in your system.
Page 62
Verify that SMB driver is loaded and working. Open PowerShell window and execute the following command : C:\Users\Administrator> driverquery.exe | findstr /I smb Verify that Chelsio driver is loaded and working. Open PowerShell window and execute the following command : C:\Users\Administrator> driverquery.exe | findstr /I chel ...
Chelsio hardware installed in the system. The software includes a command line interface (CLI) tool and a web management interface (Web GUI) to help you manage all Chelsio network adapter cards on the network across multiple operating systems.
The Management Agent is a binary executable, which runs as a service on the system that has at least one Chelsio card installed. It is installed along with libraries that can manage various components of the system and enabled during system startup.
The authentication credentials, as well as all data exchanged between the CLI client or the Web GUI and the agent, are encrypted using SSL. This ensures that the data cannot be accessed when it is being transmitted over the network. Chelsio T5/T4 Unified Wire for Windows...
Chapter III. Unified Wire Manager (UM) 2. Hardware and Software 2.1. Supported Adapters Following are the currently shipping Chelsio Adapters that are compatible with Chelsio Unified Wire Manager: T5 Adapters T520-CR T4 Adapters T420-CR T440-CR T422-CR ...
Chapter III. Unified Wire Manager (UM) 2.3. Platform/Driver Matrix The table below lists the Chelsio T5/T4 driver(s) and their supported versions: Chelsio driver Version 5.1.29.0 Chelsio T5/T4 Unified Wire for Windows...
Chapter III. Unified Wire Manager (UM) 3. Installing Unified Wire Manager Chelsio Unified Wire has been designed to install Unified Wire Manager (UM) by default. Hence, no separate installation is required. Chelsio T5/T4 Unified Wire for Windows...
2. Perform following tasks C:\Program Files (x86)\Apache Software Foundation\Apache2.2\Conf\httpd.conf file Change "DocumentRoot" to “C:/Program Files (x86)/Apache Software Foundation/Apache2.2/htdocs/chelsio” Uncomment "LoadModule rewrite_module modules/mod_rewrite.so" iii. Uncomment "Include conf/extra/httpd-ssl.conf" Uncomment "LoadModule ssl_module modules/mod_ssl.so" Add the following lines: Chelsio T5/T4 Unified Wire for Windows...
Page 71
Uncomment the following line SSLSessionCache "dbm:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache" Comment the following line SSLSessionCache "shmcb:C:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/ssl_scache(512000)" Use the Windows Event Log (Event Viewer) for troubleshooting any installation Note related issues. Chelsio T5/T4 Unified Wire for Windows...
Verifying Management Agent 1. On the system running Management Agent, launch Services from the Control Panel. You can also type services.msc in the Run command. This will open the Services window. Figure 5.1(a) – Windows Services Chelsio T5/T4 Unified Wire for Windows...
2. Search for Unified Wire Management Station in the list of services. You should get the options to stop,start and restart the service in the Actions menu on the left side. Figure 5.3 – Verifying Management Station service status Chelsio T5/T4 Unified Wire for Windows...
Page 74
Chapter III. Unified Wire Manager (UM) While accessing the Web Management Interface, if an error “Management Note Station is not running” is displayed at the log-in page, follow the above steps to restart Management Station and try again. Chelsio T5/T4 Unified Wire for Windows...
If there is a firewall appliance / software protecting the network that the system is on, and you wish to connect to the system from a different network, using the client, the firewall appliance also needs to be configured appropriately. Chelsio T5/T4 Unified Wire for Windows...
Also, two different Web GUI or CLI clients cannot connect to a management agent at the same time. There is no mechanism to allow this scenario. Chelsio T5/T4 Unified Wire for Windows...
2. Search for “Apachex.x” in the list of services and click Start in the Action menu on the left. Figure 8.1.1 (a) – Starting Apache HTTP server 3. Search for “Unified Wire Management Station” and click Start in the Action menu on the left. Figure 8.1.1(b) – Starting Management Station service Chelsio T5/T4 Unified Wire for Windows...
You will need to select the correct option to continue. Security Certificate prompt in Internet Explorer Figure 8.2 (a) - Security Certificate prompt in Mozilla Firefox Figure 8.2 (b) - Chelsio T5/T4 Unified Wire for Windows...
Page 79
Login button. Figure 8.2 (e) - Web GUI Login page Not performing any operation/action for 5 minutes will result in session timeout. Note You will have to re-login and connect to the Agents again. Chelsio T5/T4 Unified Wire for Windows...
Navigation Pane. The panels can be expanded and collapsed by clicking on the panel heading. The Bottom bar has the About link on the right and copyright details on the left. Figure 8.3 – Web Management Interface Chelsio T5/T4 Unified Wire for Windows...
The passwords are encrypted, but it is still advisable to store passwords only if the system you are running the GUI client on, is secure. Figure 8.4.1 (a) - Bookmarks and history module Chelsio T5/T4 Unified Wire for Windows...
Page 82
Select the system from the Bookmark list and click Delete system to remove it. Once removed, the system will no longer appear in the Bookmarks and History Note module. If you wish to manage that system again, you will have to use the “Add system” option. Chelsio T5/T4 Unified Wire for Windows...
Page 83
Installing Driver 1. In the Choose the card fields, select T3 or T4/T5 depending on the chip revision of the network card. 2. Select the operating system for which drivers are to be installed in the Choose the OS Type field.
Page 84
Chapter III. Unified Wire Manager (UM) 3. Select a system or systems from the list and choose the driver to be installed in the Driver Installation section. 4. Download the appropriate driver from Chelsio’s Download Center, service.chelsio.com. 5. Locate the driver package.
Page 85
Use this option to disconnect an Agent. To remove an agent, click on the name of the system in the tree menu in the left and click Remove System. Then click Yes to confirm. Figure 8.4.3 - Removing a UM Agent Chelsio T5/T4 Unified Wire for Windows...
Page 86
This feature is available only on the Web Management Interface. Using this option, you can receive email alerts regarding the link status of a Chelsio Network Interface Card. This feature sends email notifications regarding the port and the card, on which the link up/down event has occurred.
Page 87
Various configurable parameters have been categorized into several modules like Boot Configuration module to install and erase option ROM, Network Configuration module to set MTU and VLAN ID, Card Configuration module to change driver parameters, etc. Chelsio T5/T4 Unified Wire for Windows...
Page 88
MTU size of a network interface (in the Network Configuration module), create a group with group type Network. To install or erase option ROM on a Chelsio T4 adapter (in the Boot Configuration module), create a group with group type t4adapter.
Page 89
Figure 8.4.6 (b) – Managing a group Boot Configuration Using this module, you can install option ROM or erase option ROM on Chelsio network devices. The Set Default Boot Settings button will reset the adapter to factory boot settings. Figure 8.4.6 (c) – Boot Configuration module...
Page 90
MTU can be set between 1500-9000 bytes. VLAN id can be set for an adapter within the range 0-4094 (enter 0 to disable it). The IP type can be static or DHCP. Figure 8.4.6 (d) – Network Configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 91
The Card Configuration module allows you to set various adapter settings including TCP Offload. Offload settings are only available when using the TOE capable drivers (t3_tom and toecore for T3 cards; t4_tom and toecore for T4 cards). Figure 8.4.6 (e) – Card Configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 92
In the Port Configuration module, you can set various port settings like enabling Tx checksum and TCP segmentation offload, setting Link speed and link duplex mode, etc. The settings depend on the device driver installed. Figure 8.4.6 (f) - Port Configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 93
Chapter III. Unified Wire Manager (UM) Bypass Configuration Use the Bypass Configuration module to configure Chelsio’s bypass adapters like B420-SR and B404-BT. Figure 8.4.6 (g) - Bypass Configuration module Chelsio T5/T4 Unified Wire for Windows...
The system page contains generic system and support modules which are discussed below: 8.5.1. System summary This module lists the system Hostname, Operating System, platform and also gives the count of the Chelsio cards found. Figure 8.5.1 (a) - System Summary module Chelsio T5/T4 Unified Wire for Windows...
Page 95
Chapter III. Unified Wire Manager (UM) 8.5.2. Drivers Installation Using this module, one can install various Chelsio drivers for different operating systems. Figure 8.5.2 (a) - Drivers Installation module connected to Windows Agent Chelsio T5/T4 Unified Wire for Windows...
Page 96
Chapter III. Unified Wire Manager (UM) 8.5.3. Driver Details A list of Chelsio device drivers with related information like driver description, version, current load status and installation date is shown in this module. To load or unload a particular driver, select the appropriate option (Yes to load, No to unload) in the corresponding cell of the Loaded column and click Load/Unload Driver button.
Page 97
Chapter III. Unified Wire Manager (UM) 8.5.4. System Diagnostics Using this module, you can run various diagnostic tests on Chelsio adapters to troubleshoot adapter related issues. Select the adapter(s) from the list for which you want to run the test, select the operation (type of test;...
Page 98
A list of the Unified Wire Manager agent components installed on the managed system is shown in this module. The versions of the components are useful in case of reporting an issue to support. Figure 8.5.5 - Unified Wire Manager Component Versions module Chelsio T5/T4 Unified Wire for Windows...
Page 99
The properties box will display the domain state of the machines selected. Now, click on any of the system power actions provided at the bottom. Figure 8.5.6 - VM Configurations module Chelsio T5/T4 Unified Wire for Windows...
Page 100
Chapter III. Unified Wire Manager (UM) 8.5.7. Managed system application logs The management agent logs its activities and any errors that occur, in /var/log/chelsio in Linux and FreeBSD and in the Event log, in Windows. This log can be obtained in this module. Only 20 entries can be obtained and viewed at a time.
8.6.1. Network summary The Network Summary module provides the total number of Chelsio adapters present, including the number of T5, T4 and T3 adapters. It also provides the total number of Network interfaces including corporate and Chelsio interfaces and VLANs.
Page 102
Chapter III. Unified Wire Manager (UM) 8.6.2. Chelsio card page When a Chelsio card is selected in the tree menu on the left, this page is displayed. It provides details of the card and associated settings. It also displays any card specific statistics that the hardware provides.
Page 103
Highlight the system item in the tree menu on the left, and click "Refresh", to refresh data from the system, in case the updated settings are not being shown. Figure 8.6.2 (b) - TCP Offload Settings module for a FreeBSD Agent Chelsio T5/T4 Unified Wire for Windows...
Page 104
Chapter III. Unified Wire Manager (UM) Device Driver settings (Windows) The device driver settings applicable to the card are shown here. For Chelsio T5 and T4 adapters, only the MaxVMQueues field will be displayed. On changing the settings, the changed settings may not reflect immediately on refreshing the data.
Page 105
Chelsio card's port The port page is displayed on selecting a port of a Chelsio card listed in the tree menu on the left. It provides details of the port and port settings. It also displays any port specific statistics that the hardware provides.
Page 106
Port settings Port settings such as MTU, Link speed and others can be set in this module. The settings depend on the device driver installed. Figure 8.6.2.1 (b) - Port Settings of T4 CNA Chelsio T5/T4 Unified Wire for Windows...
Page 107
Chapter III. Unified Wire Manager (UM) Port statistics Ethernet statistics and additional hardware statistics for the port are displayed in this module. Figure 8.6.2.1 (c) - Port Statistics of T4 CNA on Windows Agent Chelsio T5/T4 Unified Wire for Windows...
Page 108
0-4094 (enter 0 to disable it). You can use the View/Set IP addresses option to add, modify or delete IP aliases. Figure 8.6.3 (a) - System network configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 109
Chapter III. Unified Wire Manager (UM) Figure 8.6.3 (b) – Managing IP aliases Chelsio T5/T4 Unified Wire for Windows...
Page 110
Table view in the Advanced NIC characteristics. The polling time field sets the average time (in seconds) based on which the table/graph updates the report. Figure 8.6.3 (c) - System network statistics module Chelsio T5/T4 Unified Wire for Windows...
Page 111
Chapter III. Unified Wire Manager (UM) Figure 8.6.3 (d) - Network Throughput Vs Time instant Graph Figure 8.6.3 (e) - Network Throughput Vs Time instant Table Chelsio T5/T4 Unified Wire for Windows...
Page 112
Windows, you may set multiple default gateways. Use the option to set multiple default gateways with caution, since it may cause the system to stop communicating with external networks. Figure 8.6.3 (f) - Default gateway and DNS configuration module for a Windows Agent Chelsio T5/T4 Unified Wire for Windows...
Page 113
All modes may not be available with all configurations / combinations. Also, the team members can only be 2 ports of a single offload-enabled card, and not across Chelsio cards. Do not mix third party cards and offload-enabled Chelsio cards in a single team.
Page 114
Use the GetConnections utility to view currently active TCP/UDP connections. Offload status for each connection is also displayed if protocol offload hardware is available. This is useful for troubleshooting any connectivity issues for clients to various services. Figure 8.6.3 (h) - Ping Utility Chelsio T5/T4 Unified Wire for Windows...
Page 116
To do so, click on the virtual machine and click “Detach”. Similarly, detach all the virtual machines and then use the “Delete Switch” to delete the virtual network. Figure 8.6.3.1 (a) – Virtual Network Manager module Chelsio T5/T4 Unified Wire for Windows...
Page 117
Once created, you can manage the virtual networks in the Virtual Network Manager module. Figure 8.6.3.1 (b) – Creating external virtual network Figure 8.6.3.1 (c) – Creating internal virtual network Chelsio T5/T4 Unified Wire for Windows...
Page 118
To attach a virtual network to a virtual machine, select the virtual network from the Virtual Network list and the virtual machine from the VM list. Finally click Attach. Figure 8.6.3.1 (e) – Attaching Virtual Network to VM Chelsio T5/T4 Unified Wire for Windows...
Page 119
These settings can be set only when iWARP driver (iw_cxgb4 for T4 and T5; iw_cxgb3 for T3) is loaded. If you set any parameter for a T5 adapter, it applies for all the T5 adapters present. Same applies for T4 and T3 adapters.
Page 120
Chapter III. Unified Wire Manager (UM) Figure 8.6.4 (a) – iWARP settings for T4 CNA for FreeBSD Agent Chelsio T5/T4 Unified Wire for Windows...
Page 121
Chapter III. Unified Wire Manager (UM) Figure 8.6.4 (b) – iWARP settings for T4 CNA for Linux Agent Chelsio T5/T4 Unified Wire for Windows...
Figure 7.7 – Storage Summary Module 8.7.1. FCoE Initiator (Linux, Windows, XenServer) All supported Chelsio FCoE initiators available on the operating system can be managed from this page. FCoE support is extended on Linux, Windows and XenServer platforms. Please refer to Platform/Driver matrix section on the list of operating systems that are supported.
Page 123
Figure 8.7.1.1 (a) – FCoE Card Summary module FCoE Attributes Information such as Interrupt modes (MSI/MSI-X/INTx), SCSI mode and the card state are provided in this module. Figure 8.7.1.1 (b) – FCoE Attributes module Chelsio T5/T4 Unified Wire for Windows...
Page 124
NPIV management support. It contains the following sections: FCoE Port Summary The SCSI adapter name and the underlying ENODE MAC address of the physical port can be found here. Figure 8.7.1.2 (a) – FCoE Port Summary module for Linux Agent Chelsio T5/T4 Unified Wire for Windows...
Page 125
(10G/1G) being used. Note that only class 3 service is supported by the initiator for now and the frame size is fixed to 2128 bytes as per spec. Figure 8.7.1.2 (b) – FCoE Port Atrributes module for Linux Agent Chelsio T5/T4 Unified Wire for Windows...
Page 126
To delete a virtual port, select the option Delete and select the virtual port WWPN which you want to delete and click on delete. Figure 8.7.1.2 (c) – FCoE NPIV management module Chelsio T5/T4 Unified Wire for Windows...
Page 127
This module provides details about the discovered target such as target’s FC ID, WWPN and WWNN so that the user can identify the discovered target accordingly. Figure 8.7.1.3 (a) – FCoE Remort Port Attributes module Chelsio T5/T4 Unified Wire for Windows...
Page 128
This module provides the LUN information such as size of the LUN, SCSI address, and LUN address. For Linux, the SCSI address is displayed in H:C:T:L (Host:Channel:Target:Lun) format and for Windows, it is displayed in P:B:T:L(SCSI Port:Bus:Target:Lun) format. Figure 8.7.1.3 (b) – FCoE Remote Port Lun Details module Chelsio T5/T4 Unified Wire for Windows...
Page 129
FCoE Virtual Port Summary The SCSI adapter name and the underlying ENODE MAC address of the physical port can be found here. Figure 8.7.1.4 (a) – FCoE Virtual Port Summary module for Linux Agent Chelsio T5/T4 Unified Wire for Windows...
Page 130
(10G/1G) being used. Note that only class 3 service is supported by the initiator for now and the frame size is fixed to 2128 bytes as per spec. Figure 8.7.1.4 (b) – FCoE Virtual Port Attributes module Chelsio T5/T4 Unified Wire for Windows...
Page 131
LUN, SCSI address, and LUN address are provided. For Linux, the SCSI address is displayed in H:C:T:L (Host:Channel:Target:Lun) format and for Windows, it is displayed in P:B:T:L(SCSI Port:Bus:Target:Lun) format. Figure 8.7.1.4 (d) - FCoE Remote Port Lun Details module Chelsio T5/T4 Unified Wire for Windows...
Page 132
(Chelsio node cannot be disabled in Windows), and its properties can be viewed and edited in this module. In the Chelsio Linux stack, new initiator nodes can be created too. Disabling the initiator causes it to log out of any iSCSI targets that it is connected to, thus removing any disks provided by the iSCSI targets that were connected.
Page 133
Chapter III. Unified Wire Manager (UM) Figure 8.7.2 (b) - Microsoft iSCSI initiator Chelsio T5/T4 Unified Wire for Windows...
Page 135
(the IP address and TCP Port specified when discovering the target). If there are any pre-existing iSCSI sessions established to the target, deletion of Note the target Portal from the discovered targets list will fail. Figure 8.7.2 (d) - Discover targets module Chelsio T5/T4 Unified Wire for Windows...
Page 136
If a target is connected, the sessions and connections to the target, and the disks provided by the target will be listed. Figure 8.7.2 (e) - Targets module after logging in Chelsio T5/T4 Unified Wire for Windows...
Page 137
8.7.3. FO iSCSI Initiator (Linux) Full Offload iSCSI Hardware Information PCI, firmware and other adapter related details are provided in this module. Select the Chelsio adapter for which you want to view properties from the Select a T4 Card drop-down list and the module will expand to display related properties.
Page 138
Here you can configure various port settings like VLAN id, Maximum Transmission Unit (MTU) and IP. Select a Chelsio adapter from Select a T4 Card drop-down list and then select the port for which you want set any of the aforementioned properties. MTU can be set between 1500- 9000 bytes.
Page 139
In the FO iSCSI Initiator Properties module, you can configure FO iSCSI Initiator by setting different properties like enabling/disabling CHAP authentication, setting Header and Data digest, etc. Figure 8.7.3 (c) - FO iSCSI Initiator Properties Chelsio T5/T4 Unified Wire for Windows...
Page 140
In this module, you can set upto 8 instances. Configurable parameters include initiator node name (IQN), alias (friendly) name, Initiator (CHAP) Username and password. Figure 8.7.3 (d) - FO iSCSI Manage Instances module Chelsio T5/T4 Unified Wire for Windows...
Page 141
Chapter III. Unified Wire Manager (UM) FO iSCSI Discover Details iSCSI Targets can be discovered using this module. Select a Chelsio adapter and initiator instance using which you want to discover targets. Next, provide the source (initiator) and destination (target) IP. Finally, click Discover. After successful discovery, all the discovered targets will appear in the Discovered Targets section.
Page 142
CHAP for a secure iSCSI connection. One-way (target authenticates the initiator) and Mutual (target and initiator authenticate each other) authentication methods are supported. Figure 8.7.3 (f) - FO iSCSI Session Details module: Login Chelsio T5/T4 Unified Wire for Windows...
Page 143
Established sessions section. Select the Adapter and session id. Details of the selected session will be displayed. To end the session, click Logout. Figure 8.7.3 (g) - FO iSCSI Session Details module: Established Sessions Chelsio T5/T4 Unified Wire for Windows...
Page 144
Target properties is also available. The modules available on this page are as below: Target Stack Globals This module displays various global properties of a currently connected iSCSI target. Authentication priority between CHAP and ACL can be set here. Figure 8.7.4 (a) - Target Stack Globals module Chelsio T5/T4 Unified Wire for Windows...
Page 145
Properties such as Target name and Alias, Max Data Receive Length, Authentication mode related to a specific iSCSI target can be viewed and modified here. iSCSI targets can be started/stopped or deleted. Figure 8.7.4 (b) - Target properties module Chelsio T5/T4 Unified Wire for Windows...
Page 146
Chapter III. Unified Wire Manager (UM) Session details Details including Session ID, Initiator IQN and Connections List of all discovered and currently connected iSCSI targets are listed here. Figure 8.7.4 (c) – Session Details module Chelsio T5/T4 Unified Wire for Windows...
Page 147
Chapter III. Unified Wire Manager (UM) New Target Creation New iSCSI target can be created here by specifying the Target IQN and Target Alias name. Figure 8.7.4 (d) - New Target Creation module Chelsio T5/T4 Unified Wire for Windows...
Page 148
View/Edit iSCSI Target LUNs This module displays various Logical Units created in an iSCSI Target. Selected LUNs can be deleted. Figure 8.7.5 (a) - View/Edit iSCSI Target LUNs module Chelsio T5/T4 Unified Wire for Windows...
Page 149
Device and RAM Disk Size etc. RW (Read-Write) and RO (Read Only) are the two kinds of permissions that can be set. If Ram Disk is selected, then a minimum of 16 MB should be provided. Figure 8.7.5 (b) - Adding a new LUN Chelsio T5/T4 Unified Wire for Windows...
Page 150
Portal List on the left displays details of the portal group on which an iSCSI target is listening and the related info is displayed on the right under Portal Details. Selected portals can be deleted. Figure 8.7.6 (a) - View/Edit iSCSI Target Portals module Chelsio T5/T4 Unified Wire for Windows...
Page 151
Chapter III. Unified Wire Manager (UM) Add Portal New Portals can be added here by choosing the specific target and Portal IP address. The Port number should be 3260. Figure 8.7.6 (b) – Adding a new Portal Chelsio T5/T4 Unified Wire for Windows...
Page 152
View/Edit iSCSI Target ACLs This module displays details for all the ACLs configured for an iSCSI Target. Selected ACLs can be deleted. Figure 8.7.7 (a) - Target ACL operations module Chelsio T5/T4 Unified Wire for Windows...
Page 153
Chapter III. Unified Wire Manager (UM) Add ACL New ACLs can be configured by specifying Target name, initiator IQN name, IP address and permission type. Figure 8.7.7 (b) - Adding new ACL Chelsio T5/T4 Unified Wire for Windows...
Chapter III. Unified Wire Manager (UM) 8.8. Hardware Features The Hardware module lists the status of configuration modules under Hardware Features section, running on the agent. Figure 8.8 – Hardware module Chelsio T5/T4 Unified Wire for Windows...
Page 155
Note time to reflect. Highlight the system item in the tree menu on the left, and click "Refresh system", to refresh data from the system, in case the updated settings are not being shown. Chelsio T5/T4 Unified Wire for Windows...
Page 156
The FILTERID and T4 CARD fields are mandatory. After providing appropriate values for the parameters click “Save Changes”. For a detailed explanation regarding different fields, please refer cxgbtool Note manual by running man cxgbtool command on Management Agent CLI. Figure 8.8.1(b) - T4 Filtering Configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 157
(t3_tom for T3 adapters; t4_tom for T4 adapters). 8.8.3. Traffic Management configuration The Chelsio Card section on the left displays all the cards available in the server and their corresponding policies on the right. Policies can be added and deleted. Policy Details displays the primitives (maximum 8) and actions which can be modified.
Page 158
/ChelsioUwire- x.x.x.x/src/network/firmware. For instance, to select Low latency Networking, locate the file, t4- config.txt, in /ChelsioUwire-x.x.x.x/src/network/firmware/low_latency_config directory. Figure 8.8.4 - T4 Save Config File module Chelsio T5/T4 Unified Wire for Windows...
Page 159
8.8.5. T3 iSCSI / T3 PXE Boot Option Rom Management (Linux) The Chelsio T3 card may be used for PXE or iSCSI boot. This module allows managing the boot capability. The Option ROM (PXE/iSCSI) may be installed to the card, or erased from the card.
Page 160
8.8.6. T5/T4 Boot Option ROM management This module allows managing the PXE and FCoE boot capability for Chelsio T5 and T4 cards. The Option ROM (PXE and FCoE) may be installed to or erased from the card. The version of Option ROM flashed can be viewed here.
Page 161
FCoE targets. Enable the Option ROM only if you are planning to boot the system via PXE or install the operating system on FCoE LUN. Figure 8.8.7 (a) - PXE Boot configuration for T4 CNAs Chelsio T5/T4 Unified Wire for Windows...
Page 162
Figure 8.8.7 (c) - iSCSI Boot configuration for T4 CNAs 8.8.8. Bypass (Linux) You can use the Bypass page to configure various settings for Chelsio’s bypass adapters like setting bypass operation mode, creating rules (filters), starting/stopping BA server, etc. There are two modules available: Bypass Configuration and Redirect Configuration.
Page 163
The Watchdog timer is used to ensure that if there is a software failure, the switch will enter the default state. The Watchdog timeout value should be provided in milliseconds. Figure 8.8.8 (a) - Bypass Configuration module Chelsio T5/T4 Unified Wire for Windows...
Page 164
To edit an existing rule, select the corresponding checkbox, change the desired paremeters and click Save Changes. To delete a rule, select the corresponding checkbox and click Delete a Filter. Finally, click Save Changes. You can delete multiple rules using this method. Chelsio T5/T4 Unified Wire for Windows...
Page 167
Chapter III. Unified Wire Manager (UM) 8.8.9. T4 Egress Class Schedulers (Linux) Schedulers can be set only when T5/T4 network driver (cxgb4) is loaded. Egress Queue Map Using this module, you can bind (map) NIC (non-offloaded) Tx queues to Tx Scheduler classes.
Chapter III. Unified Wire Manager (UM) 9. Uninstalling Unified Wire Manager To uninstall Unified Wire Manager, use Programs and Features in the Control Panel. Chelsio T5/T4 Unified Wire for Windows...
Chapter IV. UM for Win PE 1. Introduction Chelsio UM for Win PE is a light-weight management tool developed for Windows PE (Windows Preinstallation Environment) platform and provides features to view and configure different aspects of the system, including Chelsio adapter installed.
Chapter IV. UM for Win PE 1.2. Software Requirements 1.2.1. Windows Requirement Currently Chelsio UM for Win PE is available for Windows server 2012 R2. Chelsio T5/T4 Unified Wire for Windows...
Examples 1.3.1. Viewing help Run the following command to view the list of commands available under a service. X:\windows\system32> chelsio_uwlite.exe <service-name> E.g. To view commands available under the chelsio service: X:\windows\system32> chelsio_uwlite.exe Chelsio Chelsio T5/T4 Unified Wire for Windows...
Page 173
Run the following command to view syntax and usage for a sub-command: X:\windows\system32> chelsio_uwlite.exe chelsio <sub-command> /? E.g. To view syntax and usage of EraseSettings sub-command under chelsio service: X:\windows\system32> chelsio_uwlite.exe chelsio erasesettings /? Chelsio T5/T4 Unified Wire for Windows...
Page 174
Chapter IV. UM for Win PE 1.3.2. Flashing Option ROM Run the following command to list all Chelsio CNAs present in the system. The list displays a unique index for each CNA found. X:\windows\system32> chelsio_uwlite.exe chelsio listadapters Now, run the following command to flash option ROM onto the adapter: X:\windows\system32>...
Page 175
Chapter IV. UM for Win PE 1.3.3. Erasing Option ROM Run the following command to list all Chelsio CNAs present on the system. The list displays a unique index for each CNA found. X:\windows\system32> chelsio_uwlite.exe chelsio listadapters Now, run the following command to erase option ROM from the adapter: X:\windows\system32>...
As Licensee, you own only the media upon which the Software is recorded or fixed, but Chelsio retains all right, title and interest in and to the Software recorded on the original media and all subsequent copies of the Software, regardless of the form or media in or on which the Software may be embedded.
Page 178
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.
Page 179
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.
Need help?
Do you have a question about the T5 and is the answer not in the manual?
Questions and answers