[WinOF]
authorstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 3 Mar 2009 17:43:53 +0000 (17:43 +0000)
committerstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 3 Mar 2009 17:43:53 +0000 (17:43 +0000)
  buildrelease.bat - added sign only option
  build-all-MSI.bat - update comments and support 'sign' option
  README_release.txt - WinOF 2.1 beginnings
  Release_notes.htm - WinOF 2.1 beginnings

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

WinOF/BuildRelease.bat
WinOF/WIX/README_release.txt
WinOF/WIX/Release_notes.htm
WinOF/WIX/build-all-MSI.bat

index f77b026..e0d137c 100644 (file)
@@ -8,7 +8,7 @@ rem           in %IDIR%
 rem\r
 rem BuildRelease option\r
 rem  option == all | allnoforce | compile | compilenoforce | makebin | msi |\r
-rem            wix | clean | msi-label | msi-del | msi-dir {OPENIB_REV}\r
+rem            sign | wix | clean | msi-label | msi-del | msi-dir {OPENIB_REV}\r
 \r
 rem This script is an 'example' of a one-command entire IB stack build to\r
 rem single-file installer; used to build a WinOF releases.\r
@@ -27,6 +27,7 @@ if "%1" == "compile" goto OK
 if "%1" == "compilenoforce" goto OK\r
 if "%1" == "makebin" goto OK\r
 if "%1" == "msi" goto OK\r
+if "%1" == "sign" goto OK\r
 if "%1" == "wix" goto OK\r
 if "%1" == "clean" goto OK\r
 if "%1" == "msi-label" goto OK\r
@@ -50,6 +51,7 @@ echo    makebin - assumes binaries are built, will installs binaries to WIX tree
 echo              then exit.\r
 echo    msi - assumes binaries are installed in WIX tree, signs drivers and\r
 echo          create installers (.msi files) in IDIR.\r
+echo    sign - assumes binaries are built and installed, sign drivers, exit.\r
 echo    wix - build .msi installers, assumes (drivers signed) .cat files exist\r
 echo    clean - remove build artifacts for a clean build: .obj, .sys, ...\r
 echo    msi-label {OPENIB_REV}\r
@@ -108,20 +110,17 @@ if "%1" == "clean" (
 rem Driver Signing Certificate filename, assumes %WIX%\%CERTFILE% is valid.\r
 rem set CERTFILE=noCert\r
 set CERTFILE=MSCV-VSClass3.cer\r
-set CERTSNAME="OpenFabrics Alliance"\r
+set SW_PUBLISHER="OpenFabrics Alliance"\r
 \r
 rem A Digital driver signing certificate store name may be required.\r
-if "%1" == "all" (\r
-    if "%CERTFILE%" == "noCert" set /P CERTFILE=[Enter Certificate FileName] \r
-    if "%CERTFILE%" == "" (\r
-        echo %0\r
-        echo %0: Err - driver signing certificate filename required.\r
-        echo %0: see certmgr.exe\r
-        exit /B 1\r
-    )\r
-)\r
 \r
-if "%1" == "msi" (\r
+if "%1" == "all" goto chk_cert\r
+if "%1" == "msi" goto chk_cert\r
+if "%1" == "sign" goto chk_cert\r
+\r
+goto cert_OK\r
+\r
+:chk_cert\r
     if "%CERTFILE%" == "noCert" set /P CERTFILE=[Enter Certificate FileName] \r
     if "%CERTFILE%" == "" (\r
         echo %0\r
@@ -131,6 +130,8 @@ if "%1" == "msi" (
     )\r
 )\r
 \r
+:cert_OK\r
+\r
 rem Use this WDK\r
 \r
 set _DDK=%SystemDrive%\WinDDK\6001.18001\r
@@ -277,22 +278,34 @@ if NOT EXIST etc\makebin.bat (
 )\r
 set STIME=%TIME%\r
 \r
-rem skip build - assumes binaries already built.\r
+rem skip build - assumes binaries already built and installed.\r
 \r
 if "%1" == "wix" (\r
     set MSI_CMD=msi\r
     goto mk_msi\r
 )\r
 \r
-set MSI_CMD=all\r
-if "%1" == "msi" (\r
-    if not EXIST "%RBIN_WLH%"  goto InstallBin\r
-    if not EXIST "%RBIN_WNET%" goto InstallBin\r
-    if not EXIST "%RBIN_WXP%"  goto InstallBin\r
-    goto mk_msi\r
+if "%1" == "makebin" goto InstallBin\r
+\r
+rem poor man's OR\r
+if "%1" == "sign" (\r
+    set MSI_CMD=%1\r
+    goto do_msi_chk\r
+) else (\r
+    set MSI_CMD=all\r
 )\r
+if "%1" == "msi" goto do_msi_chk\r
+goto compile\r
 \r
-if "%1" == "makebin" goto InstallBin\r
+:do_msi_chk\r
+\r
+rem make sure building a msi has files to work with.\r
+if not EXIST "%RBIN_WLH%"  goto InstallBin\r
+if not EXIST "%RBIN_WNET%" goto InstallBin\r
+if not EXIST "%RBIN_WXP%"  goto InstallBin\r
+goto mk_msi\r
+\r
+:compile\r
 \r
 set OPS=-wgcPM 3\r
 if "%1" == "allnoforce" (\r
@@ -435,7 +448,7 @@ echo     %RBIN_WXP%
 \r
 rem build WIX installers --> see WinOF\WIX\r
 \r
-%COMSPEC% /V:on /E:on /C "%_DDK%\bin\setenv.bat %_DDK% fre X64 WNET & cd /D %WIX% & build-all-MSI %MSI_CMD% %CERTFILE% %CERTSNAME% %IDIR%"\r
+%COMSPEC% /V:on /E:on /C "%_DDK%\bin\setenv.bat %_DDK% fre X64 WNET & cd /D %WIX% & build-all-MSI %MSI_CMD% %CERTFILE% %SW_PUBLISHER% %IDIR%"\r
 \r
 \r
 :finito\r
index 7e8d1ba..7442ad9 100644 (file)
@@ -1,7 +1,7 @@
 \r
-[1-17-09] WinOF 2.1 (RC0) release\r
+[4-17-09] WinOF 2.1 (RC0) release\r
 \r
-Downloads available at http://www.openfabrics.org/downloads/WinOF/v2.0.1_rc0\r
+Downloads available at http://www.openfabrics.org/downloads/WinOF/v2.1_rc0\r
 \r
 \r
 WinOF 2.1 Summary Changes \r
@@ -10,40 +10,74 @@ WinOF 2.1 Summary Changes
 1) The WinOF 2.1 release is based on openib-windows source svn revision\r
    (branches\WOF2-1 svn.xxxx).\r
 \r
-   Last WinOF release (2.0) based on svn 1763.\r
+   Last WinOF release (2.0.1) based on svn 1932.\r
 \r
-2) WHQL fixes in\r
+2) Bug fixes in\r
 \r
    IB Core\r
    IPoIB\r
    WSD\r
-   VNIC\r
    SRP\r
    DAT/DAPL\r
    WinVerbs\r
-   OFED verbs API\r
+   OFED (Open Fabrics Enterprise Distribution [Linux]) verbs API\r
    OFED Diagnostics\r
 \r
 3) New Functionality\r
 \r
-   Windows Server 2008/Vista WinOF installs now depend on Windows Plug-n-Play\r
-   to install the correct HCA driver(s). Specification of HCA device type is\r
-   no longer required for Server 2008/Vista/HPC.\r
+  A) Connected mode IPoIB ensures higher performance IPoIB transfers in\r
+     addition to OFED (Linux) IPoIB compatibility.\r
 \r
-   Windows Server 2003/XP WinOF unattended installs can override the default\r
-   HCA device 'InfiniHost' via the msiexe.exe command line override 'HCA=cx'\r
-   for ConnectX HCA device. Additionally 'HCA=+cx' will install the ConnectX\r
-   HCA driver in addition to the InfiniHost HCA driver.\r
+  B) Windows Server 2008/Vista WinOF installs now utilize Windows Plug-n-Play\r
+     (PNP) to install the correct HCA driver(s). Selection of a specific HCA\r
+     device type is no longer required for Server 2008/Vista/HPC.\r
+     Windows Server 2003 & XP installs still require an explicit HCA device\r
+     type selection; the default HCA selection is Mellanox InfiniHost.\r
 \r
-   Example 'start/wait msiexec /I WOF.msi /qn /quiet HCA=cx'\r
+     Windows Server 2003/XP WinOF unattended installs can override the install\r
+     default HCA device 'InfiniHost' via the msiexe.exe command line override\r
+     'HCA=cx'; where 'cx' implies the Mellanox ConnectX HCA device.\r
+     Specifing 'HCA=+cx' will install the ConnectX HCA driver in addition to\r
+     the InfiniHost HCA driver.\r
 \r
-   Server 2008/HPC install support has been enhanced to provide a no-drivers\r
-   installed mode. Driver '.inf' files are not processed, although the rest of\r
-   the WinOF files are installed to '%ProgramFiles(x86)%\WinOF'.\r
+     Example unattended install:\r
 \r
-   Examples\r
-      unattended install 'start/wait msiexec /I WOF.msi /quiet NODRV=1'\r
-      install selectable features 'start/wait msiexec /I WOF.msi NODRV=1'\r
+        start/wait msiexec /I WOF.msi /qn /quiet HCA=cx\r
+\r
+     Server 2008/HPC install support has been enhanced to provide a no-drivers\r
+     installed mode. Device driver '.inf' files are not processed, although\r
+     the remainder of the WinOF files are installed to\r
+     '%ProgramFiles(x86)%\WinOF'.\r
+\r
+     Examples\r
+\r
+        unattended install: start/wait msiexec /I WOF.msi /quiet NODRV=1\r
+\r
+        install selectable features: start/wait msiexec /I WOF.msi NODRV=1\r
+\r
+  C) HCA drivers load WinVerbs and WinMad filter drivers by default.\r
+\r
+  D) OFED Compatibility layers allow for easy porting of OFED applications\r
+     into the WinOF environment.\r
+        libibverbs - OFED verbs API library.\r
+        libmad - InfiniBand MAD (MAnagement Datagram) library.\r
+        libumad - IB MAD exported user-mode interface library.\r
+\r
+  E) OFED fabric diagnostic utilities are available.\r
+       ibstat - display HCA information.\r
+       ibnetdiscover - generate a fabric topology.\r
+       portinfo - display InfiniBand port specific information.\r
+       saquery - SA (Subnet Administrator) query test.\r
+\r
+\r
+Note on Vista installs Only:\r
+\r
+  Vista installs must be performed from an Administrator priviledged command\r
+  window. Right-clicking the .msi installer file for a Vista installation\r
+  will fail due to insufficent privileges to install the HCA driver!\r
+  From the Administrator privileged cmd-window say\r
+\r
+    start/wait msiexec /I WinOF_wlh_xxx.msi\r
 \r
 \r
 **** WARNING ****\r
@@ -63,8 +97,7 @@ which are covered by other windows. Such is the case on Server 2008 initial
 install - Answer 'yes' to always trust the OpenFabrics Alliance as a SW\r
 publisher.\r
 \r
-Vista installs require a command window with Administrator priviledges.\r
-Execute this command from a Vista command window 'msiexec /i WinOF_xxx_xxx.msi'.\r
+\r
 \r
 Please:\r
   read the Release_notes.htm file!\r
index ef710d1..e85a008 100644 (file)
@@ -92,7 +92,7 @@ src=openfabrics.gif></h1>
 <h1 align=center style='text-align:center'><a name="1.1_Release_Notes">2.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 -->01/16/2009<!--webbot bot="Timestamp" endspan i-checksum="12600" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->02/09/2009<!--webbot bot="Timestamp" endspan i-checksum="12642" --></h3>\r
 \r
 <div class=MsoNormal align=center style='text-align:center'>\r
 \r
@@ -383,15 +383,15 @@ installing this version of Windows OpenFabrics (WinOF).</p>
 &nbsp;&nbsp;&nbsp; Control Panel -&gt; Add or Remove Programs-&gt; Windows\r
 OpenFabrics-&gt;Remove.</p>\r
 <p>openib-windows (IB stack before WinOF 1.0 release) uninstall: (not the normal \r
-uninstall case, see previous discussion)</p>\r
+uninstall case)</p>\r
 \r
 <ol start=1 type=1>\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
+       <li class=MsoNormal>Stop the openSM subnet manager if it is running on the \r
+       local node.</li>\r
  <li class=MsoNormal>Uninstall the Infiniband HCA device; don't forget the \r
        System Device-&gt; InfiniBand Fabric</li>\r
 </ol>\r
@@ -400,8 +400,8 @@ uninstall case, see previous discussion)</p>
 \r
 <p><b>REBOOT</b></p>\r
 \r
-<p>Upon system restart, cancel the 'Found New Hardware Wizard' attempt to install \r
-drivers for newly discovered PCI device.</p>\r
+<p>Upon system restart, cancel the 'Found New Hardware Wizard' attempts to install \r
+drivers for newly discovered PCI device (HCA).</p>\r
 <p>'My Computer-&gt;Manage-&gt;Device Manager' should display\r
 'Other Devices-&gt;?PCI device' which is your Infiniband HCA device.</p>\r
 \r
@@ -409,8 +409,13 @@ drivers for newly discovered PCI device.</p>
 \r
 <blockquote style='margin-top:5.0pt;margin-bottom:5.0pt'>\r
 \r
-<p>From a login with administrator privileges, double-click the\r
-WinOF_M-m{-p}_OSE_arch.msi file to begin the Windows OpenFabrics installation.&nbsp;</p>\r
+<p>Vista installation <b>only</b>; open a privileged Administrator command \r
+window and say</p>\r
+<p>&nbsp;&nbsp;&nbsp; start/wait msiexec /I WinOF_wlh_xxx.msi</p>\r
+<p>For all other Windows variants, double-clicking the installer file (.msi) \r
+works correctly to start a WinOF installation.<br>\r
+From a login session with administrator privileges, double-click the WinOF_M-m{-p}_OSE_arch.msi file to begin the Windows OpenFabrics \r
+installation.</p>\r
 <p>Where 'M-n{-p}' indicates Major release number, Minor release number, and \r
 optional point-release number.</p>\r
 <p>&nbsp;OSE - Operating System Environment:</p>\r
@@ -689,11 +694,14 @@ occur after the uninstall.</p>
 <p>&nbsp;</p>\r
 \r
 <h2><u><a name="Trouble_Shooting">Trouble Shooting</a></u></h2>\r
-<p>Vista installs can fail to install the HCA driver due to protection failures \r
-- installing from a non-privileged Administrator window or double-clicking the .msi \r
-file.<br>\r
-Startup a privileged Administrator command window (Start-&gt;Command \r
-Prompt-&gt;Right-click-&gt;Run as Administrator) and execute: msiexec /I \r
+<p>A Vista WinOF installation can fail due to protection failures when \r
+installing the HCA driver. Vista HCA driver installation failure can be caused \r
+by&nbsp; double-clicking the .msi installer \r
+file to start the installation.<br>\r
+WinOF installs for Vista (only) require the installation be started&nbsp; from a \r
+privileged Administrator command window.<br>Start a privileged Administrator command window (Start-&gt;Command \r
+Prompt-&gt;Right-click-&gt;Run as Administrator) and execute:<br>\r
+&nbsp;&nbsp;&nbsp; msiexec /I \r
 WinOF_xxx_yyy.msi</p>\r
 <p>To create a LOG file of your WinOF installation, execute this command: \r
 msiexec /I WinOF_xxx_yyy.msi&nbsp; /Lv %TEMP%\WOF-install.log<br>\r
index 3d6493d..f00aeb3 100644 (file)
@@ -9,12 +9,12 @@ rem           otherwise sign all drivers and installers (.msi files)
 \r
 rem            Cross-CertFilename is indeed a filename only, we prefix ...\WIX before\r
 rem            pass it down.\r
-rem     CertName - Cert name in 'MY' Cert Store, see signtool /n switch\r
+rem     SW_PUB - Software Publisher name in 'MY' Cert Store, see signtool /n switch\r
 \r
 rem *** REQUIRES nmake, common invocation from Visual C or WDK command window\r
 rem *** Assumes current folder is WIX\\r
 \r
-set USE=usage %0 all/msi Certificate-FileName CertSubjName[see signtool /n] {dest-path-for-msi-files}\r
+set USE=usage %0 all/msi Certificate-FileName SW_Publisher[see signtool /n] {dest-path-for-msi-files}\r
 \r
 if "%1" == "" (\r
     echo %0: %USE%\r
@@ -27,6 +27,9 @@ if "%1" == "all" (
 if "%1" == "msi" (\r
     goto ok\r
 )\r
+if "%1" == "sign" (\r
+    goto ok\r
+)\r
 echo %0 - Unknown command '%1' - 'all' or 'msi'\r
 echo %0: %USE%\r
 exit /B 1\r
@@ -39,7 +42,7 @@ if NOT EXIST %2 (
     exit /B 1\r
 )\r
 \r
-rem need a Cert subject name string - name is passed in quoted!\r
+rem need a Cert subject name string - name is passed-in quoted!\r
 if %3 == "" (\r
     echo %0: %USE%\r
     exit /B 1\r
@@ -63,17 +66,24 @@ if ERRORLEVEL 1 (
 )\r
 del /Q /F %DST%\jnk.txt\r
 \r
-if "%1" == "all" (\r
-    rem Sign drivers for all OSes & arches. Convert CertFilename to full path.\r
-    call sign-all-drivers %CD%\%2 %3\r
+if "%1" == "msi" goto mk_msi\r
 \r
-    if ERRORLEVEL 1 (\r
-        echo %0: Error signing drivers?\r
-        exit /B 1\r
-    )\r
+rem Sign drivers for all OSes & arches. Convert CertFilename to full path.\r
+call sign-all-drivers %CD%\%2 %3\r
+\r
+if ERRORLEVEL 1 (\r
+    echo %0: Error signing drivers?\r
+    exit /B 1\r
 )\r
 \r
-:: build Windows Server 2008 / Vista (LongHorn versions) x86, x64 & ia64\r
+if "%1" == "sign" (\r
+    echo %0: Drivers Signed. \r
+    exit /B 0\r
+)\r
+\r
+:mk_msi\r
+\r
+rem build Windows Server 2008 / Vista (LongHorn versions) x86, x64 & ia64\r
 \r
 pushd wlh\r
 call build-MSI %DST%\r