From: Tziporet Koren Date: Tue, 9 Dec 2008 15:10:27 +0000 (+0200) Subject: update for ofed 1.4 X-Git-Url: https://openfabrics.org/gitweb/?a=commitdiff_plain;h=dc92b1f9d4f5064ce7a42832b5341e631e83688e;p=compat-rdma%2Fdocs.git update for ofed 1.4 Signed-off-by: Oren Kladnitsky --- diff --git a/ibutils_release_notes.txt b/ibutils_release_notes.txt index 1487c07..1b53855 100755 --- a/ibutils_release_notes.txt +++ b/ibutils_release_notes.txt @@ -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 , 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 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 , 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 index 0000000..8f11333 --- /dev/null +++ b/mstflint_release_notes.txt @@ -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 +=============================================================================== + +