[WinOF] RC3 changes

Document RC3 changes, opensm as a service(disabled)
INSTALLDIR appended to system search path.

git-svn-id: svn://openib.tc.cornell.edu/gen1@672 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

diff --git a/branches/WinOF/InstallShield/Release_notes.htm b/branches/WinOF/InstallShield/Release_notes.htm
index 157441013e83866d40a848be87fccd0ac2fc95af..4580f6cad4b98baa99b3b74c1d9011206e410979 100644 (file)
--- a/branches/WinOF/InstallShield/Release_notes.htm
+++ b/branches/WinOF/InstallShield/Release_notes.htm
@@ -86,10 +86,10 @@ src=openfabrics.gif></h1>
 \r
 <h1 align=center style='text-align:center'>Windows OpenFabrics </h1>\r
 \r
-<h1 align=center style='text-align:center'>1.0 Release Notes [RC2]</h1>\r
+<h1 align=center style='text-align:center'>1.0 Release Notes [RC3]</h1>\r
 \r
 <h3 align=center style='text-align:center'>\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/17/2007<!--webbot bot="Timestamp" endspan i-checksum="12620" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/24/2007<!--webbot bot="Timestamp" endspan i-checksum="12580" --></h3>\r
 \r
 <div class=MsoNormal align=center style='text-align:center'>\r
 \r
@@ -232,10 +232,9 @@ tab-stops:list .5in'>
 \r
 <p>All installed files are located in '%SystemDrive%\Program\r
 Files\WinOF'.&nbsp; Installed user mode executables are designed to be run from\r
-a Command Prompt window; see</p>\r
-<blockquote>\r
-       <p>'Start-&gt;Program Files-&gt; Windows OpenFabrics-&gt; Command Prompt'.</p>\r
-</blockquote>\r
+a Command Prompt window; see&nbsp; 'Start-&gt;Program Files-&gt; Windows OpenFabrics-&gt; Command Prompt'.</p>\r
+<p>'%SystemDrive%\Program Files\WinOF' is appended to the system wide search \r
+path.</p>\r
 \r
 <p>The \91default\92 installation installs \91released/free\92 (not\r
 checked/debug) versions of drivers, libraries and executables.</p>\r
@@ -243,10 +242,12 @@ 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.&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
+<p>It is recommended that OpenSM be run as a Windows service.&nbsp; A typical install will install OpenSM as a Windows service which \r
+is disabled; after an installation, choose your openSM node and start the openSM \r
+service.&nbsp; \r
+See the WinOF Manual for details on opensm as a service.<br>\r
+By selecting the OpenSM_service feature of a 'Custom' install, an OpenSM subnet \r
+management service will be automatically started. </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
@@ -273,7 +274,9 @@ installing this version of Windows OpenFabrics.</p>
 <p>openib-windows uninstall:</p>\r
 \r
 <ol start=1 type=1>\r
- <li class=MsoNormal>Disable any Local Area Connections which are bound to the\r
+ <li class=MsoNormal>Stop the openSM subnet manager if it is running on the \r
+       local node.</li>\r
+       <li class=MsoNormal>Disable any Local Area Connections which are bound to the\r
      IPoIB network adapter.</li>\r
  <li class=MsoNormal>Uninstall the IPoIB driver - My\r
      computer-&gt;Manage-&gt;Devices-&gt;Network Adapters-&gt;IPoIB*</li>\r
@@ -660,22 +663,21 @@ Window</li>
        </ol>\r
 </blockquote>\r
 <h3><u>OpenIB Subnet Management as a Windows Service</u></h3>\r
-<p>InfiniBand subnet management is installed by default, although it is NOT \r
-enabled by default. There are two ways to enable OpenSM on a node:</p>\r
+<p>Limit the number of Subnet Managers on your fabric; one SM per fabric is \r
+sufficient, although redundant Subnet Managers are supported.</p>\r
 <ol>\r
-       <li>Manual - In a command window run 'opensm.exe'. The opensm.exe \r
-       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: (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
-       Manager&quot;<br>\r
-&nbsp;&nbsp;&nbsp; 2) sc start opensm<br>\r
-&nbsp;&nbsp;&nbsp; 3) sc qc opensm&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
-       rem Query service description,&nbsp; 'sc stop opensm'&nbsp; Stops the opensm \r
-       service</li>\r
+       <li>After a 'typical' WinOF install, OpenSM is installed as a <b>disabled</b> \r
+       Windows service called &quot;InfiniBand Subnet Management&quot;. To start the OpenSM \r
+       service on the system use My computer-&gt;Manage-&gt;Device \r
+       Manager-&gt;Services-&gt;InfiniBand Subnet Manager-&gt;Start.<br>\r
+       Set the service properties to 'auto' in order to restart upon the next \r
+       system reboot.<br>\r
+&nbsp;</li>\r
+       <li>Install OpenSM as an automatic/running Windows service:<br>\r
+       a) Request a 'Custom' install, selecting the OpenSM_service feature. Once \r
+       the install is complete, check that the Infiniband Subnet Manager service is \r
+       running: My computer-&gt;Manage-&gt;Device Manager-&gt;Services-&gt;InfiniBand Subnet \r
+       Manager</li>\r
 </ol>\r
 <p>&nbsp;</p>\r
 <h3><u>Local Network Adapter Ordering</u></h3>\r
@@ -695,16 +697,17 @@ release<br>&nbsp;&nbsp;&nbsp; notes.</p>
 <h3><u>DAT &amp; uDAPL Configuration</u></h3>\r
 <p align="left">In order for DAT/uDAPL programs to execute correctly, the 'dat.dll' \r
 file must be present in the current directory,<br>\r
-%SystemRoot%\ or in the library search path.</p>\r
-<p align="left">The default WinOF installation places the file dat.dll in '%SystemRoot%' \r
+%WINDIRt% or in the library search path.</p>\r
+<p align="left">The 'typical' WinOF installation places the dat.dll and dapl.dll \r
+files in the '%WINDIR%' \r
 folder (a.k.a. \Windows).</p>\r
-<p align="left">The DAPL configuration file by default is defined as \r
+<p align="left">The DAPL configuration file by convention is defined as \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
 located as the 5th whitespace separated line argument. By default the DAPL \r
-library file is installed as %SystemRoot%\dapl.dll'.</p>\r
+library file is installed as %WINDIR%\dapl.dll'.</p>\r
 <p align="left">Should you choose to relocated the DAPL library file to a path \r
 where whitespace appears in the full library path specification, then the full \r
 library file specification must be contained within double-quotes. A side effect \r
@@ -732,12 +735,7 @@ dat.conf file is not automatically installed in it's default location.</p>
        to appear which incorrectly claims problems with the Infiniband device \r
        installation; Check IB device status via the Device Manager.<br>\r
        Microsoft claims this behavior is resultant from installation of non-signed \r
-       device drivers coupled with the IB fabric coinstaller.<br>\r
-&nbsp;</font></p></li>\r
-       <li>\r
-       <p class=MsoPlainText><font face="Times New Roman" size="3">The \r
-       InstallShield-12 'Current Settings' window is empty; Resolution is underway.<br>\r
-&nbsp;</font></p></li>\r
+       device drivers coupled with the IB fabric coinstaller.<br>&nbsp;</font></p></li>\r
 </ul>\r
 <p class=MsoPlainText><br>\r
 &nbsp;</p>\r