**************************************** README **************************************** Chelsio FCoE Initiator for Windows Version : 2.0.9.0_WIN_006.0.32 Date : 09/26/2018 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 v2.0.9.0 - Virtual Bus Driver (VBD) v6.11.4.1 NOTE: Drivers are WHQL certified. ================================================================================ 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 2016 |FCoE | |------------------------|-----------------------------------------------------| |10 AU Client |FCoE | |------------------------|-----------------------------------------------------| |Server 2012 R2 |FCoE | |------------------------------------------------------------------------------| 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 on Windows Server 2016 & 10 AU Client versions. 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. 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) Now clicking on "Install" button will start installation with the selected options. f) 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 drivers. 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\Win10 for Server 2016 and 10 AU Client. - ChelsioUwire_x.x.x.x_WIN_yyy.y.yy\drivers\Win7 for Server 2012 R2. 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.21.5.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: - 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 other driver/firmware issues, follow the below procedure to collect the standard logs: - Download the script from https://github.com/Microsoft/SDN/blob/master/Diagnostics/Get-NetView.PS1 - Run the script and the logs will be collected in a zip package. PS C:\Users\Administrator\Desktop> .\Get-NetView.PS1 Please contact Chelsio support at support@chelsio.com with relevant logs for any issues. ******************************************************************************** Copyright (C) 2018 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.