[WinOF] document SRP install (OFED 1.4 target) & uninstall items of interest
authorstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 6 Jan 2009 20:07:42 +0000 (20:07 +0000)
committerstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 6 Jan 2009 20:07:42 +0000 (20:07 +0000)
git-svn-id: svn://openib.tc.cornell.edu/gen1/trunk@1809 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

WinOF/WIX/Release_notes.htm
docs/Manual.htm

index 6cafd21..e35d6c6 100644 (file)
@@ -92,7 +92,7 @@ src=openfabrics.gif></h1>
 <h1 align=center style='text-align:center'><a name="1.1_Release_Notes">2.0.1 Release Notes</a></h1>\r
 \r
 <h3 align=center style='text-align:center'>\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->11/20/2008<!--webbot bot="Timestamp" endspan i-checksum="12511" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->01/06/2009<!--webbot bot="Timestamp" endspan i-checksum="12592" --></h3>\r
 \r
 <div class=MsoNormal align=center style='text-align:center'>\r
 \r
@@ -133,7 +133,7 @@ QLogic VNIC Configuration</font></a></u></h3>
 <h3><u><a href="#DAT_&_uDAPL_Configuration"><font color="#000000">\r
 DAT &amp; uDAPL Configuration</font></a></u></h3>\r
 <h3><u><a href="#SRP_-_SCSI_RDMA_Protocol_Driver_Installation">\r
-<font color="#000000">SRP - SCSI RDMA Protocol Driver Installation</font></a></u></h3>\r
+<font color="#000000">SRP (SCSI RDMA Protocol) Driver Installation</font></a></u></h3>\r
 <h3><a href="#WinVerbs"><font color="#000000">W</font></a><u><a href="#WinVerbs"><font color="#000000">inVerbs</font></a></u></h3>\r
 <h3><u><a href="#Known_Issues"><font color="#000000">\r
 Known Issues</font></a></u></h3>\r
@@ -663,6 +663,28 @@ occur after the uninstall.</p>
                completely uninstalled; use device manager for checking. The effect of a \r
                partially uninstalled Infiniband Fabric device is IPoIB load failure \r
                upon the next WinOF install.</p>\r
+<h3><span style="text-decoration: underline">Uninstall Notes</span></h3>\r
+<ol>\r
+       <li>If the SRP (SCSI RDMA Protocol) driver has been previously installed, \r
+       then in order to achieve a 'clean' uninstall, the SRP target drive(s) must \r
+       be released.<br>\r
+&nbsp;<ul>\r
+               <li>Use the following diskpart.exe commands from an administrator \r
+               privileged command window:</li>\r
+               <li><a href="file:///c:/windows/temp">c:\windows\temp</a>&gt; diskpart.exe<br>\r
+&nbsp;&nbsp;&nbsp; SELECT VOLUME=&lt;Drive Letter of the SRP target to be released&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+               # example: SELECT VOLUME=L<br>\r
+&nbsp;&nbsp;&nbsp; OFFLINE DISK<br>\r
+&nbsp;&nbsp;&nbsp; EXIT</li>\r
+               <li>For additional SRP drives, repeat SELECT &amp; OFFLINE DISK with new \r
+               Drive Letter.</li>\r
+       </ul>\r
+       <p>Consequences of not releasing the SRP target drive(s) is that after the \r
+       uninstall reboot there are lingering InfiniBand driver files. These driver \r
+       files remain because while the SRP target is active they have references, \r
+       thus when the uninstall attempts to delete the files the operation fails.</p>\r
+       </li>\r
+</ol>\r
 <p><a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
 <p>&nbsp;</p>\r
 \r
@@ -986,19 +1008,42 @@ manual for further details.<br>
 <p align="left"><a href="#1.1_Release_Notes"><font color="#000000">\r
 &lt;Return-to-Top&gt;</font></a></p>\r
 <p align="left">&nbsp;</p>\r
-<h2 align="left"><u><a name="SRP_-_SCSI_RDMA_Protocol_Driver_Installation">SRP - SCSI RDMA Protocol Driver Installation</a></u></h2>\r
-<p align="left">The WinOF stack does not install the SRP driver by default.&nbsp; \r
-If SRP is\r
-selected in the custom installation window, it will only be copied during WinOF\r
-installation. To complete the SRP driver installation, an SRP target must be\r
-detected; a Subnet Manager must be running somewhere in the InfiniBand subnet.<br>\r
-<br>\r
-Upon the detection of an SRP target, the &quot;New Hardware Found&quot; Wizard pops up.<br>\r
-- Select Install Automatically and click Next. This installs the I/O unit \r
-device.<br>\r
-<br>\r
-Once completed, the &quot;New Hardware Found&quot; Wizard pops up again.<br>\r
-- Select Install Automatically and click Next. This installs the SRP driver.<br>\r
+<h2 align="left"><u><a name="SRP_-_SCSI_RDMA_Protocol_Driver_Installation">SRP (SCSI RDMA Protocol) Driver Installation</a></u></h2>\r
+<p align="left">The WinOF installer does not install the SRP driver as part of a default \r
+installation.&nbsp; \r
+If the SRP feature is selected in the custom installation window, an InfiniBand \r
+SRP Miniport driver will be installed; see the device manager view under SCSI \r
+and RAID controllers.</p>\r
+<p align="left">The system device 'InfiniBand I/O Unit' (IOU) \r
+device is required for correct SRP operation.&nbsp; The WinOF installer will \r
+install/load the IOU driver if the SRP feature is selected.&nbsp; See the device \r
+manager view System Devices --&gt; InfiniBand I/O Unit for conformation of correct \r
+IOU driver loading.</p>\r
+<p align="left">In order for the SRP miniport driver installation to complete, an SRP target must be\r
+detected by a Subnet Manager running somewhere on the InfiniBand fabric; either \r
+a local or remote Subnet Manager works.</p>\r
+<h3 align="left"><u>SRP Driver Uninstall</u></h3>\r
+<p align="left">If the SRP (SCSI RDMA Protocol) driver has been previously \r
+installed, then in order to achieve a 'clean' uninstall, the SRP target drive(s) \r
+must be released.</p>\r
+<ul>\r
+       <li>Use the following diskpart.exe commands from an administrator privileged \r
+       command window:</li>\r
+       <li>\r
+       <a href="file:///c:/windows/temp" style="color: blue; text-decoration: underline">\r
+       c:\windows\temp</a>&gt; diskpart.exe<br>\r
+&nbsp;&nbsp;&nbsp; SELECT VOLUME=&lt;Drive Letter of the SRP target to be released&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+       # example: SELECT VOLUME=L<br>\r
+&nbsp;&nbsp;&nbsp; OFFLINE DISK<br>\r
+&nbsp;&nbsp;&nbsp; EXIT</li>\r
+       <li>For additional SRP drives, repeat SELECT &amp; OFFLINE DISK with new Drive \r
+       Letter.</li>\r
+</ul>\r
+<p>The consequences of not releasing the SRP target drive(s) are that after the \r
+WinOF uninstall reboot there are lingering InfiniBand driver files. These driver \r
+files remain because while the SRP target is active they have references, thus \r
+when the WinOF uninstall attempts to delete the files the operation fails.</p>\r
+<p align="left">\r
 <br>\r
 <a href="#1.1_Release_Notes"><font color="#000000">&lt;Return-to-Top&gt;</font></a></p>\r
 <p align="left">&nbsp;</p>\r
index 1cdc9e1..663173c 100644 (file)
@@ -15,7 +15,7 @@ div.Section1
 <h1 align="center">User's Manual</h1>\r
 <h2 align="center">Release 2.0</h2>\r
 <h3 align="center">\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->12/23/2008<!--webbot bot="Timestamp" endspan i-checksum="12561" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->01/06/2009<!--webbot bot="Timestamp" endspan i-checksum="12592" --></h3>\r
 <h2 align="left"><u>Overview</u></h2>\r
 <p align="left"><span style="FONT-SIZE: 12pt; FONT-FAMILY: 'Times New Roman'">\r
 The Windows OpenFabrics (WinOF) package is composed of software modules intended \r
@@ -1882,35 +1882,56 @@ with a Subnet<br>
 Manager running somewhere on the IB fabric.<br>\r
 <br>\r
 - Supported Operating Systems and Service Packs:<br>\r
-&nbsp;&nbsp; o Windows XP SP2 x64<br>\r
-&nbsp;&nbsp; o Windows Server 2008&nbsp; (x86, x64, IA64)<br>\r
-&nbsp;&nbsp; o Windows Server 2003 SP2/R2 (x86, x64, IA64)<br>\r
-&nbsp;&nbsp; o Windows Server 2003 CCS (x64)</p>\r
-<h4 align="left"><br>\r
-<u>Testing Level</u></h4>\r
+&nbsp;&nbsp; o Windows XP SP3 x86 &amp; x64<br>\r
+&nbsp;&nbsp; o Windows Server 2008/Vista&nbsp; (x86, x64)<br>\r
+&nbsp;&nbsp; o Windows Server 2008 HPC (x64)<br>\r
+&nbsp;&nbsp; o Windows Server 2003 SP2/R2 (x86, x64, IA64)</p>\r
+<h4 align="left"><u>Testing Levels</u></h4>\r
 <p align="left">The SRP driver has undergone basic testing against Mellanox \r
-Technologies'<br>\r
-SRP Targets MTD1000 and MTD2000. Testing included format, read, and write<br>\r
+Technologies'\r
+SRP Targets MTD1000 and MTD2000.<br>\r
+Additioinally the Linux OFED 1.4 SRP target has been tested.<br>\r
+Testing included SRP target drive format, read, write and dismount/offline\r
 operations.<br>\r
 &nbsp;</p>\r
 <h4 align="left"><u>Installation</u></h4>\r
-<p align="left">The WinOF stack&nbsp; does not install the SRP driver by default. \r
-If SRP is\r
-selected in the <i>custom</i> installation window, it will only be copied during WinOF\r
-installation. To complete the SRP driver installation, an SRP target must be\r
-detected; a Subnet Manager must be running somewhere in the IB subnet.<br>\r
-<br>\r
-Upon the detection of an SRP target, the &quot;New Hardware Found&quot; Wizard pops up.<br>\r
-- Select Install Automatically and click Next. This installs the I/O unit \r
-device.<br>\r
-<br>\r
-Once completed, the &quot;New Hardware Found&quot; Wizard pops up again.<br>\r
-- Select Install Automatically and click Next. This installs the SRP driver.<br>\r
-&nbsp;</p>\r
-<h4 align="left"><u>New Features and Changes</u></h4>\r
-<p align="left">- SRP supports WPP tracing tools by using the GUID: \r
-'5AF07B3C-D119-4233-9C81-C07EF481CBE6'.<br>\r
-&nbsp; The flags and level of debug can be controlled at load-time or run-time.</p>\r
+<p align="left">The WinOF installer does not install the SRP driver as part of a default \r
+installation.&nbsp; \r
+If the SRP feature is selected in the custom features installation view, an InfiniBand \r
+SRP Miniport driver will be installed; see the device manager view under SCSI \r
+and RAID controllers.</p>\r
+<p align="left">The system device 'InfiniBand I/O Unit' (IOU) \r
+device is required for correct SRP operation.&nbsp; The WinOF installer will \r
+install and load the IOU driver if the SRP feature is selected.&nbsp; See the device \r
+manager view System Devices --&gt; InfiniBand I/O Unit for conformation of correct \r
+IOU driver loading.</p>\r
+<p align="left">In order for the SRP miniport driver installation to complete, an SRP target must be\r
+detected by a Subnet Manager running somewhere on the InfiniBand fabric; either \r
+a local or remote Subnet Manager works.</p>\r
+<h4 align="left"><u>SRP Driver Uninstall</u></h4>\r
+<p align="left">If the SRP (SCSI RDMA Protocol) driver has been previously \r
+installed, then in order to achieve a 'clean' uninstall, the SRP target drive(s) \r
+must be released.</p>\r
+<ul style="margin-bottom: 0in">\r
+       <li>Use the following diskpart.exe commands from an administrator privileged \r
+       command window:</li>\r
+       <li>\r
+       <a href="file:///c:/windows/temp" style="color: blue; text-decoration: underline">\r
+       c:\windows\temp</a>&gt; diskpart.exe<br>\r
+&nbsp;&nbsp;&nbsp; SELECT VOLUME=&lt;Drive Letter of the SRP target to be released&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+       # example: SELECT VOLUME=L<br>\r
+&nbsp;&nbsp;&nbsp; OFFLINE DISK<br>\r
+&nbsp;&nbsp;&nbsp; EXIT</li>\r
+       <li>For additional SRP drives, repeat SELECT &amp; OFFLINE DISK with new Drive \r
+       Letter.</li>\r
+</ul>\r
+<p>The consequences of not releasing the SRP target drive(s) are that after the \r
+WinOF uninstall reboot there are lingering InfiniBand driver files. These driver \r
+files remain because while the SRP target is active they have references, thus \r
+when the WinOF uninstall attempts to delete the files the operation fails.</p>\r
+<p align="left">SRP supports WPP tracing tools by using the GUID: \r
+'5AF07B3C-D119-4233-9C81-C07EF481CBE6'.&nbsp; The flags and level of debug can be controlled at load-time or run-time; \r
+see ib_srp.inf file for details.</p>\r
 <h4 align="left"><a href="#TOP"><font color="#000000" size="4">&lt;return-to-top&gt;</font></a></h4>\r
 <h3>&nbsp;</h3>\r
 <h2><u><a name="QLOGICVNIC"></a>QLogic VNIC Configuration</u></h2>\r