Skip to main content
SAN hosts and cloud clients

Install Solaris Host Utilities 6.2

Contributors netapp-ranuk

The Solaris Unified Host Utilities assists you in managing NetApp ONTAP storage attached to a Solaris host.

The Solaris Host Utilities 6.2 supports several Solaris environments and multiple protocols. The primary host utilities environments are:

  • Native OS with MPxIO with either the Fibre Channel (FC) or iSCSI protocol on a system using either a SPARC processor or an x86/64 processor.

  • Veritas Dynamic Multipathing (DMP) with either the FC or iSCSI protocol on a system using a SPARC processor, or the iSCSI protocol on a system using an x86/64 processor.

The Solaris Unified Host Utilities 6.2 continues to support the following versions of Solaris:

  • Solaris 11.x series

  • Solaris 10.x series

What you'll need

  • For reliable operation, verify that your entire iSCSI,FC or FCoE configuration is supported.

You can use the NetApp Interoperability Matrix Tool to verify your configuration.

Note The NetApp Solaris Host Utilities software package is available on the NetApp Support Site in a compressed file format for your processor. You can download the Host Utilities software package for your environment from the Support site.
Steps

  1. Login to your host as root.

  2. Download a copy of the compressed file containing the Host Utilities from the NetApp Support Site to a directory on your host.

    At the time this documentation was prepared, the compressed files were called:

    • SPARC CPU: netapp_solaris_host_utilities_6_2_sparc.tar.gz

    • x86/x64 CPU: netapp_solaris_host_utilities_6_2_amd.tar.gz

  3. Go to the directory containing the download.

  4. Unzip the file using the gunzip command:

    # gunzip netapp_solaris_host_utilities_6_2_sparc.tar.gz

  5. Unzip the file. You can use the tar xvf command to do this.

    # tar xvf netapp_solaris_host_utilities_6_2_sparc.tar

  6. Add the packages that you extracted from tar file to your host. You can use the pkgadd command to do this.

    The packages are added to the /opt/NTAP/SANToolkit/bin directory. The following example uses the pkgadd command to install the Solaris installation package:

    # pkgadd -d ./NTAPSANTool.pkg

  7. Confirm that the toolkit was successfully installed by using the pkginfo command or the ls - al command.

    # ls -alR /opt/NTAP/SANToolkit
/opt/NTAP/SANToolkit:
total 1038
drwxr-xr-x   3 root     sys            4 Jul 22  2019 .
drwxr-xr-x   3 root     sys            3 Jul 22  2019 ..
drwxr-xr-x   2 root     sys            6 Jul 22  2019 bin
-r-xr-xr-x   1 root     sys       432666 Sep 13  2017 NOTICES.PDF

/opt/NTAP/SANToolkit/bin:
total 7962
drwxr-xr-x   2 root     sys            6 Jul 22  2019 .
drwxr-xr-x   3 root     sys            4 Jul 22  2019 ..
-r-xr-xr-x   1 root     sys      2308252 Sep 13  2017 host_config
-r-xr-xr-x   1 root     sys          995 Sep 13  2017 san_version
-r-xr-xr-x   1 root     sys      1669204 Sep 13  2017 sanlun
-r-xr-xr-x   1 root     sys          677 Sep 13  2017 vidpid.dat

# (cd /usr/share/man/man1; ls -al host_config.1 sanlun.1)
-r-xr-xr-x   1 root     sys        12266 Sep 13  2017 host_config.1
-r-xr-xr-x   1 root     sys         9044 Sep 13  2017 sanlun.1

  8. After you finish, configure the host parameters for your environment using the /opt/NTAP/SANToolkit/bin/host_config command:

    • MPxIO

    • Veritas DMP

  9. Verify the installation:

    sanlun version

SAN Toolkit

Solaris Host Utilities is a NetApp host software that provides a command line toolkit on your Oracle Solaris host. The toolkit is installed when you install the NetApp Host Utilities package. This kit provides the sanlun utility which helps you manage LUNs and host bus adapters (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 the LUN information.

#sanlun lun show all
controller(7mode)/ device host lun
vserver(Cmode)                     lun-pathname       filename                                       adapter protocol size mode
-----------------------------------------------------------------------------------------------------------------------------------
data_vserver                     /vol/vol1/lun1     /dev/rdsk/c0t600A098038304437522B4E694E49792Dd0s2 qlc3   FCP       10g cDOT
data_vserver                     /vol/vol0/lun2     /dev/rdsk/c0t600A098038304437522B4E694E497938d0s2 qlc3   FCP       10g cDOT
data_vserver                     /vol/vol2/lun3     /dev/rdsk/c0t600A098038304437522B4E694E497939d0s2 qlc3   FCP       10g cDOT
data_vserver                     /vol/vol3/lun4     /dev/rdsk/c0t600A098038304437522B4E694E497941d0s2 qlc3   FCP       10g cDOT
Note This toolkit is common across all Host Utilities configurations and protocols. As a result, some toolkit content might apply to one configuration, but not another. Having unused components does not affect your system performance.