IBM(R) Subsystem Device Driver DSM Version 2.4.3.

1-2 README for

Windows Server 2003 SP2, Windows 2008 & Windows 2008 R2

March 08, 2011
-------------------------------------------------------------------------------
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 SDDDSM
3.0 SDDDSM change history
3.1 Defects Fixed
3.2 New Features
3.3 Feature Details and Restrictions
3.4 Known issues
3.5 Known issues and workaround details
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
4.10 Appendix A
5.0 Notices
6.0 Trademarks and service marks
-------------------------------------------------------------------------------
1.0 About this README file
Welcome to IBM Subsystem Device Driver DSM(SDDDSM). This README file contai
ns
the most recent information about the IBM Subsystem Device Driver DSM,
Version 2 Release 4 Modification 3 Level 1 Build 2 (SDDDSM 2.4.3.1-2) for
Windows Server 2003 SP2, Windows 2008 & Windows 2008 R2.
IBM recommends that you go to this Web site to get the most current
information about this release of SDDDSM:
http://www.ibm.com/systems/support/storage/software/sdd/
You should carefully review the following information available through
that site:
1. The most current README file. This will contain corrections to the
readme file, corrections to the SDDDSM User's Guide, and documentation
updates made discovered since this copy of the README was prepared.
2. The SDDDSM Users' Guide. Because SDDDSM can be installed in so many
different environments / configurations, detailed information about each
environment is placed in the appropriate chapter of the SDDDSM Users Guide.
The 'Summary of Changes' section of the SDDDSM Users' Guide can help you
quickly determine if the latest changes affect you.
3. The Flashes. As we become aware of any information that is likely to
impact a broad set of our customers, Flashes are prepared and posted on
this site. You should review this section periodocally to see any new
Flashes that have been posted since your last review.
For prerequisites information, be sure to look in the SDDDSM User's Guide a
s
well as the prerequisites section of this readme file for the latest
updates.
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:

1. 2145/IBM Storwize V7000
2. ESS 2105
3. DS 8000
4. DS 6000
5. RSSM

1.2 How to get help
Go to the following Web site for SDDDSM technical support and for the most
current SDDDSM documentation and support information:
http://www.ibm.com/systems/support/storage/software/sdd/

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 SDDDSM
OSes: Windows Server 2003 with SP2
Windows Server 2008
Windows Sercer 2008 R2

SDD: SDD must be uninstalled prior to install SDDDSM.
MPIO: 1.23.3790.2451 (shipped with SDDDSM) for Windows 2003
Hotfixes: the following hotfixes must be installed prior to install SDDDSM
For W2K3 SP1:
KB909360: this hotfix is required to fix a data corruption problem. For
detail, please go to the following link:
http://support.microsoft.com/kb/909360
For W2K3 RTM, SP1 and SP2
KB941276: A Windows Server 2003-based computer stops responding when the

system is under a heavy load and when the Storport driver is u
sed
KB934739: The Plug and Play subsystem may not detect an external storage
device when it is reconnected in Windows Server 2003
For W2K8:
KB967349 This hotfix is recommedned when access to the storage device f
ails
after disconnect all data cables and then reconnect them. For

detail, please go to the following link:
http://support.microsoft.com/kb/967349
-------------------------------------------------------------------------------

3.0 SDDDSM Change History
===============================================================================
3.1 Defects Fixed
Defects fixed in 2.4.3.x
4851 Sandboot systems sometime crashes when reinstalling SDDDSM
4919 Garbage information get printed in event 17 & 18
4933 HyperV clients lost access when connected thru 2 paths
4940 Fix buffer overrun in tracing code
4973 Potential Crash on Windows 2008 Cluster(PMR 48817 and 18717)
4991 Under high san error loads, the windows sdddsm sql server crashed
(PMR 78254)
Defects fixed in 2.4.2.x
4590 Load Balancing issues
S1012281 SASWWPN shows only one port
238707 Oracle DB crash at secondary power off in PPRC
4726 Unable to restore a path when TargetPdo==NULL due to race conditio
n
4733 Add retry delay for sense 2/4/C not ready errors
4735 Remove Ds4K/5K support from the driver and sdddsm.inf file
4738 Reduce sdddsm trace logging for CSV reservation errors.
Defects fixed in 2.4.1.x
4558 Upgrade MPIO package to 1.22 from 1.21 (2.4.1.1-1)
(http://support.microsoft.com/Default.aspx?id=961640)
4590 Incorrectly configured more than 32 paths
4591 Force retry on the same path after SrbStatus 0e, bus reset
4593 Force additional retry after 3 repeatable errors within the predefi
ned time threshold
4567 Upgrade MPIO package to 1.23 from 1.22 (2.4.1.2-2)
(http://support.microsoft.com/Default.aspx?id=961640)

Defects fixed in 2.4.0.x
96242 Disk Manager hang after resource moved to another cluster
4467 Datapath query devicestats fails with a -d option.
4474 Datapath set last adapter returns a wrong message.
4475 Datapath set last path returns a wrong message.
4447 EventLog indicates that always Path0 to the device came online.
4446 System Crashes when the bootdisk is unmaped from one host wwpn in
2145.
214897 Datapath query wwpn fails intermittently.
4336 Unmounting Virtual Devices in Microsoft virtual Server Fails.
4334 Fix exit message for non-Administrator user installing SDDDSM on
W2K8.
Defects fixed in 2.3.0.x
4327 Datapath query device -d supports all devices
Defects fixed in 2.2.0.x
208338 Disable ports does not take paths offline
4267 X64 Host crashes after receiving a TPC probe.
4239 SDDDSM failed a path during concurrent esm download
Defects fixed in 2.1.1.x
3775 System crash when REPORT TARGET PORT GROUP fails due to lun not ready

===============================================================================
3.2 New Features
Features added in 2.4.3.x
4934 Display DS8800 8 ports FC adapter by 'datapath query portmap'
xxxx Support IBM Storwize V7000
Features added in 2.4.2.x
4657 SASWWPN using saswwpn.bat
Features added in 2.4.1.x
4534 Support Windows Enterprise Business Server(EBS)
4559 Drop support of DS4K and DS5K devices. The user must uninstall the pr
ior version of SDDDSM
before installing the new SDDDDSM to remove the device definition from
the host.

4567 Enhanced trace statement and updrade MPIO package to 1.23.3790.2451


Features added in 2.4.0.x
4326 RSSM support

Features added in 2.2.0.x
4116 Windows 2008 Support
Features added in 2.1.1.x
3810 event log support in SDDDSM
3755,3751 support essutil in SDDDSM
3104,3745 support 'datapath clear count' in SDDDSM
3772,3745 support 'datapath query version' in SDDDSM
3505,3745 Support '-i' and '-d' option in 'datapath query device' to
run datapath repeatedly and by model
3690,3745 support change policy dynamically using 'datapath set policy'
3746 display SCSI address of paths using '-s' in 'datapath query device'

===============================================================================
3.3 Feature/Defect Details and Restrictions
4657 SASWWPN using saswwpn.bat (download sasflash.exe from LSI website)
For the feature to work you will have to download the sasflash utilit
y
from LSI website and replace it in the SDDDSM package. Follow the pro
cedure
mentioned below to do so
a> Visit the following link
http://www.lsi.com/storage_home/products_home/host_bus_adapters/
sas_hbas/internal/sas3081e-r/index.html
b> Select the "Support and Downloads" tab.
c> Scroll down to the "Firmware" table.
d> Click the "Windows Installer" link.
e> Read thru the download agreement, and if you confirm, click "I
accept" link.
f> Save the "sasFlashWinP16.zip" on your computer.
g> Unzip the downloaded package.
h> Get the "sasflash_win_x86_rel\sasflash.exe" and replace it with
the sasflash.exe in SDDDSM package.
i> Install the new package on the server.
Note:
If SDDDSM is already installed on the server, get the sasflash.exe
using the procedure above till step "g"
and then replace the file sasflash.exe in "\Program Files\IBM\SDDDS
M\" with the new one.
4934 "datapath query essmap" and "datapath query portmap" commands are on
ly suppose to be used by IBM PFE.
===============================================================================
3.4 Known Issues
None
================================================================================
=
3.5 Known issues and workaround details
None

-------------------------------------------------------------------------------
4.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.
4.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.
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 Subsystem Device Driver 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.
4.10 Appendix A
This Appendix indicates:
1. Which specific IBM devices the Program and Documentation are to be
used with:
IBM devices: IBM TotalStorage SAN Volume Controller
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.ibm.com/storage/support/2145 for
IBM TotalStorage SAN Volume Controller support
CONTINUING WITH THIS INSTALLATION CONSTITUTES YOUR ACCEPTANCE OF THE
TERMS OF THE ABOVE 'USER LICENSE AGREEMENT FOR IBM DEVICE DRIVERS'
-------------------------------------------------------------------------------
5.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.
===============================================================================
IBM agreement for licensed internal code
+---- Read Before Using -----------------------------------------------+
|IMPORTANT |
| |
|YOU ACCEPT THE TERMS OF THIS IBM LICENSE AGREEMENT FOR MACHINE CODE BY|
|YOUR USE OF THE HARDWARE PRODUCT OR MACHINE CODE. PLEASE READ THE |
|AGREEMENT CONTAINED IN THIS BOOK BEFORE USING THE HARDWARE PRODUCT.SEE|
|IBM agreement for licensed internal code. |
| |
+----------------------------------------------------------------------+
You accept the terms of this Agreement(3) by your initial use of a
machine that contains IBM Licensed Internal Code (called "Code"). These
terms apply to Code used by certain machines IBM or your reseller
specifies (called "Specific Machines"). International Business Machines
Corporation or one of its subsidiaries ("IBM") owns copyrights in Code
or has the right to license Code. IBM or a third party owns all copies
of Code, including all copies made from them.
If you are the rightful possessor of a Specific Machine, IBM grants you
a license to use the Code (or any replacement IBM provides) on, or in
conjunction with, only the Specific Machine for which the Code is
provided. IBM licenses the Code to only one rightful possessor at a
time.
Under each license, IBM authorizes you to do only the following:
1. execute the Code to enable the Specific Machine to function according
to its Official Published Specifications (called "Specifications");
2. make a backup or archival copy of the Code (unless IBM makes one
available for your use), provided you reproduce the copyright notice
and any other legend of ownership on the copy. You may use the copy
only to replace the original, when necessary; and
3. execute and display the Code as necessary to maintain the Specific
Machine.
You agree to acquire any replacement for, or additional copy of, Code
directly from IBM in accordance with IBM's standard policies and
practices. You also agree to use that Code under these terms.
You may transfer possession of the Code to another party only with the
transfer of the Specific Machine. If you do so, you must 1) destroy all
your copies of the Code that were not provided by IBM, 2) either give
the other party all your IBM-provided copies of the Code or destroy
them, and 3) notify the other party of these terms. IBM licenses the
other party when it accepts these terms. These terms apply to all Code
you acquire from any source.
Your license terminates when you no longer rightfully possess the
Specific Machine.
Actions you must not take
You agree to use the Code only as authorized above. You must not do, for
example, any of the following:
1. Otherwise copy, display, transfer, adapt, modify, or distribute the
Code (electronically or otherwise), except as IBM may authorize in
the Specific Machine's Specifications or in writing to you;
2. Reverse assemble, reverse compile, or otherwise translate the Code
unless expressly permitted by applicable law without the possibility
of contractual waiver;
3. Sublicense or assign the license for the Code; or
4. Lease the Code or any copy of it.

-------------------------------------------------------------------------------
6.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
IBM TotalStorage
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.