IBM(R) SUBSYSTEM DEVICE DRIVER VERSION 1.4.0.5 README FOR AIX™ --------------------------------------------------------------------------- CONTENTS 1.0 About this README file 1.1 Who should read this README file 1.2 How to get help 2.0 Prerequisites for SDD 3.0 Special instructions for first time installation 4.0 Correction to User's Guide 5.0 SDD defects and fixes 6.0 User license agreement for IBM device drivers 6.1 Background / Purpose 6.2 Definitions 6.3 License grant 6.4 Responsibilities 6.5 Confidential information 6.6 Limitation of liability 6.7 Termination 6.8 Representations and warranties 6.9 General provisions 6.10 Appendix A 7.0 Notices 8.0 Trademarks and service marks --------------------------------------------------------------------------- 1.0 About this README file Welcome to IBM Subsystem Device Driver (SDD). This README file contains the most recent information about the IBM Subsystem Device Driver, Version 1 Release 4 Modification 0 Level 5 (SDD 1.4.0.5) for AIX. IBM recommends that you print and review the contents of this README file and the Subsystem Device Diver User’s Guide before installing and using SDD. You can find the most current documentation and support information on the Web site: www.ibm.com/storage/support/techsup/swtechsup.nsf/support/sddupdates/ 1.1 Who should read this README file This README file is intended for storage administrators, system programmers, and performance and capacity analysts. 1.2 How to get help Go to the following Web site for SDD technical support and for the most current SDD documentation and support information: www.ibm.com/storage/support/techsup/swtechsup.nsf/support/sddupdates/ 1.3 Go to the following Web site for the IBM ESS Open Systems support: www.storage.ibm.com/hardsoft/products/ess/supserver.htm 1.4 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 Prerequisites for SDD Prior to installing SDD for ESS, you should install the latest version of ibm2105.rte. The latest version of ibm2105.rte is 32.6.100.15 ------------------------------------------------------------------------ 3.0 Special instructions for first time installation Procedures for first time installation of SDD: 1. Log in as the root user. 2. Load the compact disc into the CD-ROM drive. 3. From your desktop window, type smitty install_update and press Enter to go directly to the installation panels. The Install and Update Software menu displays. 4. Highlight Install Software and press Enter. 5. Press F4 to display the INPUT Device/Directory for Software panel. 6. Select the compact disc drive that you are using for the installation, for example, /dev/cd0; and press Enter. 7. Press Enter again. 417 The Install Software panel displays. 8. Highlight Software to Install and press F4. The Software to Install panel displays. 8. Highlight and select two packages a. devices.sdd.*.rte b. devices.sdd.*.1.4.0.5.bff to install by pressing F7 (Select the installation package that is appropriate for your environment. See the SDD User's Guide Section entitled "Determining the installation package" for details). An ">" sign will appear on the left hand side of the package name. 9. Press Enter. The Software to Install panel displays. 10. Press Enter. The Install and Update from LATEST Available software panel displays with the name of the software you selected to install. 11. Check the default option settings to ensure that they have the values that you need. 12. Press Enter to install. SMIT responds with the following message: +----------------------------------------------------------------+ | ARE YOU SURE?? | | Continuing may delete information you may want to keep. | | This is your last chance to stop before continuing. | +----------------------------------------------------------------+ 13. Press Enter to continue. The installation process can take several minutes to complete. 14. When the installation is complete, press F10 to exit from SMIT. Remove the compact disc. Note: You do not need to reboot SDD even though the bosboot message indicates that a reboot is necessary. Note: If user migrates from older version of SDD(VRMF < 1.4.0.0) to SDD 1.4.0.x, user will encounter an error during restoration of LVM configuration, with the following message displayed: "Error! Could not get 2105_max_luns value from file" To recover from here, user needs to do the following steps: 1. vi /etc/lvm.cfg file, 2. add a value of 600 beneath the broken doubled line as shown below: 2105_MAX_LUN ============ 600 3. save the file. 4. run "lvmrecover" script to complete the migration. Tip: The SMIT facility runs in two interfaces, nongraphical and graphical. This procedure uses the nongraphical interface. You can type smit to invoke the graphical user interface. The list items on the SMIT panel might be worded differently from one AIX version to another. ------------------------------------------------------------------------ 4.0 Correction to User's Guide Missing section in the User's Guide: Upgrading SDD Manually If you are upgrading from a previous version of the SDD that you installed with an installation package not listed in Table 1, or if you use migration to upgrade from AIX 4.3.3 to AIX 5.1.0, you cannot perform an installation upgrade. Instead, you must uninstall the existing SDD and then install the new version of SDD. Table 1. List of previously installed installation packages that are supported with the installation upgrade ----------------------------------------- | Installation package name | ----------------------------------------- | ibmSdd_432.rte | | ibmSdd.rte.432 | | ibmSdd_433.rte | | ibmSdd.rte.433 | | ibmSdd_510.rte | | ibmSdd_510nchacmp.rte | | devices.sdd.43.rte | | devices.sdd.51.rte | | devices.sdd.52.rte | ----------------------------------------- Perform the following steps to upgrade SDD: 1. Remove any .toc files generated during previous SDD installations. Type the following command to delete any .toc file found in the /usr/sys/inst.images directory: rm .toc Note: Ensure that this file is removed because it contains information about the previous version of SDD. 2. Issue the lspv command to find out all the SDD volume groups. 3. Issue the lsvgfs command for each SDD volume group to find out which file systems are mounted. Type the following command: lsvgfs vg_name 4. Issue the umount command to unmount all file systems belonging to SDD volume groups. Type the following command: umount filesystem_name 5. Run the vp2hd script to convert the volume group from SDD devices to ESS or SAN Volume Controller hdisk devices. 6. Issue the varyoffvg command to vary off the volume groups. Type the following command: varyoffvg vg_name 7. Remove all SDD devices. Type the following command: rmdev -dl dpo -R 8. Use the smitty command to uninstall SDD. Type smitty deinstall and press Enter. The uninstall process begins. Complete the uninstall process. See "Removing SDD from an AIX host system" for the step-by-step procedure for uninstalling SDD. 9. If you have an AIX migration system, use the smitty command to upgrade your operating system from AIX 4.3.3 to AIX 5.1.0. 10. Use the smitty command to install the newer version of SDD from the compact disc. Type smitty install and press Enter. The installation process begins. Go to to complete the installation process. 11. Use the smitty device command to configure all the SDD devices to the Available state. See for a step-by-step procedure for configuring devices. 12. Issue the lsvpcfg command to verify the SDD configuration. Type the following command: lsvpcfg 13. Issue the varyonvg command for each volume group that was previously varied offline. Type the following command: varyonvg vg_name 14. Run the hd2vp script for each SDD volume group to convert the physical volumes from ESS or SAN Volume Controller hdisk devices back to SDD vpath devices. Type the following command: hd2vp vg_name 15. Issue the lspv command to verify that all physical volumes of the SDD volume groups are SDD vpath devices. 16. Issue the mount command to mount all file systems that were unmounted in step 4. Type the following command: mount filesystem-name Attention: If the physical volumes on an SDD volume group’s physical volumes are mixed with hdisk devices and vpath devices, you must run the dpovgfix utility to fix this problem. Otherwise, SDD will not function properly. Issue the dpovgfix vg_name command to fix this problem. Correction to section entitled 'Unconfiguring Subsystem Device Driver' on page 25: 1. Before you unconfigure SDD devices, ensure that: All I/O activities on the devices that you need to unconfigure are stopped. All file systems belonging to the SDD volume groups are unmounted and all volume groups are varied off. 2. Run the vp2hd conversion script to convert the volume group from SDD devices (vpathN) to ESS or SAN Volume Controller devices (hdisks). Addendum to section entitled 'Committing or Rejecting a PTF Update' on page 30: Prior to rejecting a PTF update: 1. stop SDD Server. Type the following command: stopsrc -s sddsrv 2. Issue the lspv command to find out all the SDD volume groups. 3. Issue the lsvgfs command for each SDD volume group to find out which file systems are mounted. Type the following command: lsvgfs vg_name 4. Issue the umount command to unmount all file systems belonging to SDD volume groups. Type the following command: umount filesystem_name 5. Run the vp2hd script to convert the volume group from SDD devices to ESS or SAN Volume Controller hdisk devices. 6. Issue the varyoffvg command to vary off the volume groups. Type the following command: varyoffvg vg_name 7. Remove all SDD devices. Type the following command: rmdev -dl dpo -R After the procedure to reject a PTF update completes successfully: 1. Use the smitty device command to configure all the SDD devices to the Available state. See for a step-by-step procedure for configuring devices. 2. Issue the lsvpcfg command to verify the SDD configuration. Type the following command: lsvpcfg 3. Issue the varyonvg command for each volume group that was previously varied offline. Type the following command: varyonvg vg_name 4. Run the hd2vp script for each SDD volume group to convert the physical volumes from ESS or SAN Volume Controller hdisk devices back to SDD vpath devices. Type the following command: hd2vp vg_name 5. Issue the lspv command to verify that all physical volumes of the SDD volume groups are SDD vpath devices. 6. Issue the mount command to mount all file systems that were unmounted in step 4. Type the following command: mount filesystem-name Attention: If the physical volumes on an SDD volume group’s physical volumes are mixed with hdisk devices and vpath devices, you must run the dpovgfix utility to fix this problem. Otherwise, SDD will not function properly. Issue the dpovgfix vg_name command to fix this problem. 7. start SDD Server. Type the following command: startsrc -s sddsrv ------------------------------------------------------------------------ 5.0 SDD defects and fixes SDD 1.4.0.1 2543 Fix open failure for reservation conflict SDD 1.4.0.2 2070 (mc def 84727) (sddsrv) If the HACMP script file uses the '-c' flag when calling 'stopsrc' to stop sddsrv, it could cause a failure and leave the subsequent path open. This is because the '-c' flag will stop sddsrv immediately, leaving some paths in an open state. A fix to the HACMP script is necessary to remove '-c' flag in the 'stopsrc' command, so sddsrv can shut down gracefully. 2081 (sddsrv) PMR02293,c866 sddsrv needs to run an additional path probing cycle before it shuts down in order to detect any failed paths. 2089 (mc def 85514) PMH08491,b69h,c760: SDD driver adds 1 more retry to a failed I/O request if it fails on the last path. 2106 (mc def 86065) The SDD adapter select_count variable went to a negative number. This was caused by integer overflow. SDD 1.4.0.3 2118 When PR Preempt cmd being executed, but returns timed out status, SDD needs to re-register initiators. 86657 If user migrates from older version of SDD(VRMF < 1.4.0.0) to SDD 1.4.0.x, user will encounter an error during restoration of LVM configuration, with the following message displayed: "Error! Could not get 2105_max_luns value from file" To recover from here, user needs to do the following steps: 1. vi /etc/lvm.cfg file, 2. add a value of 600 beneath the broken doubled line as shown below: 2105_MAX_LUN ============ 600 3. save the file. 4. run "lvmrecover" script to complete the migration. SDD 1.4.0.4 86801 1000 SDD vpath devices were reduced to 600 after concurrent upgrading AIX SDD PTF v1.4.0.3. This is a packaging problem. This problem only occured on aix520 system. So only devices.sdd.52.rte is updated to v1.4.0.4 SDD 1.4.0.5 87154 When the last path loses access, I/O is retired repetitively and possibly hangs the host. ------------------------------------------------------------------------ 6.0 User license agreement for IBM device drivers 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. 6.1 Background/Purpose IBM provides certain device drivers 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. 6.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 Subsystem Device Driver in Object Code form. 6.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. 6.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 6.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. 6.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. 6.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. 6.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. 6.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. CONTINUING WITH THIS INSTALLATION CONSTITUTES YOUR ACCEPTANCE OF THE TERMS OF THE ABOVE 'USER LICENSE AGREEMENT FOR IBM DEVICE DRIVERS. --------------------------------------------------------------------------- 7.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. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. 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. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Information Enabling Requests Dept. DZWA 5600 Cottle Road San Jose, CA 95193 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM License Agreement for Non-Warranted Programs. 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. --------------------------------------------------------------------------- 8.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 Enterprise Storage Server HACMP/6000 IBM IBM logo IBM TotalStorage iSeries Netfinity NetVista Operating System/400 RS/6000 Seascape SP StorWatch System/360 System/370 System/390 System/400 TotalStorage Versatile Storage Server xSeries zSeries z/Architecture 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. All rights reserved.