Using Linux Hosts with ONTAP Storage
Total Page:16
File Type:pdf, Size:1020Kb
Linux® Uni®ed Host Utilities 7.1 Using Linux® Hosts with ONTAP storage February 2019 | 215-11446_C0 [email protected] Table of Contents | 3 Contents Overview of the supported Linux environments ....................................... 7 (iSCSI) How to configure iSCSI for Linux ............................................... 10 Getting the iSCSI initiator node name ...................................................................... 10 Setting the timeout values to enable multipathing with iSCSI .................................. 11 Setting up CHAP for Red Hat Linux 5, 6, and 7, SUSE Linux 10, 11, 12, 15, and later for iSCSI ............................................................................................... 12 (iSCSI) Setting up CHAP for Red Hat Enterprise Linux 4 series ............................. 13 Starting the iSCSI service ......................................................................................... 14 Methods for setting up target discovery with software initiators on iSCSI .............. 15 Discovering the iSCSI target by using the iscsiadm utility on Red Hat 5, 6, and 7 and SUSE 10, 11, 12, 15, and later ............................................ 15 (iSCSI) Setting up target discovery on Red Hat Enterprise Linux 4 series ... 16 Discovering targets by using YaST2 on SUSE 10, 11, 12, 15, or later on iSCSI ........................................................................................................ 16 Configuring the iSCSI service to start automatically ................................................ 17 Configuring manual or automatic node login with iSCSI ......................................... 18 Configuring the storage system ................................................................. 19 DM-Multipath configuration ..................................................................... 20 Verifying the required multipathing packages .......................................................... 20 Editing the DM-Multipath configuration file ............................................................ 21 Starting DM-Multipath .............................................................................................. 22 Configuring DM-Multipath to start automatically while booting ................. 23 Verifying the DM-Multipath configuration ............................................................... 24 Stopping DM-Multipath ............................................................................................ 27 Veritas Dynamic Multipath configuration ............................................... 28 (Veritas) VxDMP restore daemon and LUN retries tunable configuration ............... 28 Setting the Veritas restore daemon and LUN retry editable values ............... 28 Configuring Red Hat Enterprise Linux 6 series and Red Hat Enterprise Linux 7 series to support Veritas Storage Foundation ...................................................... 29 Configuring SUSE Linux Enterprise Server 11 to support Veritas Storage Foundation ........................................................................................................... 30 The Veritas Array Support Library and Array Policy Module .................................. 31 (Veritas) What the ASL is ............................................................................. 31 (Veritas) What the APM is ............................................................................ 32 Installing the ASL and APM software to support Veritas Storage Foundation ............................................................................................... 32 (Veritas) Removing the ASL and APM ......................................................... 33 (Veritas) Information about ASL error messages .......................................... 33 Methods for working with LUNs in native Linux environments ........... 35 Discovering new LUNs in FC and hardware iSCSI environments ........................... 35 Discovering new LUNs on Red Hat and SUSE with iSCSI and multipathing ......... 36 4 | Using Linux® Hosts with ONTAP storage Discovering new LUNs on Red Hat Enterprise Linux 4 with DM-Multipath and software iSCSI ..................................................................................................... 36 Viewing a list of LUNs .............................................................................................. 37 Examples of sanlun, iscsiadm, iscsi output when used to view LUNs ......... 37 Enabling device persistence for newly discovered LUNs ......................................... 43 Removing an unmapped LUN ................................................................................... 43 (Veritas) LUN access when using VxDMP ............................................... 45 Discovering new LUNs on Veritas with FC .............................................................. 45 Discovering new LUNs for Red Hat 5, 6 or 7 or SUSE 10, 11, 12, 15 and later while using Veritas and iSCSI ............................................................................. 46 Viewing LUNs mapped to the host and on VxVM disks .......................................... 46 Examples of sanlun, iscsiadm, and iscsi output when used to view LUNs on Veritas ................................................................................................. 47 (Veritas) Displaying multipathing information for VxDMP ..................................... 51 (Veritas) Examples of sanlun output for VxDMP ......................................... 51 Removing an unmapped LUN ................................................................................... 52 Displaying available paths using VxVM on Veritas ................................................. 52 (FC) Setting up a SAN boot LUN on Red Hat Enterprise Linux ........... 54 (FC) Setting up a SAN boot LUN on SUSE Linux Enterprise Server ... 55 (FC) Configuring the root partition with DM-Multipath on SUSE Linux Enterprise Server ................................................................................................. 55 (iSCSI) SAN boot configuration for iSCSI hardware, software initiators .................................................................................................. 57 (Hardware iSCSI) Configuring SAN boot on Red Hat Enterprise Linux ................. 57 (Native multipathing) Using sanlun to display DM-Multipath information ............. 58 (Native multipathing) Examples of sanlun output containing DM- Multipath information ............................................................................. 58 (Software iSCSI) Configuring SAN boot on Red Hat Enterprise Linux 5 or 6 series .................................................................................................................... 61 Configuring SAN boot on Red Hat Enterprise Linux 7 series .................................. 62 (Software iSCSI) Configuring SAN boot on SUSE Linux Enterprise Server .......... 63 (Software iSCSI) Configuring multipathing for a SAN boot LUN using SUSE Linux Enterprise Server ....................................................................................... 65 Configuring SAN boot in a Veritas environment ..................................... 66 Support for host virtualization .................................................................. 68 Hypervisor VHD requires alignment for best performance ...................................... 68 Supported Linux and Data ONTAP features ........................................... 70 Protocols and configurations supported by Host Utilities ......................................... 70 The FC protocol ............................................................................................ 70 The FCoE protocol ........................................................................................ 71 The iSCSI protocol ........................................................................................ 71 SAN booting .................................................................................................. 71 Support for Linux Device Mapper Multipathing .......................................... 72 Volume management and multipathing with Veritas Storage Foundation .... 72 Linux configurations that support ALUA ..................................................... 72 Table of Contents | 5 Troubleshooting .......................................................................................... 74 LUNs not recognized by DM-Multipath ................................................................... 74 (FC) LUNs not visible on the Linux host .................................................................. 74 FC troubleshooting .................................................................................................... 75 (FC) Warnings displayed during Host Utilities installation .......................... 75 (FC) Linux hosts with QLogic initiators fail to detect LUNs ....................... 76 (FC) The SAN booted root on a DM-Multipath host freezes during FC path faults ................................................................................................ 76 (FC) Poor performance due to misalignment of partitioned LUNs .............. 76 (FC) sanlun command displays error when HBA libHBAAPI.so is missing ..................................................................................................... 77 (FC) LUNs are unavailable after a storage system failover or giveback ....... 77 (FC) SCSI rescan issues on SUSE Linux Enterprise Server hosts