Using IBM FlashSystem with MPIO on AIX 5.

3IBM China Systems & Technology Lab

Using IBM FlashSystem with MPIO on AIX 5.3

Date: Jan. 21, 2014

Author: Zhen Hua Feng (fengzhh@cn.ibm.com)

Reviewer: Tao Tian (tiantao@cn.ibm.com)

IBM China Systems & Technology Lab

IBM Storage Interoperability Test

Version: 1.0

IBM Storage Interoperability Test 1/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Index
Abstract..............................................................................................................................................3
Supported Products............................................................................................................................3
Pre-request.........................................................................................................................................3
Procedures.........................................................................................................................................3

IBM Storage Interoperability Test 2/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Abstract
This document describes how to deploy IBM FlashSystem storage on AIX5.3 with native multipath
driver MPIO (AIXPCM).

Supported Products
 IBM FlashSystem 720 (9831-AS2)
 IBM FlashSystem 820 (9831-AE2)

Pre-request
 To use FlashSystem on AIX5.3, additional APAR IV53068 is essential for MPIO to identify
LUNs from FlashSystem
 Installing APAR IV53068 requires AIX5.3 TL12 or higher

Procedures
1. Mapping LUNs from FlashSystem to AIX. LUNs can not be identified by MPIO for no
FlashSystem related ODM definition on AIX5.3.
Example:
# lsdev -Cc disk
hdisk0 Available Virtual SCSI Disk Drive
hdisk1 Available 02-00-02 Other FC SCSI Disk Drive
hdisk2 Available 02-00-02 Other FC SCSI Disk Drive
2. Downloading and Installing APAR IV53068.
Example:
# cd /tmp
# ls –l IV53068.131213.epkg.Z
-rw-r--r-- 1 root system 8130 Jan 19 23:04 IV53068.131213.epkg.Z
# emgr -e IV53068.131213.epkg.Z
+-----------------------------------------------------------------------------+
Efix Manager Initialization
+-----------------------------------------------------------------------------+
Initializing log /var/adm/ras/emgr.log ...
Efix package file is: /home/IV53068.131213.epkg.Z
MD5 generating command is /usr/bin/csum
MD5 checksum is ab03ddec16c3f0546d51006bf503cbc6

IBM Storage Interoperability Test 3/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Accessing efix metadata ...

Processing efix label "IV53068" ...
Verifying efix control file ...

+-----------------------------------------------------------------------------+
Installp Prerequisite Verification
+-----------------------------------------------------------------------------+
Verifying prerequisite file ...
Checking prerequisites ...

Prerequisite Number: 1
Fileset: devices.common.IBM.mpio.rte
Minimal Level: 5.3.12.0
Maximum Level: 5.3.12.99
Actual Level: 5.3.12.5
Type: PREREQ
Requisite Met: yes

All prerequisites have been met.

+-----------------------------------------------------------------------------+
Processing APAR reference file
+-----------------------------------------------------------------------------+
ATTENTION: Interim fix is enabled for automatic removal by installp.

+-----------------------------------------------------------------------------+
Efix Attributes
+-----------------------------------------------------------------------------+
LABEL: IV53068
PACKAGING DATE: Fri Dec 13 13:38:31 CST 2013
ABSTRACT: APAR to recognize IBM FlashSystem
PACKAGER VERSION: 7
VUID: 0000C3FAD200121313123113
REBOOT REQUIRED: yes
BUILD BOOT IMAGE: yes
PRE-REQUISITES: yes
SUPERSEDE: no
PACKAGE LOCKS: no
E2E PREREQS: no
FIX TESTED: no
ALTERNATE PATH: None

IBM Storage Interoperability Test 4/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

EFIX FILES: 1

Install Scripts:
PRE_INSTALL: no
POST_INSTALL: yes
PRE_REMOVE: no
POST_REMOVE: yes

File Number: 1
LOCATION: /usr/lib/methods/scdisk.cat
FILE TYPE: Standard (file or executable)
INSTALLER: installp
SIZE: 24
ACL: DEFAULT
CKSUM: 26811
PACKAGE: devices.scsi.disk.rte
MOUNT INST: no

+-----------------------------------------------------------------------------+
Efix Description
+-----------------------------------------------------------------------------+
This i-fix contains ODM to allow AIX to
recognize flash devices as MPIO capable
devices. The devices recognized by this
i-fix include

IBM FlashSystem 820

IBM FlashSystem 840
TMS RamSan

+-----------------------------------------------------------------------------+
Efix Lock Management
+-----------------------------------------------------------------------------+
Checking locks for file /usr/lib/methods/scdisk.cat ...

All files have passed lock checks.

+-----------------------------------------------------------------------------+
Space Requirements
+-----------------------------------------------------------------------------+
Checking space requirements ...

IBM Storage Interoperability Test 5/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Space statistics (in 512 byte-blocks):

File system: /usr, Free: 210744, Required: 1278, Deficit: 0.
File system: /tmp, Free: 782184, Required: 69445, Deficit: 0.

+-----------------------------------------------------------------------------+
Efix Installation Setup
+-----------------------------------------------------------------------------+
Unpacking efix package file ...
Initializing efix installation ...

+-----------------------------------------------------------------------------+
Efix State
+-----------------------------------------------------------------------------+
Setting efix state to: INSTALLING

+-----------------------------------------------------------------------------+
File Archiving
+-----------------------------------------------------------------------------+
Saving all files that will be replaced ...
Save directory is: /usr/emgrdata/efixdata/IV53068/save
File 1: Saving /usr/lib/methods/scdisk.cat as EFSAVE1 ...

+-----------------------------------------------------------------------------+
Efix File Installation
+-----------------------------------------------------------------------------+
Installing all efix files:
Installing efix file #1 (File: /usr/lib/methods/scdisk.cat) ...

Total number of efix files installed is 1.

All efix files installed successfully.

+-----------------------------------------------------------------------------+
Package Locking
+-----------------------------------------------------------------------------+
Processing package locking for all files.
File 1: locking installp fileset devices.scsi.disk.rte.

All package locks processed successfully.

+-----------------------------------------------------------------------------+

IBM Storage Interoperability Test 6/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Post-Install Script
+-----------------------------------------------------------------------------+
Executing post-install script ...
Return code from post-install script is: 0

+-----------------------------------------------------------------------------+
Reboot Processing
+-----------------------------------------------------------------------------+

*** NOTICE ***

This efix package requires the target system to be rebooted after the current
operation is complete. It is recommended that you reboot the target system as
soon as possible after installation to avoid disruption of current functionality.

+-----------------------------------------------------------------------------+
Efix State
+-----------------------------------------------------------------------------+
Setting efix state to: REBOOT REQUIRED

+-----------------------------------------------------------------------------+
Boot Image Processing
+-----------------------------------------------------------------------------+
Rebuilding boot image ...
bosboot: Boot image is 44523 512 byte blocks.
Successfully rebuilt boot image.

+-----------------------------------------------------------------------------+
Operation Summary
+-----------------------------------------------------------------------------+
Log file is /var/adm/ras/emgr.log

EPKG NUMBER LABEL OPERATION RESULT

=========== ============== ================= ==============
1 IV53068 INSTALL SUCCESS

ATTENTION: system reboot is required. Please see the "Reboot Processing"

sections in the output above or in the /var/adm/ras/emgr.log file.

Return Status = SUCCESS

3. Removing old devices and rescanning. LUNs from FlashSystem will be under control of
MPIO now.

IBM Storage Interoperability Test 7/8 © Copyright IBM Corporation, 2014

Using IBM FlashSystem with MPIO on AIX 5.3IBM China Systems & Technology Lab

Example:
# rmdev -Rdl hdisk1
hdisk1 deleted
# rmdev -Rdl hdisk2
hdisk2 deleted
# cfgmgr
# lsdev -Cc disk
hdisk0 Available Virtual SCSI Disk Drive
hdisk1 Available 02-00-02 MPIO IBM FlashSystem Disk
# lspath
Enabled hdisk0 vscsi0
Enabled hdisk1 fscsi0
Enabled hdisk1 fscsi1
# lsattr -El hdisk1
PCM PCM/friend/fcpother Path Control Module False
algorithm round_robin Algorithm True
clr_q no Device CLEARS its Queue on error True
dist_err_pcnt 0 Distributed Error Percentage True
dist_tw_width 50 Distributed Error Sample Time True
hcheck_cmd test_unit_rdy Health Check Command True
hcheck_interval 60 Health Check Interval True
hcheck_mode nonactive Health Check Mode True
location Location Label True
lun_id 0x0 Logical Unit Number ID False
max_transfer 0x40000 Maximum TRANSFER Size True
node_name 0x10000020c21221a3 FC Node Name False
pvid 00c5ecd5a071851c0000000000000000 Physical volume identifier False
q_err yes Use QERR bit True
q_type simple Queuing TYPE True
queue_depth 64 Queue DEPTH True
reassign_to 120 REASSIGN time out value True
reserve_policy no_reserve Reserve Policy True
rw_timeout 30 READ/WRITE time out value True
scsi_id 0x914200 SCSI ID False
start_timeout 60 START unit time out value True
timeout_policy retry_path Timeout Policy True
unique_id 3C231IBM FlashSystem 1221a300a00BFlashSystem03IBMfcp Unique device identifier
False
ww_name 0x21040020c21221a3 FC World Wide Name False

IBM Storage Interoperability Test 8/8 © Copyright IBM Corporation, 2014