[mirror/winof/.git] / WinOF / WIX / Release_notes.htm
1 <html>\r
2 \r
3 <head>\r
4 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">\r
5 <meta http-equiv="Content-Language" content="en-us">\r
6 <meta name=Generator content="Microsoft Word 11 (filtered)">\r
7 \r
8 <style>\r
9 <!--\r
10  /* Font Definitions */\r
11  @font-face\r
12         {font-family:Wingdings;\r
13         panose-1:5 0 0 0 0 0 0 0 0 0;}\r
14 @font-face\r
15         {font-family:"MS Mincho";\r
16         panose-1:2 2 6 9 4 2 5 8 3 4;}\r
17 @font-face\r
18         {font-family:"\@MS Mincho";\r
19         panose-1:2 2 6 9 4 2 5 8 3 4;}\r
20  /* Style Definitions */\r
21  p.MsoNormal, li.MsoNormal, div.MsoNormal\r
22         {margin:0in;\r
23         margin-bottom:.0001pt;\r
24         font-size:12.0pt;\r
25         font-family:"Times New Roman";}\r
26 h1\r
27         {margin-right:0in;\r
28         margin-left:0in;\r
29         font-size:24.0pt;\r
30         font-family:"Times New Roman";\r
31         font-weight:bold;}\r
32 h2\r
33         {margin-right:0in;\r
34         margin-left:0in;\r
35         font-size:18.0pt;\r
36         font-family:"Times New Roman";\r
37         font-weight:bold;}\r
38 h3\r
39         {margin-right:0in;\r
40         margin-left:0in;\r
41         font-size:13.5pt;\r
42         font-family:"Times New Roman";\r
43         font-weight:bold;}\r
44 h4\r
45         {margin-right:0in;\r
46         margin-left:0in;\r
47         font-size:12.0pt;\r
48         font-family:"Times New Roman";\r
49         font-weight:bold;}\r
50 a:link, span.MsoHyperlink\r
51         {color:blue;\r
52         text-decoration:underline;}\r
53 a:visited, span.MsoHyperlinkFollowed\r
54         {color:blue;\r
55         text-decoration:underline;}\r
56 p.MsoPlainText, li.MsoPlainText, div.MsoPlainText\r
57         {margin:0in;\r
58         margin-bottom:.0001pt;\r
59         font-size:10.0pt;\r
60         font-family:"Courier New";}\r
61 p\r
62         {margin-right:0in;\r
63         margin-left:0in;\r
64         font-size:12.0pt;\r
65         font-family:"Times New Roman";}\r
66 @page Section1\r
67         {size:8.5in 11.0in;\r
68         margin:1.0in 65.95pt 1.0in 65.95pt;}\r
69 div.Section1\r
70         {page:Section1;}\r
71  /* List Definitions */\r
72  ol\r
73         {margin-bottom:0in;}\r
74 ul\r
75         {margin-bottom:0in;}\r
76 -->\r
77 </style>\r
78 \r
79 <title>WinOF 1.1 Release Notes</title>\r
80 \r
81 </head>\r
82 \r
83 <body lang=EN-US link=#0000FF vlink=#808080>\r
84 \r
85 <div class=Section1>\r
86 \r
87 <h1 align=center style='text-align:left'><img width=107 height=93\r
88 src=openfabrics.gif></h1>\r
89 \r
90 <h1 align=center style='text-align:center'>Windows OpenFabrics </h1>\r
91 \r
92 <h1 align=center style='text-align:center'><a name="1.1_Release_Notes">2.1 Release Notes</a></h1>\r
93 \r
94 <h3 align=center style='text-align:center'>\r
95 <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->02/09/2009<!--webbot bot="Timestamp" endspan i-checksum="12642" --></h3>\r
96 \r
97 <div class=MsoNormal align=center style='text-align:center'>\r
98 \r
99 <hr size=2 width="100%" align=center>\r
100 \r
101 <h3 style="text-align: left"><u><a href="#Overview"><font color="#000000">\r
102 Overview</font></a></u></h3>\r
103 <h3 style="text-align: left"><u>\r
104 <a href="#Supported_Platforms,_Operating_Systems_and_Infiniband_Hardware">\r
105 <font color="#000000">Supported Platforms, Operating Systems and InfiniBand Hardware</font></a></u></h3>\r
106 <h3 style="text-align: left"><a href="#Installation_Specifics">\r
107 <font color="#000000">Installation Notes</font></a></h3>\r
108 <h3 style="text-align: left"><a href="#How_to_Install"><font color="#000000">\r
109 How to Install</font></a></h3>\r
110 \r
111 </div>\r
112 \r
113 <h3><u><a href="#Unattended_Install"><font color="#000000">\r
114 Unattended Install</font></a><font color="#000000"> </font></u></h3>\r
115 <h3><u><font color="#000000"> <a href="#Server_2008_HPC_Install_Notes">\r
116 <font color="#000000">Server 2008 HPC Install Notes</font></a></font></u></h3>\r
117 <h3><a href="#HCA Driver Installation"><font color="#000000">HCA Device Driver \r
118 Installation</font></a></h3>\r
119 <h3><u><a href="#Setting_the_IPoIB_Interface_IP_Address"><font color="#000000">\r
120 Setting the IPoIB Interface IP Address</font></a></u></h3>\r
121 <h3><u><a href="#Uninstall"><font color="#000000">\r
122 Uninstall</font></a></u></h3>\r
123 <h3><u><a href="#Trouble_Shooting"><font color="#000000">\r
124 Trouble Shooting</font></a></u></h3>\r
125 <h3><a href="#OpenIB_Subnet_Management_as_a_Windows_Service">\r
126 <font color="#000000">InfiniBand</font></a><u><a href="#OpenIB_Subnet_Management_as_a_Windows_Service"><font color="#000000"> Subnet Management as a Windows Service</font></a></u></h3>\r
127 <h3><u><a href="#Local_Network_Adapter_Ordering"><font color="#000000">\r
128 Local Network Adapter Ordering</font></a></u></h3>\r
129 <h3><u><a href="#Which_WinOF_release_is_installed"><font color="#000000">\r
130 Which WinOF release is installed</font></a></u><a href="#Which_WinOF_release_is_installed"><font color="#000000">?</font></a></h3>\r
131 <h3><u><a href="#QLogic_VNIC_Configuration"><font color="#000000">\r
132 QLogic VNIC Configuration</font></a></u></h3>\r
133 <h3><u><a href="#DAT_&_uDAPL_Configuration"><font color="#000000">\r
134 DAT &amp; uDAPL Configuration</font></a></u></h3>\r
135 <h3><u><a href="#SRP_-_SCSI_RDMA_Protocol_Driver_Installation">\r
136 <font color="#000000">SRP (SCSI RDMA Protocol) Driver Installation</font></a></u></h3>\r
137 <h3><a href="#WinVerbs"><font color="#000000">W</font></a><u><a href="#WinVerbs"><font color="#000000">inVerbs</font></a></u></h3>\r
138 <h3><u><a href="#Known_Issues"><font color="#000000">\r
139 Known Issues</font></a></u></h3>\r
140 <hr>\r
141 <p>&nbsp;</p>\r
142 \r
143 <h2><u><a name="Overview">Overview</a></u></h2>\r
144 \r
145 <p class=MsoPlainText><span style='font-size:12.0pt;font-family:"Times New Roman"'>The\r
146 Windows OpenFabrics (WinOF) release package is composed of software modules\r
147 intended for use on Microsoft Windows based computer systems connected via an\r
148 InfiniBand fabric.</span></p>\r
149 \r
150 <p class=MsoPlainText><span style='font-size:12.0pt;font-family:"Times New Roman"'>&nbsp;Binary\r
151 files generated from the OpenIB-windows developers subversion (svn) source tree </span>\r
152 'svn://openib.tc.cornell.edu'<span style='font-size:12.0pt;font-family:"Times New Roman"'> \r
153 (branches\WOF2-0 svn revision <font color="#FF0000">1835</font>)\r
154 are packaged into a <a href="http://www.dalun.com/wix/default.htm">WIX 2.0 \r
155 (Windows Installer Xml)</a> single file install package referred to as the \r
156 Windows OpenFabrics&nbsp;(WinOF) release 2.0.1.<br>\r
157 &nbsp;</span></p>\r
158 <p class=MsoPlainText><font size="3"><span style="font-family: Times New Roman">\r
159 This WinOF 2.0.1 is a point release as it contains WHQL fixes \r
160 to numerous components:</span></font></p>\r
161 \r
162 </div>\r
163 <ul>\r
164         <li>\r
165         <p class="MsoPlainText"><font face="Times New Roman" size="3">Windows Server \r
166         2008 and Vista are supported.</font></p></li>\r
167         <li>\r
168         <p class="MsoPlainText"><font face="Times New Roman" size="3">Network Direct \r
169         supported on Server 2008/HPC.</font></p></li>\r
170         <li>\r
171         <p class="MsoPlainText"><font face="Times New Roman" size="3">Mellanox ConnectX(mlx4) drivers \r
172         enhanced for increased performance and stability.</font></p></li>\r
173         <li>\r
174         <p class="MsoPlainText"><font face="Times New Roman" size="3">QLogic has \r
175         enhanced VNIC &amp; SRP for increased performance and stability.</font></p></li>\r
176         <li>\r
177         <p class="MsoPlainText"><font face="Times New Roman" size="3">Bug fixes for stability in IBcore, WSD, VNIC, SRP, IPoIB, DAT/DAPL</font></p>\r
178         </li>\r
179 </ul>\r
180 <div class=Section1>\r
181 \r
182 <p>The Windows OpenFabrics (WinOF) release package contains the following:<br>\r
183 <br>\r
184 OpenFabrics InfiniBand core drivers and Upper Level Protocols (ULPs):</p>\r
185 <ul>\r
186         <li>\r
187         <p style="text-indent: -.25in; margin-left: .5in"><span dir="LTR">HCA \r
188         Drivers - </span>\r
189         <span style='background-position: 0% 0%; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll' dir="LTR">&nbsp;Mellanox \r
190         </span>\r
191         <st1:stockticker>\r
192         <span\r
193  style='background-position: 0% 0%; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll'>\r
194         InfiniHost &amp; ConnectX</span></st1:stockticker><span\r
195 style='background-position: 0% 0%; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll'> low level drivers; See list of\r
196 supported devices below</span></li>\r
197         <li>\r
198         <p style="text-indent: -.25in; margin-left: .5in">\r
199         <span style="background-position: 0% 0%">Infiniband Core components</span></li>\r
200         <li>\r
201         <p style="text-indent: -.25in; margin-left: .5in">Upper Layer Protocols: \r
202         IPoIB, WSD, ND, VNIC, SRP Initiator and DAT/DAPL</li>\r
203 </ul>\r
204 \r
205 <p>OpenFabrics utilities:</p>\r
206 \r
207 <ul>\r
208         <li>\r
209         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>OpenSM: InfiniBand fabric Subnet Manager</span></p>\r
210         </li>\r
211         <li>\r
212         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>Performance \r
213         tests</span></p></li>\r
214         <li>\r
215         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">Diagnostic tools</span></p>\r
216         </li>\r
217 </ul>\r
218 \r
219 <p>Documentation</p>\r
220 \r
221 <ul>\r
222         <li>\r
223         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>User's manual</span></p>\r
224         </li>\r
225         <li>\r
226         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>Release Notes</span></p>\r
227         </li>\r
228 </ul>\r
229 \r
230 <p style="text-indent: -.25in; margin-left: .5in"><a href="#1.1_Release_Notes">\r
231 <font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
232 <p style="text-indent: -.25in; margin-left: .5in">&nbsp;</p>\r
233 <h2><u><a name="Supported_Platforms,_Operating_Systems_and_Infiniband_Hardware">Supported Platforms, Operating Systems and Infiniband Hardware</a></u></h2>\r
234 \r
235 <h4>CPU architectures</h4>\r
236 \r
237 <ul>\r
238         <li>\r
239         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>x64 (x86_64, amd64)</span></p>\r
240         </li>\r
241         <li>\r
242         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>x86</span></p>\r
243         </li>\r
244         <li>\r
245         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>IA64</span></p>\r
246         </li>\r
247 </ul>\r
248 \r
249 <h4>Operating Systems</h4>\r
250 \r
251 <ul>\r
252         <li>\r
253         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">Windows \r
254         Server 2008</span></p>\r
255         </li>\r
256         <li>\r
257         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">Vista</span></p>\r
258         </li>\r
259         <li>\r
260         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>Windows Server 2008 HPC Edition</span></p>\r
261         </li>\r
262         <li>\r
263         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">Windows Server 2003 \r
264         / XP64</span></p>\r
265         </li>\r
266         <li>\r
267         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>Windows XP/32 (SP2)</span></p>\r
268         </li>\r
269 </ul>\r
270 \r
271 <h4><u>Supported HCAs (Host Channel Adapters)</u></h4>\r
272 \r
273 <p>Mellanox</p>\r
274 <ul>\r
275         <li>\r
276         <p style='margin-left:.5in;text-indent:-.25in;mso-list:l13 level1 lfo1;\r
277 tab-stops:list .5in'><![if !supportLists]><font size="3">\r
278         <span style='background-position: 0% 0%; font-style:normal; font-variant:normal; font-weight:normal; font-family:Times New Roman; mso-list:Ignore; mso-bidi-font-size:12.0pt; mso-fareast-font-family:Symbol; mso-bidi-font-family:Symbol; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll'>\r
279         MT23108 - InfiniHost</span></font><![endif]></p></li>\r
280         <li>\r
281         <p style='margin-left:.5in;text-indent:-.25in;mso-list:l13 level1 lfo1;\r
282 tab-stops:list .5in'>\r
283         <span style='background-position: 0% 0%; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll' dir="LTR">MT25218 \96 InfiniHost III Ex, memfree</span></p>\r
284         </li>\r
285         <li>\r
286         <p style='margin-left:.5in;text-indent:-.25in;mso-list:l13 level1 lfo1;\r
287 tab-stops:list .5in'>\r
288         <span style='background-position: 0% 0%; mso-highlight:yellow; background-image:none; background-repeat:repeat; background-attachment:scroll' dir="LTR">MT25204 \96 InfiniHost III Lx</span></p>\r
289         </li>\r
290         <li>\r
291         <p style='margin-left:.5in;text-indent:-.25in;mso-list:l13 level1 lfo1;\r
292 tab-stops:list .5in'><span style="background-position: 0% 0%">MT25408 - </span>\r
293         <span style="background-position: 0% 0%">ConnectX DDR Channel Adapter, not \r
294         yet supported on IA64 platforms.</span></p>\r
295         </li>\r
296 </ul>\r
297 <p>Both SDR and DDR mode of the InfiniHost III family are supported.<br><br>For official Firmware (FW) versions and update tools please see:<br>\r
298 <a href="http://www.mellanox.com/support/firmware_table.php">http://www.mellanox.com/support/firmware_table.php</a><br>\r
299 Current HCA firmware version can be viewed from the 'vstat' command.</p>\r
300 \r
301 <h4><u>Supported Switches</u></h4>\r
302 \r
303 <ul>\r
304         <li>\r
305         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">QLogic</span></p>\r
306         </li>\r
307         <li>\r
308         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>SilverStorm - \r
309         update your firmware for correct embedded Subnet Manager operation.</span></p>\r
310         </li>\r
311         <li>\r
312         <p style='margin-left:.5in;text-indent:-.25in'><span dir="LTR">Voltaire</span></p>\r
313         </li>\r
314         <li>\r
315         <p style='margin-left:.5in;text-indent:-.25in'><span dir=LTR>Flextronics</span></p>\r
316         </li>\r
317         <li>\r
318         <p style='margin-left:.5in;text-indent:-.25in'>Due to lack of hardware \r
319         accessibility, \r
320         other vendor switches have not been tested.</p>\r
321         </li>\r
322 </ul>\r
323 \r
324 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
325 <p>&nbsp;</p>\r
326 <h2><u><a name="Installation_Specifics">Installation </a></u>\r
327 <a name="Installation_Specifics"><u>Notes</u></a></h2>\r
328 \r
329 <p>User mode tools and diagnostics are installed in '%SystemDrive%\Program\r
330 Files (x86)\WinOF'.&nbsp; Although driver modules initially reside in \r
331 '%SystemDrive%\Program Files (x86)\WinOF', when installed the Windows device \r
332 installer copies driver files to %SystemRoot%\system32 &amp; %SystemRoot%\SysWOW64'. \r
333 DAT &amp; DAPL runtime libraries are installed into %SystemRoot% in order to be \r
334 accessible to user mode applications.<br>\r
335 WinOF user mode executables are designed to be run from\r
336 a Command Prompt window; see&nbsp; 'Start-&gt;Program Files-&gt; Windows OpenFabrics-&gt; Command Prompt'.</p>\r
337 <p>'%SystemDrive%\Program Files (x86)\WinOF' is appended to the system wide search \r
338 path; new command windows created after the installation will have the updated \r
339 %PATH% environment variable, hence will be able to access WinOF executables.</p>\r
340 \r
341 <p>The \91default\92 installation installs \91released/free\92 (not\r
342 checked/debug) versions of drivers and executables. Debug/Checked versions are \r
343 available as an install feature.</p>\r
344 \r
345 <p>A single instance of a subnet manager, opensm.exe, must be\r
346 running on a fabric connected node in order for the Infiniband fabric to be\r
347 configured and useful; either Windows or Linux OFED opensm work well.</p>\r
348 <p>It is recommended that OpenSM be run as a Windows service.&nbsp; A typical \r
349 WinOF install will install OpenSM as a Windows service which \r
350 is disabled; after an installation, choose your openSM node and start the openSM \r
351 service.&nbsp; \r
352 See the WinOF Manual for details on opensm as a service.<br>\r
353 By selecting the 'OpenSM_Service_Enabled' install feature, an OpenSM subnet \r
354 management service will be automatically started. </p>\r
355 \r
356 <p>Note, the opensm.exe process must continue to run in order\r
357 to maintain Infiniband fabric configuration. Should the opensm.exe process die,\r
358 restart the service if not automatic or re-run opensm.exe in order to continue\r
359 correct fabric operation.</p>\r
360 \r
361 <p>For more subnet management information, consult the Windows\r
362 OpenFabrics manual.</p>\r
363 \r
364 <p class=MsoNormal><a href="#1.1_Release_Notes"><font color="#000000">\r
365 &lt;Return-to-Top&gt;</font></a></p>\r
366 <p class=MsoNormal>&nbsp;</p>\r
367 \r
368 <h2><u><a name="How_to_Install">How to Install</a></u></h2>\r
369 \r
370 <h3>Requirements</h3>\r
371 \r
372 <p>Install HCA hardware prior to installing the Windows OpenFabrics Release\r
373 package. Upon reboot, cancel any attempts to install new device hardware from \r
374 the &quot;Found New Hardware Wizard&quot;.</p>\r
375 \r
376 <p>If you have previously installed openib-windows, WinOF (Windows OpenFabrics)\r
377 packages or vendor supplied Infiniband packages, uninstall and reboot prior to\r
378 installing this version of Windows OpenFabrics (WinOF).</p>\r
379 \r
380 <p>For an existing Windows OpenFabrics (WinOF) uninstall<br>\r
381 &nbsp;&nbsp;&nbsp; Start-&gt; Programs-&gt; Windows OpenFabrics-&gt; Uninstall WinOF<br>\r
382 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -or-<br>\r
383 &nbsp;&nbsp;&nbsp; Control Panel -&gt; Add or Remove Programs-&gt; Windows\r
384 OpenFabrics-&gt;Remove.</p>\r
385 <p>openib-windows (IB stack before WinOF 1.0 release) uninstall: (not the normal \r
386 uninstall case)</p>\r
387 \r
388 <ol start=1 type=1>\r
389         <li class=MsoNormal>Disable any Local Area Connections which are bound to the\r
390      IPoIB network adapter.</li>\r
391  <li class=MsoNormal>Uninstall the IPoIB driver - My\r
392      computer-&gt;Manage-&gt;Devices-&gt;Network Adapters-&gt;IPoIB*</li>\r
393         <li class=MsoNormal>Stop the openSM subnet manager if it is running on the \r
394         local node.</li>\r
395  <li class=MsoNormal>Uninstall the Infiniband HCA device; don't forget the \r
396         System Device-&gt; InfiniBand Fabric</li>\r
397 </ol>\r
398 \r
399 <p>&nbsp;</p>\r
400 \r
401 <p><b>REBOOT</b></p>\r
402 \r
403 <p>Upon system restart, cancel the 'Found New Hardware Wizard' attempts to install \r
404 drivers for newly discovered PCI device (HCA).</p>\r
405 <p>'My Computer-&gt;Manage-&gt;Device Manager' should display\r
406 'Other Devices-&gt;?PCI device' which is your Infiniband HCA device.</p>\r
407 \r
408 <h3><u>Install</u></h3>\r
409 \r
410 <blockquote style='margin-top:5.0pt;margin-bottom:5.0pt'>\r
411 \r
412 <p>Vista installation <b>only</b>; open a privileged Administrator command \r
413 window and say</p>\r
414 <p>&nbsp;&nbsp;&nbsp; start/wait msiexec /I WinOF_wlh_xxx.msi</p>\r
415 <p>For all other Windows variants, double-clicking the installer file (.msi) \r
416 works correctly to start a WinOF installation.<br>\r
417 From a login session with administrator privileges, double-click the WinOF_M-m{-p}_OSE_arch.msi file to begin the Windows OpenFabrics \r
418 installation.</p>\r
419 <p>Where 'M-n{-p}' indicates Major release number, Minor release number, and \r
420 optional point-release number.</p>\r
421 <p>&nbsp;OSE - Operating System Environment:</p>\r
422 <ul>\r
423         <li>wlh - (Windows LongHorn) Windows Server 2008, HPC or Vista</li>\r
424         <li>wnet - Windows Server 2003 or Windows XP 64-bit version</li>\r
425         <li>wxp - Windows XP x86/32-bit version</li>\r
426 </ul>\r
427 <p>'_arch_' will be one of</p>\r
428 <ul>\r
429         <li>_x64_ for&nbsp; Intel EMT64 systems or amd64; see\r
430         <a href="http://en.wikipedia.org/wiki/X86-64">x86-64</a></li>\r
431         <li>_x86_ for x86\r
432 compatible systems</li>\r
433         <li>_ia64_ for Intel IA64 systems. </li>\r
434 </ul>\r
435 \r
436 <p>Follow the on-screen instructions.<br>\r
437 <br>\r
438 Answer 'yes' or 'Continue' to any notifier windows which reference non-WHQL'ed \r
439 driver installation.<br>\r
440 These non-WHQL'ed driver install questions can <b>not</b> be disabled \r
441 via 'My Computer-&gt;Properties-&gt;Hardware-&gt;Driver Signing-&gt;Ignore'.</p>\r
442 <p>Bottom-line - The digitally signed WinOF drivers in this package are not WHQL'ed \r
443 per se, although they are \r
444 built from driver source which has been or is in process of being WHQL'ed by \r
445 hardware vendors who participate in the open source WinOF development process.</p>\r
446 <p>&nbsp;</p>\r
447 <p>&nbsp;<font size="4">**** WARNING ****</font></p>\r
448 <blockquote>\r
449         <p>Should any 'Welcome to the Found New Hardware Wizard' windows popup after the \r
450         WinOF install has started, just ignore (window will disappear in a few \r
451         seconds) or 'Cancel' the errant popup window.&nbsp; \r
452         For Windows Server 2003 (SP1) you can safely ignore the errant FNHW popup \r
453         window; for Windows XP (SP2) the errant FNHW popups need to be 'cancelled' \r
454         in order for the WinOF install to proceed. The report back from Microsoft on these 'Found New Hardware Wizard' windows \r
455         popping up, is they are due to the fact the WinOF drivers are not WHQL'ed \r
456         and hence are not trusted by Windows; MS claims this is a 'feature'.</p>\r
457         <p>An artifact of cancelling an errant 'Found New Hardware' popup window may \r
458         induce an errant taskbar Information notifier/bubble indicating there may \r
459         have been problems installing your hardware drivers;\r
460         IGNORE/cancel this information bubble, likely the device installation \r
461         proceeded without error. Check the Device Manager views for the \r
462         Infiniband HCA and IPoIB Network Adapters for initial verification of \r
463         correct installation.</p>\r
464         <p>You <b>do</b> need to answer 'Yes' or 'Continue' to those notifier windows which \r
465         reference non-WHQL driver installation. If you have previously \r
466         set My Computer-&gt;Properties-&gt;Hardware-&gt;Driver Signing-&gt;Ignore, the FNHW \r
467         windows likely will occur anyway.</p>\r
468         <p>Should the install appear to hang, look around for occluded notifier windows \r
469         waiting for a response which \r
470         are covered by existing windows.<br>\r
471 &nbsp;</p>\r
472 </blockquote>\r
473 \r
474 <h4>Install type: Custom only</h4>\r
475 \r
476 <ul type=disc>\r
477  <li class=MsoNormal>InfiniBand Core:<ul type=disc>\r
478         <li>HCA driver - Mellanox: InfiniHost or ConnectX</li>\r
479         <li>IB core stack and libraries.</li>\r
480         <li>Release Notes, Manual</li>\r
481         <li>Subnet Management service [OpenSM] (installed &amp; disabled), Performance &amp; Diagnostic tools</li>\r
482         </ul></li>\r
483         <li>Optional:<br>&nbsp;&nbsp;&nbsp; IPoIB - Internet Protocols over \r
484         InfiniBand<br>&nbsp;&nbsp;&nbsp; Winsock Direct (Win2008/3 only)<br>\r
485 &nbsp;&nbsp;&nbsp; Network Direct (MS supported only for Server 2008 HPC).<br>&nbsp;&nbsp;&nbsp; VNIC - Virtual Ethernet device over Infiniband<br>&nbsp;&nbsp;&nbsp; SRP - SCSI over RDMA Protocol<br>&nbsp;&nbsp;&nbsp; \r
486         DAT/DAPL \r
487         - RDMA device independent, user-mode Direct Access Transport &amp; Direct Access \r
488         Provider<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - DAT v1.1&nbsp; runtime libraries.<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - DAT v1.1 application build environment \r
489         (header files &amp; link files).<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - DAT/DAPL v2.0 runtime libraries<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - DAT v2.0 application build environment<br>&nbsp;&nbsp;&nbsp; OpenSM_service_started - InfiniBand Subnet Management \r
490         enabled and started as a Windows Service.<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
491         By default OpenSM is installed as a disabled Windows Service.<br>\r
492 &nbsp;&nbsp;&nbsp; WinVerbs - OFED verbs API for Windows.<br>\r
493 &nbsp;&nbsp;&nbsp; Checked versions of driver files.<br>\r
494 &nbsp;</li>\r
495         <li>The '<b>default</b>' installation includes IB core, IPoIB, WSD (Win2K3 only), \r
496         DAT 1.1 runtime libraries, OpenSM service (disabled).</li>\r
497 </ul>\r
498 \r
499 </blockquote>\r
500 \r
501 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
502 <p>&nbsp;</p>\r
503 <h3><u><a name="Unattended_Install">Unattended Install</a></u></h3>\r
504 \r
505 <div id="main-copy">\r
506         <p>To perform a silent/unattended installation for Server 2003/XP, invoke \r
507         the following command from a command window; Server 2008/HPC see notes \r
508         below.</p>\r
509         <blockquote>\r
510                 <p>start/wait msiexec.exe /i WinOF_2-0_wlh_x64.msi /qn /quiet /log \r
511                 %TEMP%\WOF_install.log</p>\r
512                 <p>'/log dev:path\logFilename.log' is optional.</p>\r
513                 <p>msiexec.exe /? for all options.</p>\r
514         </blockquote>\r
515         <p>An unattended install will install the following 'default' install options:</p>\r
516         <ul>\r
517                 <li>Infiniband Core modules - HCA driver, IB core stack and libraries, \r
518                 Documentation</li>\r
519                 <li>IPoIB - Internet Protocols over InfiniBand</li>\r
520                 <li>WSD - (Win2K8/3 only, not installed on XP) Win Sock Direct</li>\r
521                 <li>ND - Network Direct, started automatically (via ndinstall.exe) only for Server \r
522                 2008/HPC and Vista.</li>\r
523                 <li>DAT &amp; DAPL (v1.1 &amp; v2.0) runtime libraries + dapltest.exe \r
524                 (dt-svr &amp; dt-cli).</li>\r
525         </ul>\r
526 </div>\r
527 <p>Should WSD not be a desirable unattended install option (Win2008/3 only), \r
528 currently you would install unattended then execute the<br>\r
529 command 'installsp -r' \r
530 on each node to remove WSD.</p>\r
531 <p>&nbsp;</p>\r
532 <h3><u><a name="HCA Driver Installation">HCA Driver Installation</a></u></h3>\r
533 <p>WinOF Server 2008 / Vista device driver installation operates somewhat \r
534 differently than Server 2003/XP device driver installation.<br>\r
535 Server 2008 uses the device driver installation program dpinst.exe plus the \r
536 Windows driver store, where Server 2003 uses the older devman/devcon device \r
537 driver installation technology.<br>\r
538 The main difference for Server 2008 is the Microsoft Plug-n-Play (PNP) subsystem \r
539 controls which Infiniband HCA (Host Channel Adapter) device driver is loaded \r
540 from the Windows Driver Store. HCA driver selection based on PNP system device \r
541 configuration probing, thus InfiniHost, ConnectX or both drivers can be loaded \r
542 by the PNP subsystem.<br>\r
543 Using PNP probing results in the Server 2008/Vista WinOF installation not \r
544 requiring a specific HCA model [ConnectX or InfiniHost] selection.<br>\r
545 Where Server 2003/XP installs require the selection of a specific HCA model.</p>\r
546 <p>The default Server 2003/XP HCA device type defaults to Mellanox InfiniHost \r
547 HCA hardware. When installing WinOF you have two choices on how to override the \r
548 default HCA device type (case of ConnectX HCA hardware):</p>\r
549 <ol>\r
550         <li>Use the WinOF installer GUI to change the default HCA device driver \r
551         feature selection from InfiniHost to ConnectX.</li>\r
552         <li>From a command line: start/wait msiexec /I WinOF_os_arch.msi /qb /quiet \r
553         HCA=cx<br>\r
554         The 'HCA=cx' argument forces the default HCA device type to be Mellanox \r
555         ConnectX (mlx4_*).<br>\r
556         'HCA=+cx' argument adds the Mellanox ConnectX HCA type to the list of \r
557         default HCA types - installs drivers for ConnectX and InfiniHost.</li>\r
558 </ol>\r
559 <h3><u><a name="Server_2008_HPC_Install_Notes">Server 2008 HPC Install Notes</a></u></h3>\r
560 <p>Device drivers in WinOF 2.0 and later releases, are Digitally \r
561 signed although they are not WHQL'ed (Windows Quality Hardware Labs) certified. The lack \r
562 of WHQL certification impacts unattended installs by requiring the user to \r
563 'accept' \r
564 installation of the non-WHQL'ed driver the first time a compute node is \r
565 installing WinOF drivers via the WinOF .msi installer.&nbsp; Additionally the non-WHQL \r
566 driver notifier box has a \r
567 checkbox which allows establishing a trust for software from the publisher \r
568 'OpenFabrics Alliance'. Checking this box allows future WinOF driver installs to proceed \r
569 without user intervention as you have indicated to Windows that you trust non-WHQL \r
570 drivers from the Openfabrics Alliance software publisher.</p>\r
571 <p>***** Warning *****<br>\r
572 WinOF .msi installs on compute nodes the first time require human input to 'accept' \r
573 installation of non-WHQL'ed drivers along with establishing a trust for the SW \r
574 publisher 'OpenFabrics Alliance'.<br>\r
575 If one attempts an unattended WinOF .msi install using 'clusrun.bat msiexec /i \r
576 WinOF.....msi /quiet', the install will \r
577 silently hang waiting for user input.<br>\r
578 First time unattended WinOF .msi installs need mouse input to complete.&nbsp; \r
579 Once the SW publisher trust has been established, future unattended WinOF .msi \r
580 installs procees without human input.</p>\r
581 <p>Be aware: if a node is reimaged (same or different template applied) the \r
582 established trust of OpenFabric Alliance is destroyed, thus the non-WHQL driver \r
583 notifier box and ensuing human input is again required on the first WinOF .msi \r
584 install</p>\r
585 <h4><u>Windows Deployment Manager usage for HPC compute node provisioning</u></h4>\r
586 <p>Microsoft has chosen the WDM to provision HPC \r
587 cluster compute nodes. WinOF 2.0 supports an administrative install mode which \r
588 is a method to extract the WinOF&nbsp; files without actually installing them, \r
589 thus making WinOF driver files accessible for WDM provisioning.</p>\r
590 <p>msiexec /a WinOF_2-0_wlh_x64.msi TARGETDIR=dev:\path-to-extracted-files</p>\r
591 <p>example:&nbsp; msiexec /a WinOF_2-0_wlh_x64.msi TARGETDIR=C:\windows\Temp\WOF&nbsp;&nbsp;&nbsp; \r
592 (note: TARGETDIR is case sensitive)</p>\r
593 <p>The above command creates the following folder structure:<br>\r
594 <a href="file:///C:/windows/Temp/WOF/PFiles/WinOF/">C:\windows\Temp\WOF\PFiles\WinOF\</a><br>&nbsp;&nbsp;&nbsp; IBcore\mthca.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
595 Mellanox InfiniHost HCA driver<br>&nbsp;&nbsp;&nbsp; IBcore\mlx4_bus.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
596 Mellanox ConnectX bus driver<br>&nbsp;&nbsp;&nbsp; IBcore\mlx4_hca.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
597 Mellanox ConnectX HCA driver (both ConnectX drivers required).<br>&nbsp;&nbsp;&nbsp; net\netipoib.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
598 IPoIB + Network Direct IB provider + WSD (Winsock Direct) provider.<br>\r
599 &nbsp;&nbsp;&nbsp; srp\ibsrp.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
600 SCSI over IB.<br>\r
601 &nbsp;&nbsp;&nbsp; vnic\qlgcvnic.inf&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
602 QLogic VNIC (Virtual Ethernet controller over InfiniBand)</p>\r
603 <h4><u>WinOF device driver-less installs:</u></h4>\r
604 <p>Normally WinOF device driver files are installed by processing the driver '.inf' \r
605 files. To install the WinOF package by selecting install features without \r
606 installing any device drivers [HCA, IPoIB, ND, WSD, SRP or VNIC] (assumded \r
607 reliance on WDM to install drivers) can be accomplished with the following \r
608 command:</p>\r
609 <p>start/wait msiexec /i WinOF_2-0-1_wlh_x64.msi NODRV=1</p>\r
610 <p>To skip driver installation in an unattended install say</p>\r
611 <p>start/wait msiexec /i WinOF_2-0-1_wlh_x64.msi /qn /quiet NODRV=1</p>\r
612 <p>See <a href="http://unattended.sourceforge.net/installers.php">Unattended \r
613 Installations</a> for further references.</p>\r
614 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
615 <p>&nbsp;</p>\r
616 <h3><a name="Setting_the_IPoIB_Interface_IP_Address">Setting the IPoIB Interface IP Address</a></h3>\r
617 <p>The Windows command 'netsh' will assist in assigning an IP address to an \r
618 IPoIB interface.<br>\r
619 By default, an IPoIB interface is configured to use DHCP. The following \r
620 discussion deals with setting a static IP address on an IPoIB interface.<br>\r
621 If your system has two Ethernet ports, then IPoIB interfaces (HCA port 1, 2...) \r
622 will be assigned to 'Local Area Connection 3' and 'Local Area Connection 4'.&nbsp; \r
623 If you system has a single Ethernet port, then IPoIB interface is Local Area \r
624 Connection 2'.</p>\r
625 <p>For Server 2008/HPC systems, the WinOF installation follows the above \r
626 discussion. In defining HPC network interfaces, the IPoIB network can be \r
627 identified as the 'Application' network. In this case, a few minutes after a \r
628 compute node is installed, the local network manager will rename the installed \r
629 IPoIB 'Local Area Connection X' network interface to the 'Application' network.</p>\r
630 <p>Display all network interface configuration information<br>\r
631 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; netsh interface ip show config<br>\r
632 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; netsh interface ip show address \r
633 &quot;Local Area Connection 3&quot;</p>\r
634 <p>Config a static IP address for an IPoIB interface: [Local Area Connection 3 \r
635 == 1st IPoIB interface], is the assigned IP address<br>\r
636 with a netmask of, the gateway is metric is 2.</p>\r
637 <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; netsh interface ip set address \r
638 &quot;Local Area Connection 3&quot; static 2</p>\r
639 <p>See <a href="http://support.microsoft.com/kb/257748">netsh</a> for further \r
640 reference.</p>\r
641 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
642 <p>&nbsp;</p>\r
643 <h2><u><a name="Uninstall">Uninstall</a></u></h2>\r
644 \r
645 <p>To uninstall a WinOF package from a single node</p>\r
646 <ol>\r
647         <li>Programs-&gt; Windows OpenFabrics-&gt; Uninstall WinOF</li>\r
648         <li>Control Panel-&gt; Add Remove Programs-&gt; Windows OpenFabrics-&gt; Remove</li>\r
649 </ol>\r
650 <h3><span style="font-weight: 400; text-decoration: underline">Unattended \r
651 Uninstall</span></h3>\r
652 <p>From a Command Window invoke the following command; a system reboot will \r
653 occur after the uninstall.</p>\r
654 <blockquote>\r
655         <p>start/wait msiexec.exe&nbsp; /x {3A6A276E-A636-48E8-8624-9A0DE3F2A15E} \r
656         /quiet \r
657         /forcerestart<br>\r
658 &nbsp; - or -<br>\r
659         start/wait msiexec.exe&nbsp; /x WinOF_wlh_2-0_x64.msi /quiet /forcerestart&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
660         # WinOF_xxxx.msi is the file used to install WinOF.</p>\r
661         <p>msiexec.exe /help for details.</p>\r
662         <p>'/log dev:path\logfilename.log'&nbsp; if you wish to later view the install \r
663         results.</p>\r
664         <p>If for some reason the Product Code {GUID} changes, the latest code can \r
665         be located via<br>Programs-&gt; Windows OpenFabrics-&gt; Uninstall WinOF&lt;right-click&gt;Properties</p>\r
666 </blockquote>\r
667 <p>Infrequently, the 'System Device-&gt;Infiniband Fabric' may not correctly uninstall. Make sure the Infiniband Fabric device is \r
668                 completely uninstalled; use device manager for checking. The effect of a \r
669                 partially uninstalled Infiniband Fabric device is IPoIB load failure \r
670                 upon the next WinOF install.</p>\r
671 <h3><span style="text-decoration: underline">Uninstall Notes</span></h3>\r
672 <ol>\r
673         <li>If the SRP (SCSI RDMA Protocol) driver has been previously installed, \r
674         then in order to achieve a 'clean' uninstall, the SRP target drive(s) must \r
675         be released.<br>\r
676 &nbsp;<ul>\r
677                 <li>Use the following diskpart.exe commands from an administrator \r
678                 privileged command window:</li>\r
679                 <li><a href="file:///c:/windows/temp">c:\windows\temp</a>&gt; diskpart.exe<br>\r
680 &nbsp;&nbsp;&nbsp; SELECT VOLUME=&lt;Drive Letter of the SRP target to be released&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
681                 # example: SELECT VOLUME=L<br>\r
682 &nbsp;&nbsp;&nbsp; OFFLINE DISK<br>\r
683 &nbsp;&nbsp;&nbsp; EXIT</li>\r
684                 <li>For additional SRP drives, repeat SELECT &amp; OFFLINE DISK with new \r
685                 Drive Letter.</li>\r
686         </ul>\r
687         <p>The consequences of not releasing the SRP target drive(s) is that after the \r
688         uninstall reboot there are lingering InfiniBand driver files. These driver \r
689         files remain because while the SRP target is active they have references, \r
690         thus when the uninstall attempts to delete the files the operation fails.</p>\r
691         </li>\r
692 </ol>\r
693 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
694 <p>&nbsp;</p>\r
695 \r
696 <h2><u><a name="Trouble_Shooting">Trouble Shooting</a></u></h2>\r
697 <p>A Vista WinOF installation can fail due to protection failures when \r
698 installing the HCA driver. Vista HCA driver installation failure can be caused \r
699 by&nbsp; double-clicking the .msi installer \r
700 file to start the installation.<br>\r
701 WinOF installs for Vista (only) require the installation be started&nbsp; from a \r
702 privileged Administrator command window.<br>Start a privileged Administrator command window (Start-&gt;Command \r
703 Prompt-&gt;Right-click-&gt;Run as Administrator) and execute:<br>\r
704 &nbsp;&nbsp;&nbsp; msiexec /I \r
705 WinOF_xxx_yyy.msi</p>\r
706 <p>To create a LOG file of your WinOF installation, execute this command: \r
707 msiexec /I WinOF_xxx_yyy.msi&nbsp; /Lv %TEMP%\WOF-install.log<br>\r
708 View %TEMP%\WOF-install.log</p>\r
709 <p>msiexec /? for details.</p>\r
710 <p>Server 2008 or Vista can also fail to install due to driver install files \r
711 left over from previously failed install attempts; see %windir%\system32\DriverStore\{Temp|FileRepository}. \r
712 Look for folders with the following in the folder name: mthca, mlx4_, netipoib, \r
713 srp, vnic. Once you have located one of these folders you need to remove it as \r
714 win2k8/Vista will use these files instead of what your attempting to install.; \r
715 removing the folders is a pain.<br>\r
716 Right-click the folder and select Properties-&gt;Security-&gt;Advanced, select owner \r
717 tab, select Edit button, select Administrator and check the 'Replace owner on \r
718 subcontainers and objects', now click 'OK', OK again, select Edit button from \r
719 the securities tab, check allow 'Full Control' box and click OK, OK again. At \r
720 this point you should be back to the file explorer. Now you can delete the \r
721 folder!</p>\r
722 <p>Setupapi.log has moved in Server 2008/Vista, see '%windir%\inf\setupapi-dev.log'. \r
723 Setupapi-*.log can at times contain useful install debug info.</p>\r
724 <p>Server 2008/Vista/HPC all use dpinst.exe to preinstall drivers into the \r
725 driver store. Windows PNP (Plug-n-Play) later will deamand drivers when the \r
726 hardware is recognized. dpinst.exe writes it's error information to '%windir%\dpinst.log'.</p>\r
727 <p>Down rev firmware will result in IPoIB not installing or other anonmolus \r
728 behavior. Consult the event \r
729 viewer, system error records, look for 'mthca' or 'mlx4*' entries generated when the HCA \r
730 driver loads. One of the mthca or mlx4 entries will display the current firmware \r
731 revision.</p>\r
732 <p>Firmware version information and updates \r
733                 are available at\r
734 <a href="http://www.mellanox.com/support/firmware_download.php">\r
735                 www.mellanox.com/support/firmware_download.php</a></p><p:colorscheme\r
736  colors="#ffffff,#000000,#808080,#000000,#ffc86c,#acc5ff,#fff4b4,#c4f48a"/>\r
737 \r
738 <div v:shape="_x0000_s1026" style="tab-stops:.6215in">\r
739         <div class="O" style="mso-line-spacing:&quot;80 20 0&quot;;mso-margin-left-alt:145;\r
740 mso-char-wrap:1;mso-kinsoku-overflow:1">\r
741                 <span style="font-family:&quot;Arial Narrow&quot;;\r
742 font-size:106%;color:#F2862F">\r
743                 <span style="mso-special-format:bullet;\r
744 position:absolute;left:-3.41%">\95</span></span><span style="font-family:&quot;Arial Narrow&quot;;\r
745 font-size:19pt;color:#F2862F"><b> </b></span></div>\r
746         <blockquote>\r
747                 <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
748 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
749                         <span style="font-family:&quot;Arial Narrow&quot;;font-size:94%;color:#241172">\r
750                         <span style="mso-special-format:bullet;position:absolute;left:-4.4%">\96</span></span></div>\r
751         </blockquote>\r
752         <div class="O" style="mso-line-spacing:&quot;80 20 0&quot;;mso-margin-left-alt:145;\r
753 mso-char-wrap:1;mso-kinsoku-overflow:1">\r
754                 <span style="font-family:&quot;Arial Narrow&quot;;\r
755 font-size:106%;color:#F2862F">\r
756                 <span style="mso-special-format:bullet;\r
757 position:absolute;left:-3.41%">\95</span></span><b><span style="font-family: Arial Narrow; ">If \r
758                 HCA FW is older than minimal FW</span><span style="font-family: Arial Narrow; color: #F2862F"> </span> </b></div>\r
759         <blockquote>\r
760                 <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
761 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
762                         <span style="font-family: Arial Narrow; color: #241172"><b>Error \r
763                         reported to system event log </b></span></div>\r
764                 <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
765 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
766                         <span style="font-family: Arial Narrow; color: #241172">\r
767                         <span style="mso-special-format:bullet;position:absolute;left:-4.4%">\r
768                         \96</span><b>HCA loads as memory controller to allow FW upgrade </b>\r
769                         </span></div>\r
770         </blockquote>\r
771         <div class="O" style="mso-line-spacing:&quot;80 20 0&quot;;mso-margin-left-alt:145;\r
772 mso-char-wrap:1;mso-kinsoku-overflow:1">\r
773                 <span style="font-family: Arial Narrow; color: #F2862F">\r
774                 <span style="mso-special-format:bullet;\r
775 position:absolute;left:-3.41%">\95</span></span><b><span style="font-family: Arial Narrow; ">If HCA<span style="mso-spacerun:yes">&nbsp;\r
776                 </span>FW is equal or newer than optimal version</span><span style="font-family: Arial Narrow; color: #F2862F"><br>\r
777 &nbsp;</span></b></div>\r
778         <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
779 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
780                 <blockquote>\r
781                         <span style="font-family: Arial Narrow; color: #241172">\r
782                         <span style="mso-special-format:bullet;position:absolute;left:-4.4%">\r
783                         \96</span><b>HCA starts OK. </b></span>\r
784                 </blockquote>\r
785         </div>\r
786         <div class="O" style="mso-line-spacing:&quot;80 20 0&quot;;mso-margin-left-alt:145;\r
787 mso-char-wrap:1;mso-kinsoku-overflow:1">\r
788                 <span style="font-family: Arial Narrow; color: #F2862F">\r
789                 <span style="mso-special-format:bullet;\r
790 position:absolute;left:-3.41%">\95</span></span><b><span style="font-family: Arial Narrow; ">Else</span></b></div>\r
791         <blockquote>\r
792                 <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
793 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
794                         <span style="font-family: Arial Narrow; color: #241172">\r
795                         <b>HCA loads OK. </b></span></div>\r
796                 <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
797 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
798                         <span style="font-family: Arial Narrow; color: #241172">\r
799                         <span style="mso-special-format:bullet;position:absolute;left:-4.4%">\r
800                         \96</span><b>Warning will be issued to system event log </b></span>\r
801                 </div>\r
802         </blockquote>\r
803         <div class="O1" style="mso-line-spacing:&quot;80 0 0&quot;;mso-margin-left-alt:395;\r
804 mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">\r
805                 <![if ppt]>\r
806                 <span style="font-family:&quot;Arial Narrow&quot;;font-size:94%;color:#241172;visibility:hidden">\r
807                 <span style="mso-special-format:bullet;position:absolute;left:-4.4%">\96</span></span><![endif]><span style="font-family:&quot;Arial Narrow&quot;;font-size:17pt;color:#241172"><b>\r
808                 </b></span></div>\r
809         <div class="O" style="mso-line-spacing:&quot;80 50 0&quot;;mso-margin-left-alt:145">\r
810                 My computer-&gt; Manage-&gt; Event Viewer-&gt; System Events; search for \r
811                 mthca, mlx4 or ipoib entries.<p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
812                 <h3>&nbsp;</h3>\r
813                 <h3><u>Incomplete Previous Uninstall</u></h3>\r
814                 <p>Should the previous uninstall silently fail, the next installation \r
815                 can fail in the Driver Install phase with the following error:<br>\r
816 &nbsp;&nbsp;&nbsp; DriverInstall - HCA Ret 2 Error 0<br>\r
817                 <br>\r
818                 At this juncture, check the Device Manager and uninstall the PCI \r
819                 device from 'InfiniBand Host Channel Adapters', and make sure you uninstall the system device\r
820                 'InfiniBand Fabric' if it is present.<br>\r
821                 <br>\r
822                 <u><b>REBOOT</b></u> and retry the WinOF installation again.<p>See \r
823                 ibscan.bat and ibcleanup.bat @\r
824                 <a href="http://www.openfabrics.org/downloads/WinOF/etc/">\r
825                 http://www.openfabrics.org/downloads/WinOF/etc/</a>.<br>\r
826                 ibscan will display WinOF files on your system.<br>\r
827                 ibcleanup will attempt to remove all WinOF files from your syste. \r
828                 WARNING - ibcleanup is not valid as a WinOF uninstall tool!<p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a><p>&nbsp;</div>\r
829 </div>\r
830 <h3><u><a name="Correct_Installation_Validation">Correct Installation Validation</a></u></h3>\r
831 <p>From the Device Manager you should find the following devices:</p>\r
832 <ul>\r
833         <li>InfiniBand Host Channel Adapters -&gt; InfiniHost or Mellanox ConnectX</li>\r
834         <li>The System Devices -&gt; InfiniBand Fabric device is no longer present in \r
835         WinOF 2.0 and following releases.</li>\r
836         <li>Network Adapters -&gt; OpenIB IPoIB Adapter (an Instance per HCA port).</li>\r
837 </ul>\r
838 <blockquote>\r
839         <h4>Validation Test</h4>\r
840         <p>Open a WinOF command window</p>\r
841         <ol>\r
842                 <li>Start-&gt;Program Files-&gt;Windows OpenFabrics -&gt; Command \r
843 Window</li>\r
844                 <li>run vstat.exe to view HCA configuration.</li>\r
845                 <li>If IPoIB is installed (Device Manager-&gt;Network Adapters), ping another node on the InfiniBand fabric 'ping a.b.c.d'<br>\r
846 &nbsp;</li>\r
847         </ol>\r
848 </blockquote>\r
849 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
850 <p>&nbsp;</p>\r
851 <h2><u><a name="OpenIB_Subnet_Management_as_a_Windows_Service">Subnet Management as a Windows Service</a></u></h2>\r
852 <p>Limit the number of Subnet Managers on your fabric; one SM per fabric is \r
853 sufficient, although redundant Subnet Managers are supported.</p>\r
854 <ol>\r
855         <li>After a 'typical' WinOF install, OpenSM is installed as a <b>disabled</b> \r
856         Windows service named &quot;InfiniBand Subnet Management&quot;. To start the OpenSM \r
857         service, use My computer-&gt;Manage-&gt;Services and Applications-&gt;Services-&gt;InfiniBand Subnet Manager-&gt;Start.<br>\r
858         Set the service properties to 'auto' in order to restart upon the next \r
859         system reboot.<br>\r
860 &nbsp;</li>\r
861         <li>Install OpenSM as an automatic/running Windows service:<br>\r
862         a) Request a 'Custom' install, selecting the 'OpenSM_service_enabled' feature. Once \r
863         the install has completed, check that the Infiniband Subnet Manager service is \r
864         running: My computer-&gt;Manage-&gt;Services and Applications-&gt;Services-&gt;InfiniBand Subnet \r
865         Manager.<br>\r
866 &nbsp;</li>\r
867         <li>Consult the OpenSM log file @ %SystemRoot%\temp\osm.log to see what \r
868         OpenSM thinks is happening.</li>\r
869 </ol>\r
870 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
871 <p>&nbsp;</p>\r
872 <h2><u><a name="Local_Network_Adapter_Ordering">Local Network Adapter Ordering</a></u></h2>\r
873 <p>Local Network Adapter ordering, which results in the IP address advertised \r
874 for the system, can be managed from<br>&nbsp;&nbsp;&nbsp; 'My Network Places-&gt; Advanced Tab-&gt; Advanced settings'<br>From the Advanced settings display, the ordering \r
875 of Local Network Adapters can be \r
876 reordered after the IPoIB Local Network Adapters have been installed. Please \r
877 check for your desired adapter ordering.<br><br>\r
878 <font color="#000000"><a href="#1.1_Release_Notes"><font color="#000000">\r
879 &lt;Return-to-Top&gt;</font></a></font></p>\r
880 <p>&nbsp;</p>\r
881 <h2><u><a name="Which_WinOF_release_is_installed">Which WinOF release is installed</a></u><a name="Which_WinOF_release_is_installed">?</a></h2>\r
882 <ol>\r
883         <li>Add/Remove Programs entry identifies the WinOF release version.</li>\r
884         <li>Start-&gt;Programs-&gt;Windows OpenFabrics-&gt;Release Notes&nbsp; \r
885 (2nd Line)</li>\r
886         <li>Driver confirmation:<br>&nbsp;&nbsp;&nbsp; Query My Computer-&gt; Manage-&gt; Device Manager-&gt; Network \r
887 Adapters-&gt; OpenFabrics IPoIB Adapter-&gt; Properties-&gt; Driver-&gt; Details<br>&nbsp;&nbsp;&nbsp; The subversion (svn) revision number will be listed under \r
888 'Driver Version'. The svn revision number will match what's listed in the \r
889 release notes.</li>\r
890         <li>Hold the mouse point over \Program Files(x86)\WinOF\ib_read_bw.exe to display \r
891 the file version; [WinOF-Major.Minor.not-used.svn revision number].</li>\r
892 </ol>\r
893 <ul>\r
894         <li>WinOF 1.0 is based on openib-windows <b><u>svn revision 614</u></b> @\r
895         <a href="http://openib.tc.cornell.edu/downloads/binaries/">http://openib.tc.cornell.edu/downloads/binaries/</a> .<br>\r
896 &nbsp;</li>\r
897         <li>WinOF 1.0.1 is based on openib-windows <b><u>svn revision 864</u></b>.<br>\r
898 &nbsp;</li>\r
899         <li>WinOF 1.1 is based on openib-windows <b><u>\r
900         (svn revision 1177 branches\WOF1-1).<br>\r
901 &nbsp;</u></b></li>\r
902         <li>WinOF 2.0 is based on<b> (<u>svn.1763 branches\WOF2-0</u>)<br>\r
903 &nbsp;</b></li>\r
904         <li>WinOF 2.1 is based on<b> (<u>svn.1763 branches\WOF2-1</u>)</b></li>\r
905 </ul>\r
906 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
907 <p>&nbsp;</p>\r
908 <h2><u><a name="QLogic_VNIC_Configuration">QLogic VNIC Configuration</a></u></h2>\r
909 <p><font face="Arial">\r
910 <span style="font-size: 12pt; font-family: Times New Roman">The QLogic VNIC \r
911 (Virtual Network Interface Card) driver in conjunction with the QLogic Ethernet \r
912 Virtual I/O Controller (EVIC) provides virtual Ethernet interfaces and transport \r
913 for Ethernet packets over Infiniband.<br>\r
914 <br>\r
915 Users can modify NIC parameters through User Interface icon in Network \r
916 Connections:<br>\r
917 ( Properties-&gt;&quot;Configure...&quot; button -&gt; &quot;Advanced&quot; Tab).</span></p>\r
918 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
919 <span style="font-size: 12pt; font-family: Times New Roman">Parameters \r
920 available:<br>\r
921 <br>\r
922 Vlan Id (802.1Q)&nbsp;</span></p>\r
923 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
924 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp; values from 0 to \r
925 4094 ( default&nbsp;<span class="899314318-23042008">0, </span>disabled )<br>\r
926 &nbsp; This specifies if VLAN ID-marked packet transmission is enabled and, if so, \r
927 specifies the ID.<br>\r
928 <br>\r
929 Priority (802.1P)</span></p>\r
930 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
931 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp; values from 0 to 7 \r
932 ( default 0, feature disabled)<br>\r
933 &nbsp; This specifies if priority-marked packet transmission is enabled.<br>\r
934 <br>\r
935 Payload MTU size&nbsp;</span></p>\r
936 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
937 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp; values from 1500 \r
938 to 9500 (default 1500)<br>\r
939 &nbsp; This specifies the maximum transfer unit size in 100 bytes increments.<br>\r
940 <br>\r
941 Recv ChkSum offload&nbsp;</span></p>\r
942 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
943 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp; (default enabled)<br>\r
944 &nbsp; This specifies if IP protocols checksum calculations for receive is offloaded.<br>\r
945 <br>\r
946 Send ChkSum offload</span></p>\r
947 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
948 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp; (default enabled)<br>\r
949 &nbsp; This specifies if IP protocols checksum calculations for send is offloaded.<br>\r
950 &nbsp;</span></p>\r
951 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
952 <span style="font-size: 12pt; font-family: Times New Roman">Secondary Path&nbsp;</span></p>\r
953 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
954 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp;&nbsp; (default \r
955 disabled)<br>\r
956 &nbsp;&nbsp; Enabled - If more than one IB path to IOC exist then secondary IB instance of \r
957 virtual port will be created and configured with the same parameters as primary \r
958 one. Failover from Primary to Secondary IB path is transparent for user \r
959 application sending data through associated NIC.<br>\r
960 <br>\r
961 &nbsp;&nbsp; Disabled \96 only one path at a time is allowed. If more than one path to IOC \r
962 exists then failed path will be destroyed and next available path will be used \r
963 for new connection. With this scenario there is a possibility new interface \r
964 instance will be assigned different MAC address when other hosts compete for \r
965 EVIC resources.<br>\r
966 &nbsp;</span></p>\r
967 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
968 <font face="Times New Roman" size="3">LBFO Bundle Id<br>\r
969 &nbsp;&nbsp; (default disabled) Enabling support for OS provided Load Balancing and Fail \r
970 Over functionality on adapter level.<br>\r
971 &nbsp;&nbsp; If enabled group ID can be selected from predefined names.</font></p>\r
972 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
973 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp;</span></p>\r
974 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
975 <span style="font-size: 12pt; font-family: Times New Roman">Heartbeat interval</span></p>\r
976 <p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
977 <span style="font-size: 12pt; font-family: Times New Roman">&nbsp;&nbsp; configures \r
978 interval for VNIC protocol heartbeat messages in milliseconds.<br>\r
979 &nbsp;&nbsp; 0 \96 heartbeats disabled.<br>\r
980 <br>\r
981 Note:<br>\r
982 &nbsp;&nbsp; To take advantage of the features supported by these options, ensure that the \r
983 Ethernet gateway is also configured appropriately.&nbsp; For example, if the Payload \r
984 MTU for a VNIC interface is set to&nbsp;<span class="899314318-23042008">4</span>000, \r
985 the MTU at the EVIC module must also be set at least&nbsp;<span class="899314318-23042008">4</span>000 \r
986 for the setting to take effect.</span></p>\r
987 </font>\r
988 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
989 <p>&nbsp;</p>\r
990 <h2><u><a name="DAT_&amp;_uDAPL_Configuration">DAT &amp; uDAPL Configuration</a></u></h2>\r
991 <p align="left">In order for DAT/DAPL programs to execute correctly, the 'dat.dll' \r
992 file must be present in the current directory,\r
993 %SystemRoot% or in the library search path.</p>\r
994 <p align="left">WinOF installation places the dat.dll and dapl.dll \r
995 files in the '%SystemRoot%' \r
996 folder (a.k.a. \Windows).</p>\r
997 <p align="left">The DAT/DAPL configuration file by convention is defined as \r
998 '%SystemDrive%\DAT\dat.conf'. If the file '%SystemDrive%\DAT\dat.conf' does not exist, \r
999 a template configuration file will be installed as '%SystemDrive%\DAT\dat.conf'.<br>\r
1000 In order to preserve existing installations, the dat.conf file is not \r
1001 automatically installed if '%SystemDrive%\DAT\dat.conf' exists.<br>\r
1002 A sample dat.conf file is always installed as '\Program Files (x86)\WinOF\dat.conf \r
1003 '.</p>\r
1004 <p align="left">The default DAT configuration file specification can be overridden by use \r
1005 of the environment variable DAT_OVERRIDE. Such that 'DAT_OVERRIDE=D:\MyDAT\test.conf' \r
1006 would be a valid override specification.</p>\r
1007 <p align="left">Within the dat.conf file, the DAPL library specification can be \r
1008 located as the 5th whitespace separated line argument. By default the DAPL \r
1009 library file is installed as %WINDIR%\dapl.dll'.</p>\r
1010 <p align="left">Should you choose to relocate the DAPL library file to a folder \r
1011 where whitespace appears in the full library path specification, then the full \r
1012 library file specification must be contained within double-quotes. A side effect \r
1013 of the double-quotes is the library specification is treated as a Windows string \r
1014 which implies the '\' (backslash character) is treated as an 'escape' character.&nbsp; \r
1015 Hence all backslashes in the library path must be duplicated when enclosed in \r
1016 double-quotes (e.g., &quot;C:\\Programs Files (x86)\\WinOF\\dapl.dll&quot;).</p>\r
1017 <h4 align="left"><span style="font-weight: 400">DAT/DAPL version 2.0 runtime \r
1018 libraries are identified as dat2.dll and dapl2.dll, both in %SystemRoot%; see \r
1019 manual for further details.<br>\r
1020 &nbsp;</span></h4>\r
1021 <p align="left"><a href="#1.1_Release_Notes"><font color="#000000">\r
1022 &lt;Return-to-Top&gt;</font></a></p>\r
1023 <p align="left">&nbsp;</p>\r
1024 <h2 align="left"><u><a name="SRP_-_SCSI_RDMA_Protocol_Driver_Installation">SRP (SCSI RDMA Protocol) Driver Installation</a></u></h2>\r
1025 <p align="left">The WinOF installer does not install the SRP driver as part of a default \r
1026 installation.&nbsp; \r
1027 If the SRP feature is selected in the custom installation window, an InfiniBand \r
1028 SRP Miniport driver will be installed; see the device manager view under SCSI \r
1029 and RAID controllers.</p>\r
1030 <p align="left">The system device 'InfiniBand I/O Unit' (IOU) \r
1031 device is required for correct SRP operation.&nbsp; The WinOF installer will \r
1032 install/load the IOU driver if the SRP feature is selected.&nbsp; See the device \r
1033 manager view System Devices --&gt; InfiniBand I/O Unit for conformation of correct \r
1034 IOU driver loading.</p>\r
1035 <p align="left">In order for the SRP miniport driver installation to complete, an SRP target must be\r
1036 detected by a Subnet Manager running somewhere on the InfiniBand fabric; either \r
1037 a local or remote Subnet Manager works.</p>\r
1038 <h3 align="left"><u>SRP Driver Uninstall</u></h3>\r
1039 <p align="left">If the SRP (SCSI RDMA Protocol) driver has been previously \r
1040 installed, then in order to achieve a 'clean' uninstall, the SRP target drive(s) \r
1041 must be released.&nbsp;&nbsp; Unfortunately the 'offline disk' command is only \r
1042 valid for diskpart (ver 6.0.6001) which is not distributed with Windows Server \r
1043 2003 or XP.</p>\r
1044 <ul>\r
1045         <li>Use the following diskpart.exe commands from an administrator privileged \r
1046         command window:</li>\r
1047         <li>\r
1048         <a href="file:///c:/windows/temp" style="color: blue; text-decoration: underline">\r
1049         c:\windows\temp</a>&gt; diskpart.exe<br>\r
1050 &nbsp;&nbsp;&nbsp; SELECT VOLUME=&lt;Drive Letter of the SRP target to be released&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
1051         # example: SELECT VOLUME=L<br>\r
1052 &nbsp;&nbsp;&nbsp; OFFLINE DISK<br>\r
1053 &nbsp;&nbsp;&nbsp; EXIT</li>\r
1054         <li>For additional SRP drives, repeat SELECT &amp; OFFLINE DISK with new Drive \r
1055         Letter.</li>\r
1056 </ul>\r
1057 <p>The consequences of not releasing the SRP target drive(s) are that after the \r
1058 WinOF uninstall reboot there are lingering InfiniBand driver files. These driver \r
1059 files remain because while the SRP target is active they have references, thus \r
1060 when the WinOF uninstall attempts to delete the files the operation fails.</p>\r
1061 <p align="left">\r
1062 <br>\r
1063 <a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
1064 <p align="left">&nbsp;</p>\r
1065 <div class=Section1>\r
1066 \r
1067 <h2><a name="WinVerbs"><u>WinVerbs</u></a><u> technology preview</u></h2>\r
1068 <p>WinVerbs is a userspace verbs and communication management interface \r
1069 optimized<br>\r
1070 for the Windows operating system. Its lower interface is designed to support<br>\r
1071 any RDMA based device, including Infiniband and iWarp. Its upper interface is<br>\r
1072 capable of providing a low latency verbs interface, plus supports Microsoft's<br>\r
1073 Network Direct Interface, DAPL, and OFED libibverbs interfaces. It consists of<br>\r
1074 a userspace library and a kernel filter driver.<br>\r
1075 <br>\r
1076 The WinVerbs driver loads as an upper filter driver for Infiniband HCA.<br>\r
1077 (Open source iWarp drivers for Windows are not yet available.) A corresponding<br>\r
1078 userspace library installs as part of the Winverbs driver installation package.<br>\r
1079 Additionally, a Windows port of the OFED libibverbs library and several test<br>\r
1080 programs are also included.</p>\r
1081 <p>To install WinVerbs and it's test applications, select the 'WinVerbs' feature \r
1082 from the WinOF installer (.msi).<br>\r
1083 WinVerbs drivers are installed to %ProgramFiles(x86)%\WinOF\WinVerbs, although \r
1084 the drivers are not automatically loaded.<br>\r
1085 In order to make WinVerbs test applications usable, WinVerbs drivers must be \r
1086 manually loaded.<br>\r
1087 cd %ProgramFiles(x86)%\WinOF\WinVerbs<br>\r
1088 right-click on winverbs.inf, select 'install'.<br>\r
1089 Once WinVerbs is right-click installed, the HCA driver must be disabled and then \r
1090 enabled in order for the winverbs upper filter driver to be integrated into the \r
1091 HCA driver stack; see HCA driver properties-&gt;details, look for winverbs.<br>\r
1092 <br>\r
1093 Check if winverbs filter driver is active<br>\r
1094 &nbsp;&nbsp;&nbsp; %ProgramFiles(x86)%\WinOF\IBcore\devman classfilter \r
1095 InfiniBandController upper<br>\r
1096 <br>\r
1097 Remove winverbs filter driver<br>\r
1098 &nbsp;&nbsp;&nbsp; %ProgramFiles(x86)%\WinOF\IBcore\devman classfilter \r
1099 InfiniBandController upper !winverbs<br>\r
1100 &nbsp;</p>\r
1101 \r
1102 </div>\r
1103 \r
1104 <p class="MsoPlainText">\r
1105 <a href="#1.1_Release_Notes" style="color: blue; text-decoration: underline"><font color="#000000">\r
1106 &lt;Return-to-Top&gt;</font></a><br>\r
1107 &nbsp;</p>\r
1108 <h2><u><a name="Known_Issues">Known Issues</a></u></h2>\r
1109 \r
1110 <ul>\r
1111         <li>\r
1112         <p class=MsoPlainText><font face="Times New Roman" size="3">In a multi HCA \r
1113         (Host Channel Adapter) system, disabling HCA devices works correctly EXCEPT \r
1114         for disabling the first HCA while other HCAs are operational. Once the first \r
1115         HCA is disabled, existing HCAs and user-mode applications lose the \r
1116         connection to the kernel mode IB stack and will fail when attempting access \r
1117         to the IB stack or hardware.<br>\r
1118         Problem will be addressed in the next WinOF 2.0 release.<br>\r
1119 &nbsp;</font></p></li>\r
1120         <li>\r
1121         <p class=MsoPlainText><font face="Times New Roman" size="3">IPoIB partition \r
1122         multicast \r
1123         support requires IGMP (Internet Gateway Management Protocol) v2 Windows default is v3.<br>&nbsp;</font></p>\r
1124         <div><span class="395594910-04112008"><font face="Times New Roman">Partition \r
1125                 multicast on ipoib will only work if the machine is configured to use \r
1126                 IGMP V2 (and not V3 which is the default).</font></span></div>\r
1127         <div><span class="395594910-04112008"><font face="Times New Roman">To \r
1128                 configure your machine to use IGMP v2 please do the following:</font></span></div>\r
1129         <div><span class="395594910-04112008"></span><font face="Times New Roman">&nbsp;</font></div>\r
1130         <div><span class="395594910-04112008"><font face="Times New Roman">Server \r
1131                 2003 or XP:</font></span></div>\r
1132         <div><span class="395594910-04112008">\r
1133                 <p class="MsoNormal"><font size="3">netsh routing ip igmp install</font></span></div>\r
1134         <div><span class="395594910-04112008"><font face="Arial" size="2">\r
1135                 <p class="MsoNormal"><font size="3">netsh routing ip igmp install add \r
1136                 interface &quot;interface name of IPoIB adapter&quot;&nbsp; igmpprototype=igmprtrv2</font></p>\r
1137                 </font><font face="Arial" color="#0000ff" size="2">\r
1138                 <font face="Arial" size="2">\r
1139                 <p class="MsoNormal"></font><font size="3"><font face="Arial" size="2">If&nbsp;IGMP&nbsp;V3 is still used,&nbsp;please follow the instructions on</font><span style="color: navy"><font face="Arial" color="#0000ff" size="2">\r
1140                 <font color="#0000ff">(</font><a title="blocked::http://support.microsoft.com/default.aspx/kb/815752" style="color: blue; text-decoration: underline" href="http://support.microsoft.com/default.aspx/kb/815752">http://support.microsoft.com/default.aspx/kb/815752</a></font></font><font face="Arial" color="#0000ff" size="2"><font size="3" color="#0000ff">)</font></font></span></p>\r
1141                 <font face="Arial" color="#0000ff" size="2">\r
1142                 <p class="MsoNormal">&nbsp;</p></font></font>\r
1143                 <font face="Arial" size="2">\r
1144                 <p class="MsoNormal"><font size="3">Server 2008 </font></font>or<font size="3"> \r
1145                 HPC or Vista:</font></span></div>\r
1146         <div><span class="395594910-04112008">\r
1147                 <font face="Times New Roman" color="#000080">If the netsh command is not \r
1148                 available, then you will need to install via the command 'servermanagercmd.exe \r
1149                 -install NPAS-RRAS-Services'.</font></span></div>\r
1150         <div><span class="395594910-04112008"><font face="Tahoma" color="#0000ff">\r
1151                 <div>\r
1152                         <p class="MsoNormal"><span style="color: navy"><font size="3">netsh \r
1153                         routing ip igmp </font></span><font color="navy" size="3">\r
1154                         <span style="color: navy">install</span></font></div>\r
1155                 <div><font face="Arial" color="#0000ff" size="2">\r
1156                         <p class="MsoNormal"><span style="color: navy"><font size="3">netsh \r
1157                         routing ip igmp install </font></span><font color="navy" size="3">\r
1158                         <span style="color: navy">add interface &quot;interface name of IPoIB \r
1159                         adapter&quot;&nbsp; igmpprototype=igmprtrv2</span></font></p>\r
1160                         <p class="MsoNormal">&nbsp;</p></font></font>\r
1161                         <font face="Tahoma" size="2">\r
1162                         <p class="MsoNormal">F</font><font size="3">uture WinOF releases</font><font size="2" face="Tahoma"> \r
1163                         will support IGMP V3.</font></div></span></div>\r
1164         <p class=MsoPlainText>&nbsp;</p></li>\r
1165         <li>\r
1166         <p class=MsoPlainText><font face="Times New Roman" size="3">Sometimes an \r
1167         errant &quot;Welcome to the Found New Hardware Wizard&quot; window pops up during \r
1168         InfiniBand device installation on XP or Server 2003.<br>Just 'cancel' the FNHW popup window and proceed with installation.<br>An artifact of the 'Cancel' operation may cause a taskbar Information bubble \r
1169         to appear which incorrectly claims problems with the Infiniband device \r
1170         installation; Check IB device status via the Device Manager.</font></p></li>\r
1171 </ul>\r
1172 \r
1173 </div>\r
1174 <div class=Section1>\r
1175 \r
1176 <ul>\r
1177         <li>\r
1178         <p class=MsoPlainText><font size="3" face="Times New Roman">\r
1179         <span style="background-color: #FFFFFF">The Microsoft hotfix </span></font>\r
1180         <font face="Arial" color="navy" size="2">\r
1181         <span style="FONT-SIZE: 10pt; COLOR: navy; FONT-FAMILY: Arial">\r
1182         <a href="http://support.microsoft.com/kb/915858">\r
1183         http://support.microsoft.com/kb/915858</a> </span></font>\r
1184         <font size="3" face="Times New Roman">\r
1185         <span style="background-color: #FFFFFF">is necessary for users of SRP in any \r
1186         of the Windows Server 2003 platforms.&nbsp; The hotfix is described in Article ID \r
1187         915858 and fixes problems in the eventlog where specific event ids (56, 118, \r
1188         129) are not found in the latest IoLogMsg.dll file.&nbsp; Without the correct \r
1189         information, there is no supplied way to decipher the event log data.<br>\r
1190         The SRP hotfix need not be installed by non-SRP users; however, if the \r
1191         hotfix is installed in a system without SRP, it will not have any negative \r
1192         effects.<br>\r
1193 &nbsp;</span></font></p></li>\r
1194         <li>\r
1195         <p class=MsoPlainText><span style="background-color: #FFFFFF">\r
1196         <font face="Times New Roman" size="3">x64 Windows platforms do not exhibit \r
1197         the following SRP behavior.<br>\r
1198         SRP when run on a Windows 32-bit platform (x86) will exhibit SRP read \r
1199         transfer hangs when the size of the SRP read&nbsp; is greater-than (&gt;) 4096 \r
1200         bytes.</font></span></p>\r
1201         <div dir="ltr" align="left">\r
1202                 <span style="background-color: #FFFFFF">\r
1203                 <font face="Times New Roman" size="3">Setting the registry entry </font></span>\r
1204                 <font face="Arial" size="2"><strong>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ibsrp\Parameters<span class="795394519-15052008">\ModeFlags</span></strong></font></div>\r
1205         <p class=MsoPlainText><span style="background-color: #FFFFFF">\r
1206         <font face="Times New Roman" size="3">&nbsp;to 1 will \r
1207         enable &gt; 4KB transfers to proceed without hanging.</font></span><font size="3" face="Times New Roman"><span style="background-color: #FFFFFF"><br>\r
1208 &nbsp;</span></font></p></li>\r
1209         <li>\r
1210         <p class=MsoPlainText><font face="Times New Roman" size="3">Winsock Direct \r
1211         hotfix xxxxxxx for Windows Server 2003 is a good patch to apply if you are \r
1212         using WSD/IPoIB.</font><br>&nbsp;<font face="Times New Roman" size="3"><br>&nbsp;</font></p></li>\r
1213 </ul>\r
1214 <p class=MsoPlainText><a href="#1.1_Release_Notes"><font color="#000000">\r
1215 &lt;Return-to-Top&gt;</font></a><br>\r
1216 &nbsp;</p>\r
1217 \r
1218 </div>\r
1219 \r
1220 </body>\r
1221 \r
1222 </html>\r