Transcription

Linux Unified Host UtilitiesSAN HostNetAppMay 13, 2022This PDF was generated from https://docs.netapp.com/us-en/ontap-sanhost/hu luhu 71.html on May 13,2022. Always check docs.netapp.com for the latest.

Table of ContentsLinux Unified Host Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Linux Unified Host Utilities 7.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Linux Unified Host Utilities 7.1 Release Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Linux Unified Host UtilitiesLinux Unified Host Utilities 7.1Pre-requisites For reliable operation, you must verify that your entire iSCSI, FC, or FCoE configuration is supported.You can use the NetApp Interoperability Matrix Tool to verify your configuration. You must install the HBA management packages provided by the vendors on their web sites.The management software enables the SAN Tool kit commands to gather information about the FC HBAs,such as their WWPNs. For sanlun fcp show adapter to work, ensure that the following packages areinstalled: QLogic HBA – QConvergeConsole CLI Emulex HBA - OneCommand Manager core application CLI Brocade HBA – Brocade Command Utility CLIRPM Packages “libhbaapi” & “libhbalinux” available for each Linux Distribution should be installed on the hostOS.SAN ToolkitLinux Unified Host Utilities is a NetApp host software that provides a command line tool kit on your Linux host.The toolkit is installed automatically when you install the NetApp Host Utilities package. This kit provides thesanlun utility, which helps you manage LUNs and HBAs. The sanlun command returns information about theLUNs mapped to your host, multipathing, and information necessary to create initiator groups.ExampleIn the following example, the sanlun lun show command returns LUN information.# sanlun lun show (cDOT/FlashRay)lun-pathname filenameadapter protocol ---------------------------------data vserver/vol/vol1/lun1/dev/sdbhost16FCP120.0g cDOTdata vserver/vol/vol1/lun1/dev/sdchost15FCP120.0g cDOTdata vserver/vol/vol2/lun2/dev/sddhost16FCP120.0g cDOTdata vserver/vol/vol2/lun2/dev/sdehost15FCP120.0g cDOT1

This toolkit is common across all configurations and protocols of the Host Utilities. As a resultsome of its contents apply to one configuration, but not another. Having unused componentsdoes not affect your system performance.The SAN toolkit is not supported on Citrix XenServer, Oracle VM, and Red Hat EnterpriseVirtualization Hypervisor.Install Linux Unified Host UtilitiesThe NetApp Linux Unified Host Utilities software package is available on the NetApp Support Site in a 32-bit or64-bit .rpm file.Installing the Linux Unified Host Utilities is strongly recommended, but not mandatory. The utilities do notchange any settings on your Linux host. The utilities improve management and assist NetApp customersupport in gathering information about your configuration.1. If you have a version of Linux Unified Host Utilities currently installed, use the following command toremove it:rpm -e netapp linux unified host utilities-7-1For older versions of Linux Host Utilities, go to the directory where the host utility software is installed andenter the uninstall command.2. Download the either the 32-bit or 64-bit Linux Unified Host Utilities software package from the NetAppSupport Site to your host.3. Go to the directory to which you downloaded the software package and use the following command toinstall it:rpm -ivh netapp linux unified host utilities-7-1.x86 00%]Updating / installing.1:netapp linux unified host utiliti#################################[100%]4. Verify the installation:sanlun versionsanlun version 7.1.386.16442

Sample command referenceList all host initiators mapped to host# sanlun fcp show adapter -vadapter name:WWPN:WWNN:driver name:model:model description:Adapterserial number:hardware version:driver version:firmware version:Number of ports:port type:port state:supported speed:negotiated speed:OS device 16002B-M6Emulex LPe16002B-M6 PCIe 2-port 16Gb Fibre Channeladapter name:WWPN:WWNN:driver name:model:model description:Adapterserial number:hardware version:driver version:firmware version:Number of ports:port type:port state:supported speed:negotiated speed:OS device 16002B-M6Emulex LPe16002B-M6 PCIe 2-port 16Gb Fibre ChannelFC246378900000000b 00000010 0000000012.8.0.5; HBAAPI(I) v2.3.d, 07-12-1012.8.340.81FabricOperational4 GBit/sec, 8 GBit/sec, 16 GBit/sec16 GBit/sec/sys/class/scsi host/host15FC246378900000000b 00000010 0000000012.8.0.5; HBAAPI(I) v2.3.d, 07-12-1012.8.340.81FabricOperational4 GBit/sec, 8 GBit/sec, 16 GBit/sec16 GBit/sec/sys/class/scsi host/host16List all LUNs mapped to host3

# sanlun lun show -p -v allONTAP Path: vs sanboot:/vol/sanboot 169/lunLUN: 0LUN Size: 150gProduct: cDOTHost Device: 3600a0980383143393124515873683561Multipath Policy: service-time 0DM-MP Features: 3 queue if no path pg init retries 50Hardware Handler: 1 aluaMultipath Provider: Native----------- --------- ---------- ------- ------------ or----------- --------- ---------- ------- ------------ ------------------activeupprimarysdq15:0:5:0lif 1865:0activeupprimarysds16:0:5:0lif 1765:32activeupprimarysdac16:0:7:0lif 2565:192activeupprimarysdad15:0:7:0lif 2665:208activeupsecondary sdt15:0:4:0lif 2065:48activeupsecondary sdr15:0:6:0lif 1965:16activeupsecondary sdad16:0:4:0lif 2766:96activeupsecondary sdan16:0:6:0lif 2866:112List all LUNs mapped to host from a given SVM4

# sanlun lun show -p -v vs sanbootONTAP Path: vs sanboot:/vol/sanboot 169/lunLUN: 0LUN Size: 160gProduct: cDOTHost Device: 3600a0980383143393124515873683561Multipath Policy: service-time 0DM-MP Features: 3 queue if no path pg init retries 50Hardware Handler: 1 aluaMultipath Provider: Native----------- --------- ---------- ------- ------------ IFminor----------- --------- ---------- ------- ------------ lif 16g 569:32activeupprimarysdfk16:0:5:0lif 16g 7130:96activeupprimarysdfm16:0:7:0lif 16g 8130:128activeupprimarysdcg15:0:7:0lif 16g 669:64activeupsecondary sdcd15:0:4:0lif 16g 169:16activeupsecondary sdcf15:0:6:0lif 16g 269:48activeupsecondary sdfj16:0:4:0lif 16g 3130:80activeupsecondary sdfl16:0:6:0lif 16g 4130:112List all attributes of a given LUN mapped to host5

# sanlun lun show -p -v vs sanboot:/vol/sanboot 169/lunONTAP Path: vs sanboot:/vol/sanboot 169/lunLUN: 0LUN Size: 160gProduct: cDOTHost Device: 3600a0980383143393124515873683561Multipath Policy: service-time 0DM-MP Features: 3 queue if no path pg init retries 50Hardware Handler: 1 aluaMultipath Provider: Native----------- --------- ---------- ------- ------------ nLIFminor----------- --------- ---------- ------- ------------ :0lif 16g 569:32activeupprimarysdfk16:0:5:0lif 16g 7130:96activeupprimarysdfm16:0:7:0lif 16g 8130:128activeupprimarysdcg15:0:7:0lif 16g 669:64activeupsecondary sdcd15:0:4:0lif 16g 169:16activeupsecondary sdcf15:0:6:0lif 16g 269:48activeupsecondary sdfj16:0:4:0lif 16g 3130:80activeupsecondary sdfl16:0:6:0lif 16g 4130:112List the ONTAP SVM identity from which a given LUN is mapped to host6

# sanlun lun show -m -v vs sanboot:/vol/sanboot --------------------------------vs sanboot/vol/sanboot 169/lun/dev/sdfmhost16FCP160gcDOTLUN Serial number: 81C91 QXsh5aController Model Name: AFF-A400Vserver FCP nodename: 2008d039ea1308e5Vserver FCP portname: 2010d039ea1308e5Vserver LIF name: lif 16g 8Vserver IP address: 10.141.12.16510.141.12.16110.141.12.163Vserver volume name: sanboot 169MSID::0x000000000000000000000000809E7CC3Vserver snapshot name:List ONTAP LUN attributes by Host Device File name# sanlun lun show -d ---------------vs sanboot/vol/sanboot 9 ]#List all SVM target LIF WWPNs attached to host7

# sanlun lun show --------------------------------vs 169 16gEmu202cd039ea1308e5/vol/VOL 8g 169 2 8/lun/dev/sdlohost1810gcDOTvs 169 16gEmu202cd039ea1308e5/vol/VOL 8g 169 2 9/lun/dev/sdlphost1810gcDOTvs 169 16gEmu202cd039ea1308e5/vol/VOL 8g 169 2 7/lun/dev/sdlnhost1810gcDOTvs 169 16gEmu202cd039ea1308e5/vol/VOL 8g 169 2 5/lun/dev/sdllhost1810gcDOTList ONTAP LUNs seen on host by a given SVM target LIF WWPN# sanlun lun show -wwpn -----------------------------------vs sanboot2010d039ea1308e5/vol/sanboot 169/lun/dev/sdfmhost16160gcDOTNotice FileLinux Unified Host Utilities Notice FileLinux Unified Host Utilities 7.1 Release NotesThis Release Notes document contains the latest information for the Linux Unified HostUtilities 7.1 release, including updates about known problems and limitations, anyimportant cautions, new features, and enhancements. It also describes any issues thatmight have been discovered since the Host Utilities were released.About the Linux Unified Host Utilities 7.1 releaseThe Linux Unified Host Utilities support several Linux operating systems. The Host Utilities enable you toconnect a Linux host to NetApp storage systems.The Linux Unified Host Utilities 7.1 continues to support the following versions of Linux:8

Red Hat Enterprise Linux SUSE Linux Enterprise Server Oracle Linux Oracle VM Citrix XenServer VeritasFor specific information about the operating system versions and updates that the Host Utilitiessupport, see the NetApp Interoperability Matrix Tool.The Host Utilities software is provided as both 32-bit and 64-bit .rpm files. You can download the correct .rpmfile for your host architecture and the documentation from the NetApp Support Site.For instructions about installing and setting up, see the Linux Unified Host Utilities 7.1 Installation Guide.What’s new in the 7.1 releaseLinux Host Utilities is now called Linux Unified Host Utilities because it supports NetApp E-Series storagesystems running SANtricity as well as AFF and FAS systems running ONTAP.Any mention of Host Utilities or Linux Host Utilities in this document refers to Linux Unified HostUtilities. This release of the Linux Unified Host Utilities provides support for a tuned package for setting serverprofiles and improving I/O performance on Red Hat Enterprise Linux 6 and 7 hosts. The Linux Unified Host Utilities 7.1 continues to support versions of the following: Red Hat Enterprise Linux SUSE Linux Enterprise Server Oracle Linux Oracle VM Citrix XenServer Veritas Red Hat Enterprise Linux 6 and 7 now have a tuned package with a tuned-adm command to set differentserver profiles on the host depending on the environment. This includes an enterprise storage profile for configurations where LUNs from enterprise storagearrays are used. You can also use the virtual guest profile for Red Hat Enterprise Linux as a guestvirtual machine. Using these tuned packages can result in marked improvement in throughput andlatency on ONTAP.NetApp continues to work with the Host Utilities to add support for features after the initialrelease. For latest information about the features that are supported and the new features thathave been added, see the NetApp Interoperability Matrix Tool.9

New features and enhancementsThe Release Notes are updated between product releases as new information is available.7.1 enhancements This release includes support for the following: SUSE Linux Enterprise Server 15 series Oracle VM 3.2 series Oracle Linux 6 and 7 series Red Hat Enterprise Linux 6 and 7 series SUSE Linux Enterprise Server 11 SP4 KVM and XEN, RHEV 6.4 and 6.5 Citrix XenServer parameters Adds support for 32 GB Fibre Channel adapters from Emulex and Qlogic. Fixes sanlun lun show -p getting SIGABRT in SLES12SP1, OL7.2, RHEL7.2, and RHEL 6.8. Extends support for Red Hat Linux 6.8, Oracle Linux 6.8, XenServer 7.0, Oracle VM 3.3 series, and OracleVM 3.4 series operating systems.Known problems and limitationsNetApp Bug IDDescription1457017sanlun installation issues warning messages related to libdevmapper.so andlibnl.so libraries. These warnings do not affect the functionality of sanlun kit.NetApp Bugs Online provides complete information for most known issues, including suggested workaroundswhere possible.Some keyword combinations and bug types that you might want to use include the following: FCP - Linux iSCSI – LinuxRefer to the ONTAP SAN Host Configuration documentation for more information on Host OS settings andconfigurations.About SAN Host Configuration documentationDocumentation for SAN Host Utilities is included in the ONTAP SAN Host Configuration documentation.ONTAP SAN HOST configuration documentation is cumulative, covering all current SAN HOST releases. Anyfunctional differences across releases are noted in context.Additional informationDefault values recommended when using drivers bundled with Linux kernelWhen you are setting up an FC environment that uses the native, inbox drivers that are bundled with the Linuxkernel, you can use the default values for the drivers. In iSCSI environments where you are using a iSCSI10

solution software, you need to manually set certain recommended values depending on the OS version youare using.Where to find product documentation and other informationYou can access documentation for all NetApp products and find other product information resources, such astechnical reports and white papers on the Product Documentation page of the NetApp corporate site.Related informationConfiguring and managing your ONTAP storage system The ONTAP Software Setup Guide for your version of ONTAP The ONTAP SAN Administration Guide for your version of ONTAP The ONTAP Release Notes for your version of ONTAPConfiguring and managing your E-Series storage system The SANtricity Storage Manager Configuration and Provisioning for Windows Express Guide that isappropriate for your protocol The SANtricity Storage Manager Configuration and Provisioning Express Guide for your operating system,protocol, and version of SANtricity. The SANtricity Storage Manager Software Installation Reference specific for your version of SANtricity. The SANtricity Storage Manager Multipath Driver’s Guide specific for your version of SANtricity. The SANtricity Storage Manager Release Notes for your version of SANtricity.Go to the E-Series documentation to find SANtricity related documentation.11

Copyright InformationCopyright 2022 NetApp, Inc. All rights reserved. Printed in the U.S. No part of this documentcovered by copyright may be reproduced in any form or by any means-graphic, electronic, ormechanical, including photocopying, recording, taping, or storage in an electronic retrieval systemwithout prior written permission of the copyright owner.Software derived from copyrighted NetApp material is subject to the following license and disclaimer:THIS SOFTWARE IS PROVIDED BY NETAPP “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WHICH ARE HEREBYDISCLAIMED. IN NO EVENT SHALL NETAPP BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OFTHE POSSIBILITY OF SUCH DAMAGE.NetApp reserves the right to change any products described herein at any time, and without notice.NetApp assumes no responsibility or liability arising from the use of products described herein,except as expressly agreed to in writing by NetApp. The use or purchase of this product does notconvey a license under any patent rights, trademark rights, or any other intellectual propertyrights of NetApp.The product described in this manual may be protected by one or more U.S. patents,foreign patents, or pending applications.RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data andComputer Software clause at DFARS 252.277-7103 (October 1988) and FAR 52-227-19 (June 1987).Trademark InformationNETAPP, the NETAPP logo, and the marks listed at http://www.netapp.com/TM are trademarks ofNetApp, Inc. Other company and product names may be trademarks of their respective owners.12

The SAN toolkit is not supported on Citrix XenServer, Oracle VM, and Red Hat Enterprise Virtualization Hypervisor. Install Linux Unified Host Utilities . Download the either the 32-bit or 64-bit Linux Unified Host Utilities software package from the NetApp Support Site to your host. 3. Go