[WinOF] RC3 changes

Document openSM service changes + PATH changes.

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

diff --git a/branches/WinOF/InstallShield/Manual.htm b/branches/WinOF/InstallShield/Manual.htm
index 3c0cb386993dd5973ed84c92afc96925aa9c76ea..0e2d9fed27aabdd7acb894728221cab09160c074 100644 (file)
--- a/branches/WinOF/InstallShield/Manual.htm
+++ b/branches/WinOF/InstallShield/Manual.htm
@@ -15,7 +15,7 @@ div.Section1
 <h1 align="center">User's Manual</h1>\r
 <h2 align="center">Release 1.0</h2>\r
 <h3 align="center">\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->05/08/2007<!--webbot bot="Timestamp" endspan i-checksum="12628" --></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
 <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
@@ -66,7 +66,11 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
        <blockquote>\r
                <p align="left">The OpenFabrics Alliance Windows release contains a set of \r
        user mode tools which are designed to faciliate the smooth operation of an \r
-       Windows OpenFabrics installation.</p>\r
+       Windows OpenFabrics installation. These tools are available from a command \r
+               window (cmd.exe) as the installation path '%SystemDrive%\Program \r
+               Files\WinOF' is appended to the system wide search path registry entry. \r
+               A start menu short-cut 'WinOF Cmd Window' is provided to faciliate \r
+               correction tool operation.</p>\r
                <h4 align="left">Infiniband Subnet Management</h4>\r
                <ul>\r
                        <li>\r
@@ -358,33 +362,33 @@ Options specific to -r:
 <p align="left">&nbsp;</p>\r
 <h2 align="left"><a name="opensm"></a>Subnet Management with OpenSM Rev: openib-1.2.0</h2>\r
 <p align="left">A single running process (opensm.exe) is required to configure \r
-and thus make an Infiniband subnet useable.&nbsp; For most cases, invoking \r
-opensm.exe with no arguments from a command window is sufficient to correctly configure most \r
-Infiniband fabrics.</p>\r
+and thus make an Infiniband subnet useable.&nbsp; For most cases, InfiniBand \r
+Subnet Management as a Windows service is sufficient to correctly configure most \r
+InfiniBand fabrics.</p>\r
 <p align="left">The Infiniband subnet management process (opensm) may exist on a \r
-Windows (WinOF) node or a Linux (OFED) node but not both!<br>\r
-One OpenSM per IB fabric.</p>\r
+Windows (WinOF) node or a Linux (OFED) node.<br>\r
+<br>\r
+Limit the number of OpenSM processes per IB fabric; one SM is sufficient \r
+although redundant SMs are supported. You do not need a Subnet Manager per \r
+node/system.</p>\r
 <h4>OpenIB Subnet Management as a Windows Service</h4>\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>InfiniBand subnet management (OpenSM), as a Windows service, is installed by default, although it is NOT \r
+started by default. There are two ways to enable the InfiniBand Subnet \r
+Management service.</p>\r
 <ol style="margin-bottom: 0in">\r
-       <li>Manual - In a command window run 'opensm.exe', command window/opensm.exe \r
-       must remain active in order for the fabric to remain configured.</li>\r
-       <li>Start OpenSM as a Windows service:<br>\r
-       a) Request a 'Custom' install, selecting the OpenSM install feature; the \r
-       preferred method.<br>\r
-       b) Manually create/start the OpenSM service:<br>\r
-&nbsp;&nbsp;&nbsp; 1) sc create opensm binPath= &quot;<a href="file:///C:/Program%20Files/WinOF/opensm.exe%20--service" style="color: blue; text-decoration: underline">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>Reset the installed OpenSM service &quot;InfiniBand Subnet Management&quot; to \r
+       start automatically; See My Computer-&gt;Manage-&gt;Device Manager-&gt;Services-&gt;InfiniBand \r
+       subnet Management-&gt;Start.<br>\r
+&nbsp;</li>\r
+       <li>Install OpenSM as a 'running' Windows service:<br>\r
+       Request a 'Custom' install, selecting the OpenSM_service install feature. \r
+       Once the installation has completed, check the running InfiniBand Subnet \r
+       Management service status via the Windows service manager (see #1).</li>\r
 </ol>\r
-<p>WARNING - only 'one' OpenSM per IB fabric.</p>\r
+<p>&nbsp;</p>\r
 <hr>\r
-<p align="left">Usage: opensm [options]</p>\r
+<h4 align="left">Manual InfiniBand Subnet Management from a command window</h4>\r
+<p align="left">Usage: opensm.exe [options]</p>\r
 <p align="left">Options:</p>\r
 <blockquote>\r
        <p align="left">-c<br>\r