============================================================================
This README provides information about Array Support Library and Array Policy 
Module for IBM SAN Volume Controller Arrays (Active/Active-Asymmetric) using 
DMP with Veritas Volume Manager 5.0 and later on Linux
============================================================================

ASL Package Name: 	 VRTSibmsvc 
ASL Package Description: Veritas Array Support Library for IBM SANVC Array

APM Package Name: 	 VRTSibmsvcapm
APM Package Description: Veritas Array Policy Module for IBM SANVC Array

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. Download the VRTSIBMSANVCaslapm_vm-5.0_Linux.tar.gz and verify checksum of the file

	# cksum VRTSIBMSANVCaslapm_vm-5.0_Linux.tar.gz
	1774882524      4678491 VRTSIBMSANVCaslapm_vm-5.0_Linux.tar.gz

3. Unzip the file and extract the rpm packages

	# gunzip VRTSIBMSANVCaslapm_vm-5.0_Linux.tar.gz
	# tar xvf VRTSIBMSANVCaslapm_vm-5.0_Linux.tar

	Note:
		There is one ASL package for each distribution
		There is one APM package for every architecture of each distribution

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

		RHEL5/VRTSIBMsvc-5.0-2.0_RHEL5.i686.rpm
		RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.i686.rpm
		RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.ia64.rpm
		RHEL5/VRTSibmsvcapm-5.0-1.2_RHEL5.x86_64.rpm
		RHEL5/VRTSsvcapm-5.0-1.0_RHEL5.ppc64.rpm
		RHEL5/VRTSibmsvc-5.0-1.0_RHEL5.ppc64.rpm
	
		SLES9/VRTSIBMsvc-5.0-2.0_SLES9.i586.rpm
		SLES9/VRTSibmsvcapm-5.0-1.1_SLES9.i586.rpm
		SLES9/VRTSibmsvcapm-5.0-1.1_SLES9.ia64.rpm
		SLES9/VRTSibmsvcapm-5.0-1.2_SLES9.x86_64.rpm

		SLES10/VRTSIBMsvc-5.0-2.0_SLES10.i586.rpm
		SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.i586.rpm
		SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.ia64.rpm
		SLES10/VRTSibmsvcapm-5.0-1.2_SLES10.x86_64.rpm
		SLES10/VRTSsvcapm-5.0-1.0_SUSE10.ppc64.rpm
		SLES10/VRTSibmsvc-5.0-1.0_SUSE10.ppc64.rpm
	
		SLES11/VRTSIBMsvc-5.0-2.0_SLES11.x86_64.rpm
		SLES11/VRTSibmsvcapm-5.0-1.0_SLES11.x86_64.rpm
		SLES11/VRTSsvcapm-5.0-1.0_SUSE11.ppc64.rpm
		SLES11/VRTSibmsvc-5.0-1.0_SUSE11.ppc64.rpm
	
 Following are installation instructions on RHEL4 system 
 (similar instructions can be used on other platforms)

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

	# vxdctl mode
	mode: enabled 

5. ASL Installation

	# rpm -ivh VRTSIBMsvc-5.0-2.0_RHEL4.i686.rpm

6. APM Installation

	# rpm -ivh VRTSibmsvcapm-5.0-1.1_RHEL4.x86_64.rpm

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

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


9. Verify the ASL library version

	# vxddladm listversion libname=libvxibmsvc.so
	libvxibmsvc.so has version string: vm-5.0-rev-2. VXVM version: 5.0


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