Emulex® Drivers for Linux User Manual
Total Page:16
File Type:pdf, Size:1020Kb
Emulex® Drivers for Linux User Manual P009417-02A Rev. A Emulex Connects™ Servers, Storage and People 2 Copyright © 2003-2013 Emulex. All rights reserved worldwide. No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex. Information furnished by Emulex is believed to be accurate and reliable. However, no responsibility is assumed by Emulex for its use; or for any infringements of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under any patent, copyright or related rights of Emulex. Emulex, the Emulex logo, AutoPilot Installer, AutoPilot Manager, BlockGuard, Connectivity Continuum, Convergenomics, Emulex Connect, Emulex Secure, EZPilot, FibreSpy, HBAnyware, InSpeed, LightPulse, MultiPulse, OneCommand, OneConnect, One Network. One Company., SBOD, SLI, and VEngine are trademarks of Emulex. All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations. Emulex provides this manual "as is" without any warranty of any kind, either expressed or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. Emulex may make improvements and changes to the product described in this manual at any time and without any notice. Emulex assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties that may result. Periodic changes are made to information contained herein; although these changes will be incorporated into new editions of this manual, Emulex disclaims any undertaking to give notice of such changes. Emulex, 3333 Susan Street Costa Mesa, CA 92626 OpenSolaris DHCHAP Notice Contains portions of Covered Software subject to the Common Development and Distribution License (CDDL) Version 1.0. Such portions of Covered Software in Source Code form may be obtained from the website www.opensolaris.org, or by contacting online support from the website www.emulex.com. Derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved. Emulex Drivers for Linux User Manual P009417-02A Rev. A Supported Driver Versions 3 Supported Driver Versions The following table lists the Emulex-supported Fibre Channel (FC), Fibre Channel over Ethernet (FCoE), Ethernet, and internet Small Computer System Interface (iSCSI) drivers that are applicable in this manual. A check mark “” indicates the type of driver distribution that is supported. Driver Distribution Driver Version Inbox DUP/DUD Out-of-Box Supported Operating Systems FC and FCoE Drivers 8.2.2.15 RHEL 5.6-5.9, SLES 10 SP3-SP4, OL 5.6-5.9, CentOS 5.6-5.9 8.3.7.18 RHEL 6.1-6.4, SLES 11 SP1-SP2, OL 6.1-6.4, CentOS 6.1-6.4, Oracle Linux UEK R1, R2 with OL 5, Oracle Linux UEK R1, R2 with OL 6 Ethernet Drivers 4.6.142.5 RHEL 5.5-5.9, RHEL 6.1-6.4, SLES 10 SP3-SP4, SLES 11 SP1-SP2, OL 5.5-5.8, OL 6.0-6.4, CentOS 5.5-5.8 CentOS 6.0-6.4, Oracle Linux UEK R1, R2 with OL 5, Oracle Linux UEK R1, R2 with OL 6, Debian 6.0.7, Ubuntu 11.10, Ubuntu 12.10 4.6.148.0 RHEL 5.5-5.9, RHEL 6.1-6.4, SLES 10 SP3-SP4, SLES 11 SP1-SP2 iSCSI Drivers 4.6.142.0 RHEL 5.5-5.9, RHEL 6.1-6.4, SLES 10 SP3-SP4, SLES 11 SP1-SP2, OL 5.5-5.8, OL 6.0-6.4, CentOS 5.5-5.8, CentOS 6.0-6.4, Oracle Linux UEK R1, R2 with OL 5, Oracle Linux UEK R1, R2 with OL 6 4.6.148.0 RHEL 5.5-5.9, RHEL 6.1-6.4, SLES 10 SP3-SP4, SLES 11 SP1-SP2 Emulex Drivers for Linux User Manual P009417-02A Rev. A Table of Contents 4 Table of Contents Supported Driver Versions.......................................................................3 List of Tables .......................................................................................8 1. Introduction .....................................................................................9 Overview................................................................................................9 Known Issues......................................................................................10 Abbreviations ........................................................................................ 10 2. Installing and Uninstalling .................................................................. 14 General Installation Requirements .............................................................. 14 Binary RPM FC and FCoE Driver Kit.............................................................. 14 Installing the Binary RPM FC and FCoE Driver Kit...........................................15 Uninstalling the Binary RPM FC and FCoE Driver Kit........................................15 Ethernet Driver Kit.................................................................................. 16 Installing the Ethernet Driver Kit..............................................................16 Uninstalling the Ethernet Driver Kit ..........................................................16 iSCSI Driver Kit....................................................................................... 17 Installing the iSCSI Driver Kit ..................................................................17 Uninstalling the iSCSI Driver Kit ...............................................................18 Booting from a Non-Zero LUN Attached to an Emulex LPFC Adapter..................... 18 OneCommand Manager Application.............................................................. 18 3. Configuration ................................................................................. 19 FC and FCoE Driver Configuration ............................................................... 19 FC and FCoE Driver Parameters ...............................................................19 Static FC and FCoE Driver Parameters............................................................ 19 Dynamic FC and FCoE Driver Parameters ........................................................ 22 Configuring FC and FCoE Driver Parameters.................................................24 Temporary Configuration with modprobe........................................................ 24 Persistent Configuration with modprobe.conf or lpfc.conf ................................... 24 Configure Parameters with a Read/Write to sysfs.............................................. 25 Creating a New Ramdisk Image................................................................26 Dynamically Recognizing LUNs and Targets (Using scan) ..................................26 Persistent Naming ...............................................................................27 Using udev to Discover Logical to Physical Mappings for sd Devices......................... 27 Configuring the System to Boot Using Persistent Names ...................................... 27 Using udev with st Devices ......................................................................... 28 Persistent Naming References ..................................................................... 30 Emulex Drivers for Linux User Manual P009417-02A Rev. A Table of Contents 5 Ethernet Driver Configuration.................................................................... 31 Ethernet Driver Configuration Parameters...................................................31 VLAN Support on UMC ...........................................................................31 SR-IOV Configuration ............................................................................31 Introduction........................................................................................... 31 Setting Up SR-IOV .................................................................................... 32 Configuring VFs....................................................................................... 36 Viewing VF Properties............................................................................... 38 iSCSI Driver Configuration ......................................................................... 39 iSCSI Driver Parameter Descriptions ..........................................................39 Configuring the iSCSI Driver Parameters .....................................................40 Configuring the ETO and LDTO Parameters...................................................... 40 Configuring the large_io Parameter .............................................................. 40 Configuring the im_policy Parameter............................................................. 41 iSCSI Error Handling .............................................................................42 Error Handling using ETO and LDTO Parameters ................................................ 42 Error Handling Under MultiPath I/O (MPIO) and Cluster Configurations..................... 42 Virtual Port (VPort) Configuration ............................................................... 43 VPort Configuration Prerequisites.............................................................43 Creating, Deleting, and Displaying VPorts ...................................................43 Creating VPorts Using the mkvport.sh Script .................................................... 43 Deleting VPorts Using the rmvport.sh Script .................................................... 44 Displaying VPorts Using the lsvport.sh Script.................................................... 44 VPort sysfs ........................................................................................44