			IBM(R) IBM2105.RTE README FOR AIX 

				February 11, 2005

------------------------------------------------------------------------------

CONTENTS

1.0	About this README file
1.1	  Who should read this README file
1.2	  How to get help
2.0	IBM2105.RTE Change History
3.0     Procedure for upgrading AIX OS, Host attachment, and/or SDD
4.0	User license agreement for IBM device drivers
4.1	  Background / Purpose
4.2	  Definitions
4.3	  License grant
4.4	  Responsibilities
4.5	  Confidential information
4.6	  Limitation of liability
4.7	  Termination
4.8	  Representations and warranties
4.9	  General provisions
5.0	Appendix A
6.0	Notices
7.0	Trademarks and service marks

------------------------------------------------------------------------------

1.0	About this README file

	Welcome to IBM2105.RTE. This README file contains the most recent information about  
	the IBM2105.RTE for the AIX platform. 

	IBM recommends that you print and review the contents of this README file and the 
	IBM ESS TotalStorage Host Systems Attachment Guide before installing and using IBM2105.RTE. 
	You can find the most current documentation and support information on the Web site:
	
	www.storage.ibm.com/hardsoft/products/ess/supserver.htm 
	
1.1	Who should read this README file

	This README file is intended for storage administrators, system programmers,
	and performance and capacity analysts.

	The information in this file only applies to customers who run ESS.


1.2	How to get help

	Go to the following Web site for the most current SDD documentation
	and support information: 
		http://www-1.ibm.com/servers/storage/support/software/sdd.html

	Go to the following Web site for the IBM ESS Open Systems support:
		http://www.storage.ibm.com/hardsoft/products/ess/supserver.htm

	Call one of the following numbers to obtain nontechnical or administrative
	support, such as hardware and software orders, hardware maintenance, services
	contract of entitlement, and invoices:

	   - For commercial or state and local support operations:
  	     1-877-426-6006 (Listen to the voice prompts.)

	   - For business partner support operations:
	     1-800-426-9990

	   - For federal government support operations:
	     1-800-333-6705 

--------------------------------------------------------------------------------------------

2.0	IBM2105.RTE

	The IBM2105.RTE is a Host Attachment(HA) package for AIX.  Use this attachment package
	with the documentation for the IBM ESS TotalStorage Host Systems Attachment Guide.
	The following lists history of the HA packages:

	- V32.6.100.24
	- V32.6.100.23
	- V32.6.100.22
	- V32.6.100.21
	- V32.6.100.19
	- V32.6.100.18
	- V32.6.100.17
	- V32.6.100.16
	- V32.6.100.15
	- V32.6.100.13
	- V32.6.100.12
	- V32.6.100.9
	- V32.6.100.8
	- V32.6.100.7
	- V32.6.100.6
	- V32.6.100.4
	
	The following provides descriptions of each HA update for AIX. 

	V32.6.100.24
	============
	This version adds new environment variable checking during upgrade.
	The new environment variable, SDDHDISK_ON_ROOTVG, is used when customers intend
	to upgrade the HA package while one or more 2105 hdisks belong to the rootvg volume
	group.  If it is set to YES, upgrade continues(Reboot is advised so that hdisks are
	reconfigured with new ODM attributes). If set to NO, all 2105 hdisks must
	be removed before upgrade can continue.

	If upgrading from v31.6.100.19 or below, you may encounter an ODM corruption
	after upgrade. Please contact your IBM technical support to correct ODM in this case.
	Also, refer to the following SDD AIX FLASH website for details:
		http://www-1.ibm.com/support/search.wss?rs=540&tc=ST52G7&dc=D600&dtm

	V32.6.100.23
	============
	This version adds one new attribute to the odm, max_transfer. This attribute 
	allows user to change the maximum data transfer size of a device. The default 
	value is set to 40,000. This attribute is only fully supported by AIX starting from
	AIX 5.2 or later.

	V32.6.100.22
	============
	This version does not allow installation of the ibm2105.rte Host Attachment if 
	ibm2105.rte version 32.6.100.19 or earlier is installed on the system, and hdisks are
	configured.  Users must remove all 2105 hdisks and SDD vpath devices from the host 
	system prior to upgrading.  This will help users avoid potential ODM corruption.

	V32.6.100.21
	============
	This version contains support for ESS scsi, fcp, and iscsi devices.  A new attribute 
	was also added to this version to support parallel configuration.

	Starting from this release(32.6.100.21), ESS FC devices will be configured as
	"IBM FC 2105", as seen from the "lsdev -Cc disk" output. This is changed from 
	"IBM FC 2105XXX", where 'XXX' is the ESS device model, such as F20 or 800.  
	Because of this change, you will need to remove all ESS FC hdisks and SDD vpath devices
	from your host system prior to installing or upgrading to this version of ibm2105.rte.

	V32.6.100.19
	============
	This version adds support for the new ESS model 750.

	V32.6.100.18
	============
	This version adds two new attributes to the odm, scbsy_dly(scsi and fcp) and 
	qfull_dly(fcp only).  These two attributes will prevent several host failures caused 
	when ESS is in a long busy state and returns queue full.

	V32.6.100.17
	============
	This version does not ship any new ODM stanzas.  This version only includes a check 
	to make sure the host attachment that supports MPIO is not installed on the host
	system already.  If the host attachment for MPIO is installed on the host already, 
	the installation of this package will fail.

	V32.6.100.16
	============
	This version provides support for FC dynamic device tracking.  It also provides a new 
	device attribute "lun_reset_spt" with default value set to 'yes' to support scsi-3
	lun_reset command for ESS devices.

	V32.6.100.15
	============
	This version does not ship any new ODM stanzas.  There are only changes to the packaging
 	to make sure there are no other versions of ibm2105.rte on the system already.

	V32.6.100.13
	============
	This version fixes a duplicate entry bug in the ODM.

	V32.6.100.12	
	============
	This version provides support for the new IBM 2105800 model. This version also 
        includes ODM entries of the PR for all Shark model.  

	V32.6.100.9
	===========
	This version provides support for Network Installation Management (NIM). You can install
	the IBM2105.RTE from a NIM master machine to multiple NIM AIX client machines. There 
	are no new ODM stanzas.  There are no changes to the existing ODM stanzas in the 
	fileset. You need the following filesets for NIM support:

	- devices.fcp.disk.ibm2105.rte
	- devices.scsi.disk.ibm2105.rte

	If you do not plan to use the NIM feature and are currently at version v32.6.100.7 or
	above, you are not required to install IBM2105.RTE version v32.6.100.9.

	V32.6.100.8
	===========
	This version provides a non-disruptive upgrade feature. When you install a new version of
	IBM2105.RTE, you are not required to run the varyoff command or deinstall the old version.

	There are no new ODM stanzas. There are no changes to the existing ODM stanzas in the 
	fileset. You are not required to install this version if you are currently at version 
	v32.6.100.7. IBM recommends that you install version 32.6.100.8 if you have version
	v32.6.100.6 or lower.  

	V32.6.100.7
	===========
	This version fixes the bosboot absence problem. The bosboot command was not executed
	after a successful installation of IBM2105.RTE version v32.6.100.6.

	V32.6.100.6
	===========
	For this version, the queue_depth setting was reduced to 20 based on the findings
	from the performace group.

	V32.6.100.4
	===========
	For this version, IBM added ODM stanzas to support fibre-channel subsystem disks 
	and support for the IBM 2105 Model F10/F20.
	
----------------------------------------------------------------------------------------------	

3.0  Procedure for upgrading AIX OS, Host attachment, and/or SDD

     The following procedure should be used when you want to upgrade:
     - AIX OS only**
     - Host attachment + AIX OS**
     - SDD + AIX OS
     - Host attachment + SDD
     - Host attachment only
     - SDD + Host attachment + AIX OS

     ** Upgrading the AIX OS will always require you to install the SDD which 
        corresponds to the new AIX OS level.

     In the case where you want to upgrade SDD only, follow the procedure in the SDD 
     User's Guide.

     1. Have rootvg on local SCSI disks. 
     2. Stop all activities related to SDD devices:
	- Stop application running on SDD volume groups/file systems.
	- If your host is in an HACMP environment, gracefully stop the cluster services.  
	- If there is active paging space created with SDD devices, deactivate 
          the paging space.
	- Umount all file systems of SDD volume group
	- Vary off all SDD volume groups.
     3. Remove SDD vpath devices with the command 'rmdev -dl dpo -R'.
     4. Remove hdisk devices with the command 
        'lsdev C t 2105* -F name | xargs -n1 rmdev -dl' for 2105 devices
        'lsdev C t 2145* -F name | xargs -n1 rmdev -dl' for 2145 devices
        'lsdev C t 2062* -F name | xargs -n1 rmdev -dl' for 2062 devices
	'lsdev C t 2107* -F name | xargs -n1 rmdev -dl' for 2107 devices
	'lsdev C t 1750* -F name | xargs -n1 rmdev -dl' for 1750 devices
     5. Check if hdisk devices are successfully removed with the command.
        'lsdev C t 2105* -F name' for 2105 devices
        'lsdev C t 2145* -F name' for 2145 devices
        'lsdev C t 2062* -F name' for 2062 devices
	'lsdev C t 2107* -F name' for 2107 devices
	'lsdev C t 1750* -F name' for 1750 devices 
     6. If upgrading OS, run 'stopsrc -s sddsrv' to stop sddsrv daemon.
     7. If upgrading OS, deinstall SDD.
     8. If required, upgrade to the latest version of the host attachment.
        Package names are:
        ibm2105.rte for 2105 devices
        devices.fcp.disk.ibm.rte for 2145, 2062, 2107, and 1750 devices
     9. If not upgrading OS, configure hdisks with the 'cfgmgr -vl fcsX' command for each
        FC adapter.
     10. If upgrading OS, migrate to the new AIX OS level first.
     11. If OS is upgraded, boot to the new AIX OS level with no disk groups online except rootvg
         which is on local SCSI disks. Reboot will automatically start at the end of 
         migration.
     12. If OS is upgraded, install or upgrade the corresponding SDD level for
	 the new AIX OS level. 
     13. Configure SDD vpath devices by running 'cfallvpath'.
     14. If your current SDD version is earlier than 1.6.0.0, run 'hd2vp' on all SDD 
	 volume groups. Otherwise, skip this step.
     15. Resume all activities related to SDD vpath devices:
	 - If there were active paging space created with SDD vpath devices, activate 
           the paging space.
	 - If your host was in an HACMP environment, start the cluster services. 
	 - Vary on all SDD volume groups.
	 - Mount all file system.
	 - Start application running on SDD volume groups/file systems.

-----------------------------------------------------------------------------------------------	

4.0	User license agreement for IBM 

	NOTICE: PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE PROGRAM AND DOCUMENTATION. 
	IBM(R) WILL ONLY LICENSE THIS PROGRAM AND DOCUMENTATION TO YOU IF YOU FIRST ACCEPT THE 
	TERMS OF THIS AGREEMENT. BY USING THE PROGRAM AND DOCUMENTATION, YOU AGREE TO ABIDE BY 
	THESE TERMS AND APPLICABLE COPYRIGHT LAWS. IBM LIMITS YOUR ACCEPTANCE OF THE PROGRAM AND 
	DOCUMENTATION TO THE TERMS OF THIS AGREEMENT. 

	The Program and Documentation is owned by International Business Machines Corporation or 
	one of its subsidiaries (IBM) or IBM suppliers, and is copyrighted and licensed, not sold. 
	IBM does not transfer title to this Program and Documentation to you. The terms of this 
	Agreement apply to any additional license copy of the Program or Documentation that IBM 
	authorizes you to make. The term "Program" means the original program and all whole or 
	partial copies of it, including portions merged with other programs. A Program consists of 
	machine-readable instructions and related license materials. 

	Under this Agreement, IBM provides you with a license to use the Program
	and Documentation only.
 

4.1	Background/Purpose 

	IBM provides certain Devices and Documentation under this Agreement. The device 
	drivers and library support that IBM provides under this Agreement are in object code form 
	only. Appendix A of this Agreement indicates the server platforms that are supported. IBM uses 
	announcements to withdraw service for device drivers, feature codes, etc., on hardware and/or 
	operating system platforms. IBM reserves the right to change the Programs or Documentation 
	at any time without prior notice. 


4.2	Definitions

	Derivative Work is a work based on a preexisting work, including a compilation. A Derivative 
	Work prepared without the authorization of the copyright owner of the preexisting work would 
	constitute a copyright infringement. 

	Documentation is the Program documentation that IBM provides to you as follows: IBM Subsystem 
	Device Driver and README files. 

	Object Code is machine-readable instructions in Object Code format. It is substantially in 
	binary form and directly executable by a computer after suitable processing but without the 
	intervening steps of compilation or assembly. 

	Program is the IBM Enterprise Storage Server in Object Code form.
 
4.3	License grant 

	IBM grants you a revocable, nontransferable, nonexclusive, worldwide, paid-up copyright 
	license to: 

   	1. Use the Program and Documentation solely on the platforms and with the applicable IBM 
	   devices described in Appendix A of this Agreement. 
   	2. Maintain one copy of the Program for backup purposes only. 

	Your license to the Programs and Documentation terminates when you no longer rightfully 
	possess the IBM device described in Appendix A. 

	This Agreement does not grant you any right or license to prepare Derivative Works of the 
	Program and Documentation. Nothing in this Agreement grants either party any rights or 
	licenses under any patents or patent applications regardless of whether use and/or execution 
	of the software licensed herein may be construed to practice one or more patents.

4.4	Responsibilities

	You agree to use the Program and Documentation only with the IBM device described in 
	Appendix A of this Agreement. You will not: 

   	1. otherwise copy, display, transfer, adopt, modify or distribute in any form, the Program 
	   and Documentation, except as IBM expressly authorizes in the Documentation 
   	2. decompile, disassemble, reverse engineer, or in any way modify the Program or Documentation 
   	3. sell, rent, lease, sublicense the Program or Documentation, unless explicitly permitted 
	   by law without the possibility of contractual waiver; and sublicense or assign the 
	   license for the Program and Documentation 

4.5	Confidential information

	Any information which either party may disclose to the other party shall not be deemed to be 
	confidential. If the parties require the exchange of confidential information, such exchange 
	will be made under a separate written confidentiality agreement. 


4.6	Limitation of liability

	IN NO EVENT SHALL IBM OR ITS SUPPLIERS BE LIABLE FOR COSTS OF PROCUREMENT OF SUBSTITUTE 
	GOODS OR SERVICES, LOSS OF DATA, LOST PROFITS, BUSINESS INTERRUPTION OR ANY SPECIAL, 
	INCIDENTAL, INDIRECT, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES , EVEN IF ADVISED OF 
	THE POSSIBILITY OF SUCH DAMAGES AND NOTWITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE OF 
	ANY REMEDY. 

	You acknowledge that circumstances may arise where, because of a default on IBM's part or 
	other liability, you may be entitled to recover damages. Under any such circumstances, you 
	agree that in each such instance, regardless of the basis on which you are entitled to 
	claim damages, IBM shall be liable only up to an amount equal to five thousand  U.S. 
	dollars ($5,000). This limitation will not apply to claims relating to bodily injury 
	(including death), and damage to real property and personal property. 


4.7	Termination
	
	Termination for Cause. If either party fails to perform its obligations hereunder, then the 
	other party may terminate this Agreement or the license granted hereunder for cause. 

	Effect of Termination. The rights and licenses granted to you under this Agreement shall 
	automatically terminate upon the termination of this Agreement. 


4.8	Representations and warranties 
	
	THE PROGRAM AND DOCUMENTATION IS PROVIDED ON AN "AS IS" BASIS. IBM MAKES NO REPRESENTATION 
	OR WARRANTY, EXPRESS OR IMPLIED, WITH RESPECT TO THE PROGRAM AND DOCUMENTATION.IBM DISCLAIMS 
	THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
	NON-INFRINGEMENT. THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE PROGRAM AND 
	DOCUMENTATION REMAINS WITH YOU. 


4.9	General Provisions
	
	Transfer. You may transfer possession of the program and its media and Documentation to 
	another pay with the transfer of the IBM device described in Appendix A on which such 
	Program is used with. If you do so, you must give the other party a copy of these terms 
	and provide all user documentation to that party, and such party must first agree to such 
	terms before it uses the Program and Documentation. Upon transfer of the Program and 
	Documentation, you must destroy all your copies of the Program and Documentation. 

	Severability. If any provision of this Agreement is found to be illegal or unenforceable, 
	the remainder of this Agreement shall continue in full force and effect provided that the 
	Agreement still effectuates the parties' original intent. 

	Governing Law and Jury Trial Waiver. This Agreement shall be governed by the laws of the 
	State of New York, excluding its conflict of law rules. Each party hereby agrees to waive 
	its rights to a trial by jury. 

	Modifications. No modification to this Agreement, nor any waiver of any rights, shall be 
	effective unless agreed to in a writing that is executed by both parties, and the waiver 
	of any breach or default of this Agreement shall not constitute a waiver of any other right 
	or of any subsequent breach or default. 

	Limitations on Legal Actions. Neither party will bring a legal action against the other more 
	than two (2) years after the cause of action arose. Both parties will act in good faith to 
	resolve disputes. 

	Order of Precedence. In the event of a conflict in terms between this Agreement and another 
	agreement, the terms of this Agreement shall take precedence and prevail over such other 
	terms. 

	Entire Agreement. This Agreement constitutes the entire and exclusive agreement between 
	the parties with respect to this subject matter. All previous discussions and agreements 
	with respect to this subject matter are superseded by this Agreement.

-------------------------------------------------------------------------------------------------
5.0	Appendix A
	
	This Appendix indicates: 

   	1. Which specific IBM devices the Program and Documentation are to be used with:

		IBM devices:IBM Enterprise Storage Server?(ESS) 

   	2. For what specific server platforms the Program and Documentation are to be used on and 
	   for what software requirements apply to the use of the Program and Documentation reference 
	   the ESS Open Systems Support Web page,located at: 

      		www.storage.ibm.com/hardsoft/products/ess/supserver.htm 

	CONTINUING WITH THIS INSTALLATION CONSTITUTES YOUR ACCEPTANCE OF THE TERMS OF THE ABOVE 
	'USER LICENSE AGREEMENT FOR IBM DEVICE DRIVERS'. 

-----------------------------------------------------------------------------------------------

6.0 	Notices

	This information was developed for products and services offered in the U.S.A. 

	IBM may not offer the products, services,or features discussed in this document in other 
	countries. Consult your local IBM representative for information on the products and services 
	currently available in your area. Any reference to an IBM product, program, or service is 
	not intended to state or imply that only that IBM product, program, or service may be used. 
	Any functionally equivalent product, program, or service that does not infringe any IBM 
	intellectual property right may be used instead. However, it is the user's responsibility 
	to evaluate and verify the operation of any non-IBM product, program, or service. 

	IBM may have patents or pending patent applications covering subject matter described in 
	this document. The furnishing of this document does not give you any license to these patents.
	You can send license inquiries, in writing, to:                          
                        
		IBM Director of Licensing
		IBM Corporation
		North Castle Drive
		Armonk, NY 10504-1785
		U.S.A.

	For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual 
	Property Department in your country or send inquiries,in writing, to: 

		IBM World Trade Asia Corporation
		Licensing
		2-31 Roppongi 3-chome, Minato-ku
		Tokyo 106, Japan

	The following paragraph does not apply to the United Kingdom or any other country where 
	such provisions are inconsistent with local law:

	INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT 
	WARRANTY OF ANY KIND,EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
	WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some 
	states do not allow disclaimer of express or implied warranties in certain transactions, 
	therefore, this statement may not apply to you. 

	This information could include technical inaccuracies or typographical errors. Changes are 
	periodically made to the information herein; these changes will be incorporated in new 
	editions of the publication. IBM may make improvements and/or changes in the product(s) 
	and/or the program(s) described in this publication at any time without notice. 

	IBM may use or distribute any of the information you supply in any way it believes appropriate 
	without incurring any obligation to you.

	Any performance data contained herein was determined in a controlled environment. Therefore, 
	the results obtained in other operating environments may vary significantly. Some 
	measurements may have been made on development-level systems and there is no guarantee that 
	these measurements will be the same on generally available systems. Furthermore, some 
	measurement may have been estimated through extrapolation. Actual results may vary. Users 
	of this document should verify the applicable data for their specific environment. 

	Information concerning non-IBM products was obtained from the suppliers of those products, 
	their published announcements or other publicly available sources. IBM has not tested those 
	products and cannot confirm the accuracy of performance, compatibility or any other claims 
	related to non-IBM products. Questions on the capabilities of non-IBM products should be 
	addressed to the suppliers of those products. 

	This information contains examples of data and reports used in daily business operations. 
	To illustrate them as completely as possible, the examples include the names of individuals, 
	companies, brands, and products. All of these names are fictitious and any similarity to 
	the names and addresses used by an actual business enterprise is entirely coincidental. 


-----------------------------------------------------------------------------------------------

7.0	Trademarks and service marks

	The following terms are trademarks of the International Business Machines Corporation in 
	the United States, or other countries, or both: 

	AIX
	AS/400
        Enterprise Storage Server
        HACMP/6000
	IBM
        IBM logo
	iSeries
        Netfinity
        NetVista
        Operating System/400
	pSeries
        RS/6000
        Seascape
        SP
        System/360
        System/370
        System/390
	The eServer logo
        TotalStorage
        Versatile Storage Server
        xSeries
        zSeries
        z/Architecture
        z/OS

	Microsoft, Windows, Windows NT, and the Windows logo are registered
	trademarks of Microsoft Corporation.

	Java and all Java-based trademarks are trademarks of Sun Microsystems,
	Inc. in the United States, other countries, or both.

	UNIX is a registered trademark of The Open Group in the United States
	and other countries.

	Other company, product, and service names may be trademarks or
	service marks of others.

--------------------------------------------------------------------------------------------------
(C) Copyright IBM Corporation 2000, 2002, 2003, 2004, 2005. All rights reserved. 



