[Pkg-ofed-commits] r484 - /trunk/howto/infiniband-howto.sgml

[gmpc-guest at alioth.debian.org]

Author: gmpc-guest
Date: Tue Oct 13 14:08:01 2009
New Revision: 484

URL: http://svn.debian.org/wsvn/pkg-ofed/?sc=1&rev=484
Log:
Add entries to the troubleshooting section

Modified:
    trunk/howto/infiniband-howto.sgml

Modified: trunk/howto/infiniband-howto.sgml
URL: http://svn.debian.org/wsvn/pkg-ofed/trunk/howto/infiniband-howto.sgml?rev=484&op=diff
==============================================================================
--- trunk/howto/infiniband-howto.sgml (original)
+++ trunk/howto/infiniband-howto.sgml Tue Oct 13 14:08:01 2009
@@ -889,14 +889,62 @@
 </tscreen>
 
 
-<sect>Network Troubleshooting
-<p>
-<sect1>ibdiagnet
+<sect>Troubleshooting
+<p>
+This section covers general troubleshooting and commonly reported problems.
+<sect1>Genernal fabric troubleshooting
 <p>
 The ibdiagnet program can be used to troubleshoot potential issues with your infiniband fabric.
-
 <tscreen>
 ibdiagnet -r
+</tscreen>
+
+<sect1>ib_query_gid() failed errors on mlx4 platforms.
+<p>
+ibstat or opensm hangs and the following kernel messages are printed:
+
+<tscreen>
+<verb>
+kernel: [   78.170077] ib0: ib_query_gid() failed
+kernel: [   89.272789] ib0: ib_query_port failed
+</verb>
+</tscreen>
+
+Fix: Load the mlx4_core module with the msi_x=0 option.
+
+<tscreen>
+<verb>
+cat > /etc/modprobe.d/mlx4_core <<EOF
+options mlx4_core msi_x=0
+EOF
+
+update-initramfs -u
+
+</verb>
+</tscreen>
+
+<sect1>Missing XRC support
+<p>
+If you see error messages pertaining to missing support for XRC, it means you have mis-matched kernel modules and userspace libraries.
+<tscreen>
+<verb>
+mlx4: There is a mismatch between the kernel and the userspace  
+libraries: Kernel does not support XRC. Exiting.
+</verb>
+</tscreen>
+Fix: Make sure that you build and install the OFED kernel modules as described in section X.
+
+
+<sect>Tips and Tricks
+<p>
+This section details an assortment of miscellaneous tips.
+<sect1>Descriptive node names
+<p>
+You can give your hosts descriptive names by echoing text to the following file:
+<tscreen>
+<verb>
+echo `uname -n` > /sys/class/infiniband/&lt;driver&gt;/node_desc
+</verb>
 </tscreen>
 
 <sect>Further Information