[WinOF] Remove disucssions for Server 2003 & XP w.r.t. selecting HCA device driver...
[mirror/winof/.git] / WinOF / WIX / README_release.txt
1 \r
2 [6-23-09] WinOF 2.1 (pre-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.2272).\r
12 \r
13    Last WinOF release (2.0.2) based on svn.1975.\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    WinMAD\r
24    OFED (Open Fabrics Enterprise Distribution [Linux]) verbs API\r
25    OFED Diagnostic utilities\r
26    WinOF Installer\r
27 \r
28 3) Integrated Functionality\r
29 \r
30   - OFED Compatibility layers allow for easy porting of OFED applications\r
31     into the WinOF environment.\r
32         libibverbs - OFED verbs API library.\r
33         libmad - InfiniBand MAD (Management Datagram) library.\r
34         libumad - IB MAD exported user-mode interface library.\r
35         librdmacm - OFED RDMA CM (Comunications Manager).\r
36 \r
37   - OFED Fabric Diagnostics available ( for usage info, see --help ).\r
38        ibaddr - query InfiniBand address(es)\r
39        ibnetdiscover - generate a fabric topology.\r
40        iblinkinfo - report link info for all links in the fabric\r
41        ibping - ping an InfiniBand address\r
42        ibportstate - manage IB port (physical) state and link speed\r
43        ibqueryerrors - query and report non-zero IB port counters\r
44        ibroute - query InfiniBand switch forwarding tables\r
45        ibstat - display HCA information.\r
46        ibsysstat - system status for an InfiniBand address\r
47        ibtracert - trace InfiniBand path\r
48        saquery - SA (Subnet Administrator) query test.\r
49        sminfo - query InfiniBand SMInfo attributes\r
50        smpdump - dump InfiniBand subnet management attributes\r
51        smpquery - query InfiniBand subnet management attributes\r
52        vendstat - query InfiniBand vendor specific functions\r
53 \r
54   - Connected mode IPoIB ensures higher performance IPoIB transfers in\r
55      addition to OFED (Linux) IPoIB connectivity.\r
56 \r
57   - All WinOF installs now utilize the Windows Driver Store along with the\r
58      Plug-n-Play (PNP) subsystem to install the correct HCA driver(s).\r
59      Selection of a specific Mellanox HCA type is no longer required.\r
60 \r
61   - Server 2008-HPC install support has been enhanced to provide a no-drivers\r
62      installed mode to ease WinOF installation when drivers have been previously\r
63      installed with WDM (Windows Deployment Manager) node templates.\r
64      From an msiexec.exe command line when NODRV=1, device driver '.inf' files\r
65      are not processed during the WinOF install.\r
66      The base assumption is the WDM node provisioning template (see cluster\r
67      Manager) will install WinOF drivers. All other WinOF files are installed\r
68      to the standard WinOF location '%ProgramFiles(x86)%\WinOF'.\r
69      When uninstalling a WinOF install which was done with NODRV=1, you MUST\r
70      include NODRV=1 on the msiexec.exe uninstall command line or the uninstall\r
71      will uninstall WinOF drivers installed via WDM templates.\r
72 \r
73      Examples\r
74 \r
75         unattended install (for use with clusrun.bat)\r
76            start/wait msiexec /I WOF.msi /quiet NODRV=1\r
77 \r
78         console based non-interactive install:\r
79            start/wait msiexec /I WOF.msi /passive NODRV=1\r
80 \r
81         Install selectable features (No drivers):\r
82           start/wait msiexec /I WOF.msi NODRV=1\r
83 \r
84         Extract WinOF install files (aka driver files for WDM install)\r
85           start/wait msiexec /A WinOF_wlh_x64.msi TARGETDIR=%TEMP%\r
86 \r
87           The folder %TEMP%\PFiles\WinOF will be created.\r
88 \r
89         console based unattended uninstall with auto-reboot:\r
90           start/wait msiexec /X WOF.msi /passive\r
91 \r
92         clusrun unattended uninstall with auto-reboot\r
93           start/wait msiexec /X WOF.msi /quiet /forcereboot\r
94 \r
95   - Subnet Management started as a local Windows Service from a command line:\r
96         start/wait msiexec /I WOF.msi /passive OSMS=1\r
97 \r
98   - HCA drivers now load WinVerbs and WinMad filter drivers by default.\r
99 \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 (Interactive install) 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
140 WinOF Developers.\r
141 \r