=======================================================================
VRTSaslapm package (Array Support Libraries and Array Policy Modules) on
Veritas Volume Manager (tm) 5.1SP1 for AIX
=======================================================================

Date					: 12/26/2011

Package Name				: VRTSaslapm

Package Description                     : Array Support Libraries and
                                          Array Policy Modules for
                                          Veritas Volume Manager

Package Version				: 5.1.100.301

Operating System			: AIX
Operating System version		: 5.3, 6.1, 7.1

Veritas Volume Manager Version		: 5.1.100.000

	Note: AIX 7.1 support requires VxVM 5.1SP1RP2

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

Change Log:
	Incident: 2652488
	Issue: Inactive SnapShot LUNs and Mirror LUNs created with MirrorView 
	       or SnapView will cause Trespassing
	Solution: Detect inactive SnapShot/Mirror LUNs using error code 5/25/01 
		  and avoid doing failover which leads to trespassing

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


Installation Procedure:
======================

   1. Pre-Installation Checks:
   --------------------------

	A) If there are any external ASL/APM packages installed on 
	   the system, Remove them before you start installation of 
	   VRTSaslapm package.
		   
	B) VxVM 5.1.100 is the minimum VxVM version that needs to be 
	   installed before proceeding with installation of VRTSaslapm 
	   package. So make sure that VxVM 5.1.100 or higher version is 
	   installed on system. 
	
   2.  Package Download Instructions:
   ----------------------------------

	A. Create a directory to store the VRTSaslapm package

		# mkdir /tmp/aslapm
		# cd /tmp/aslapm

	B. Download the VRTSaslapm package

	C. After downloading VRTSaslapm_AIX_5.1.100.301.tar.gz 
	   in /tmp/aslapm directory, verify the cksum

		# cksum VRTSaslapm_AIX_5.1.100.301.tar.gz
		96439813        272810   VRTSaslapm_AIX_5.1.100.301.tar.gz

	D. Uncompress the file and extract the packages

		# gunzip VRTSaslapm_AIX_5.1.100.301.tar.gz
		# tar -xvf VRTSaslapm_AIX_5.1.100.301.tar

		   
   3. Installation Instructions:
   ----------------------------

	A. If VRTSaslapm package is currently NOT installed on your 
	   system then perform an initial install.

		1. Install the package

			# installp -acgX -d VRTSaslapm.bff VRTSaslapm

		2. After you install VRTSaslapm package, you must execute:

			# vxdctl enable

	B. If there is a VRTSaslapm package already installed on your system 
	   then perform an upgrade/downgrade install.

		Note: For AIX 7.1 support, if you are upgrading from 5.1SP1PR1, 
			then  you will need to follow the "Downgrade Installation Instructions"
			below as the revision of VRTSaslapm package for PR releases 
			are higher than the latest VRTSaslapm update packages.

	   Upgrade Installation Instructions:
	   ----------------------------------

		1. Verify the version of currently installed VRTSaslapm package.
		   Make sure that you are upgrading VRTSaslapm package with a 
		   higher version.

			# lslpp -l  VRTSaslapm

		2. To upgrade VRTSaslapm package to higher version, execute:

			# installp -ad ./VRTSaslapm.bff VRTSaslapm

		3. After you upgrade VRTSaslapm package, you must execute:

			# vxdctl enable


	   Downgrade Installation Instructions:
	   ------------------------------------

		Note: If an array support was added via the currently 
			installed version of the VRTSaslapm package 
			then the downgrade of the package may cause 
			that array to not work properly.

		1. Verify the version of currently installed VRTSaslapm package.
		   Make sure that you are downgrading VRTSaslapm package with 
		   a lower version.

			# lslpp -l  VRTSaslapm

		2. To downgrade VRTSaslapm package to a lower version, execute:

			# installp -F -ad ./VRTSaslapm.bff VRTSaslapm


		3. After you downgraded VRTSaslapm package, you must execute:

			# vxdctl enable

   4. Post-Installation Checks:
   ----------------------------

	A. After you install VRTSaslapm package, verify output of 
	   "vxddladm listsupport" command:

		# vxddladm listsupport [all]
		# vxddladm listsupport libname=<libname>
			
	B. Check the output of "vxdmpadm listapm" command.
	   The APM should be in Active state if the corresponding array 
	   is connected:

		# vxdmpadm listapm [all | apmname]

	C. To see package information, execute

		# lslpp -l VRTSaslapm


Un-installation Procedure:
==========================

	Note: After un-installlation of VRTSaslapm package, any arrays that
		require an ASL/APM may not work properly until VRTSaslapm is 
		installed again.
		
	A. To uninstall VRTSaslapm package, execute
		# installp -u VRTSaslapm

	B. After you uninstall VRTSaslapm package, you must execute
		# vxdctl enable