This Tech File provides information about the Array Support Library (ASL) and Array Policy Module (APM) for IBM SAN Volume Controller arrays using dynamic multipathing (DMP) with Veritas Volume Manager 5.0 and later on Linux
.
For general information about ASLs, see TechNote 249446 (link in the Related Documents section of this TechFile)

Note: DMP for the SANVC is supported by Native DMP


ASL Package Name: VRTSibmsvc
ASL Package Description: Array Support Library for IBM SANVC
ASL Package Version: 2.0
APM Package Name: VRTSibmsvcapm
APM Package Description: Veritas Array Policy Module for IBM SVC
APM Package Version: 1.0
Supported versions of VERITAS Volume Manager(tm): 5.0, 5.0 MP1, 5.0 MP3, 5.0RU1 and 5.0RU4
Supported Arrays: IBM SAN Volume Controller (2145, 2062)

Supported Mode: A/A-A (Active/Active-Asymmetric)

 

Installation Instructions:
 

1. Create a directory to store ASL/APM packages
 

# mkdir /tmp/asl_apm
 

# cd /tmp/asl_apm
 

 

2. At the bottom of this TechFile, click on Download Now to download the ASL/APM packages to /tmp/asl_apm
 

 

3. After downloading VRTSIBMSANVCaslapm_vm-5.0_Linux.tar_339224.gz, verify checksum of the file
 

# cksum VRTSIBMSANVCaslapm_vm-5.0_Linux.tar_339224.gz
 

3690176984 4666565 VRTSIBMSANVCaslapm_vm-5.0_Linux.tar_339224.gz
 

 

4. Unzip the file and extract the rpm packages
 

# gunzip VRTSIBMSANVCaslapm_vm-5.0_Linux.tar_339224.gz
 

# tar xvf VRTSIBMSANVCaslapm_vm-5.0_Linux.tar_339224
 

 

Note:
 

a.  Verify that there are 22 rpm packages as part of the tar ball.
 

b. There is one ASL package for each supported distribution
 

c. There is one APM package for every supported architecture of each supported distribution
 

d. The asl VRTSibmsvc-5.0-1.1_RHEL4.i686.rpm can be used for both RHEL4 and RHEL5
 

Simliarly, the asl VRTSibmsvc-5.0-1.1_SLES9.i586.rpm can be used for both SLES9 and SLES10.
 

RHEL4/VRTSibmsvcapm-5.0-1.1_RHEL4.x86_64.rpm
RHEL4/VRTSibmsvcapm-5.0-1.1_RHEL4.ia64.rpm
RHEL4/VRTSibmsvcapm-5.0-1.1_RHEL4.i686.rpm
RHEL4/VRTSibmsvc-5.0-1.1_RHEL4.i686.rpm

RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.i686.rpm
RHEL5/VRTSsvcapm-5.0-1.0_RHEL5.ppc64.rpm
RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.x86_64.rpm
RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.ia64.rpm
RHEL5/VRTSibmsvc-5.0-1.0_RHEL5.ppc64.rpm

SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.x86_64.rpm
SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.i586.rpm
SLES10/VRTSibmsvc-5.0-1.0_SUSE10.ppc64.rpm
SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.ia64.rpm
SLES10/VRTSsvcapm-5.0-1.0_SUSE10.ppc64.rpm

SLES9/VRTSibmsvcapm-5.0-1.1_SLES9.ia64.rpm
SLES9/VRTSibmsvc-5.0-1.1_SLES9.i586.rpm
SLES9/VRTSibmsvcapm-5.0-1.1_SLES9.i586.rpm
SLES9/VRTSibmsvcapm-5.0-1.2_SLES9.x86_64.rpm

SUSE11/VRTSibmsvc-5.0-1.0_SUSE11.ppc64.rpm
SUSE11/VRTSsvcapm-5.0-1.0_SUSE11.ppc64.rpm
SUSE11/VRTSIBMsvc-5.0-1.0_SLES11.x86_64.rpm
SUSE11/VRTSibmsvcapm-5.0-1.0_SLES11.x86_64.rpm


Note: Following are installation instructions on RHEL4 system (similar instructions can be used on other platforms)
 

 

5. Before adding any ASL package, ensure Veritas Volume Manager is installed and enabled
 

# vxdctl mode
 

mode: enabled

6. ASL Installation
# rpm -ivh VRTSibmsvc-5.0-1.1_RHEL4.i686.rpm

7. APM Installation
# rpm -ivh VRTSibmsvcapm-5.0-1.1_RHEL4.x86_64.rpm

 

8. After the package is installed, you must execute the vxdctl enable command to claim the disk array
 

# vxdctl enable
 

 

Note: In some cases, it has been reported that the installation of the ASL and/or APM does not
 

take effect and vxdctl enable does not claim the enclosure and devices. In such cases, you can
 

execute the vxconfigd -k command in addition to vxdctl enable
 

 

9. After executing vxdctl enable, verify the output of the vxddladm listsupport command
 

# vxddladm listsupport libname=libvxibmsvc.so
 

ATTR_NAME           ATTR_VALUE
 

=================================================================================================
 

LIBNAME             libvxibmsvc.so
 

VID                 IBM
 

PID                 2145, 2062
 

ARRAY_TYPE          A/A-A-IBMSVC
 

ARRAY_NAME          SAN_VC
 

10. Verify the ASL library version
# vxddladm listversion libname=libvxibmsvc.so
libvxibmsvc.so has version string: vm-5.0-rev-2. VXVM version: 5.0

 

11. Verify that APM is in Active state
 

# vxdmpadm  listapm dmpsvc.ko
 

Filename:               dmpsvc.ko
 

APM name:               dmpsvc
 

APM version:            1
 

Feature:                VxVM
 

VxVM version:           50
 

Array Types Supported:  A/A-A-IBMSVC
 

Depending Array Types:  A/A-A
 

State:                  Active
 

 

ASL Package Information:
 

# rpm -qil VRTSibmsvc
 

Name        : VRTSibmsvc                  
 

Relocations : (not relocatable)
 

Version     : 5.0                              
 

Vendor      : VERITAS Software Corporation Inc.
 

Release     : 1.1_RHEL4                    
 

Build Date  : Fri 25 Jan 2008 12:49:07 AM IST
 

Install Date: Thu 17 Dec 2009 07:55:51 AM IST      
 

Build Host  : vmlx11.veritas.com
 

Group       : System/Data Storage          
 

Source RPM  : VRTSibmsvc-5.0-1.1_RHEL4.src.rpm
 

Size        : 10342                            
 

License: Copyright (c) 1990-2005 VERITAS Software Corporation.
 

ALL RIGHTS RESERVED.  THIS SOFTWARE IS THE PROPERTY OF AND IS
 

LICENSED BY VERITAS SOFTWARE, AND/OR ITS SUPPLIERS.
 

Signature   : (none)
 

Packager    : linuxvm-pkgr@veritas.com
 

URL         : http://www.veritas.com/
 

Summary     : Array Support Library for IBM SANVC
 

Description : Array Support library for IBM SANVC
 

/etc/vx/aslkey.d
 

/etc/vx/aslkey.d/libvxibmsvc.key.2
 

/etc/vx/lib/discovery.d
 

/etc/vx/lib/discovery.d/libvxibmsvc.so.2
 

 

 

APM Package Information:
 

# rpm -qil VRTSibmsvcapm
 

Name        : VRTSibmsvcapm                
 

Relocations : (not relocatable)
 

Version     : 5.0                              
 

Vendor      : VERITAS Software Corporation Inc.
 

Release     : 1.1_RHEL4                    
 

Build Date  : Fri 25 Jan 2008 01:57:37 AM IST
 

Install Date: Thu 17 Dec 2009 07:56:03 AM IST      
 

Build Host  : vmoptlx1.veritas.com
 

Group       : System/Data Storage          
 

Source RPM  : VRTSibmsvcapm-5.0-1.1_RHEL4.src.rpm
 

Size        : 2853630
 

License     : Copyright (c) 1990-2005 VERITAS Software Corporation.
 

ALL RIGHTS RESERVED.  THIS SOFTWARE IS THE PROPERTY OF AND IS
 

LICENSED BY VERITAS SOFTWARE, AND/OR ITS SUPPLIERS.
 

Signature   : (none)
 

Packager    : linuxvm-pkgr@veritas.com
 

URL         : http://www.veritas.com/
 

Summary     : Veritas Array Policy Module for IBM SVC.
 

Description : Veritas Array Policy Module for IBM SVC.
 

/etc/vx/apmkey.d
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.EL.2
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.ELlargesmp.2
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.ELsmp.2
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.ELv.2
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.ELvlargesmp.2
 

/etc/vx/apmkey.d/32/dmpsvc.key.2.6.9-34.ELvsmp.2
 

/etc/vx/kernel
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.EL.2
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.ELlargesmp.2
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.ELsmp.2
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.ELv.2
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.ELvlargesmp.2
 

/etc/vx/kernel/dmpsvc.ko.2.6.9-34.ELvsmp.2