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

Date					: 1/16/2012

Package Name				: VRTSaslapm

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

Package Version				: 5.1.100.301

Operating System			: Linux
Operating System version		: RHEL, SLES

Veritas Volume Manager Version		: 5.1.100.000

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

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_Linux_5.1.100.301.tar.gz 
	   in /tmp/aslapm directory, verify the cksum

		# cksum VRTSaslapm_Linux_5.1.100.301.tar.gz
		3262656654      663369  VRTSaslapm_Linux_5.1.100.301.tar.gz

	D. Uncompress the file and extract the packages

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

	E. Change Directory to appropriate Linux release.

		# cd SLES11

		Note: The below are example installation instructions for 
			Linux SLES11. Similar instructions can be followed 
			for RHEL5, RHEL6 and SLES10

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

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

		1. Install the package

		    # rpm -ivh VRTSaslapm-5.1.100.301-SP1_SLES11.x86_64.rpm 

		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 RHEL 6 support, if you are upgrading from 5.1SP1PR2,
                        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.

		    # rpm -qil VRTSaslapm-5.1<version> | grep Version

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

		    # rpm -Uvh VRTSaslapm-5.1.100.301-SP1_SLES11.x86_64.rpm

		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 t
			hat 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.

		  # rpm -qil VRTSaslapm-5.1<version> | grep Version


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

		  # rpm --force -Uvh VRTSaslapm-5.1.100.301-SP1_SLES11.x86_64.rpm


		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

		# rpm -qil VRTSaslapm-5.1.100.301-SP1_SLES11


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
		# rpm -e VRTSaslapm-5.1.100.301-SP1_SLES11

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