Skip to main content
ONTAP SAN Host Utilities

Install Linux Host Utilities 8.0 for ONTAP storage

Contributors netapp-pcarriga
PDFs

The Linux Host Utilities help you manage ONTAP storage attached to a Linux host. NetApp strongly recommends installing the Linux Host Utilities, but it isn't mandatory. The utilities improve management and assist NetApp customer support in gathering information about your configuration.

Linux Host Utilities 8.0 supports the following distribution types:

  • Red Hat Enterprise Linux (RHEL)

  • SUSE Linux Enterprise Server

  • Oracle Linux

  • Ubuntu

Note The Linux Host Utilities software doesn't support NVMe over Fibre Channel (NVMe/FC) and NVMe over TCP (NVMe/TCP) host protocols.
About this task

When you install the Linux Host Utilities, it doesn't change any settings on your Linux host.

Before you begin

  • For reliable operation, use the Interoperability Matrix Tool to verify that your iSCSI, FC, or FCoE configuration is supported.

  • Install the host bus adapter (HBA) management packages available on the vendor support site. The management software enables the sanlun commands to gather information about the FC HBAs, such as their WWPNs.

    Refer to the vendor documentation to verify that the following packages are correctly installed. These packages are required to support the sanlun fcp show adapter command:

    • Marvell QLogic HBA – QConvergeConsole CLI

    • Broadcom Emulex HBA - OneCommand Manager core application CLI

Steps

  1. If you have a version of Linux Host Utilities currently installed, remove it:

    Linux hosts

    Remove Linux Host Utilities from a RHEL, SUSE Linux Enterprise Server, or Oracle Linux host:

    rpm -e netapp_linux_unified_host_utilities-x-x
    Ubuntu

    Remove Linux Host Utilities from an Ubuntu host:

    sudo apt remove netapp_linux_unified_host_utilities-x-x

    For earlier 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. The NetApp Linux Host Utilities software package is available on the NetApp Support Site in a 64-bit .rpm file. Download the 64-bit file from the NetApp Support Site to your host.

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

    Linux hosts

    Install Linux Host Utilities 8.0 on a RHEL, SUSE Linux Enterprise Server, or Oracle Linux host:

    rpm -ivh netapp_linux_unified_host_utilities-8-0.x86_xx.rpm

    You should see an output similar to the following example:

    rpm -ivh netapp_linux_unified_host_utilities-8-0.x86_64.rpm
Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:netapp_linux_unified_host_utiliti################################# [100%]
    Ubuntu

    1. Install Linux Host Utilities 8.0 on an Ubuntu host:

      sudo apt install /<path_to_file>/netapp_linux_unified_host_utilities-8-0.x86_xx.deb

    2. Manually link the Ubuntu OS to the HBA library:

      cp /opt/QLogic_Corporation/QConvergeConsoleCLI/lib64/libHBAAPI.so.2.0.2 /usr/lib64/libHBAAPI.so

  4. Verify the installation:

    sanlun version

    You should see an output similar to the following example:

    sanlun version 8.0.386.1644

What's next?

  • Recommended driver settings with Linux kernel

    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.

  • Learn about the "sanlun" utility.