Installing HBAs/Drivers on an AIX Host

 

Topic

Setting up a host environment

Selections

Select a host: AIX

Select a AIX host task: Installing HBAs/drivers

 

 

Contents

Installing HBA(s) on an AIX Host 3

Installing an HBA driver on an AIX host 4

Install the EMC ODM Support package for AIX.. 5

Determine WWPN of new HBA for AIX.. 6

Making LUNs or Devices available to AIX.. 6

 


 

Install/Setup HBA/Driver Environment on AIX

Using various procedures, this section for HP-UX, featuring AIX environments describes how to install and setup host bus adapters and other aspects of a host environment that deal with managing devices of a storage system. A series of procedures take you from installing HBAs, HBA drivers, to installing and setting up HBA firmware and drivers.

 

            Installing HBA(s) on an AIX Host

 

Overview

This procedure for IBM AIX explains how to install and setup host bus adapters for the Symmetrix storage management environment.

 

These procedures are based on content from the following EMC documentation:

  • EMC Host Connectivity guide for IBM AIX
  • EMC Support Matrix AIX

 

You can download these guides from EMC Online Support (registration required): https://support.EMC.com

 

Accessed from the Powerlink home page, mouse over the Support>
Interoperability/Compatibility/Configuration>E-Lab Interoperability Navigator, and click Launch E-Lab Interoperability Navigator. From there you can search for IBM AIX support documentation.

 

If the host does not already have Fibre Channel HBAs installed, install them as described in the host documentation.

 

NOTE: IBM documentation often specifies where an HBA can be installed in a host. Some warranties may become void if the HBAs are installed without Professional Services. Contact the host vendor if you are uncertain.

 

Skip the following four steps if the HBA(s) are already installed.

 

1.   

Stop all I/O and shutdown

Stop all I/O to the storage systems connected to where the new HBA will be installed.

 

Shut down AIX on the host system where the new HBA will be installed, using the following command:

 

shutdown F

 

With host system power removed, install the HBA(s) by following the HP instructions included with your adapter. The adapter installs into a single slot per HP requirements.

 

Repeat the installation steps for each host system in which you are installing Fibre Channel HBAs.

 

 

2.   

Install adapter in card slot

With host system power removed, install the host bus adapters by following the IBM AIX instructions included with your adapter. The adapter installs into a single slot per AIX requirements.

 

Repeat the installation steps for each host system in which you are installing Fibre Channel HBAs.

 

 

3.   

Install the hardware

Install and cable the new HBA hardware. Label each cable to identify the HBA and the FA, hub, or switch port that it connects.

 

 

4.   

Apply power and boot

Reapply power and allow the system to boot normally.

 

By default, the hdisks will be in a failed over state.

 

 

 

7Table of Contents

            Installing an HBA driver on an AIX host

1.   

Overview

This procedure for IBM AIX explains how to install the HBA drivers for the Symmetrix storage management environment.

 

These procedures are based on content from the following EMC documentation:

  • EMC Host Connectivity guide for IBM AIX
  • EMC Support Matrix AIX

 

You can download these guides from EMC Online Support (registration required): https://support.EMC.com

 

 

2.   

Locate the appropriate driver software:

When installing or upgrading drivers, be sure to use the latest versions supported by EMC. Review the E-Lab Interoperability Navigator for the latest information on approved HBAs and drivers. Refer to the release notes provided with the driver for information that might be unique to new driver revisions.

On the host, find the installed driver version using the lslpp command. For example:

lslpp -al |grep df1000


devices.pci.df1000f7.com 5.1.0.0 COMMITTED Common PCI FC Adapter Device
devices.pci.df1000f7.diag 5.1.0.0 COMMITTED PCI FC Adapter Device
devices.pci.df1000f7.rte 5.1.0.0 COMMITTED PCI FC Adapter Device Software
devices.pci.df1000f9.diag 5.1.0.0 COMMITTED 64-bit PCI FC Adapter Device
devices.pci.df1000f9.rte 5.1.0.0 COMMITTED 64-bit PCI FC Adapter Device
devices.pci.df1000f7.com 5.1.0.0 COMMITTED Common PCI FC Adapter Device
devices.pci.df1000f7.rte 5.1.0.0 COMMITTED PCI FC Adapter Device Software#

 

 

3.   

Get appropriate drivers:

Compare the installed driver version with the required version as identified in the E-Lab Interoperability Navigator.

If the correct version is not installed, obtain the driver(s) from the operating system vendor and install them as described in the operating system documentation.

 

 

4.   

Verify that you have a copy of the EMC config share file:

Download the emc_cfgmgr.sh file from the following EMC ftp URL:

 

ftp://ftp.emc.com/pub/elab/powerpath/aix

 

Note: Make sure that the most recent version of this script is used. Older versions of emc_cfgmgr.sh may not configure Symmetrix devices correctly.

 

Later in this procedure, you will be asked to copy this file to the AIX host.

 

 

 

7Table of Contents

 

            Install the EMC ODM Support package for AIX

  1.  

Install the IBM Fibre Channel Interface Support software (ODM) on the AIX server. The ODM software enables the host operating system to recognize devices as belonging to a Symmetrix storage system.

 

NOTE: If any version of CLArrayS3 is already installed, it must be removed before installing the EMC ODM Support package. If necessary, refer to the EMC Host Connectivity Guide for IBM AIX manual (P/N 300-000-608) for more information.

 

 

2.   

Download EMC ODM:

Download the most recent EMC ODM Support package for the AIX version from Powerlink. The file can be found at the following Location :

 

Home > Support > Downloads and Patches > Downloads A-C > AIX ODM Definitions

 

Alternatively You can download them from the EMC FTP site:

 

ftp://ftp.EMC.com/pub/elab/aix/ODM_DEFINITIONS

 

Please review the Readme.txt file to ensure you are using the proper ODM package.

 

 

3.   

Uncompress the file set:

In the /tmp directory, uncompress the file set. Substitute the appropriate filename revision for the command to work properly:

 

uncompress EMC.AIX.X.X.X.tar.Z

 

 

4.   

Untar the file set:

After you uncompress the file set, you will be left with a file with the .tar extension. Untar the resulting file. Substitute the appropriate filename revision for the command to work properly:

 

tar xvf EMC.AIX.X.X.X.tar

 

 

5.   

If the SMIT menu interface is preferred, invoke smit installp from the /tmp directory.

 

Select Install and Update from LATEST Available Software.

 

 

6.   

Use the List function to select /tmp as the installation directory.

 

Use the List function to select EMC Symmetrix AIX Support Software, EMC CLARiiON Fibre Channel Support Software, or both depending on your configuration.

 

EMC Symmetrix AIX Support Software; Standard utility support.
EMC Symmetrix FCP Support Software; IBM Fibre Channel driver support.
EMC Symmetrix FCP MPIO Support Software; IBM default PCM MPIO support.
EMC Symmetrix FCP PowerMPIO Support Software; PowerPath custom PCM MPIO support.
EMC Symmetrix iSCSI Support Software; IBM iSCSI driver support.

 

 

7.   

Press Enter after making all desired changes. You can use the default options.

 

 

8.   

Be sure to scroll all the way down to the bottom of the window to see the Installation Summary, and verify that the SUCCESS message is displayed.

 

 

 

 

       Determine WWPN of new HBA for AIX

 

Overview

This procedure describes how to determine the WWPN of the newly installed HBA or HBAs.

 

 

1.   

Identify the WWPN of each HBA (AIX)

For each Fibre Channel HBA that you are connecting to the storage system, identify the World Wide Port Name (WWPN) of each HBA using the following command:

 

lscfg vpl device_name

 

Where device_name is the name of the HBA device.

 

NOTE: To find the names of devices, enter the lscfg command with no arguments and look for device names beginning with fsc.

 

In the output, the Network Address field identifies the WWPN. Record the WWPN of each HBA as you will need to refer to this information.

 

 

 

 

       Making LUNs or Devices available to AIX

 

Overview

This procedure describes how to make the devices or LUNs available or visible to an AIX host. It describes how to use the fdisk command to label and partition devices.

 

Note and Caution: If your host system cannot see the devices, it may necessary to do a disk or device scan of the I/O bus with this procedure. If you must, at an appropriate low-peak time in your production environment, apply the necessary operating system native commands, to perform a device scan (discover) to make the devices visible to the host workstation. This might take a few minutes or so to execute. Be sure you follow your operating system specific administrators guide and/or known site procedures for this operation, as scanning devices can cause pauses and crashes to other operational processes running on this host. If you can and prefer, a reboot will also accomplish the same thing (device discovery). The following steps are provided only as a general or possible guide and not meant to supersede your site preferences.

 

 

5.   

Partition devices:

A disk is configured and made available to AIX through the device configuration method included with the ODM definitions. The configuration method defines and configures all devices that are assigned to the host by the Symmetrix storage array as AIX hdisk devices.

 

a.      To configure previously bound LUNs under AIX, run the following command:

/usr/lpp/EMC/Symmetrix/bin/emc_cfgmgr

 

6.   

Create filesystems on partitions:

To view all the devices in the list, enter:

 

lsdev Cc disk

AIX will display a list of disk entries. For example:

 

        An internal SCSI disk drive would appear similar to the following:

hdisk0 Available 40-60-00-4,0 16 Bit SCSI Disk Drive

        If your system is running the Symmetrix ODM package, a Symmetrix RAID 5 device would appear similar to the following:

hdisk1 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk2 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk3 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk4 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk5 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk6 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk7 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk8 Available 07-08-02 EMC Symmetrix FCP Raid1

hdisk9 Available 07-08-02 EMC Symmetrix FCP Raid1


Note:
In the previous example, 07-08-02 is the location code. Location codes are in the format AB-CD-EF - where AB identifies which bus into which the adapter is plugged, CD identifies which slot in the bus into which the adapter is plugged, and EF is the pseudo qualifier that is specified by the high-order FC-AL Address ID switch on the storage system. For complete information on location codes, refer to the AIX documentation.

 

An hdisk device listed as Available is in a normal state and ready to accept I/O. If an hdisk is listed as defined, it is not currently available to AIX and not ready for I/O requests. You can obtain the same information through SMIT by entering the smit disk command at the shell prompt and selecting List All Defined Disks from the Fixed Disk menu. After viewing the status screen that SMIT displays, press F3 or Esc+0 (zero) to exit the display.

 

 

7.   

Multiple path considerations:

If more than one path exists for a given LUN, AIX creates a unique hdisk for each path. If this is the case with PowerPath installed, an hdiskpower device is created for each set of hdisks that map to the same physical LUN, in order to handle failover functions for this Symmetrix device. The hdiskpower devices also appear along with the hdisks when running the lsdev -Cc disk command.

 

If PowerPath is installed and multiple paths exist between the host and Symmetrix storage, but hdiskpower devices are not present after running the emc_cfgmgr command, run the powermt config command to configure them.

 

 

8.   

Once Symmetrix devices are fully configured and available to AIX, they can be placed into volume groups and have logical volumes and file systems created on them for storing customer data.

 

Note: If AIX does not recognize any LUNs, verify the connection to the Storage Array.

 

 

 

7Table of Contents