IBM(R) SUBSYSTEM DEVICE DRIVER 1.2.2.x README FOR AIX™ CONTENTS 1.0 ABOUT THIS README FILE 1.1 Who should read this README file 1.2 How to get help 1.3 Help contacts 1.4 Where to find more information 2.0 USER LICENSE AGREEMENT FOR IBM DEVICE DRIVERS 2.1 Background / Purpose 2.2 Definitions 2.3 License grant 2.4 Responsibilities 2.5 Confidential information 2.6 Limitation of liability 2.7 Termination 2.8 Representations and warranties 2.9 General provisions 3.0 APPENDIX A 4.0 IBM SUBSYSTEM DEVICE DRIVER 1.2.2.x README FOR AIX™ 5.0 README.txt 6.0 New SDD functions available via a no-charge RPQ 7.0 DEFECTS CORRECTED 8.0 UTILITIES FOR IBM SUBSYSTEM DEVICE DRIVER ON AN ESS: ESS / DPO Custom Utilities for AIX 9.0 NOTICES 9.1 Trademarks and service marks 1.0 ABOUT THIS README FILE Welcome to IBM Subsystem Device Driver. This README file contains the latest information about installing IBM Subsystem Device Driver. 1.1 Who should read this README file This documentation is for storage administrators, system programmers, and performance and capacity analysts. 1.2 How to get help The most current support information can be found on the following Web site: www.ibm.com/storage/support/techsup/swtechsup.nsf/support/sddupdates For support procedures, you can also go to the following Web site: ssddom01.storage.ibm.com/techsup/swtechsup.nsf/support/sddsupport 1.3 Help contacts Who to contact for administrative support (non-technical) You may call this number concerning questions on hardware/software orders, hardware maintenance, services contract of entitlement, and invoices: Commercial or State & Local Support Operations: 1-877-426-6006 (Please listen to voice prompts) Business Partner Support Operations direct toll free number: 1-800-426-9990 Federal Government Support Operations direct toll free number: 1-800-333-6705 1.4 Where to find more information For more information, you can refer to The Subsystem Device Driver Installation and User's Guide. You can also go to the ESS Open Systems Support Web site, located at: www.storage.ibm.com/hardsoft/products/ess/supserver.htm 2.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. 2.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. 2.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. 2.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. 2.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 theProgram 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 2.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. 2.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. 2.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. 2.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. 2.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 toin 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. 3.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'. 4.0 IBM SUBSYSTEM DEVICE DRIVER 1.2.0.x README FOR AIX™ IBM Subsystem Device Driver for AIX Version 1 Release 2 Modification 2 Level x 5.0 README.txt This README file contains last-minute product information for the Subsystem Device Driver 1.2.0.x. It is strongly recommended that you print and review the contents of this README file and the Subsystem Device Driver Installation and User's Guide before installing the Subsystem Device Driver. The most current level of the documentation and support information can be found on the Web site: www.ibm.com/storage/support/techsup/swtechsup.nsf/support/sddupdates 6.0 New SDD functions available via a no-charge RPQ The following SDD functions are available via a no-charge RPQ (Request for Price Quotation): 1. SDD support for AIX 5.1.0 2. Non-disruptive installation procedure for AIX 4.2.1 or higher 3. Dynamic addpaths feature for AIX 4.3.2 or higher. You can obtain any of these functions through your IBM sales representative or Business Partner. 7.0 DEFECTS CORRECTED TABLE 1. The following table list the defects corrected in this release of Subsystem Device Driver. See the Defects Details section for more information, if available, on a listed defect. Note: The following defect numbers are for IBM internal reference use only. ====================================================================== Defect # Description ====================================================================== 1163 The "datapath set adapter offline" command fails if any of the Subsystem Device Driver vpath devices is configured with a single path even though the path is not attached to this adapter. 1142 "cfallvpath" is added as a new Subsystem Device Driver configuration method. 1183 The new "cfallvpath" Subsystem Device Driver configuration method fails to check the maximum number of ESS LUNs supported by the Subsystem Device Driver. 1138 Script is changed to ensure that "extendvg4vp" checks for any opened logical volumes before calling "varyoffvg." 1134 Turn on the 'f' flag when running the "mkvg4vp" command in the SMIT panel 1099 Support for "512" and "1024" block sizes in the SMIT panel: Under fastpath datapath_mkvg in the SMIT menu, "512" and "1024" are added to the selection list for "Physical partition size in megabytes" to match the settings in fastpath "mkvg." 1089, 1131 The new "savevg4vp" and "restvg4vp" commands are provided by the Subystem Device Driver to replace the "savevg" and "restvg" commands. 1087 Add a missing trace flag in the Subsystem Device Driver trace file. DEFECT DETAILS. The following section provides additional information about the defects listed above (as applicable). ====================================================================== Defect #1142 "cfallvpath" as a new Subsystem Device Driver configuration method The "cfallvpath" command is added to achieve the following: 1. Greatly reduce the amount of time to configure the Subsystem Device Driver with a large number of ESS hdisks or to boot up the system configured with a large number of ESS hdisks and Subsystem Device Driver devices. 2. Avoid the potential failure to configure the Subsystem Device Driver due to the memory leak caused by AIX system calls. Use the "cfallvpath" command, instead of the "cfgmgr -1 dpo" command, to configure the Subsystem Device Driver devices with a large number of ESS hdisks. The "cfallvpath" command does not require any parameters. ====================================================================== Defect #1089 New "savevg4vp" and "restvg4vp" commands 1131 The "savevg4vp" (derived from savevg) command is designed to save an entire volume group created by the Subsystem Device Driver devices. It allows the device pvids to remain with the Subsystem Device Driver devices. You must replace the "savevg" command with the "savevg4vp" command in your script file to back up all files that belong to a specific Subsystem Device Driver volume group. Caution: Using the "savevg4vp" command to back up data will overwrite the data previously stored on the selected output medium. Data integrity of the archive might be comprised if a file is modified during the system backup process. Keep the number of system activities at a minimum during the system backup procedure. The "restvg4vp" (derived from restvg) command is designed to restore an entire volume group created by the Subsystem Device Driver. It allows the device pvids to remain with the Subsystem Device Driver devices. You must replace the "restvg" command with the "restvg4vp" command in your script file to restore all files that belong to a specific Subsystem Device Driver volume group. See Subsystem Device Driver Installation and User Guide for more information about using the "savevg4vp" and "restvg4vp" commands. 8.0 UTILITIES FOR IBM SUBSYSTEM DEVICE DRIVER ON AN ESS: ESS / DPO Custom Utilities for AIX. lsvp is a utility program that displays the Subsystem Device Driver vpath status from an ESS physical code perspective. You can use the lsvp program to set the Subsystem Device Driver vpath paths offline using an ESS location code. The lsvp program is available from the ibmpfe.essutil.rte file set (install package) for an AIX host system. You can obtain the ibmpfe.essutil.rte install package from the the following web site: http://www.ibm.com/storage/support/techsup/swtechsup.nsf/support/sddlink Tip: On the website, click on "Utilities for IBM Subsystem Device Driver / Data Path Optimizer on an ESS:" The following files are included in the ibmpfe.essutil.rte fileset: /usr/lpp/ibmpfe.essutil/README /usr/lib/methods/scsimap /usr/lib/methods/fcmap /usr/bin/lsess /usr/bin/ls2105 /usr/bin/lssdd /usr/bin/lsvp /usr/bin/get_ess_port /usr/bin/get_ess_vpd /usr/bin/get_ess_cudv Complete the following steps to install the ibmpfe.essutil.rte fileset: 1. Use smitty to install ibmpfe.essutil.rte file set 2. Choose the next set of options according to your needs. Note: - For SCSI device support: Use smitty to install ibmpfe.essutil.scsi.data fileset. - For FC device support: Use smitty to install ibmpfe.essutil.fibre.data fileset. Attention: You can install both the SCSI and FC support. However, to avoid the error messages described below, you should only install the support for the device types you have configured. You can run the following four programs from the command line: 1) lsvp 2) lsess 3) ls2105 4) lssdd Header definitions for all programs are as follows: Disk - hdisk name assigned by the host Location - physical location code of host adapter lun is accessed through LUN SN - unique serial number for each lun within the ESS Type - device and model Size - configured capacity of lun in giga bytes LSS - logical subsystem where lun resides Vol - volume number within the LSS Rank - unique identifier for each raid-array with the ESS C/A - cluster and adapter accessing the array S - shared by two or more ESS ports, Yes or No Connection - physical location code of ESS adapter lun is accessed through lsvp program descriptions and example: The lsvp shows the Subsystem Device Driver vpath status from an ESS physical location code perspective. Included is the capability to set the Subsystem Device Driver vpath paths offline using an ESS location code. Usage: lsvp [-adt] [-o] [-l location_code] -a Display SDD logical path to ESS physical location code -d Display path status for each vpath device -t Test physical access to hdisks, can only be used with -d option -o Attempts to set all SDD paths ONLINE -l Set SDD paths OFFLINE for specified ESS location code location_code must be in one of the following formats: single port = R1-Bx-Hy-Zz all ports on card = R1-Bx-Hy all ports on bay = R1-Bx Type the following at the command prompt: # lsvp -d The output should look similar to this: BAY-1(B1) BAY-2(B2) BAY-3(B3) BAY-4(B4) H1 H2 H3 H4 H1 H2 H3 H4 H1 H2 H3 H4 H1 H2 H3 H4 A B A B A B A B A B A B A B A B A B A B A B A B A B A B A B A B 0 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 1 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 2 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 3 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 4 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 5 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 6 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 7 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 8 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 9 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 10 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 11 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - Y = online/open O = online/closed N = offline X = not-available - = path not configured ? = path information not available PD = path down lsess program descriptions and example: The lsess program displays data collected from the fcmap and scsimap program invoked by cfgmgr. fcmap and scsimap issues scsi commands directly to the disks (inquiry,read capacity, and log sense) to collect the information displayed. Note: To run lsess, you will need to either restart your host system or run cfgmgr (AIX command to configure disks) with all 2105 vg's offline. This is only necessary for the initial run. Type the following at the command prompt: # lsess The output should look similar to this: Disk Location LUN SN Type Size LSS Vol Rank C/A S Connection ------ ------------ -------- ------------ ------ ----- ----- ------ ---- --- ----------- hdisk1 10-68-01[FC] 008FC106 IBM 2105-E20 2.0 10 8 1001 01 Y R1-B2-H4-ZA ls2105 and lssdd descriptions and examples: The ls2105 and lssdd programs format data collected by AIX and stored in the ODM when the disks were configured to the host. Type the following at the command prompt: # ls2105 The output should look similar to this: Hostname VG hdisk Location LUN SN S Connection Size LSS Vol Rank -------- -- ----- -------- ------ - ---------- ---- --- --- ---- hashark1 None hdisk1 10-68-01 008FC106 Y R1-B2-H4-ZA 2.0 10 8 1001 Type the following at the command prompt: # lssdd The output should look similar to this: Hostname VG vpath hdisk Location LUN SN S Connection Size LSS Vol Rank -------- -- ----- ----- -------- ------ - ---------- ---- --- --- ---- hashark1 sharkvg vpath0 hdisk1 10-68-01 008FC106 Y R1-B2-H4-ZA 2.0 10 8 1001 hashark1 sharkvg vpath0 hdisk9 10-68-01 008FC106 Y R1-B1-H4-ZA 2.0 10 8 1001 Note: ls2105, lssdd, and lsvp do not require a system restart or vg's to be offline for initial run. However, they do require the ibm2105.rte package to be at 32.6.100.3 code level (or higher). If lsess has not been run, the lssdd output will not contain LSS, Volume, and Rank information. Attention: If you are getting one of the following errors when running cfgmgr, it is because your 2105 devices are either all native SCSI or all FC. Method error (/usr/lib/methods/scsimap >> /var/adm/essmap.out): 0514-023 The specified device does not exist in the customized device configuration database. Method error (/usr/lib/methods/fcmap >> /var/adm/essmap.out): 0514-023 The specified device does not exist in the customized device configuration database. If you no not intend to have a mix of 2105-SCSI and 2105-FC, then you can eliminate the error by performing either: Use smitty to remove ibmpfe.essutil.fibre.data fileset (do this for all 2105-SCSI configurations) Use smitty to remove ibmpfe.essutil.scsi.data fileset (do this for all 2105-FC configurations) Note: Both actions will remove support for the device types you do not have configured. 9.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 licenseinquiries, 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. If you are viewing this information softcopy, the photographs and color illustrations may not appear. 9.1 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 IBM Netfinity RS/6000 Microsoft, Windows, Windows NT, and the Windows logo are registered trademarks of Microsoft Corporation. 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, 2001. All rights reserved.