**************************************** README **************************************** Chelsio FCoE Initiator for Windows Version : 2.0.9.0_WIN_006.0.100 Date : 04/25/2023 Overview ================================================================================ Chelsio FCoE Initiator package for Windows provides installation of 64-bit Windows based drivers and tools for Chelsio's Unified Wire adapters. It consists of the following component(s): - FCoE Storport Miniport Driver v2.0.9.0 - Virtual Bus Driver (VBD) v6.16.9.1 ================================================================================ CONTENTS ================================================================================ - 1. Supported Operating Systems - 2. Supported Cards - 3. How to Use - 4. Support Documentation - 5. Customer Support 1. Supported Operating Systems ================================================================================ The Chelsio Unified Wire software has been developed to run on Windows based platforms. Following is the list of Drivers/Software and supported Windows version(s). |########################|#####################################################| | Windows Version | Driver/Software | |########################|#####################################################| |Server 2022 |FCoE | |------------------------|-----------------------------------------------------| |Server 2019 |FCoE | |------------------------|-----------------------------------------------------| |11 Client |FCoE | |------------------------|-----------------------------------------------------| |10 Client |FCoE | |------------------------------------------------------------------------------| NOTE: Drivers are WHQL certified. Other versions have not been tested and are not guaranteed to work. 2. Supported Cards ================================================================================ Following is the list of drivers/software and supported Chelsio adapters: - T6225-CR - T6225-LL-CR - T520-CR - T520-LL-CR - T540-CR NOTE: T4 family of adapters are not supported. 3. How to Use ================================================================================ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Chelsio Unified Wire ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Pre-requisites ============== - Latest Microsoft Visual C++ Redistributable Packages for Visual Studio (x86 and x64) are required if you are planning to use installer. - Windows update KB2685811 should be installed on Windows 7 Client and 2008 R2 Server. It will be installed if "Automatic Updates" is configured or can be installed manually from https://www.catalog.update.microsoft.com/Search.aspx?q=KB2685811 Installation ============ Chelsio Unified Wire can be installed using the Installer or the Zip package. Refer the appropriate section below depending on the method of installation. IMPORTANT: If you are planning to install Unified Wire in a cluster, it should be done on all the members. Using different versions of Unified Wire is not supported. Unified Wire Installer (Windows GUI Machine) -------------------------------------------- Enabling Test Signing ---------------------- In case the drivers in the package are not WHQL certified, follow the steps mentioned below to enable test signing on your system: a) Goto Start->Run command option, enter "cmd" and press OK. This will open the command prompt utility. b) Run the following command: C:\Users\Administrator> bcdedit /set testsigning on c) Reboot the machine for the changes to take effect. GUI Based Installation ---------------------- a) Run the "ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.exe" application. b) Click the Next button for the Chelsio End User License Agreement Window. c) Select the radio button "I accept the terms of the license agreement" and click on "Next" button. d) Select "Complete" for complete package installation. e) "Set NIC parameters to default values" is auto-selected during the installation. Click Next. f) Now clicking on "Install" button will start installation with the selected options. g) Click on the "Finish" button to exit from the installer. CLI Based (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. The NIC parameters will be reset to default values during installation. Existing NIC parameters will be retained during update operation. To know more about other parameters and options, execute the following command: C:\Users\Administrator>ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.exe -help The above command will create a help file, ChelsioUwire_x.x.x.x_WIN_yyy.y.yy_help.txt, in the present working directory which contains the complete list of command line syntax required for performing all the necessary CLI operations. NOTE: A log file, ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.log, is created in the same directory which keeps a record of all the commands executed and their results. Zip Package ----------- Enabling Test Signing --------------------- In case of non-WHQLed drivers, please follow the steps mentioned below to enable test signing before installing Unified Wire: a) Open command prompt and run the following command to enable test signing: C:\Users\Administrator>bcdedit /set testsigning on b) Change your working directory to "ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\Selfsign\" and run the following commands: C:\ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\Selfsign> .\certmgr.exe -add .\chelsiocert1.cer -s -r LocalMachine root -all C:\ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\Selfsign> .\certmgr.exe -add .\chelsiocert1.cer -s -r LocalMachine trustedpublisher -all c) Reboot the machine for the changes to take effect. Drivers location ---------------- The driver files should be manually picked from: - ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\drivers\Win19 for Server 2022, 2019 and 11 Client. - ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\drivers\Win10 for Server 2016 and 10 Client. Manual Installation ------------------- In Manual method, the driver components will have to be individually installed using the Device Manager. Please refer User's Guide for instructions. The components must be installed strictly in the order specified in the document. Any other order is not supported. Offline Windows Image --------------------- You can use Windows Deployment Image Servicing and Management (DISM) tool to add Chelsio driver components (.inf files) to an offline Windows image. For more information, visit the following links: - http://technet.microsoft.com/en-us/library/hh825070.aspx - http://blogs.technet.com/b/heyscriptingguy/archive/2012/09/27/use-the-powershell-dism-cmdlets-to-manage-windows-8.aspx Firmware Update =============== The driver will auto-load firmware (v1.27.3.0) 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 \ChelsioUwire\Firmware\ folder during installation. For the zip package, the binaries will be present in ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\firmware\ folder. Un-installation =============== Installer --------- GUI --- a) Run the "ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.exe" application. b) Select the radio button "Remove" and click "Next". c) Click on the "Finish" button to exit from the installer. NOTE: This method of uninstallation is possible only if the drivers were installed using Unified Wire Installer. CLI --- To uninstall the FCoE and NIC drivers, execute the following command: C:\Users\Administrator>ChelsioUwire_x.x.x.x_WIN_yyy.y.yy.exe -un all Zip Package ----------- If the driver components were installed using the zip package, they will have to be uninstalled manually. Please refer to User's Guide for step-by-step instructions. IMPORTANT: The driver components must be uninstalled manually and strictly in the order specified in the document. Any other order is not supported. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ FCoE Storport Miniport ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ FCoE fabric discovery verification ================================== Verifying Target Discovery --------------------------- a) Go to Start->Control Panel->Device Manager or launch device manager directly from Start->Run->devmgmt.msc and hit [Enter]. b) Go to "Disk drives" section under which you will find the list of all the LUNS that were discovered. c) To bring the LUNs online, launch disk management by going to Start->Run->diskmgmt.msc. Right click on the LUN and select "online". d) 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". This will invoke the "New Simple Volume Wizard". e) 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. f) Click "Finish" to close the wizard. g) The volume should appear in "My Computer". NOTE: For information on Switch configuration, please refer User's Guide. 4. Support Documentation ================================================================================ The documentation for this release can be found in the following directory in the system: Windows Unified Wire Installer (after installation): \ChelsioUwire\docs\ Zip Package: ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\docs\ It contains: - README - Release Notes - User's Guide 5. Customer Support ================================================================================ Installer issues ---------------- In case of any failures while running the Chelsio Unified Wire Installer, please collect the below: a) Screenshot of the failure. b) Installer logs from \Windows\Temp\ChelsioUwire_x.x.x.x_WIN_yyy.y.y_logs directory. Compress the directory to a zip package. Logs collection --------------- In case of any other issues, follow the below procedure to collect the standard logs: a) Download Get-NetView.psm1 file from https://github.com/microsoft/Get-NetView and run the below commands: PS C:\Users\Administrator\Desktop> Set-ExecutionPolicy Unrestricted PS C:\Users\Administrator\Desktop> Import-Module Get-NetView.psm1 b) Run the below command and the logs will be collected in a zip package. PS C:\Users\Administrator\Desktop> get-netview c) Driver Event tracing logs can be collected using the below procedure: - Start the tracing. PS C:\Users\Administrator\Desktop> cxgbtool debug trace nic 0xffff 5 vbd 0xffff 5 - Rerun the test to hit the observed issue. - Stop tracing. PS C:\Users\Administrator\Desktop> cxgbtool debug trace stop cxgbtrace.etl file will be collected in the same path. In case of BSOD, please collect the MEMORY.DMP from \Windows\ It is recommended to provide complete memory dump. Change the memory dump setting from: Control Panel -> System -> Advanced system settings -> Advanced -> Startup and Recovery Settings -> System Failure -> Write Debugging Information -> Complete memory dump Please contact Chelsio support at support@chelsio.com with relevant logs for any issues. ******************************************************************************** Copyright (C) 2023 Chelsio Communications. All Rights Reserved. The information in this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Chelsio Communications. Chelsio Communications assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without the express written consent of Chelsio Communications.