]> git.openfabrics.org - ~tnikolova/docs/.git/commitdiff
more updated for 1.4.1
authorTziporet Koren <tziporet@mellanox.co.il>
Sun, 10 May 2009 14:13:19 +0000 (17:13 +0300)
committerTziporet Koren <tziporet@mellanox.co.il>
Sun, 10 May 2009 14:13:19 +0000 (17:13 +0300)
Signed-off-by: Tziporet Koren <tziporet@mellanox.co.il>
OFED_release_notes.txt
ipoib_release_notes.txt
mlx4_release_notes.txt

index 87be635aa0228f0b0d446938d5cecc9a27b7a572..9b1d2a2acaaf175b680c6efebca1ec1fb55f044d 100644 (file)
@@ -282,6 +282,13 @@ components of the OFED 1.4 release.
           echo "%__arch_install_post %{nil}" >> /root/.rpmmacros 
 7. IPoIB: brctl utilities do not work on IPoIB interfaces. The reason for that
    is that these utilities support devices of type Ethernet only.
+8.  "openibd stop" can sometime fail with the error: 
+        Unloading ib_cm                                            [FAILED]
+        ERROR: Module ib_cm is in use by ib_ipoib 
+    Workaround: run "openibd stop" again.
+9.  When working with ISCSI over IPoIB or mlx4_en, you must disable LRO (even
+    if IPoIB is set to connected mode). This is because there is a bug in older
+    kernels which causes a kernel panic.
 
 
 Note: See the release notes of each component for additional issues.
index 295be48f3669a7ca497d8e4feff06bc13d0cc8d1..03b7757007e76e6637d83865ab67a7016a5803ba 100644 (file)
@@ -163,36 +163,82 @@ Usage and configuration:
     connected mode). This is because there is a bug in older kernels which causes
     a kernel panic.
 
+14. IPoIB datagram mode initial packet loss (bug #1287): When the datagram test
+    gets to packet size 8192 and larger it always loose the first packet in the 
+    sequence. 
+    Workaround: Increase the number of pending skb's before a neighbor is
+    resolved (default is 3). This value can be changed with:
+    sysctl net.ipv4.neigh.ib0.unres_qlen.
 
     
 ===============================================================================
-4. DHCP Support of IPoIB
+4. IPoIB Configuration Based on DHCP
 ===============================================================================
-Note: To use DHCP the user must apply a special patch (see "DHCP Notes" below).
-
-DHCP Supported Operating Systems
---------------------------------
-1. SLES 10
-2. RHEL 5
-3. All kernels from 2.6.14 and up
-
-DHCP Unsupported Operating Systems
-----------------------------------
-RedHat EL 4 distributions are supported.
-
-
-DHCP Notes
-----------
-1. It may be required to run over different UDP ports than the well known ports
-   (67 and 68). Free port numbers greater than 0x8000 must be chosen. To
-   specify a server or a client port number, use the option -p <port number>.
-   The client's port number must be the chosen server's port number plus one.
-
-2. For IPoIB to use DHCP, you must patch ISC's DHCP. The patch file can be
-   found under OFED-1.3/docs/dhcp after extracting the distribution file.
-   (After installation it can also be found under <prefix>/docs/dhcp.) The
-   patch should be applied for the server and for each client. Tests were run
-   on version 3.0.4 of the DHCP package.
+
+Setting an IPoIB interface configuration based on DHCP (v3.1.2 which is available 
+via www.isc.org) is performed similarly to the configuration of Ethernet 
+interfaces. In other words, you need to make sure that IPoIB configuration files 
+include the following line:
+       For RedHat:
+       BOOTPROTO=dhcp
+       For SLES:
+       BOOTPROTO=dchp
+Note: If IPoIB configuration files are included, ifcfg-ib<n> files will be 
+installed under:
+/etc/sysconfig/network-scripts/ on a RedHat machine
+/etc/sysconfig/network/ on a SuSE machine
+
+Note: A patch for DHCP is required for supporting IPoIB. The patch file for 
+DHCP v3.1.2, dhcp.patch, is available under the docs/ directory.
+
+Standard DHCP fields holding MAC addresses are not large enough to contain an 
+IPoIB hardware address. To overcome this problem, DHCP over InfiniBand messages 
+convey a client identifier field used to identify the DHCP session. This client
+identifier field can be used to associate an IP address with a client identifier 
+value, such that the DHCP server will grant the same IP address to any client 
+that conveys this client identifier.
+
+Note: Refer to the DHCP documentation for more details how to make this 
+association.
+
+The length of the client identifier field is not fixed in the specification. 
+
+4.1 DHCP Server
+In order for the DHCP server to provide configuration records for clients, an 
+appropriate configuration file needs to be created. By default, the DHCP server 
+looks for a configuration file called dhcpd.conf under /etc. You can either edit
+this file or create a new one and provide its full path to the DHCP server using
+the -cf flag. See a file example at docs/dhcpd.conf of this package.
+The DHCP server must run on a machine which has loaded the IPoIB module.
+
+To run the DHCP server from the command line, enter:
+dhcpd <IB network interface name> -d
+Example:
+host1# dhcpd ib0 -d
+
+4.2 DHCP Client (Optional)
+
+Note: A DHCP client can be used if you need to prepare a diskless machine with 
+an IB driver. 
+In order to use a DHCP client identifier, you need to first create a 
+configuration file that defines the DHCP client identifier. Then run the DHCP 
+client with this file using the following command:
+dhclient cf <client conf file> <IB network interface name>
+Example of a configuration file for the ConnectX (PCI Device ID 25418), called 
+dhclient.conf:
+# The value indicates a hexadecimal number
+interface "ib1" {
+send dhcp-client-identifier 00:02:c9:03:00:00:10:39;
+}
+Example of a configuration file for InfiniHost III Ex (PCI Device ID 25218), called
+dhclient.conf:
+# The value indicates a hexadecimal number
+interface "ib1" {
+send dhcp-client-identifier 20:00:55:04:01:fe:80:00:00:00:00:00:00:00:02:c9:02:00:23:13:92;
+}
+
+In order to use the configuration file, run:
+host1# dhclient cf dhclient.conf ib1
 
 
 ===============================================================================
index 9527c7c52b54e0726735f651749078e87cd2f06a..79755409a5f684ca678dfe023ae75d0fc72336d6 100644 (file)
@@ -143,6 +143,8 @@ Non FW dependent features:
 - Do not enable blueflame sends if write combining is not available  
 - Add write combining support for for PPC64, and thus enable blueflame sends.
 - Unregister IB device before executing CLOSE_PORT.
+- Notify and exit if the kernel module used does not support XRC. This is done 
+  to avoid libmlx4 compatibility problem.
 
 ===============================================================================
 6. Eth (mlx4_en) new features and bug fixes since OFED 1.4
@@ -166,6 +168,25 @@ Non FW dependent features:
        log2_uar_bar_megabytes = 5
   2. Burn a modified firmware image with the changed INI file.
   3. Reboot the system.
+- Ethernet in MLNX_OFED 1.4 is not supported for the following OPNs:
+    MHQH29-XTC
+    MHGH29-XTC
+    MHGH29-XSC
+    MHGH28-XTC
+    MHGH28-XTC
+    MHGH28-XSC
+    MHGH28-XSC
+    MHEH28-XTC
+    MHEH28-XSC
+    MHQH19-XTC
+
+    Attempting to use these cards as NICs will yield the following error
+    in /var/log/messages:
+    mlx4_core 0000:0d:00.0: command 0x9 failed: fw status = 0x8
+    <date & time> mtlx008 kernel: mlx4_en 0000:0d:00.0: Failed Initializing port
+    <date & time> mtlx008 kernel: mlx4_en 0000:0d:00.0: Failed starting port:1
+
+    As a workaround, use the MLNX_EN driver instead of OFED for Linux.
 
      
 ===============================================================================