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:TECH62002  |  Created: 2008-01-25  |  Updated: 2011-02-10  |  Article URL http://www.symantec.com/docs/TECH62002
Article Type
Technical Solution


Environment

Issue



 

THIS FILE HAS BEEN UPDATED, please refer to the following article for the most recent version:  http://www.symantec.com/business/support/index?page=content&id=TECH68818

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 FILE HAS BEEN UPDATED, please refer to the following article for the most recent version:  http://www.symantec.com/business/support/index?page=content&id=TECH68818
 
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.
 

 
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.1_asl-v1.3-vm5.0MP3-Linux.tar_306692.gz, uncompress the file:
 
# gunzip VRTSNTAP_apm-v1.1_asl-v1.3-vm5.0MP3-Linux.tar_306692.gz
 
# tar xvf VRTSNTAP_apm-v1.1_asl-v1.3-vm5.0MP3-Linux.tar_306692
 
There are a total of sixteen packages present in VRTSNTAP_apm-v1.1_asl-v1.3-vm5.0MP3-Linux.tar_306692.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.1_RHEL4.i686.rpm, VRTSNTAPapm-5.0-1.1_RHEL4.ia64.rpm, VRTSNTAPapm-5.0-1.1_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.1_SLES9.i586.rpm, VRTSNTAPapm-5.0-1.1_SLES9.ia64.rpm, VRTSNTAPapm-5.0-1.1_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.1_SLES9.x86_64.rpm, type:
 
# rpm -ivh VRTSNTAPapm-5.0-1.1_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.1_SLES9
 
Name        : VRTSNTAPapm                  Relocations: (not relocatable)
 
Version     : 5.0                               Vendor: VERITAS Software Corporation Inc.
 
Release     : 1.1_SLES9                     Build Date: Fri Jul 25 01:30:14 2008
 
Install date: Fri Aug  1 07:17:52 2008      Build Host: vm2850lx4.veritas.com
 
Group       : System/Data Storage           Source RPM: VRTSNTAPapm-5.0-1.1_SLES9.src.rpm
 
Size        : 2022600                          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



306692


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


Terms of use for this information are found in Legal Notices