7442ad93ccd6272747a86c7a721dff4878db90bd
[mirror/winof/.git] / WinOF / WIX / README_release.txt
1 \r
2 [4-17-09] WinOF 2.1 (RC0) release\r
3 \r
4 Downloads available at http://www.openfabrics.org/downloads/WinOF/v2.1_rc0\r
5 \r
6 \r
7 WinOF 2.1 Summary Changes \r
8 -------------------------\r
9 \r
10 1) The WinOF 2.1 release is based on openib-windows source svn revision\r
11    (branches\WOF2-1 svn.xxxx).\r
12 \r
13    Last WinOF release (2.0.1) based on svn 1932.\r
14 \r
15 2) Bug fixes in\r
16 \r
17    IB Core\r
18    IPoIB\r
19    WSD\r
20    SRP\r
21    DAT/DAPL\r
22    WinVerbs\r
23    OFED (Open Fabrics Enterprise Distribution [Linux]) verbs API\r
24    OFED Diagnostics\r
25 \r
26 3) New Functionality\r
27 \r
28   A) Connected mode IPoIB ensures higher performance IPoIB transfers in\r
29      addition to OFED (Linux) IPoIB compatibility.\r
30 \r
31   B) Windows Server 2008/Vista WinOF installs now utilize Windows Plug-n-Play\r
32      (PNP) to install the correct HCA driver(s). Selection of a specific HCA\r
33      device type is no longer required for Server 2008/Vista/HPC.\r
34      Windows Server 2003 & XP installs still require an explicit HCA device\r
35      type selection; the default HCA selection is Mellanox InfiniHost.\r
36 \r
37      Windows Server 2003/XP WinOF unattended installs can override the install\r
38      default HCA device 'InfiniHost' via the msiexe.exe command line override\r
39      'HCA=cx'; where 'cx' implies the Mellanox ConnectX HCA device.\r
40      Specifing 'HCA=+cx' will install the ConnectX HCA driver in addition to\r
41      the InfiniHost HCA driver.\r
42 \r
43      Example unattended install:\r
44 \r
45         start/wait msiexec /I WOF.msi /qn /quiet HCA=cx\r
46 \r
47      Server 2008/HPC install support has been enhanced to provide a no-drivers\r
48      installed mode. Device driver '.inf' files are not processed, although\r
49      the remainder of the WinOF files are installed to\r
50      '%ProgramFiles(x86)%\WinOF'.\r
51 \r
52      Examples\r
53 \r
54         unattended install: start/wait msiexec /I WOF.msi /quiet NODRV=1\r
55 \r
56         install selectable features: start/wait msiexec /I WOF.msi NODRV=1\r
57 \r
58   C) HCA drivers load WinVerbs and WinMad filter drivers by default.\r
59 \r
60   D) OFED Compatibility layers allow for easy porting of OFED applications\r
61      into the WinOF environment.\r
62         libibverbs - OFED verbs API library.\r
63         libmad - InfiniBand MAD (MAnagement Datagram) library.\r
64         libumad - IB MAD exported user-mode interface library.\r
65 \r
66   E) OFED fabric diagnostic utilities are available.\r
67        ibstat - display HCA information.\r
68        ibnetdiscover - generate a fabric topology.\r
69        portinfo - display InfiniBand port specific information.\r
70        saquery - SA (Subnet Administrator) query test.\r
71 \r
72 \r
73 Note on Vista installs Only:\r
74 \r
75   Vista installs must be performed from an Administrator priviledged command\r
76   window. Right-clicking the .msi installer file for a Vista installation\r
77   will fail due to insufficent privileges to install the HCA driver!\r
78   From the Administrator privileged cmd-window say\r
79 \r
80     start/wait msiexec /I WinOF_wlh_xxx.msi\r
81 \r
82 \r
83 **** WARNING ****\r
84 \r
85 After the WinOF.msi file has started installation execution, an errant\r
86 "Welcome to the Found New Hardware Wizard" window 'may' popup.\r
87 \r
88 Just ignore or 'cancel' the errant FNHW popup window in order to proceed with\r
89 the installation. XP requires a cancel, for WLH & WNET, the notifiers will\r
90 disappear on their own. \r
91 \r
92 You do need to answer 'Yes' or 'Continue' to those popup windows which refer to\r
93 non-WHQL'ed drivers.\r
94 \r
95 If the install appears to hang, look around for popup windows requesting input\r
96 which are covered by other windows. Such is the case on Server 2008 initial \r
97 install - Answer 'yes' to always trust the OpenFabrics Alliance as a SW\r
98 publisher.\r
99 \r
100 \r
101 \r
102 Please:\r
103   read the Release_notes.htm file!\r
104   make 'sure' your HCA firmware is recent; vstat.exe displays HCA firmware\r
105   version.\r
106 \r
107 thank you.\r
108 \r