[ofw] WinOF 2.1 General Availability Release @ OpenFabrics.org

[Smith, Stan]

WinOF 2.1 GA (General Availability) Release

WinOF 2.1 Release available @
   http://www.openfabrics.org/downloads/WinOF/v2.1/

Please address comments and concerns to https://bugs.openfabrics.org and/or the
Windows OpenFabrics email list ofw at lists.openfabrics.org


  *** WinOF now installed into %ProgramFiles%\WinOF on all systems!


WinOF 2.1 Summary
-----------------

1) The WinOF 2.1 release is based on openib-windows source svn revision
   (branches\WOF2-1 svn.2476).

   Last WinOF release (2.0.2) based on svn.1975.

2) Bug fixes in

   IB Core
   IPoIB
   WSD
   SRP
   DAT/DAPL
   WinVerbs
   WinMAD
   OFED (Open Fabrics Enterprise Distribution [Linux]) verbs API
   OFED Diagnostic utilities
   WinOF Installer

3) Integrated Functionality

  - OFED Compatibility layers allow for easy porting of OFED applications
    into the WinOF environment.
        libibverbs - OFED verbs API library.
        libmad - InfiniBand MAD (Management Datagram) library.
        libumad - IB MAD exported user-mode interface library.
        librdmacm - OFED RDMA CM (Communications Manager).

  - OFED Fabric Diagnostics available ( for usage info, see --help ).
       ibaddr - query InfiniBand address(es)
       ibnetdiscover - generate a fabric topology.
       iblinkinfo - report link info for all links in the fabric
       ibping - ping an InfiniBand address
       ibportstate - manage IB port (physical) state and link speed
       ibqueryerrors - query and report non-zero IB port counters
       ibroute - query InfiniBand switch forwarding tables
       ibstat - display HCA information.
       ibsysstat - system status for an InfiniBand address
       ibtracert - trace InfiniBand path
       saquery - SA (Subnet Administrator) query test.
       sminfo - query InfiniBand SMInfo attributes
       smpdump - dump InfiniBand subnet management attributes
       smpquery - query InfiniBand subnet management attributes
       vendstat - query InfiniBand vendor specific functions

4) New Functionality

  - All WinOF installs now utilize the Windows Driver Store along with the
     Plug-n-Play (PNP) subsystem to install the correct HCA driver(s).
     Selection of a specific Mellanox HCA device type is no longer required.

  - Server 2008-HPC install support has been enhanced to provide a no-drivers
     installed mode to ease WinOF installation when drivers have been previously
     installed with WDM (Windows Deployment Manager) node templates.
     From an msiexec.exe command line when NODRV=1, device driver .inf files
     are not processed during the WinOF install.
     The base assumption is the WDM node provisioning template (see cluster
     Manager) will install InfiniBand drivers. All other WinOF files are
     installed to the standard WinOF location '%ProgramFiles%\WinOF'.
     When uninstalling a WinOF install which was done with NODRV=1, you MUST
     include NODRV=1 on the msiexec.exe uninstall command line or the uninstall
     will uninstall HCA drivers installed via WDM templates.

     See examples '%ProgramFiles%\WinOF\HPC\ReadMe-HPC.txt'

     For 'first' time HPC WinOF installs or node provisioning with WinOF drivers
     via WDM, the batch script cert-add.bat, in '%ProgramFiles%\WinOF\HPC',
     should be utilized to extract the 3rd Party Software Publisher certificate
     from the WinOF_2-1_wlh_x64.msi installer and inserted in all compute nodes
     certificate store.
     Suggest WinOF install on head node then run 'cert-add.bat' from
     head-node; requires a common share visible from all remote nodes prior to
     execution.
     For WDM node provisioning, suggest cert-add.bat invocation followed by
     WinOF-Install.bat from Node provisioning template.

     Examples

        unattended install (for use with clusrun.bat)
           start/wait msiexec /I WOF.msi /quiet NODRV=1

        console based non-interactive install with progress window:
           start/wait msiexec /I WOF.msi /passive NODRV=1

        Install selectable features (No drivers):
          start/wait msiexec /I WOF.msi NODRV=1

        Extract WinOF install files (aka driver files for WDM install)
          mkdir %TEMP%\WOF
          start/wait msiexec /A WinOF_wlh_x64.msi TARGETDIR=%TEMP%\WOF

          The folder %TEMP%\WOF\PFiles\WinOF will be created.

        console based unattended uninstall with auto-reboot:
          start/wait msiexec /X WOF.msi /passive

        clusrun unattended uninstall with auto-reboot
          start/wait msiexec /X WOF.msi /quiet /forcereboot

  - Install the Subnet Management started as a local Windows Service from a
    command line:
        start/wait msiexec /I WOF.msi /passive OSMS=1

  - HCA drivers now load WinVerbs and WinMad filter drivers by default.

  - ndinstall.exe command line interface changes - see manual.htm

5) Technology Previews

   DAPL2 Socket-CM provider
    Uses IPv4 sockets to exchange Queue pair setup information, thus bypassing
    IB Path Record lookups.

   DAPL rdma-CM
    Compatible with OFED rdma-CM interfaces; facilates IB application
    portability between Linux/OFED and Windows/WinOF.


6) Vista installs Only:

  Vista installs must be performed from an Administrator privileged command
  window. Right-clicking the .msi installer file for a Vista installation
  will fail due to insufficient privileges to install the HCA driver!
  From the Administrator privileged cmd-window (Interactive install) say

    start/wait msiexec /I WinOF_wlh_xxx.msi
          -or-
    a quiet, default install:  start/wait msiexec /I WinOF_wlh_xxx.msi /passive


**** WARNING ****

After the WinOF.msi file has started installation, an errant
"Welcome to the Found New Hardware Wizard" window 'may' popup; XP & Svr 2003.

Just ignore or 'cancel' the errant FNHW popup window in order to proceed with
the installation. XP requires a cancel, for WLH & WNET, the notifier will
disappear on their own.

You do need to answer 'Yes' or 'Continue' to popup windows which refer to
Non-Logo'ed (aka, Non-WHQL'ed) drivers.

If the install appears to hang, look around for popup windows requesting input
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 publisher.


Please:
  Read the Release_notes.htm file!
  make 'sure' your HCA firmware is recent:
      vstat.exe displays HCA firmware version & PSID.
      flint.exe (only in Mellanox firmware tools dist) displays PSID.

Thank you,

WinOF Developers.