]> git.openfabrics.org - compat-rdma/docs.git/commitdiff
update for ofed 1.4
authorTziporet Koren <tziporet@mellanox.co.il>
Tue, 9 Dec 2008 15:10:27 +0000 (17:10 +0200)
committerTziporet Koren <tziporet@mellanox.co.il>
Tue, 9 Dec 2008 15:10:27 +0000 (17:10 +0200)
Signed-off-by: Oren Kladnitsky <orenk@mellanox.co.il>
ibutils_release_notes.txt
mstflint_release_notes.txt [new file with mode: 0755]

index 1487c0728337ce1d599a741240b8220232b2d87e..1b538553f4d8d1258ef9bfbfbb307d579619834f 100755 (executable)
@@ -2,8 +2,8 @@
                      --------------------------------------------
 
 *******************************************************************************
-RELEASE: OFED 1.3
-DATE: Feb 2008
+RELEASE: OFED 1.4
+DATE:    Dec 2008
 
 ===============================================================================
 Table of Contents
@@ -17,124 +17,66 @@ Table of Contents
 1. Overview
 ===============================================================================
 
-The ibdiag package was enhanced to check more aspects of the network setup,
-including partitions, IPoIB and QoS. Additional major feature is its ability
-to write a topology file of the discovered network. A summary table is provided
-with a list of the executed checks and their results.
+The ibutils package provides a set of diagnostic tools that check the health
+of an InfiniBand fabric.
+Package components:
+ibis:     IB interface - A TCL shell that provides interface for sending various
+          MADs on the IB fabric. This is the component that actually accesses
+          the IB Hardware.
+
+ibdm:     IB Data Model - A library that provides IB fabric analysis.
+
+ibmgtsim: An IB fabric simulator. Useful for developing IB tools.
+
+ibdiag:   This package provides 3 tools which provide the user interface
+          to activate the above functionality:
+            - ibdiagnet:  Performs various quality and health checks on the IB
+                          fabric.
+            - ibdiagpath: Performs various fabric quality and health checks on
+                          the given links and nodes in a specific path.
+            - ibdiagui:   A GUI wrapper for the above tools. 
 
 ===============================================================================
 2. New Features
 ===============================================================================
 
-The following new checks were added to the tools:
-
-ibdiagnet new features:
------------------------
-+ Partitions Check: 
-  - Validate all leaf switch ports (connected to a host) which enforce
-    partitions are not blocking partitions set on the host ports they
-    are connected to.
-  - Report for each partition the member hosts and their membership status.
-    Full membership allows hosts to communicate to any other member.
-    Partial membership allows communication with full members only.
-    The new report file is named ibdiagnet.pkey.
-
-+ IPoIB Subnets Check:
-  - The IPoIB subnets and their properties are reported.
-  - For each group all the host ports that are part of the partition are
-    checked to have a high enough communication rate to be part of the group
-     (warn if not).
-  - If all the group members can use a communication rate higher then the group
-    rate a warning is produced as the subnet uses a suboptimal rate.
-
-Other changes:
-+ The multicast groups report was enhanced to provide the details of each
-  group and the members list is provided in a new report file: ibdiagnet.mcgs.
-
-+ A new flag, -wt <file-name>, was added. ibdiagnet, with the new option, 
-  writes out a discovered topology file by the provided file-name and
-  the required new IBNL files into an output directory named ibdiag_ibnl.
-  This new feature allows you to capture the current state of the fabric
-  and later compare to it. Such the features provided by the "Topology
-  Matching" check becomes available. These feature include recognizing 
-  changes in connections, speed and width. 
-
-+ Load subnet database from file:
-  Ibdiagnet dumps its internal database, which contains the subnet structure, 
-  to a file (/tmp/ibdiagnet.db by default). This file can be loaded in later
-  ibdiagnet runs (using the -load_db <db file> option). When this option is set, 
-  ibdiagnet loads the subnet data from the file and skips the discovery stage.
-  Using this option can save the subnet discovery time for large cluster.
-  Note: Some if ibdiagnet checks would not be performed when the -load_db
-        option is set. These checks are:
-        - Duplicated guids.
-        - Zero guids.
-        - Links in INIT state.
-        - SMs status.
-  
- + A new flag, -skip <skip-option(s)>, was added. When this flag is specified, 
-   ibdiagnet skips the given check. One or more space separated values can be
-   specified.
-   Available skip options: dup_guids, zero_guids, pm, logical_state, part, 
-   ipoib. The -skip flag can be used in order to run only specific checks, or 
-   to reduce ibdiagnet run time.
-
-ibdiagpath new features:
-------------------------
-+ Partitions Check: 
-  - The list of partitions of source and destination ports is reported.
-  - A check for which partitions are common to the source, destination and
-    every port on the path (if enforcing partitions) is calculated and
-    reported. A warning is provided if a source partition is blocked by 
-    a port on the path.
-    An error is provided in there are no common partitions for the path.
-
-+ IPoIB Subnets Check:
-  - The IPoIB subnets available for the path and reported.
-  - If the source or destination ports are members in partitions which have
-    an IPoIB group and for some reason can not join the group a warning is
-    provided.
-
-+ QoS Check:
-  With the introduction of QoS, the following new issues might arise from 
-  improper setup of the fabric:
-  - VL Arbitration Tables might use VLs which are higher then the currently 
-    supported maximal VL on the port. A warning is provided for such cases.
-  - VL Arbitration Tables might "block" a VL by setting its weight to zero.
-    A warning is provided for these cases
-  - SLs (service levels) might be mapped to VLs which are blocked by the 
-    two above rules. In such case these SLs can not be used by the path.
-    A report including the set of "valid" SLs for the path is provided.
-  - If there are no "valid" SLs an error is provided since the source and
-    destination ports can not communicate.
-
-Common changes to all tools:
-----------------------------
-A summary table of all the checks performed and their total number of errors and
-warnings was added to the tools standard output.
+
+* Mellanox InfiniScaleIV support:
+  - Support switches with port count > 32
+  - Added ibnl (IB network) files for MTS3600 and MTS3610 InfiniScaleIV based switch systems.
+
+* IBDM QoS Credit Loop check: 
+  This check now considers SL/VL when looking for credit loops. 
+  This check can be activated by running "ibdiagnet -r"
+
+* ibdiagnet: Added -csv flag, which generated a set of Comma Separated Values
+             files, which contains data about the fabric. Generated files:
+               inv_csv   - Lists the ports found in the fabric
+               links_csv - Lists the ports connections in the fabric
+               pm_csv    - Lists port counters in csv format 
+               err_csv   - Lists errors found during the run
+
+* ibmgtsim: Add basic M_Key mechanism simulation
 
 ===============================================================================
 3. Major Bugs Fixed 
 ===============================================================================
 
-+ Fabrics Qualities report is now available in the main log file (and not only 
-  in the standard output
+* ibdm: Support 2 port switches in a loaded LST file.
+
+* ibis: fix some buffer overrun bugs with long node description.
+
+* Installation: Ibdiagui requires tcl/tk 8.4 or 8.5 (was only 8.4). This allows
+                installation on Fedora Core 9.
+
+* ibdiagnet: Fixed -pm flag caused a crash on back to back (no switch) setup.
+
+* ibdiagnet: Do not query port counters when local port is in INIT state.
 
 ===============================================================================
 4. Known Issues
 ===============================================================================
 
-- Ibdiagnet tries to query port counters for ports in INIT state. In this
-  case, run time would be longer and an error message for each port would be
-  printed to screen.
-  Workaround: 
-  * Use "-skip pm" option if links in INIT state are found.
-  * Run opensm to activate the links.
-
-- A failure in IPoIB check may cause ibdiagnet to exit, without printing the 
-  summary report.
-
 - Ibdiagnet "-wt" option may generate a bad topology file when running on a
   cluster that contains complex switch systems.
 
-
diff --git a/mstflint_release_notes.txt b/mstflint_release_notes.txt
new file mode 100755 (executable)
index 0000000..8f11333
--- /dev/null
@@ -0,0 +1,60 @@
+                     Open Fabrics InfiniBand Diagnostic Utilities 
+                     --------------------------------------------
+
+*******************************************************************************
+RELEASE: OFED 1.4
+DATE:    Dec 2008
+
+===============================================================================
+Table of Contents
+===============================================================================
+1. Overview
+2. New features
+3. Major Bugs Fixed 
+4. Known Issues
+
+===============================================================================
+1. Overview
+===============================================================================
+
+    uhis package contains a burning tool and diagnostic tools for Mellanox
+    manufactured cards. It also provides access to the relevant source
+    code. Please see the file LICENSE for licensing details.
+    
+2) Package Contents
+    a) mstflint source code
+    b) mflash lib
+       This lib provides Flash access through Mellanox HCAs.
+    c) mtcr lib (implemented in mtcr.h file)
+       This lib enables access to HCA hardware registers.
+    d) mstregdump utility
+       This utility dumps hardware registers from Mellanox hardware
+       for later analysis by Mellanox.
+    e) mstvpd
+       This utility dumps the on-card VPD.
+       f) hca_self_test.ofed
+          This scripts checks the status of software, firmware and hardware
+          of the HCAs installed on the local host.
+
+===============================================================================
+2. New Features
+===============================================================================
+
+* Mellanox InfiniScaleIV switch support.
+  Mstflint and the mflash lib support burning of this switch device.
+  mstregdump can dump InfiniScaleIV registers
+
+* Added hca_self_test.ofed tool to the package.
+  See file hca_self_test.readme included in the package for details.
+
+===============================================================================
+3. Major Bugs Fixed 
+===============================================================================
+
+* Fixed: Mstregdump on ConnectX devices cause the device to hang
+
+===============================================================================
+4. Known Issues
+===============================================================================
+
+