Provisioning a New AIX Host

 

Topic

Setting up a host environment

Selections

Select a host: AIX

Select a AIX host task: Provisioning a new host

Select a switch type: Brocade

 

 

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

·             Creating switch zones. 7

·             Adding Symmetrix Devices. 8

·             Mapping Devices within Symmetrix. 13

·             Masking Devices. 18

·             Making LUNs or Devices available to AIX.. 22

·             Creating a Device Group.. 23

·             Install PowerPath software on an AIX host 25

 


 

Provisioning a new AIX host

This section describes how to setup a new AIX host for the Symmetrix storage management environment. A series of procedures take you from installing HBAs, HBA firmware and drivers, zoning, mapping/masking devices, and creating device groups to making LUNs available.

 

 

7Table of Contents

 

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.

 

 

 

 

·        Creating switch zones

 

Overview

For directions specific to Brocade switches, refer to the Brocade Fabric Manager Administrator’s Guide, which is located on Powerlink under the following location:

 

Home > Support > Documentation/White Paper Library > Hardware/Platforms Documentation > Connectrix Directors and Switches > Maintenance/Administration

 

Please refer to the section Managing Zones, which will provide the background information needed to configure and zone your fabric.

 

Note: There are multiple versions of the user guide available. Be sure to reference the version specific to your Fabric Manager version.

 

5.   

Create switch zones

Switch zones define paths between the host HBAs and the Symmetrix array and can be created using the switch management software (refer to the switch documentation).

 

Note:  If you are using an HP-UX server with QuickLoop zoning, then you must use port zoning.  Refer to EMC Knowledgebase article emc66355 for more information.

 

Definition -

Zoning is the process by which a single initiator is matched to a single storage array port (FA/SP) to be able to pass info to storage array device.

 

A Zone consists of 2 or more members, with only 1 initiator (HBA) per zone

A Zone is part of a zoneset .

A Zoneset is a collection of zones in a single fabric.

A Zoneset requires activation in order to be updated.

 

Important:  EMC Recommends single initiator zoning. To reduce the chance of data unavailability in the event that an HBA, switch, or FA Failure,  the host should have at least one primary path and one alternate path to each FA

 

 

6.   

Determine zoning configuration

Follow these steps to determine your zoning configuration:

a.      Determine the FA WWN by entering the following command:

symcfg –sid XXXX list –fa all

b.      Determine the HBA WWN by referencing the OS-specific commands from provisioning a host section.

c.      Determine the number of paths needed.

d.      Determine the Active Zone name.

The operations above must be performed on both fabrics for all FAs and HBAs.

 

7.   

Verify the HBA is logged in

Solutions Enabler offers a command line utility that will verify what is logged in to a specific Symmetrix FA. Use the following command:

 

symmask –sid SymmID –dir 3c –p 0 list logins

 

Where SymmID is the last four numbers of the Symmetrix serial number, 3c is the FA and 0 is the port on the FA.

 

It should also be noted that HBAs in an HP-UX host only show as logged in while there is active I/O.  However, if an entry exists in the login history table, it indicates that the HBA did log into the FA at some point.

 

After verifying that the host is logged in, move on to configuring the host.

 

 

7Table of Contents

 

 

 

 

·        Adding Symmetrix Devices

 

Overview

This procedure explains how to add or create Symmetrix devices from the array’s free physical disk space.

 

This procedure is based on content from the following EMC manual:

  • EMC Solutions Enabler Symmetrix Array Controls CLI Product Guide

 

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

 

 

1.

Look for free space

To check for available free space before you begin, enter the following command:

 

   symconfigure –sid SymmID list –freespace -units CYLINDERS | MB

 

where:

 

SymmID = The ID of a specific Symmetrix the symconfigure command is to be executed against.

 

For example, to see how much free space is available on a Symmetrix with an ID of  000000012345, execute one of the following commands:

 

symconfigure –sid 12345 list –freespace -units CYLINDERS

 

or

 

symconfigure –sid 12345 list –freespace -units MB

 

2.

Build a command file that will be used to add the device

The create dev command is used to add or create a Symmetrix device. The syntax for this command is:

 

create dev count=n, size=Cylinders,

  emulation=EmulationType,

  config=DeviceConfig,

  [, data_member_count=nn]

  [, remote_config=DeviceConfig, remote_data_member_count=nn, ra_group=n,

    [dynamic_capability=[dyn_rdf | dyn_rdf1_only |dyn_rdf2_only], ]

  [, attribute=ckd_meta | savedev

  [in pool PoolName] [member_state=ENABLE | DISABLE], ]

  [, disk_group_num=nnn, remote_disk_group _num=nnn];

 

where:

count = The number of devices to create.

 

size = The size of the device needed in number of cylinders. In Symmetrix DMX models, a cylinder of an FBA device contains 1920 512-byte blocks, or 0.98 megabytes. In earlier Symmetrix models, a cylinder of an FBA device contains 960 512-byte blocks or, 0.468 megabytes. To calculate the number of cylinders, use one of the following calculations:

 

Blocks ÷ 960

or

(Device size in megabytes) x 10242 ÷ (960 x 512 bytes)

or

(Size in megabytes) x 2.1333

Note: Devices to be used as BCV devices, SRDF devices, or metamembers will need to precisely match corresponding device sizes. Use symdev/sympd show or symdev/sympd list –cyl commands to see relevant device sizes.

 

For additional information about sizing devices in cylinders, refer to Chapter 1 of the Solutions Enabler Symmetrix Array Management CLI Product Guide.

 

emulation = The device emulation type, which currently must be fixed block architecture (FBA), CELERRA FBA, VME512 FBA, or CKD-3380, or CKD-3390 for z/OS environments.

 

config = The desired device configuration type. For possible values, see the Solutions Enabler Symmetrix Array Control CLI Product Guide.

 

data_member_count = The number of data members when creating RAID 5 or RAID 6 devices on a Symmetrix array with Enginuity version 5772 and higher.

The user should set the value to 3 or 7 for RAID 5 (3+1) and RAID 5 (7+1), or  6 or 14 for RAID 6 (6+2) and RAID 6 (14+2).

 

remote_config = The desired remote SRDF configuration (if any). Managing Configuration Changes

remote_data_member_count = The number of remote data members when creating RDF RAID 5 or RAID 6 devices on a Symmetrix array with Enginuity version 5772 and higher. Set the value to 3 or 7 for RAID 5 (3+1) and RAID 5 (7+1) or, 6 or 14 for RAID 6 (6+2) and RAID 6 (14+2).

 

ra_group = The RA group number in the SRDF environment.

 

dynamic_capability = The type of dynamic SRDF device to create. Possible values are:

 

dyn_rdf — Creates a dynamic SRDF device.

dyn_rdf1_only — Creates a dynamic R1 SRDF device.

dyn_rdf2_only — Creates a dynamic R2 SRDF device.

 

The specified dynamic capability will be applied to the local device and the corresponding remote device will be assigned a complementary dynamic capability, according to the following:

 

  Local device     Remote device

  dyn_rdf          dyn_rdf

  dyn_rdf1_only    dyn_rdf2_only

  dyn_rdf2_only    dyn_rdf1_only

 

attribute = The desired device attribute. Possible values are:

 

ckd_meta — When creating a device with an emulation type of CKD-3380 or CKD-3390, this indicates that the device should be a striped metadevice. CKD metadevices must be created in sets of four devices.

 

savedev — When creating a device, this indicates that the device should be a SAVE device. The device will become part of a pool of devices that are used with TimeFinder/Snap for virtual device Snap operations.

 

PoolName = The name of the SAVE device pool. It can be from 1 to 12 alphanumeric characters long and include hyphens ( - ), and underscore ( _ ) characters. The name DEFAULT_POOL is reserved to represent the container of all unpooled devices.

 

member_state = States whether the SAVE device(s) being added should be enabled or disabled in the pool.

Managing Configuration Changes

disk_group_num = When creating a device, this option allows you to specify a disk group. A disk group is a set of physical disks set aside to be used to create devices of the protection level. Disk group usage may improve the performance of some configurations.

 

To see how disk groups are organized in your configuration, use the following commands:

 

symdisk -sid SymmID list -by_diskgroup

 

and

 

symdev -sid SymmID list -diskgroup(nn)

 

remote_disk_group_num = When creating a device, this option allows you to specify a remote disk group.

 

Using a text editor, such as Notepad or the UNIX vi Editor, create a command file that contains one or more create dev commands. (For this procedure, a file named adddevices.cmd is used.)

 

For example, to add four new Symmetrix devices to Symmetrix array 000000012345 as two-way mirrored devices with a size of 1100 cylinders (516 MB) using FBA emulation, and to create the hypers to support the new devices in disk group 1, create a command file that contains the following line:

 

create dev count=4, size=1100, emulation=FBA, config=2-Way-Mir disk_group=1;

 

Note: If the Symmetrix array being used contains an EA, CA, or EF adapter, a value for the mvs_ssid parameter must be provided so any new FBA devices created are not seen as part of an existing subsystem ID group. If that is the case, a command line that looks more like this should be used instead:

 

create dev count=4, size=1100, emulation=FBA, mvs_ssid=1, config=2-Way-Mir disk_group=1;

 

 

3.

Commit the command file used to create the device(s)

Commit the command file created in the previous step (and activate the device creation command) by executing a symconfigure command that looks something like this:

 

symconfigure -sid SymmID -file CmdFile -v -noprompt commit

 

where:

 

SymmID = The ID of a specific Symmetrix the symconfigure command is to be executed against.

 

CmdFile = A file containing one or more create dev commands.

 

For example, to commit the commands in a command file named adddevices.cmd against a Symmetrix with an ID of 000000012345, use the following command:

 

symconfigure -sid 12345 -file adddevices.cmd -v -noprompt commit

 

When this command is executed, you should see output that looks something like this:

 

A Configuration Change operation is in progress. Please wait...

 

    Establishing a configuration change session...............Established.

 

 

    Processing symmetrix 000000012345

    {

      create dev count=4, size=1100 cyl, emulation=FBA, config=2-Way Mir,

        mvs_ssid=0, disk_group=1;

    }

 

    Performing Access checks..................................Allowed.

    Checking Device Reservations..............................Allowed.

    Submitting configuration changes..........................Submitted

    Validating configuration changes..........................Validated.

 

      New symdevs: 0918:091B

    Initiating PREPARE of configuration changes...............Prepared.

    Initiating COMMIT of configuration changes................Queued.

    COMMIT requesting required resources......................Obtained.

    Step 002 of 078 steps.....................................Executing.

    Step 004 of 078 steps.....................................Executing.

    Step 004 of 078 steps.....................................Executing.

 

...

 

    Step 111 of 151 steps.....................................Executing.

    Step 114 of 151 steps.....................................Executing.

    Step 151 of 151 steps.....................................Executing.

    Local:  COMMIT............................................Done.

    Terminating the configuration change session..............Done.

 

The configuration change session has successfully completed.

 

It is important to note that when creating devices there is no impact on I/O activity.

 

 

4.

Verify that the desired devices were created

To verify that the desired devices were created, enter the following command:

 

   symdev –sid SymmID list

 

where:

 

SymmID = The ID of a specific Symmetrix the symdev command is to be executed against.

 

For example, to see if new devices were successfully created on a Symmetrix with an ID of 000000012345, execute the following command:

 

symdev –sid 12345 list

 

The devices that were just created should be displayed at the bottom of the list produced.

 

 

 

7Table of Contents

 

 

 

·        Mapping Devices within Symmetrix

 

Overview

This procedure describes how to map devices within the Symmetrix array. You can map devices to front-end director ports, or a range of devices to consecutive addresses by specifying a starting address.

 

This procedure is based on contents from the following EMC manual:

  • EMC Solutions Enabler Symmetrix Array Controls CLI Product Guide

 

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

 

 

8.  

Identify Symmetrix devices that have not been mapped

Identify Symmetrix devices that have not been mapped to any front-end adapter ports by executing a symdev command that looks like this:

 

symdev –sid SymmID list -noport

 

where:

 

SymmID = The ID of a specific Symmetrix the symdev command is to be executed against.

 

For example, to obtain a list of Symmetrix devices that have not been mapped to a front-end adapter on a Symmetrix with an ID of 000000012345, execute the following command:

 

symdev –sid 12345 list -noport

 

Examine the output produced and identify the Symmetrix devices you want mapped.

 

 

9.  

Identify front-end adapters that are available

Identify the front-end adaptors that are available by executing a symcfg command that looks like this:

 

symcfg –sid SymmID list –dir all

 

where:

 

SymmID = The ID of a specific Symmetrix the symcfg command is to be executed against.

 

For example, to obtain a list of front-end adapters available on a Symmetrix with an ID of  000000012345, execute the following command:

 

symcfg -sid 12345 list -dir all

 

When this command is executed, you should see output that looks something like this:

 

Symmetrix ID: 000000012345

 

           S Y M M E T R I X    D I R E C T O R S

 

    Ident  Symbolic  Numeric  Slot  Type          Status

 

    DF-1A     01A       1       1   DISK          Online

    DF-2A     02A       2       2   DISK          Online

    DF-15A    15A      15      15   DISK          Online

    DF-16A    16A      16      16   DISK          Online

    DF-1B     01B      17       1   DISK          Online

    DF-2B     02B      18       2   DISK          Online

    DF-15B    15B      31      15   DISK          Online

    DF-16B    16B      32      16   DISK          Online

    FA-1C     01C      33       1   FibreChannel  Online

    FA-2C     02C      34       2   FibreChannel  Online

    FA-15C    15C      47      15   FibreChannel  Online

    FA-16C    16C      48      16   FibreChannel  Online

    RF-1D     01D      49       1   RDF-BI-DIR    Online

    RF-2D     02D      50       2   RDF-R1        Online

    RF-15D    15D      63      15   RDF-R1        Online

    RF-16D    16D      64      16   RDF-BI-DIR    Online

 

Examine the output produced and identify the front-end adapter to which you want  Symmetrix devices mapped.

 

 

10.  

Examine the front-end adaptor and port for available LUN Numbers

Identify the LUN numbers that are available for a specific front-end adapter and port by executing a symcfg command that looks like this:

 

symcfg –sid SymmID list –dir Adapter –p Port –address -available

 

where:

 

SymmID = The ID of a specific Symmetrix the symcfg command is to be executed against.

 

Adapter = The ID of the front-end adaptor that device information is to be collected for.

 

Port = The port number that device information is to be collected for.

 

For example, to obtain device information for adapter 16C, port 0 on a Symmetrix with an ID of 000000012345, execute the following command:

 

symcfg -sid 12345 list -dir 16c -p 0 -address -available

 

When this command is executed, you should see output that looks something like this:

 

Symmetrix ID: 000000012345

 

           Director                 Device Name    Attr     Address

    ---------------------- ----------------------- ---- --------------

    Ident   Symbolic  Port Sym   Physical               VBUS  TID  LUN

    ------  --------  ---- ----  -----------------      ----  ---  ---

    FA-16C  16C       0    0100  Not Visible               0   00  000

                           0101  Not Visible               0   00  001

                           0102  Not Visible               0   00  002

                           0103  Not Visible               0   00  003

                           0104  Not Visible               0   00  004

                           0105  Not Visible               0   00  005

...

                           08DC  Not Visible        (M)    0   00  0CC

                           -     AVAILABLE                 0   00  0CD *

                           0520  Not Visible        (M)    0   00  100

...

                           07CD  Not Visible               0   00  143

                           -     AVAILABLE                 0   00  144 *

                           07D1  Not Visible               0   00  200

...

                           0850  Not Visible               0   00  27F

                           -     AVAILABLE                 0   00  280 *

                           068C  Not Visible               0   00  68C

...

                           0697  Not Visible               0   00  697

                           -     AVAILABLE                 0   00  698 *

    Total                  ----

    Mapped Devices:         413

    Including Metamembers:  638

    Available Addresses:   3281 (s)

 

 

Legend for Available address:

 

(*): The VBUS, TID, LUN address values represent a gap in the

     address assignments or are the next available address in

     the run

(s): The Available Addresses for a director are shared among

     its ports (shared)

 

Note: An asterisk (*) in the LUN column represents an available LUN number or the next available range of numbers.

 

 

11.  

Build a command file that will be used to map devices in the Symmetrix array

The map dev command is used to map a Symmetrix device to a front-end director port. The syntax for this command is:

 

map dev SymDevName [:SymDevName] to dir DirectorNum:PortNum

[starting][target=ScsiTarget,] lun=ScsiLun

[, vbus=FibreVbus]

[, device_number=ckd_device_number]

[, awwn=awwn|wwn=wwn|iscsi=iscsi];

[, masking host_lun=lun | dynamic_lun];

 

where:

target = The SCSI target ID (hex value).

 

lun = The SCSI logical unit number (hex value).

 

dynamic_lun = The dynamic LUN addressing scheme. LUN addressing is assigned based on what may already be in use for that host HBA.

 

vbus = The virtual bus address for mapping to an FA port if using volume set addressing.

 

device_number = The CKD device number, when mapping a CKD device to a z/OS host.

 

awwn = The user-given name or alias WWN of a host HBA port, if updating a VCM database.

 

wwn = The unique 64-bit World Wide Name (WWN) identifier for an HBA port, if updating a VCM database.

 

iscsi = The iSCSI name, if updating a VCM database.

 

Note: For HP-UX operating systems, you must specify a target number, a virtual bus number, and LUN number. For Sun, AIX, and Windows, the target number should be 0 in a switched fabric environment.

 

Using a text editor, such as Notepad or the UNIX vi Editor, create a command file that contains one or more map dev commands. (For this procedure, a file named mapdevices.cmd is used.)

 

For example, to map Symmetrix device 000C to port 0 of front-end adapter 16C and assign it the LUN number 0CD, create a command file that contains the following lines:

 

map dev 000C to dir 16C:0 target=0, lun=0CD;

 

12.  

Commit the command file used to map devices

Commit the command file created in the previous step (and activate the map devices command specified) by executing a symconfigure command that looks something like this:

 

symconfigure -sid SymmID -file CmdFile -v -noprompt commit

 

where:

 

SymmID = The ID of a specific Symmetrix the symconfigure command is to be executed against.

 

CmdFile = A file containing one or more map dev commands.

 

For example, to commit the commands in a command file named mapdevices.cmd against a Symmetrix with an ID of 000000012345, use the following command:

 

symconfigure -sid 12345 –file mapdevices.cmd –v –noprompt commit

 

When this command is executed, you should see output that looks something like this:

 

A Configuration Change operation is in progress. Please wait...

 

    Establishing a configuration change session...............Established.

    Processing symmetrix 000000012345

    {

      map dev 000C to dir 16C:0 lun=0CD;

    }

 

    Performing Access checks..................................Allowed.

    Checking Device Reservations..............................Allowed.

    Submitting configuration changes..........................Submitted

    Locking devices...........................................Locked.

    Validating configuration changes..........................Validated.

    Initiating PREPARE of configuration changes...............Prepared.

    Initiating COMMIT of configuration changes................Queued.

    COMMIT requesting required resources......................Obtained.

    Step 003 of 012 steps.....................................Executing.

    Step 003 of 012 steps.....................................Executing.

    Step 009 of 012 steps.....................................Executing.

    Local:  COMMIT............................................Done.

    Terminating the configuration change session..............Done.

 

The configuration change session has successfully completed.

 

 

13.  

Rediscover the SYMAPI database

After performing the proper host procedures to update the host view, you need to complete host addressing by making sure that the host address is recognized in the SYMAPI view. To update the SYMAPI database, execute the following command:

 

symcfg discover

 

This may takes some time; please wait for completion.

 

 

14.  

Verify that the device mapping was successful

To verify that the device specified was successfully mapped to the front-end adapter, port, and LUN specified, execute the following command:

 

symdev –sid SymmID show SymDevName

 

where:

 

SymmID = The ID of a specific Symmetrix the symdev command is to be executed against.

 

SymDevName = The specific Symmetrix device that detailed information is to be displayed for.

 

For example, to display detailed information about Symmetrix device 000C on a Symmetrix with an ID of 000000012345, execute the following command:

 

symdev –sid 12345 show 000C

 

Scan the output produced and examine the section titled “Front Director Paths”. If the Symmetrix device was successfully mapped, you should see something that looks like this:

 

    Front Director Paths (1):

        {

        ------------------------------------------------------------------

                             POWERPATH  DIRECTOR   PORT             LUN

                             --------- ----------  ---- -------- ---------

        PdevName             Type      Type Num    Sts  VBUS TID SYMM Host

        ------------------------------------------------------------------

        Not Visible          N/A       FA   16C:0  RW   000  00  0CD  N/A

        }

 

 

 

 

 

·        Masking Devices

 

Overview

Masking is an operation that is used to present devices to a specific host bus adapter (HBA) and is typically utilized when control is needed over which devices are made available to hosts. In a Symmetrix environment, masking defines a relationship between one or more Symmetrix devices, front-end director ports, and HBAs that reside at a host.

 

To perform masking, you will need access to a host that has the Solutions Enabler base installed along with the device masking portion licensed. This host will need to have a fiber path to the Symmetrix and be able to see the VCM device and a gatekeeper.

 

This procedure is based on contents from the following EMC manual:

  • EMC Solutions Enabler Symmetrix Array Controls CLI Product Guide

 

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

 

 

 

 

 

15.  

Verify that the device(s) to be masked have been mapped

To verify that the device(s) to be masked have been mapped to a front-end director, port, and LUN, execute the following command:

 

symdev –sid SymmID show SymDevName

 

where:

 

SymmID = The ID of a specific Symmetrix the symdev command is to be executed against.

 

SymDevName = The specific Symmetrix device that detailed information is to be displayed for.

 

For example, to display detailed information about Symmetrix device 000C on a Symmetrix with an ID of 000000012345, execute the following command:

 

symdev –sid 12345 show 000C

 

Scan the output produced and examine the section titled “Front Director Paths”. If the Symmetrix device has been mapped, you should see something that looks like this:

 

Front Director Paths (1):

    {

    ----------------------------------------------------------------------

                             POWERPATH  DIRECTOR   PORT             LUN

                             --------- ----------  ---- -------- ---------

    PdevName                 Type      Type Num    Sts  VBUS TID SYMM Host

    ----------------------------------------------------------------------

    \\.\PHYSICALDRIVE7       N/A       FA   16C:0  RW   000  00  016  000

    }

 

Repeat this step for every device to be masked. If a device to be masked has not been mapped, you must map it to a front-end director, port, and LUN before continuing with this procedure.

 

 

16.  

Get the World Wide Name (WWN) for the Host Bus Adapter (HBA) the device(s) are to be masked to

There are several tools that can be used to obtain the WWN of installed HBAs. For example, Emulex provides a utility called HBAnywhere that can be used to obtain this information. If Solutions Enabler has been installed on a host, the syminq hba command can be used as well.

 

 

Using either the appropriate tools on the host or the configuration documentation where this information was recorded earlier, obtain the WWN for the HBA that one or more devices are to be masked to.

 

 

17.  

Mask the appropriate devices in the Symmetrix array

The symmask command is used to mask one or more devices to a specified HBA/director-port channel. The syntax for this command is:

 

symmask -sid SymmID -wwn wwn|-awwn awwn|-iscsi iscsi |-aiscsi aiscsi

add devs StartSymDev:EndSymDev|SymDevName|SymDevName,,,...

-dir DirNumber -p PortNumber [-noprompt]

 

where:

 

SymmID = The ID of a specific Symmetrix the symmask command is to be executed against.

 

wwn= A valid World Wide Name (WWN).

 

awwn = A user-given name in an ASCII WWN format.

 

iscsi = A valid iSCSI name.

 

aiscsi = A user-given name or an alias iSCSI name.

 

StartSymDev = The first Symmetrix device name in a range.

 

EndSymDev = The last Symmetrix device name in a range.

 

SymDevName = One or more specific Symmetrix device names.

 

DirNumber = A specific director number designation.

 

PortNumber = A specific port number designation.

 

Note: When masking metadevices, only the Symmetrix device name that is designated as the metadevice head should be specified (via the SymDevName parameter).

 

For example, to mask Symmetrix devices 000C and 000D, (which have already been mapped to port 0 of front-end adapter 16C on a Symmetrix with an ID of 000000012345), so that they can only be accessed by an HBA that has the World Wide Name 10:00:00:00:c9:6c:c8:12, execute the following command:

 

symmask –sid 12345 –wwn 10000000c96cc812 add devs 000C:000D -dir 16C -p 0

 

If Symmetrix devices 000C and 000D were masked to a different HBA earlier, the following message will be displayed when this command is executed:

 

The following devices are already assigned in at least one entry:

 

000C 000D

 

Would you like to continue (y/[n])?

 

If you indicate that the mask operation is to continue, the devices will be masked for multiple HBAs. (If the -noprompt option is specified, the masking operation will execute automatically without requiring user intervention.)

 

 

18.  

Verify that the device masking was successful

To verify that the device(s) specified were successfully masked, execute the following command:

 

symmaskdb –sid SymmID list database –dir DirNumber –p PortNumber

 

where:

 

SymmID = The ID of a specific Symmetrix the symmask command is to be executed against.

 

DirNumber = The specific director number the Symmetrix device was masked for.

 

PortNumber = The specific port number the Symmetrix device was masked for.

 

For example, to display a list of devices that have been masked for port 0 of front-end adapter 16C on a Symmetrix with an ID of  000000012345, execute the following command:

 

symmaskdb -sid 12345 list database –dir 16C –p 0

 

When this command is executed, you should see output that looks something like this:

 

Symmetrix ID            : 000000012345

 

Database Type           : Type6

Last updated at         : 03:55:26 PM on Tue Mar 31,2009

 

Director Identification : FA-16C

Director Port           : 0

 

                               User-generated

Identifier        Type   Node Name        Port Name         Devices

----------------  -----  ---------------------------------  ---------

10000000c96cc812  Fibre  10000000c96cc812 10000000c96cc812  000C:000D

 

 

19.  

Back up the VCMDB

The symmaskdb backup command is used to create a backup copy of the Device Masking VCMDB. The syntax for this command is:

 

symmaskdb -sid SymmID backup –file BkupFileName -noprompt

 

where:

 

SymmID = The ID of a specific Symmetrix the symmaskdb command is to be executed against.

 

BkupFileName = The name of the file to be used to store the backup copy of the Device Masking VCMDB created. (You cannot reuse backup file names; a new file name must be provided each time this command is executed.) The backup copy will be stored in the file specified and that file will be written to the current directory (i.e., the directory that this command is executed from).

 

For example, to store a backup copy of an existing Device Masking VCMDB for a Symmetrix with an ID of 000000012345 in a file named BackupDevMaskDB_1, execute the following command:

 

symmaskdb –sid 12345 backup –file BackupDevMaskDB_1 –noprompt

 

When this command is executed, you should see a message that looks something like this:

 

Symmetrix SymMask database backed up to file BackupDevMaskDB_1

from Symmetrix 000000012345

 

 

20.  

Refresh the Symmetrix director with VCMDB data

Update the Symmetrix array with the configuration changes by performing a director refresh operation. This causes the Symmetrix director to refresh its WWN/iSCSI-related profile tables in cache with the content data from the device masking VCMDB.

 

The symmaskdb refresh command is used to force a Symmetrix director to refresh its profile tables with the contents of the Device Masking VCMDB. The syntax for this command is:

 

symmask -sid SymmID refresh -noprompt

 

where:

 

SymmID = The ID of a specific Symmetrix the symmaskdb command is to be executed against.

 

For example, to force a Symmetrix director to refresh its profile tables with the contents of the Device Masking VCMDB for a Symmetrix with an ID of  000000012345, execute the following command:

 

symmask –sid 12345 refresh –noprompt

 

When this command is executed, you should see a message that looks something like this:

 

Symmetrix FA directors updated with contents of SymMask Database 000000012345

 

! Caution: Before executing this command, make sure no HBAs are accessing devices in the masked channel (in other words, make sure that no application or user activity is taking place on the HBAs that are about to be refreshed). !

 

 

21.  

Run the appropriate configuration method on all affected hosts or reboot all affected hosts

Many host operating systems provide a utility that can be used to automatically configure devices that have been made available to a system. For example, in Windows you can use the Device Manager to scan for hardware changes; with AIX you can execute the cfgmgr command. Before masked devices will be made visible to a host, this utility must be run on all hosts that have had devices added or removed (via masking changes). If no such utility exists, the affected hosts should be rebooted.

 

Refer to the online help available with each host operating system for information on how to perform online configuration changes or a reboot operation.

 

 

22.  

Rebuild the Symmetrix configuration database on all appropriate hosts/management servers

Any time you reconfigure a Symmetrix array by adding or removing device masking information, the SYMAPI configuration database should be updated on all affected hosts/management servers that are running Solutions Enabler. This is done by executing the following command:

 

symcfg discover

 

When executed, this command interrogates all SCSI devices available; therefore, it can take a significant amount of time to complete.

 

 

 

 

·        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.

 

 

23.  

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

 

24.  

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.

 

 

25.  

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.

 

 

26.  

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

 

 

 

 

 

·        Creating a Device Group

 

Overview

A collection of devices can be assigned to a named group to provide a more manageable single object to query status and impart blanket control operations. Device groups and composite group definitions are created locally through an attached host.

 

This procedure is based on content from the following EMC manual:

  • EMC Solutions Enabler Symmetrix Array Management CLI Product Guide

 

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

 

 

 

27.  

Examine device groups you already have

Since device group names must be unique, before you attempt to create a new one you should find out what device groups have already been created. To view a list of device groups that have already been created, execute the following command:

 

symdg list

 

 

28.  

Create a new device group

The symdg create command is used to create a new device group. The syntax for this command is:

 

symdg create DgName [-type REGULAR | RDF1 | RDF2 | RDF21]

 

where:

 

DgName = The name to assign to the device group.

 

For example, to create a device group, assign it the name TFgroup, and specify that it is a REGULAR device group, execute a symdg create command that looks like this:

 

symdg create TFgroup –type REGULAR

 

 

29.  

Add Symmetrix devices to the group

The symld command is used to add devices to an existing device group. Individual devices can be added by specifying either the physical device name (add pd) or the Symmetrix device name (add dev), as follows:

 

symld -g TFgroup add pd /dev/rdsk/c4t0d0s2
symld -g TFgroup -sid 12345 add dev 000C

A contiguous set of devices can be added to a device group by executing a symld command that looks more like this:

 

   symld -g TFgroup –sid 12345 addall –RANGE 000C:000E

(In this example, Symmetrix devices on Symmetrix array 000000012345 were used.)

 

On the other hand, BCV devices can be added to a device group by executing a symbcv command that looks like this:

 

symbcv -g TFgroup -sid 12345 associate dev 001C

 

Keep in mind that all devices added to a device group must be part of the same Symmetrix array. (Composite groups are used to group devices that reside on different Symmetrix arrays.)

 

30.  

Verify the device group creation

To verify that the device group was successfully created and that the appropriate devices were added to it, execute the following command:

 

symdg show DgName

 

where:

 

DgName = The name that has been assigned to the device group.

 

For example, to verify that a device group named TFgroup was created and the appropriate devices were assigned to it, execute the following command:

 

symdg show TFgroup

 

When this command is executed, you should see output that looks something like this:

 

Group Name:  TFgroup

 

    Group Type                                   : REGULAR

    Device Group in GNS                          : No

    Valid                                        : Yes

    Symmetrix ID                                 : 000000012345

    Group Creation Time                          : Mon Mar 23 08:50:17 2009

    Vendor ID                                    : EMC Corp

    Application ID                               : SYMCLI

 

    Number of STD Devices in Group               :    3

    Number of Associated GK's                    :    0

    Number of Locally-associated BCV's           :    0

    Number of Locally-associated VDEV's          :    0

    Number of Locally-associated TGT's           :    0

    Number of Remotely-associated VDEV's(STD RDF):    0

    Number of Remotely-associated BCV's (STD RDF):    0

    Number of Remotely-associated TGT's(TGT RDF) :    0

    Number of Remotely-associated BCV's (BCV RDF):    0

    Number of Remotely-assoc'd RBCV's (RBCV RDF) :    0

    Number of Remotely-assoc'd BCV's (Hop-2 BCV) :    0

    Number of Remotely-assoc'd VDEV's(Hop-2 VDEV):    0

    Number of Remotely-assoc'd TGT's (Hop-2 TGT) :    0

 

    Standard (STD) Devices (3):

        {

        --------------------------------------------------------------------

                                                      Sym               Cap

        LdevName              PdevName                Dev  Att. Sts     (MB)

        --------------------------------------------------------------------

        DEV001                N/A                     000C      RW      1031

        DEV002                N/A                     000D      RW      1031

        DEV003                N/A                     000E      RW      1031

        }

 

 

 

 

·        Install PowerPath software on an AIX host

31.  

This procedure describes how to install PowerPath on an AIX platform.

 

Verify the following prior to the installation of PowerPath:

 

·         Review the patch ReadMe files to determine which patches (if any) you want to install after PowerPath, and whether those patches have any added prerequisites that must be met before you install PowerPath.

·         Determine if the PowerPath software you are installing requires the removal or presence of a previous version of PowerPath.  Some full versions require the previous version to be removed while others do not.  Also, some patches require the full version to be present while others require it to be removed.  Refer to the PowerPath Release Notes and/or PowerPath patch readme files for your specific version to determine what needs to be present/removed and if and when a reboot is necessary in order to install your specific PowerPath software version and/or patch.  These documents are available on http://powerlink.emc.com.

 

·         All AIX hosts with Invista systems must select Type 4 when registering an HBA with Invista SP2 Patch 1 and higher.  Type 4 is the supported HBA initiator type for AIX on Invista SP2 Patch 1 and higher.  The EMC Invista Element Manager Administration Guide provides additional information on registering an HBA.

·         Use the AIX varyoffvg command to take offline all AIX Logical Volume Manager (LVM) volume groups that use storage-system hdisk devices, except the root volume group (rootvg).  If a filesystem or application uses these volume groups, unmount the filesystem or stop the application before taking the volume groups offline.

·         Ensure any required AIX Licensed Program Products (LPPs) are installed as follows:

LPP

Description

Required For

EMC.Symmetrix.aix.rte

 

AIX device LPP

 

Fibre-attached devices

EMC.Symmetrix.fcp.rte

EMC driver kit

Fibre-attached devices

 

NOTE:  For fibre-attached installations running AIX 5.2, the devices.pci.df1000f7.com LPP must be at level 5.2.0.17 or later.

EMC.Symmetrix.ha.rte

CLARiiON support for HACMP

HACMP clusters

Hitachi.aix.support.rte

AIX support for Hitachi and HP xp disks

All Hitachi Lightning and Hitachi Tagmastore configurations

All HP StorageWorks xp configurations

 

NOTE:  HP StorageWorks xp was qualified with the Hitachi.aix.support.rte. If you use the HP ODM (HP.aix.support.rte) and the devices are configured as XP Disk Array (Fibre), PowerPath cannot configure these devices.

HP.aix.support.rte

 

AIX support for

HP disks

All Hitachi Lightning and

Hitachi Tagmastore

configurations

All HP Storageworks

configurations

 

ibm2105.rte

IBM 2105 disk device

All IBM ESS configurations

PC1000.driver.obj

 

Cambex

PC1000 or

PC2000 HBA

support

All HP StorageWorks

EVA-hsv configurations

hsv100.rte or hsv110.rte

 

AIX support for

HP disks

All HP StorageWorks

EVA-hsv configurations

 

Note: The Symmetrix  LPPs are included in the EMC ODM fileset, which can be downloaded from: ftp://ftp.emc.com/pub/elab/aix/ODM_DEFINITIONS

 

 

32.  

Mount the PowerPath CD-ROM

a.     Verify that you are logged in as root.

 

b.    Create the directory /cdrom to be the mount point for the CD-ROM by entering:

mkdir /cdrom

c.     Insert the PowerPath installation CD-ROM and mount the CD on /cdrom by entering:

mount -v cdrfs -p -r /dev/cd0 /cdrom

d.    Enter the following command to change to the correct directory:

cd /cdrom/UNIX/AIX

 

33.  

Install PowerPath software

PowerPath can be installed directly from the CD-ROM, using either command line entries or SMIT.  Perform the applicable procedure as follows:

 

To install PowerPath from the command line:

 

Note:  To install from the command line, you must enable the adapter driver fast_fail feature by entering chdev -l fscsiX -a fc_err_recov=fast_fail –P and then rebooting.

 

Install the software by entering: installp –agXd . EMCpower

Note:  Refer to the man page for optional flags for the
installp command.

The screen displays information about the installation, ending with an installation summary display.  The result column will display success.

 

To install PowerPath from SMIT:

 

This SMIT procedure assumes you are running the X Window System version of SMIT.  You can use the tty version of SMIT, provided you substitute the appropriate tty SMIT procedures.

a.      Enter the following command to open SMIT:

smit

b.      On the main SMIT window, click Software Installation and Maintenance.

c.      On the Software Installation and Maintenance window, click Install and Update Software.

d.      On the Install and Update Software window, click Install Software.

e.      For INPUT device / directory for software, enter:

/cdrom/UNIX/AIX

f.       Click List to open the list of software to install.

g.      Select the first line in the list, EMCpower ALL and press Enter.

h.      In the Install Software dialog box that opens, review the installation options, make any necessary changes, and click OK.

i.        When prompted, click OK to continue.  The screen displays information about the installation, ending with an installation summary display.  The result column will display success.

j.        Select Exit SMIT from the Exit menu to close SMIT.

 

34.  

Complete PowerPath software registration:

After the installation is complete, you must register PowerPath on the host:

 

a.      Locate the PowerPath License Key Card, which has your license registration key printed, delivered with the PowerPath media kit.  

b.      Enter the following command:

emcpreg –install

c.      At the prompt, type y and press Enter.

d.      At the registration key prompt, enter the PowerPath registration key and press Enter. 

If you enter a valid registration key, you see the following output:

 

1 key(s) successfully added.

Key successfully installed.


NOTE:  If you enter an invalid registration number or press Enter without entering any key, the system displays an error message and prompts you to reenter a valid key.

e.      Press Enter and you will see the following output:

1 key(s) successfully registered.

 

35.  

Check for patches:

If necessary, install any PowerPath patches from the following URL:

http://powerlink.emc.com

 

NOTE:  A readme file that explains how to install the patch accompanies every patch release.  This file will also state whether you need to reboot the host after the installation of the patch. 

 

 

36.  

Pseudo device numbering:

By default, PowerPath uses a system-assigned major number for its pseudo devices.  To support NFS applications in a clustered environment, the major number of PowerPath pseudo devices (i.e., /dev/*hdiskpower*) must be the same across all cluster nodes.  This must be a unique major number that is unused by any host in the cluster.

 

To choose a major number:

 

a.     Determine a free major number common to all nodes; on each node in the cluster, run the following command:

 

lvlstmajor

Compare the free ranges on each node to find a major number that is unused on any node.

b.    Change the major number of the powerpath0 device; on each node in the cluster, run the following command:

chdev –l powerpath0 –a pp_major= x

Where x is the major number you found in step a.

c.     Verify the change; on each node in the cluster.  Run the following command:

lsattr -El powerpath0

NOTE:  The major number will take effect after you run the
powermt config command on each node in the cluster.

 

37.  

Make hdiskpower devices available:

Initialize the PowerPath hdiskpower devices and make them available to the host using either command line entries or SMIT.  Perform the applicable procedure as follows:

 

To initialize devices at the command line, enter:

 

powermt config

 

To initialize devices using SMIT:

 

a.      Open SMIT by entering:

smit

b.      On the System Management window, select Devices.

c.      Select PowerPath Disk.

d.      Select Configure All PowerPath Devices.

e.      Exit SMIT.

 

38.  

Remove CD-ROM:

Unmount the CD-ROM by entering:

 

cd /

umount /cdrom

 

Remove the CD-ROM from the CD-ROM drive.

 

 

39.  

Post tasks:

Perform other administrative tasks as necessary:

 

·         Vary on any existing LVM volume groups that you varied off before installing PowerPath by running the command varyonvg vgname.  Then remount any filesystems that you unmounted and restart any applications you stopped.

You need not reconfigure these volume groups.  The installation procedure migrates existing volume groups that use storage system devices from AIX hdisks to PowerPath hdiskpower devices.  However, if you failed to vary off a volume group before installing PowerPath, this migration will fail.  You will be able to vary off the volume group, but any vary on attempts may result in errors.  To correct this state, vary off the volume group and then run
powermt config.  The varyon command should now succeed and the volume group should be using hdiskpower devices.  When defining new volume groups, use PowerPath hdiskpower devices, not AIX hdisk devices.

·         Reconfigure applications that access AIX hdisks directly.

If an application accesses AIX hdisks directly, rather than through a volume group (a DBMS, for example), you must reconfigure that application to use PowerPath hdiskpower devices if you want PowerPath load balancing and path failover functionality. Run
powermt display dev=all to determine the correspondence between PowerPath hdiskpower devices and AIX hdisk devices.

 

Note:  You do not need to reconfigure applications that access hdisks through a volume group. 

 

When adding new applications to your system that typically would access hdisks directly, configure them to use hdiskpower devices instead.