Array Support Library (ASL) and Array Policy Module (APM) for NetApp Storage Systems (Active/Active, Active/Passive, Active/Passive- Concurrent) on Veritas Volume Manager (TM) 5.0 MP3 and later for Linux (RHEL and SLES)

Article:TECH68818  |  Created: 2009-01-17  |  Updated: 2011-02-28  |  Article URL http://www.symantec.com/docs/TECH68818
Article Type
Technical Solution


Environment

Issue



THIS TECHFILE HAS BEEN DEPRECATED. Please download the latest ASL-APM package from: https://sort.symantec.com/asl

Array Support Library (ASL) and Array Policy Module (APM) for NetApp Storage Systems (Active/Active, Active/Passive, Active/Passive- Concurrent) on Veritas Volume Manager (TM) 5.0 MP3 and later for Linux (RHEL and SLES)


Solution



THIS TECHFILE HAS BEEN DEPRECATED. Please download the latest ASL-APM package from:   https://sort.symantec.com/asl

 
This TechFile provides information about the Array Support Library (ASL) and Array Policy Module (APM) for NetApp Storage Systems (Active/Active, Active/Passive, Active/Passive-Concurrent) on Veritas Volume Manager (TM) 5.0 MP3 and later for Linux (RHEL and SLES).
 
For general information about ASLs, see TechNote <http://support.veritas.com/docs/249446>
 
ASL Package Name: VRTSNTAPasl
APM Package Name: VRTSNTAPapm
Supported versions of Veritas Volume Manager: 5.0 MP3 and later
Supported Arrays: NetApp Storage Systems (A/A-NETAPP, A/P-NETAPP, A/P-C-NETAPP), and IBM System Storage N3000, N5000 and N7000 Series.
Change Log: Modified the "post" script of RHEL4 and SLES9 APM packages to use the correct APM kernel module.
 
Note: 1. For 5.0MP3, NetApp ASL is supported in iSCSI mode on RHEL5/SLES10 and FC mode on RHEL4/RHEL5/SLES9/SLES10.
        2. All updates for RHEL4 and all SPs for SLES9 are supported.
        3. The default value of qlport_down_retry parameter is 30 on RHEL5. It needs to be changed to 0 in /etc/modprobe.conf file.
       This parameter defines maximum number of command retries to a port that returns a PORT-DOWN status before returning I/O back to the OS.
 
Installation Instructions:
1. Create a directory to store NetApp ASL and APM:
# mkdir
# cd tmp
 
2. At the bottom of this TechFile, click on Download Now to download the ASL and APM packages.
After downloading VRTSNTAP_apm-v1.2_asl-v1.3-vm5.0MP3-Linux.tar_321156.gz, uncompress the file:
# gunzip VRTSNTAP_apm-v1.2_asl-v1.3-vm5.0MP3-Linux.tar_321156.gz
# tar xvf VRTSNTAP_apm-v1.2_asl-v1.3-vm5.0MP3-Linux.tar_321156
There are a total of sixteen packages present in VRTSNTAP_apm-v1.2_asl-v1.3-vm5.0MP3-Linux.tar_321156.gz tar ball. There is one ASL package and three APM packages corresponding to ia32, ia64 and x86_64 architectures for RHEL4, RHEL5, SLES9, SLES10 as enlisted below:
VRTSNTAPapm-5.0-1.2_RHEL4.i686.rpm, VRTSNTAPapm-5.0-1.2_RHEL4.ia64.rpm, VRTSNTAPapm-5.0-1.2_RHEL4.x86_64.rpm,
VRTSNTAPapm-5.0-1.1_RHEL5.i686.rpm, VRTSNTAPapm-5.0-1.1_RHEL5.ia64.rpm, VRTSNTAPapm-5.0-1.1_RHEL5.x86_64.rpm,
VRTSNTAPapm-5.0-1.1_SLES10.i586.rpm, VRTSNTAPapm-5.0-1.1_SLES10.ia64.rpm, VRTSNTAPapm-5.0-1.1_SLES10.x86_64.rpm,
VRTSNTAPapm-5.0-1.2_SLES9.i586.rpm, VRTSNTAPapm-5.0-1.2_SLES9.ia64.rpm, VRTSNTAPapm-5.0-1.2_SLES9.x86_64.rpm,
VRTSNTAPasl-5.0-3.0_RHEL4.i686.rpm, VRTSNTAPasl-5.0-3.0_RHEL5.i686.rpm, VRTSNTAPasl-5.0-3.0_SLES10.i586.rpm, VRTSNTAPasl-5.0-3.0_SLES9.i586.rpm
 
3. Before adding any ASL package, ensure Veritas Volume Manager is installed and enabled:
# vxdctl mode
mode: enabled
 
4. ASL Installation
To install the ASL package VRTSNTAPasl-5.0-3.0_SLES9.i586.rpm, type:
# rpm -ihv VRTSNTAPasl-5.0-3.0_SLES9.i586.rpm
 
5. APM Installation
To install the APM package VRTSNTAPapm-5.0-1.2_SLES9.x86_64.rpm, type:
# rpm -ivh VRTSNTAPapm-5.0-1.2_SLES9.x86_64.rpm
Similar instructions can be followed to install the other packages as well.
 
6. After the packages are installed, you must execute the vxdctl enable command to claim the disk array as a NetApp array and to load the APM:
# 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.
 
7. After executing vxdctl enable, verify the output of the vxddladm listsupport command:
# vxddladm listsupport libname=libvxnetapp.so
ATTR_NAME           ATTR_VALUE
=================================================================================================
LIBNAME             libvxnetapp.so
VID                 NETAPP
PID                 All
ARRAY_TYPE          A/A-NETAPP, A/P-NETAPP, A/P-C-NETAPP
 
8. Verify that the APM is in ACTIVE state:
# vxdmpadm listapm dmpnetapp
Filename:               dmpnetapp.ko
APM name:               dmpnetapp
APM version:            1
Feature:                VxVM
VxVM version:           50
Array Types Supported:  A/A-NETAPP,A/P-C-NETAPP,A/P-NETAPP
Depending Array Types:  A/A,A/P-C,A/P
State:                  Active
 
Package Information:
ASL Information
# rpm -qil VRTSNTAPasl-5.0-3.0_SLES9
Name        : VRTSNTAPasl                  Relocations: (not relocatable)
Version     : 5.0                               Vendor: VERITAS Software Corporation Inc.
Release     : 3.0_SLES9                     Build Date: Wed Jul  9 05:42:13 2008
Install date: Fri Aug  1 07:17:37 2008      Build Host: vmlx21.veritas.com
Group       : System/Data Storage           Source RPM: VRTSNTAPasl-5.0-3.0_SLES9.src.rpm
Size        : 24624                            License: Copyright (c) 1990-2007 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 NetApp Array Support Library
Description :
Veritas NetApp Array Support Library
Distribution: (none)
/etc/vx/aslkey.d
/etc/vx/aslkey.d/libvxnetapp.key.2
/etc/vx/lib/discovery.d
/etc/vx/lib/discovery.d/libvxnetapp.so.2
 
APM Information
# rpm -qil VRTSNTAPapm-5.0-1.2_SLES9
Name        : VRTSNTAPapm                  Relocations: (not relocatable)
Version     : 5.0                               Vendor: VERITAS Software Corporation Inc.
Release     : 1.2_SLES9                     Build Date: Fri Mar 13 15:12:45 2009
Install date: Fri Mar 13 17:24:13 2009      Build Host: vm2850lx4.veritas.com
Group       : System/Data Storage           Source RPM: VRTSNTAPapm-5.0-1.2_SLES9.src.rpm
Size        : 2021608                          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 NetApp Array Policy Module
Description :
Veritas NetApp Array Policy Module
Distribution: (none)
/etc/vx/apmkey.d
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.244-default.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.244-smp.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.244-vdefault.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.244-vsmp.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.308-default.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.308-smp.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.308-vdefault.2
/etc/vx/apmkey.d/32/dmpnetapp.key.2.6.5-7.308-vsmp.2
/etc/vx/kernel
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.244-default.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.244-smp.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.244-vdefault.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.244-vsmp.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.308-default.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.308-smp.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.308-vdefault.2
/etc/vx/kernel/dmpnetapp.ko.2.6.5-7.308-vsmp.2
 
 



Legacy ID



321156


Article URL http://www.symantec.com/docs/TECH68818


Terms of use for this information are found in Legal Notices