]> git.openfabrics.org - ~shefty/rdma-win.git/commitdiff
[WinOF] Cleanup OpenSM text, more install hints.
authorstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Fri, 4 May 2007 18:34:39 +0000 (18:34 +0000)
committerstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Fri, 4 May 2007 18:34:39 +0000 (18:34 +0000)
git-svn-id: svn://openib.tc.cornell.edu/gen1@644 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

branches/WinOF/InstallShield/Release_notes.htm

index 9ab47b131159dffe0002899a6100bc4652a069eb..dec6cd026258f34efd9a7c6f20bbdf0cf4224628 100644 (file)
@@ -89,7 +89,7 @@ src=openfabrics.gif></h1>
 <h1 align=center style='text-align:center'>1.0 Release Notes</h1>\r
 \r
 <h3 align=center style='text-align:center'>\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/03/2007<!--webbot bot="Timestamp" endspan i-checksum="12548" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/04/2007<!--webbot bot="Timestamp" endspan i-checksum="12564" --></h3>\r
 \r
 <div class=MsoNormal align=center style='text-align:center'>\r
 \r
@@ -222,6 +222,7 @@ For official Firmware (FW) versions and update tools please see:<br>
        </li>\r
 </ul>\r
 \r
+<h2>&nbsp;</h2>\r
 <h2><u>Installation Specifics</u></h2>\r
 \r
 <p>All installed files are located in '%SystemDrive%\Program\r
@@ -237,12 +238,14 @@ checked/debug) versions of drivers, libraries and executables.</p>
 <p>A single instance of a subnet manager, opensm.exe, must be\r
 running on a fabric connected node in order for the Infiniband fabric to be\r
 configured and useful; either Windows or Linux opensm work fine.</p>\r
-<p>It is recommended that Opensm be run as a Windows service;\r
-see WinOF Manual for details on opensm as a service.</p>\r
+<p>It is recommended that Opensm be run as a Windows service.&nbsp; By selecting \r
+the OpenSM feature of a 'Custom' install, an OpenSM service is created and \r
+started.&nbsp; OpenSM is installed and not started as the typical install.&nbsp; \r
+See the WinOF Manual for details on opensm as a service.</p>\r
 \r
 <p>Note, the opensm.exe process must continue to run in order\r
 to maintain Infiniband fabric configuration. Should the opensm.exe process die,\r
-restart the service if not automatic or run opensm.exe in order to continue\r
+restart the service if not automatic or re-run opensm.exe in order to continue\r
 correct fabric operation.</p>\r
 \r
 <p>For more subnet management information, consult the Windows\r
@@ -255,11 +258,12 @@ OpenFabrics manual.</p>
 <h3>Requirements</h3>\r
 \r
 <p>Install HCA hardware prior to installing the Windows OpenFabrics Release\r
-package. Upon reboot, ignore/cancel any attempts to install new device hardware.</p>\r
+package. Upon reboot, cancel any attempts to install new device hardware from \r
+the &quot;New Hardware Found Wizard&quot;.</p>\r
 \r
 <p>If you have previously installed openib-windows, Windows OpenFabrics\r
-packages or vendor supplied Infiniband packages, uninstall them prior to\r
-installing this version of Windows OpenFabrics .</p>\r
+packages or vendor supplied Infiniband packages, uninstall and reboot prior to\r
+installing this version of Windows OpenFabrics.</p>\r
 \r
 <p>openib-windows uninstall:</p>\r
 \r
@@ -276,12 +280,12 @@ installing this version of Windows OpenFabrics .</p>
 &nbsp;&nbsp;&nbsp; Control Panel -&gt; Add or Remove Programs-&gt; Windows\r
 OpenFabrics-&gt;Remove.</p>\r
 \r
-<p>REBOOT</p>\r
+<p><b>REBOOT</b></p>\r
 \r
-<p>Upon reboot, cancel the 'Found New Hardware Wizard' attempt to install \r
+<p>Upon system restart, cancel the 'Found New Hardware Wizard' attempt to install \r
 drivers for newly discovered PCI device.</p>\r
 <p>'My Computer-&gt;Manage-&gt;Device Manager' should display\r
-'?Other Devices-&gt;?PCI device' which is your HCA device.</p>\r
+'?Other Devices-&gt;?PCI device' which is your Infiniband HCA device.</p>\r
 \r
 <h3>Install</h3>\r
 \r
@@ -289,12 +293,16 @@ drivers for newly discovered PCI device.</p>
 \r
 <p>From a login with administrator privileges, double-click the\r
 WinOF_arch_setup.exe file to begin the Windows OpenFabrics installation;&nbsp;\r
-where '_arch_' can be (_x64_ for amd64 or Intel EMT64 systems, _x86_ for x86\r
+where '_arch_' can be (_x64_ for&nbsp; Intel EMT64 systems or amd64, _x86_ for x86\r
 compatible systems or _ia64_ for Intel IA64 systems). </p>\r
 \r
 <p>Follow the instructions.<br>\r
 Answer 'yes' or 'Continue' to any notifier windows which reference non-signed \r
-driver installation.</p>\r
+driver installation. These non-signed driver install questions can be disabled \r
+via 'My Computer-&gt;Properties-&gt;Hardware-&gt;Driver Signing-&gt;Ignore'.</p>\r
+<p>Bottom-line - WinOF drivers in this package are not WHQL'ed although they are \r
+built from driver source which has been WHQL'ed.</p>\r
+<p>&nbsp;</p>\r
 <p>&nbsp;<font size="4">**** WARNING ****</font></p>\r
 <blockquote>\r
        <p>Should any 'Welcome to the Found New Hardware Wizard' windows popup after the \r
@@ -303,13 +311,16 @@ driver installation.</p>
        <p>An artifact of cancelling an errant 'Found New Hardware' popup window can \r
        induce an errant taskbar Information notifier/bubble indicating there may \r
        have been problems installing your hardware drivers;<br>\r
-       IGNORE this information bubble.</p>\r
+       IGNORE this information bubble. Check the Device Manager views for the \r
+       Infiniband HCA and IPoIB Network Adapters for initial verification of \r
+       correct installation.</p>\r
        <p>You do need to answer 'Yes' or 'Continue' to those notifier windows which \r
        reference non-signed or Legacy driver installation. If you have previously \r
        set My Computer-&gt;Properties-&gt;Hardware-&gt;Driver Signing-&gt;Ignore, then you will \r
        NOT be queried about installation of non-signed drivers.</p>\r
-       <p>Should the install appear to hang, look around for notifier windows which \r
-       are covered and waiting for a response.<br>\r
+       <p>Should the install appear to hang, look around for notifier windows \r
+       waiting for a response which \r
+       are covered by existing windows.<br>\r
 &nbsp;</p>\r
 </blockquote>\r
 \r
@@ -319,7 +330,8 @@ driver installation.</p>
 \r
 <ul type=disc>\r
  <li class=MsoNormal>Basics - Release Notes, Manual, Command Window</li>\r
- <li class=MsoNormal>Tools - Subnet Management [opensm], Performance &amp;\r
+ <li class=MsoNormal>Tools - Subnet Management [opensm.exe, SM is installed, not \r
+       started], Performance &amp;\r
      Diagnostic utilities</li>\r
  <li class=MsoNormal>mthca HCA driver</li>\r
  <li class=MsoNormal>IB fabric driver</li>\r
@@ -332,7 +344,7 @@ driver installation.</p>
 </ul>\r
 \r
 <ul style='margin-top:0in' type=disc>\r
- <li class=MsoNormal>IPoIB - Internet Protocols over InfiniBand (aka,\r
+ <li class=MsoNormal>Net - IPoIB [Internet Protocols over InfiniBand] (aka,\r
      ftp/telnet/... over IB fabric).</li>\r
  <li class=MsoNormal>DAPL - DAT and uDAPL support</li>\r
 </ul>\r
@@ -345,9 +357,9 @@ driver installation.</p>
      Diagnostic utilities</li>\r
  <li class=MsoNormal>mthca HCA driver</li>\r
  <li class=MsoNormal>IB fabric driver</li>\r
- <li class=MsoNormal>Optional:<br>&nbsp;&nbsp;&nbsp; IPoIB<br>&nbsp;&nbsp;&nbsp; WSD - Winsock Direct Provider, service started; see \r
+ <li class=MsoNormal>Optional:<br>&nbsp;&nbsp;&nbsp; Net - IPoIB<br>&nbsp;&nbsp;&nbsp; WSD - Winsock Direct Provider, service started; see \r
        installsp.exe -l<br>&nbsp;&nbsp;&nbsp; VNIC - Virtual Ethernet device over Infiniband<br>&nbsp;&nbsp;&nbsp; SRP - SCSI over RDMA Protocol<br>&nbsp;&nbsp;&nbsp; DAPL<br>\r
-&nbsp;&nbsp;&nbsp; OpenSM - InfiniBand Subnet Management as a Windows Service</li>\r
+&nbsp;&nbsp;&nbsp; OpenSM - InfiniBand Subnet Management started as a Windows Service</li>\r
 </ul>\r
 \r
 <p>&nbsp;</p>\r
@@ -517,7 +529,7 @@ mso-text-indent-alt:217;mso-char-wrap:1;mso-kinsoku-overflow:1">
                <li>Start-&gt;Program Files-&gt;OpenFabrics Alliance-&gt;Windows OpenFabrics -&gt; Command \r
 Window</li>\r
                <li>run vstat.exe to view HCA configuration.</li>\r
-               <li>If IPoIB is installed (Device Manager-&gt;Network Adapters) ping another node on the InfiniBand fabric 'ping a.b.c.d'<br>\r
+               <li>If IPoIB is installed (Device Manager-&gt;Network Adapters), ping another node on the InfiniBand fabric 'ping a.b.c.d'<br>\r
 &nbsp;</li>\r
        </ol>\r
 </blockquote>\r
@@ -529,7 +541,7 @@ enabled by default. There are two ways to enable OpenSM on a node:</p>
        process must remain in order for the fabric to remain configured.</li>\r
        <li>OpenSM running as a Windows service:<br>\r
        a) Request a 'Custom' install, selecting the OpenSM feature.<br>\r
-       b) Manually create and start the OpenSM service: (spce prior to '=' is \r
+       b) Manually create and start the OpenSM service: (space prior to '=' is \r
        required)<br>\r
 &nbsp;&nbsp;&nbsp; 1) sc create opensm binPath= &quot;<a href="file:///C:/Program%20Files/WinOF/opensm.exe%20--service">C:\Program \r
        Files\WinOF\opensm.exe --service</a>&quot; start= auto DisplayName= &quot;IB Subnet \r
@@ -543,7 +555,8 @@ enabled by default. There are two ways to enable OpenSM on a node:</p>
 <p>&nbsp;</p>\r
 <h3><u>Local Network Adapter Ordering</u></h3>\r
 <p>Local Network Adapter ordering, which results in the IP address advertised \r
-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 Local Network Adapters can be \r
+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
+of Local Network Adapters can be \r
 reordered after the IPoIB Local Network Adapters have been installed. Please \r
 check for your desired adapter ordering.<br>&nbsp;</p>\r
 <h3><u>Which WinOF release is installed</u>?</h3>\r
@@ -561,7 +574,7 @@ file must be present in the current directory,<br>
 <p align="left">The default WinOF installation places the file dat.dll in '%SystemRoot%' \r
 folder (a.k.a. \Windows).</p>\r
 <p align="left">The DAPL configuration file by default is defined as \r
-'%SystemDrive%\DAT\dat.conf'. This default specification can be overriden by use \r
+'%SystemDrive%\DAT\dat.conf'. This default specification can be overridden by use \r
 of the environment variable DAT_OVERRIDE. Such that 'DAT_OVERRIDE=D:\MyDAT\test.conf' \r
 would be a valid override specification.</p>\r
 <p align="left">Within the dat.conf file, the DAPL library specification can be \r
@@ -583,7 +596,7 @@ dat.conf file is not automatically installed in it's default location.</p>
 <p>&nbsp;</p>\r
 <h2><u>Uninstall</u></h2>\r
 \r
-<p>Use the Add Remove Programs from the control panel to remove the Windows\r
+<p>Use the&nbsp; Control Panel-&gt; Add Remove Programs to remove the Windows\r
 OpenFabrics installation.</p>\r
 <p>&nbsp;</p>\r
 \r
@@ -594,7 +607,10 @@ OpenFabrics installation.</p>
        <p class=MsoPlainText><font face="Times New Roman" size="3">Sometimes an \r
        errant &quot;Welcome to the Found New Hardware Wizard&quot; window pops up during \r
        installation.<br>\r
-       Just 'cancel' the popup and proceed with installation.</font></p></li>\r
+       Just 'cancel' the popup and proceed with installation.<br>\r
+       An artifact of the 'Cancel' operation can cause a taskbar Information bubble \r
+       to appear which incorrectly claims problems with the Infiniband device \r
+       installation; Check IB device operation via the Device Manager.</font></p></li>\r
 </ul>\r
 <p class=MsoPlainText>&nbsp;</p>\r
 \r