[WinOF] support Windows 7 (currently disabled)
[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 \r
35      Windows Server 2003 & XP installs require an explicit HCA device\r
36      type selection; the default HCA device type is Mellanox InfiniHost.\r
37 \r
38      Windows Server 2003/XP WinOF unattended installs can override the install\r
39      default HCA device 'InfiniHost' via the msiexe.exe command line override\r
40      'HCA=cx'; where 'cx' implies Mellanox ConnectX HCA device(s).\r
41      Specifing 'HCA=+cx' will install the ConnectX HCA driver in addition to\r
42      the InfiniHost HCA driver; mixed HCA environment.\r
43 \r
44      Example unattended installs:\r
45        Server 2003 with ConnectX HCA\r
46          start/wait msiexec /I WinOF_wnet_x64.msi /qn /quiet HCA=cx\r
47 \r
48        Server 2008 with ConnectX HCA\r
49          start/wait msiexec /I WinOF_wlh_x64.msi /qn /quiet\r
50 \r
51            '/passive' can replace '/qn /quiet' for attended installs or uninstalls\r
52        without overhead noise.\r
53 \r
54          start/wait msiexec /X WinOF_wlh_x64.msi /passive\r
55 \r
56 \r
57   C) Server 2008-HPC install support has been enhanced to provide a no-drivers\r
58      installed mode. Device driver '.inf' files are not processed during the\r
59      WinOF install.\r
60      The base assumption is that a WDM node provisioning template will install\r
61      WinOF drivers. All other WinOF files are installed to the standard WinOF\r
62      location '%ProgramFiles(x86)%\WinOF'.\r
63 \r
64      Examples\r
65 \r
66         unattended install: start/wait msiexec /I WOF.msi /quiet NODRV=1\r
67 \r
68         fast attended install: start/wait msiexec /I WOF.msi /passive NODRV=1\r
69 \r
70         install selectable features: start/wait msiexec /I WOF.msi NODRV=1\r
71 \r
72         Extract WinOF install files (aka driver files for WDM install)\r
73           start/wait msiexec /A WinOF_wlh_x64.msi TARGETDIR=%TEMP%\r
74 \r
75           The folder %TEMP%\PFiles\WinOF will be created.\r
76 \r
77         unattended uninstall with auto-reboot:\r
78           start/wait msiexec /X WOF.msi /passive\r
79 \r
80   D) SRP and VNIC drivers are command line selectable:\r
81         start/wait msiexec /I WOF.msi /passive SRP=1\r
82         start/wait msiexec /I WOF.msi /passive VNIC=1\r
83 \r
84   E) Subnet Management started as a local Windows Service from a command line:\r
85         start/wait msiexec /I WOF.msi /passive OSMS=1\r
86 \r
87   F) HCA drivers load WinVerbs and WinMad filter drivers by default.\r
88 \r
89   G) OFED Compatibility layers allow for easy porting of OFED applications\r
90      into the WinOF environment.\r
91         libibverbs - OFED verbs API library.\r
92         libmad - InfiniBand MAD (Management Datagram) library.\r
93         libumad - IB MAD exported user-mode interface library.\r
94 \r
95   H) OFED fabric diagnostic utilities are available.\r
96        ibstat - display HCA information.\r
97        ibnetdiscover - generate a fabric topology.\r
98        portinfo - display InfiniBand port specific information.\r
99        saquery - SA (Subnet Administrator) query test.\r
100 \r
101 \r
102 Note on Vista installs Only:\r
103 \r
104   Vista installs must be performed from an Administrator priviledged command\r
105   window. Right-clicking the .msi installer file for a Vista installation\r
106   will fail due to insufficent privileges to install the HCA driver!\r
107   From the Administrator privileged cmd-window say\r
108 \r
109     start/wait msiexec /I WinOF_wlh_xxx.msi\r
110           -or-\r
111     a quiet, default install:  start/wait msiexec /I WinOF_wlh_xxx.msi /passive\r
112 \r
113 \r
114 **** WARNING ****\r
115 \r
116 After the WinOF.msi file has started installation execution, an errant\r
117 "Welcome to the Found New Hardware Wizard" window 'may' popup.\r
118 \r
119 Just ignore or 'cancel' the errant FNHW popup window in order to proceed with\r
120 the installation. XP requires a cancel, for WLH & WNET, the notifiers will\r
121 disappear on their own. \r
122 \r
123 You do need to answer 'Yes' or 'Continue' to those popup windows which refer to\r
124 non-WHQL'ed drivers.\r
125 \r
126 If the install appears to hang, look around for popup windows requesting input\r
127 which are covered by other windows. Such is the case on Server 2008 initial \r
128 install - Answer 'yes' to always trust the OpenFabrics Alliance as a SW\r
129 publisher.\r
130 \r
131 \r
132 \r
133 Please:\r
134   read the Release_notes.htm file!\r
135   make 'sure' your HCA firmware is recent; vstat.exe displays HCA firmware\r
136   version.\r
137 \r
138 thank you.\r
139 \r