Installation in a Linux Environment | Q-Logic 8100 SERIES guide

4 Installation in a Linux Environment

Overview

This section describes how to install a QLogic 8100 Series Adapter in a Linux server, including system requirements, hardware installation, driver installation, and software installation.

System Requirements

Operating System Requirements

The QLogic 8100 Series Adapter supports the following Linux operating systems:

Red Hat® Enterprise Linux

SUSE® Linux Enterprise Server

NOTE:

The QLogic 8100 Series Adapter supports both SLES and RHEL distributions. However, this section describes the installation and configuration of the QLogic 8100 Series Adapter on RHEL systems.

Refer to the Read Me file provided with the QLogic 8100 Series Adapter multi-flash image or Linux driver for a complete list of supported operating systems and required service packs.

Architecture support: IA-32 (x86), Intel64, AMD64 (x64)

Server and Switch Requirements

QLogic adapter products are certified with products from leading converged networking switch and server vendors. For product-level interoperability information, visit http://www.qlogic.com/Interoperability/Pages/default.aspx, and select Converged Networking.

A server must satisfy the following requirements to host a QLogic Converged Network Adapter:

FE0254601-00 A

4-1

Image 99

Q-Logic 8100 SERIES manual Installation in a Linux Environment, Operating System Requirements

Contents

User’s Guide Document Revision History Table of Contents Management Tools Installation in a Windows Environment Installation in a Linux Environment Installation in a VMware Environment FE0254601-00 a Vii Configuring FCoE in a Linux Environment Configuring FCoE in a Windows Environment User’s Guide Converged Network Adapter Series Adapters Offline Utilities Brocade CEE/FCoE Switch/Blade Configuration List of Figures Xii FE0254601-00 a Xiii Xiv FE0254601-00 a User’s Guide Converged Network Adapter Series Adapters List of Tables FE0254601-00 a Xvii Page What’s in This Guide Preface Intended Audience Related MaterialsDocumentation Conventions License Agreements  See Installation Checklist on Technical Support TrainingContact Information Knowledge Database WarrantyLaser Safety Legal Notices CNS 13438 Class a QLE8xxx EMI and EMC Requirements MIC Class a QLE81xx Product Safety Compliance Preface Legal Notices Xxvi FE0254601-00 a Installation Instructions Verify the Package ContentsInstall the Adapter Hardware Figure i Illustration of Sample Motherboard and Slots Install the Adapter Drivers Additional Resources Install QConvergeConsole Management Tools Quick Start Additional Resources Xxx FE0254601-00 a What is a Converged Network Adapter? QLogic 8100 Series Converged Network AdaptersProduct Part Number What is Fibre Channel over Ethernet FCoE? What is Enhanced Ethernet? QLogic Converged Network Adapter Series Converged Network Adapters FCoE Network Deployment FCoE Deployment Hardware Components Function Series Adapter Components Hardware Function Component Software Components Operating System Driver Boot Code Management Tools and Utilities Firmware Component Operating System Comments QLogic Supported a Software and Firmware Components  Bios Adapter Specifications Physical and Electrical SpecificationSpecification Description Active Passive SR Optics Optics Not Adapter Sold by FCoE SpecificationsFeature Description Transceiver Requirements Ethernet Specifications Ethernet Specifications Management Specifications QConvergeConsole Web Management GUI Overview QConvergeConsole Management Agents qlremote/netqlremote Offline Utilities QConvergeConsole CLI Management Tools Offline Utilities Server and Switch Requirements System RequirementsOperating Systems Requirements Downloading QLogic Drivers Cabling RequirementsOther Requirements Select an Adapter and a Windows Operating System Download Drivers for Windows Servers Installing Hardware Install the Adapter Adapter Hardware Verify the Adapter Installation Drivers Command Output Installing Software Identifying Unnamed Devices Device Properties Installing the NIC Driver for Windows Server Installing and Updating Drivers Using Device Manager QLogic 8100 Series Adapter Device Entries Typical QLogic 8100 Series Ethernet Adapter Port Entries 11. Starting the Hardware Update Wizard 12. Confirming the Ethernet Adapter Installing the FCoE Driver for Windows Server 13. QLogic 8100 Series Adapter Device Entries 16. Updating an FCoE Driver 18. QLogic 8100 Series Adapter Device Entries-Windows 19. Installing an NIC Driver-Windows 22. Starting the Update Driver Software Wizard 24. QLogic 8100 Series Adapter Device Entries for Windows 25. Installing an FCoE Driver for Windows 28. Starting the Update Driver Software Wizard Downloading the Windows SuperInstaller 30. Prompt to Reboot 31. Select an Adapter and a Windows Operating System 33. Specify Additional Device 34. Insert Driver Disk 36. Install Additional Drivers 37. Windows Installation Type 39. Insert the Driver Disk Removing the Driver 41. Select Disk/LUN on which to Install Windows 42. Confirming Port Classification and Health Verifying Driver Installation 43. Network Adapters and Storage Controllers Obtaining the QLogic Firmware/Boot Code Firmware Upgrades 46. Download the Multi-boot Image Determining the Installed Firmware Version 47. Displaying the Adapter Firmware Version Using QConvergeConsole GUI or QConvergeConsole CLI Upgrading the Firmware/Boot Code 49. QConvergeConsole-Update Entire Image Updating Firmware Using QLogic Bios and Uefi Utilities Installing Management Tools 50. QConvergeConsole Download Selections Example Obtaining QLogic Adapter Management Utilities 51. Install the QConvergeConsole Introduction Installing and Launching the QConvergeConsole 53. Install the QConvergeConsole Pre-Installation Summary 54. Install the QConvergeConsole Installation Status To open QConvergeConsole locally on the server To open QConvergeConsole from a remote computer 58. Entering QConvergeConsole Web Address Example Passive Windows Installation Installing and Launching the QConvergeConsole CLIStandard Windows Interactive CLI Installation Quiet or Unattended Windows Installation Overwrite Previous Windows Installations QCCCLI.msi /i forceinstall=trueStarting the QConvergeConsole CLI Page Operating System Requirements Installation in a Linux Environment Installation in a Linux Environment Installing Hardware External components Adapter Hardware Verify the Adapter Installation Click QLogic Products Click Adapters Installing the FCoE Driver qla2xxx Select an Adapter and a Linux Operating System #cd /media/RHEL 5.4 x8664 DVD/Server Compiling the QLogic Driver Executing the build.sh Script # ./extras/build.sh install # modprobe -r qla2xxx # cd /boot# mkinitrd -f initrd-kernel version.img `uname -r` # shutdown -r now Select an Adapter and Linux Operating System Installing the FCoE Driver for Rhel 5.3 Boot-from-SAN Download the FC-FCoE DD-Kit Rhel 5.3 Boot Screen Enter Installing the Networking Driver 11. Select an Adapter and a Linux Operating System # cd /media/RHEL 5.4 x8664 DVD/Server # tar -xzvf qlgex.x.x.xx-ddmmyyxxx.x.xx.tgz # cd qlge # make install # modprobe -v qlge # modprobe -r qlge Verifying the Driver Installation # lsmod grep qla2xxx# lsmod grep qlgc # modinfo -F version qlgc # make uninstallRemoving Drivers # modinfo -F version qla2xxx 8.03.01.06.05.06-k 14. Select an Adapter and a Linux Operating System Displaying the Firmware Version Using the QConvergeConsole 15. Download the Multi-boot Image 16. Displaying the Adapter Firmware Version #cat /sys/class/scsihost/hostX/fwversion 5.03.02 8d4 Upgrading the Boot Code FirmwareDisplaying the Firmware Version Using sysfs Upgrading the Boot Code Using the QConvergeConsole GUI 18. QConvergeConsole-Update Entire Image Using QLogic Bios and Uefi Utilities Management Tool Installation 19. Download Linux Adapter Management Tools Obtaining the QLogic Adapter Management Tools 22. Install the QConvergeConsole Run in Terminal Selection Installing and Launching QConvergeConsole 23. Install the QConvergeConsole Installer Extracts FIles 25. Install the QConvergeConsole Pre-Installation Summary 26. Install the QConvergeConsole Installation Status Install Complete dialog box -27 opens To open QConvergeConsole from a remote computer 29. Entering QConvergeConsole Web Address Example QLogic Linux Utilities Installing and Launching the QLogic Linux ToolsQLogic Linux Utility Directories and Commands Directory Command QLogic Linux Utility Directories and Commands Installation in a VMware Environment Installation in a VMware Environment Installing Hardware Installing the FCoE and Networking Drivers Select Adapter Software for VMware by Operating System Selecting the Summary Tab Opening the Temporary Driver Folder # cd /mnt/cdrom/offline-bundle # cd /vmfs/volumes/Storage1/esxconsole/temp# esxupdate --bundle=network driver file.zip update # esxupdate --bundle=fcoe driver file.zip update # ls /proc/scsi/qla2xxx Verifying Driver InstallationValidating Driver and Firmware Versions # ls /proc/scsi 10. Displaying FCoE Adapter Driver Details Ifconfig -a 11. Displaying Networking Adapter Driver Details # ethtool -i vmnicN Identifying QLogic Adapters Using vSphere Client 13. Displaying Storage Adapters Using the vSphere Client Configuring NIC Using the vSphere Client 15. Configuring Networking Adapters 17. Selecting the Virtual Switch # esxcfg-module -s options qla2xxx Configuring the Driver Parameters# esxcfg-boot -b # esxcfg-module -g qla2xxx Driver Parameter Description # reboot Esxcfg-module Configurable Driver Parameters 19. Exiting Maintenance Mode Configuring a Hard Drive in a Virtual Machine 21. Virtual Machine Properties Window 22. Add Hardware-Device Type 24. Add Hardware-Select Target LUN 26. Add Hardware-Compatibility Mode 28. Add Hardware-Ready to Complete 30. Exiting Maintenance Mode Configuring a Network Adapter in a Virtual Machine 32. Virtual Machine Properties Window 33. Add Hardware-Select Adapter 35. Add Hardware-Ready to Complete Deploying Npiv for VMware ESX/ESXi Requirements for Using Npiv 37. Selecting a Managed Host Assigning WWNs to Virtual Machines 39. Create New Virtual Machine-Select a Disk 40. Create New Virtual Machine-Select Target LUN 42. Create New Virtual Machine-Compatibility Mode 44. Virtual Machine Properties-Generate New WWNs 45. Confirm Node and Port WWNs Managing the NIC Function with Windows Property pages Configuring the NIC in a Windows Environment Accessing Device Manager Adapters Properties Dialog Box Managing the NIC Function with the QConvergeConsole CLI Main Interactive Menu NIC Driver Parameters Windows Advanced tab or NIC Driver Parameters for Windows NIC Driver Parameters for Windows NIC Driver Parameters for Windows NIC Driver Parameters for Windows Offload Support Receive Side Scaling Concepts Receive Side Scaling Netsh int tcp show global Netsh int tcp set global rss = enabled Enabling RSS-Windows Advanced Properties Netsh int tcp set global rss = disabled Disable RSS-Windows Header Data Split HDS Disable RSS Per Port 10. Enabling or Disabling HDS NIC Teaming Switch Dependent Teaming Switch Independent Teaming 11. Host Level Info and Operations Menu Creating and Configuring a Team 12. Confirm VLAN/Teaming Driver Installation 13. Creating a Team 15. Deleting a Team Deleting a Team Vlan Tagging Configuring Vlan Tagging Using the Adapter NIC Function 16. Host Level Info & Operations Menu 18. Adding a Vlan to a Team Removing Vlan ID Assignment 19. Vlan Local Area Connection Entry Prerequisites for PXE Boot PXE Boot FE0254601-00 a PXE Protocol Operation 21. Boot Order in Bios 22. PXE Operation NIC Driver Parameters for Linux Configuring the NIC in a Linux EnvironmentParameter Name Description Default Allowed Configuration NIC Driver Parameters Linux NIC Driver Parameters for Linux Modifying NIC Driver Parameters Linux Using modprobe #vi /etc/modprobe.conf # modprobe -v qlge qlgeirqtype =1 qlgempicoredump=0 23. Example modprobe.conf # cd /sys/module/qlge/parameters Using sysfsSysfs Locations and Parameters Sysfs Location Modifiable Driver Parameters Using ethtool # ethtool -K eth0 rx off# ethtool -k eth0 # vi /etc/udev/rules.d/50-ethtool.rules # vi /etc/sysconfig/network-scripts/ifcfg-eth0# /etc/sysconfig/network-scripts/ifdown eth0 # /etc/sysconfig/network-scripts/ifup eth0 Identifying the QLogic 8100 Adapter Network ID Using ifconfig # cd /sys/bus/pci/drivers/qla2xxx # ls -l 28. Verify NIC Driver qlge Ethtool -1 eth0 Interrupt Support Offload SupportNIC Bonding Linux Switch Independent Bonding Switch Dependent BondingBonding Prerequisites Linux Bonding Driver Parameters Parameter Unit Description Default Allowed Values NameEthernet Channel Bonding Driver Bonding Driver Parameters Created FE0254601-00 a Linux Bonding Driver Parameters # lsmod grep bonding Loading the Bonding Driver # modinfo bonding Unloading the Bonding DriverChanging Bonding Driver Parameters # modprobe -r bonding # modprobe -v miimon=100 mode=0 # vi /etc/modprobe.confAlias bond0 bonding Options bonding miimon=100 mode=0 # ifenslave bond0 eth0 eth1 Bonding Configuration # vi /etc/sysconfig/network-scripts/ifcfg-bond0 Persistent Bonding Configuration Verify the Bonding Configuration # service network restartMASTER=bond0 SLAVE=yes # ifenslave -d bondX ethY # ifconfig bondX down# ifconfig bond0 down Disabling a Bonding Network Interface Vlan Prerequisites Vlan Configuration Configuring a Vlan Loading the Vlan 802.1q Kernel ModuleUnloading the Vlan 802.1q Kernel Module # vconfig add eth0 Etc/sysconfig/network-scripts/ directory # cat /proc/net/bonding/bond0 Verify the Vlan configuration Creating a Vlan on a Bond Interface Disabling a Vlan interface Wake On LAN 38. PXE Flow Diagram 39. Boot Order in Bios Setting the Client Servers Bios Boot OrderPage Parameter Description Default Range Configuration Method Driver ParametersDriver Parameters Configuring FCoE in a Windows Environment Driver Parameters Driver Parameters Operation Mode ZIO Interrupt Delay Timer IDT Operation Mode ValuesNPort ID Virtualization Npiv Deployment Requirements QLogic CNA Npiv Solution Creating Virtual Ports Select Port to Create a Virtual Port Verifying Additional Virtual Ports Verifying the Virtual Ports Deleting Virtual Ports Select Virtual Ports to Delete Verifying Deletion of Virtual Ports  VPD Virtual Port Features and Limitations Priority and Bandwidth-Based QoS Implementing Adapter-Based Quality of Service Setting QoS by Bandwidth Boot from SAN Boot-from-SAN RequirementsHost/Server Requirements FCoE Switch Requirements Converged Network Adapter RequirementsStorage Array Requirements Boot-from-SAN Topologies Boot-from-SAN Configuration Single-Path Topology Single-Path Configuration Multipath Topology Multipath Topology Configuring an Adapter to Boot-from-SAN Selectable Boot Settings Menu Drvcfg -sdriverhandle controllerhandle Driver Configuration Main Menu 10. Edit Boot Settings Menu Configuring FCoE in a Windows Environment Boot from SAN Page FCoE Driver Parameters for Linux FCoE Driver Parameters for Linux Fast!UTIL Interrupt Delay Timer Time interval, in 100ms 255 LIP Bios Configuring Driver Parameters Using modprobe Making Nonpersistent Changes Using modprobe#modprobe -r qla2xxx Adding the Options Line to modprobe.conf Making Persistent Changes Using modprobe Configuring Driver Parameters Using sysfs Configuring FCoE Parameters Using QLogic Utilities FCoE Driver Parameters that can be Modified with SysfsSysfs Location Driver Parameters QConvergeConsole GUI FCoE Driver Parameters Configuring FCoE Driver Parameters Using QConvergeConsoleUtility Installation Online or Offline How to Access QConvergeConsole and Fast!UTIL Comparison QConvergeConsole HBA Parameters QConvergeConsole Advanced HBA Parameters Configuring FCoE Driver Parameters Using Fast!UTIL Fast!UTIL FCoE Driver Parameters Adapter Settings Advanced Adapter Settings Fast!UTIL Advanced Adapter Settings Displaying FCoE Driver Parameters Using sysfs Sysfs Location Parameters Description Sysfs FCoE Driver Parameters and File Locations OstX/statistics Sys/class/scsihost Fwstate Firmware state #lspci grep QLogic Corp Identifying the Scsi Host ID #cd /sys/bus/pci/drivers/qla2xxx #ls -l 00008500.2/host #ls -l /sys/bus/pci/drivers/qla2xxx #echo 1 /sys/class/scsihost/host6/beacon Online Storage Configuration ReconfigurationDisplaying and Modifying sysfs Entries #cat /sys/class/scsihost/host6/fwversion Adapter FCoE Performance Tuning Interrupt Delay Timer ziotimerOperation Mode Parameter Queue Depth qla2xmaxqdepth QLogic CNA Npiv Solution #echo wwpnwwnn /sys/class/scsihost/hostX/vportcreate #cat /sys/class/scsihost/hostX/state Link Up FPort Verifying the Creation of Virtual Ports #ls -l /sys/class/scsihost/hostX# ls -l /sys/class/scsihost/host4/device #echo wwpnwwnn /sys/class/scsihost/hostX/vportdelete #cat /sys/class/scsihost/hostX/vportstate #echo 1 /sys/class/scsihost/hostX/vportdisable Differentiating Virtual Ports from Physical Ports in sysfsUnique Physical and Virtual Port sysfs Parameters 11. Comparing Npiv Physical and Virtual Ports Boot-from-SAN Boot-from-SAN Requirements Converged Network Adapter Requirements Single-Path Topology Boot-from-SAN Configuration Topologies 12. Single-Path Topology 13. Multipath Topology Configuring an Adapter to Boot-from-SAN 14. Selectable Boot Settings menu Drvcfg -sdriverhandle controllerhandle 15. Driver Configuration Main Menu 16. Edit Boot Settings Menu 17. Select Advanced Boot Loader Options Rhel 5 Install Booting from SAN Using a LUN Other Than LUN File Name Description Using the QLogic Linux Utilities File Description Package ContentsDynamic TGT-LUN Discovery Utility 10. Dynamic TGT-LUN Discovery Utility Package Files Option Description Abbreviation Using the Utility11. TGT-LUN Discovery Utility Command Line Options # ./ql-dynamic-tgt-lun-disc.sh command line options 12. TGT-LUN Discovery Utility Tasks and Commands Task Command Examples# ./ql-dynamic-tgt-lun-disc.sh --interactive 13. Dynamic TGT-LUN Main Menu 14. Select Host to Scan MenuOption Description HBA Collect Utility # ./ql-hba-collect.sh 15. HBA Collect Utility Package Files FC HBA Snapshot Utility 16. FC HBA Snapshot Utility Package Files# ./ql-hba-snapshot.sh Host number -a/--all options 17. FC HBA Snapshot Utility Command Line Options 18. FC HBA Snapshot Utility Command ExampleTask Command Example FC HBA Change LUN State Utility 19. FC HBA Change LUN State Utility Package Files# ./ql-hba-snapshot.sh --parameters # ./ql-lun-state-online.sh --interactive 20. FC HBA Change LUN State Utility Command Line Options21. HBA Change LUN State Utility Command Examples # ./ql-lun-state-online.sh 2 # ./ql-lun-state-online.sh -interactive Set Device Command Timeout Utility 22. Set Device Command Timeout Utility Package Files # ./ql-set-cmd-timeout.sh Host ## ./ql-set-cmd-timeout.sh Host # Target # Sys/class/scsihost/hostX 23. Set Device Command Timeout Utility Command Options 24. Set Device Command Timeout Utility Command Examples 25. Set Device Command Timeout Utility Main Menu Options 22. Set Device Command Timeout Utility Main Menu 26. Select Target for HostX Menu Options 23. Select Target for HostX Menu 27. Modify/Display Timeout Menu Options Offline Utilities Starting Fast!UTIL Fast!UTIL Selecting an Adapter Adapter Settings Configuration Settings Parameter Description Adapter Setting Parameters Selectable Boot Setting Window Selectable Boot Settings Select Fibre Channel Device Window Selectable Boot Settings Window Parameters Advanced Adapter Settings Restore Default SettingsRaw Nvram Data Advanced Settings Window Parameters Scan Fibre Channel Devices Fibre Disk Utility Loopback Data TestSelect Host Adapter Exit Fast!UTIL Eficfg FlasUTIL Installing FlasUTIL Using FlasUTIL FlasUTIL Command Line OptionsOption Function Installing the Multi-boot Image Efiutil Efiutil Efiutil Adapter Port LEDs Link/Ethernet Storage Traffic Hardware State Traffic LED Table A-1. Configuration Options for Virtual Ports Cisco Nexus 5000 Series Switch Configuration Nexusmv1# show feature Enable FCoE on the Switch Configure the Physical Ethernet Interface Switch Port Create and Configure the Vlan Create and Configure a Virtual Fibre Channel Interface Verify that the Adapter Is Logged into the Switch # copy running-config startup-config# show interface vfc Page Brocade CEE/FCoE Switch/Blade Configuration Admin slotshow -m Enable the Ethernet Switch ServiceAdmin fosconfig -show Admin slotpoweroff 7 admin slotpoweron Create and Configure FCoE Vlan # configure terminalConfig# interface vlan Conf-ceemap#priority-group- weight Create and Configure CEE-MAPConfig# cee-map demo Conf-ceemap#priority-group- weight 40 pfc Config# advertise dcbx-fcoe-app-tlv Configure LLDP/DCBX for FCoEConfig# do show cee maps CEE Map demo Config# protocol lldp Conf-if-te-0/19#vlan classifier activate group 1 vlan Configure CEE PortConfig# interface tengigabitethernet 0/19 Conf-if-te-0/19#switchport mode converged Conf-if-te-0/19#do fos fcoe --loginshow Page Page Corporate Headquarters QLogic Corporation