Skip to main content
SAN hosts and cloud clients

Install Linux Unified Host Utilities 7.1

Contributors netapp-ranuk netapp-aherbin netapp-aoife
PDFs

The Linux Unified Host Utilities (LUHU) assists you to manage NetApp ONTAP storage attached to a Linux host. NetApp strongly recommends installing the Linux Unified Host Utilities, but it is not mandatory. The utilities do not change any settings on your Linux host. The utilities improve management and assist NetApp customer support in gathering information about your configuration.

The following Linux distributions are supported:

  • Red Hat Enterprise Linux

  • SUSE Linux Enterprise Server

  • Oracle Linux

  • Oracle VM

  • Citrix XenServer

What you'll need

The NetApp Linux Unified Host Utilities software package is available on the NetApp Support Site in a 32-bit or 64-bit .rpm file.

  • 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 host bus adapter (HBA) management packages available on the vendor support site.

    The management software enables the SAN toolkit commands to gather information about the FC HBAs, such as their WWPNs. For the sanlun fcp show adapter command to work, verify that the following packages are correctly installed:

    • Marvell QLogic HBA – QConvergeConsole CLI

    • Broadcom Emulex HBA - OneCommand Manager core application CLI

    • Marvell Brocade HBA – Brocade Command Utility CLI

  • RPM Packages "libhbaapi" and "libhbalinux" available for each Linux distribution should be installed on the host OS.

Note Linux Unified Host Utilities software does not support NVMe over Fibre Channel (NVMe/FC) and NVMe over TCP (NVMe/TCP) host protocols.
Steps

  1. If you have a version of Linux Unified Host Utilities currently installed, use the following command to remove it:

    rpm -e netapp_linux_unified_host_utilities-7-1

    For older versions of Linux Host Utilities, go to the directory where the host utility software is installed and enter the uninstall command to remove the installed package.

  2. Download the 32-bit or 64-bit Linux Unified Host Utilities software package from the NetApp Support Site to your host.

  3. Go to the directory to which you downloaded the software package and use the following command to install it:

    rpm -ivh netapp_linux_unified_host_utilities-7-1.x86_xx.rpm

    Example output

    Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:netapp_linux_unified_host_utiliti################################# [100%]

  4. Verify the installation:

    sanlun version

    Example output

    sanlun version 7.1.386.1644

When you configure an FC environment that uses native inbox drivers that are bundled with the Linux kernel, you can use the default values for the drivers.

SAN Toolkit

Linux 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 the sanlun utility, which helps you manage LUNs and HBAs. The sanlun command returns information about the LUNs mapped to your host, multipathing, and information necessary to create initiator groups.

Example

In the following example, the sanlun lun show command returns LUN information.

# sanlun lun show all

Example output:

controller(7mode/E-Series)/            device     host               lun
vserver(cDOT/FlashRay)   lun-pathname  filename   adapter  protocol  size    Product
------------------------------------------------------------------------------------
data_vserver          /vol/vol1/lun1   /dev/sdb   host16   FCP       120.0g  cDOT
data_vserver          /vol/vol1/lun1   /dev/sdc   host15   FCP       120.0g  cDOT
data_vserver          /vol/vol2/lun2   /dev/sdd   host16   FCP       120.0g  cDOT
data_vserver          /vol/vol2/lun2   /dev/sde   host15   FCP       120.0g  cDOT
Note

  • This toolkit is common across all configurations and protocols of the Host Utilities. As a result, some of its contents apply to one configuration, but not another. Having unused components does not affect your system performance.

  • The SAN toolkit is not supported on Citrix XenServer, Oracle VM, and Red Hat Enterprise Virtualization Hypervisor.