Whamcloud - gitweb
i=isaac,b=18654:
[fs/lustre-release.git] / lnet / klnds / mxlnd / README
index eb79608..0acd0cd 100644 (file)
@@ -29,9 +29,12 @@ I. Installation
 ================
 
 MXLND is supported on Linux 2.6. It may be possible to run it on 2.4,
-but it has not been tested. MXLND requires Myricom's MX version 1.2.1
+but it has not been tested. MXLND requires Myricom's MX version 1.2.8
 or higher. See MX's README for the supported list of processors.
 
+MXLND requires the optional MX kernel library interface. MX must be compiled
+with --enable-kernel-lib.
+
 1. Configuring and compiling
 
 MXLND should be already integrated into the Lustre build process. To 
@@ -68,26 +71,9 @@ The available options are:
     board       index value of the Myrinet board (NIC)
     ep_id       MX endpoint ID
     polling     Use 0 to block (wait). A value > 0 will poll that many times before blocking
-    hosts       IP-to-hostname resolution file
-
-Of these, only hosts is required. It must be the absolute path to the
-MXLND hosts file. For example:
-
-    options kmxlnd hosts=/etc/hosts.mxlnd
-
-The file format for the hosts file is as follows:
-
-IP  HOST  BOARD   EP_ID
-
-The values must be space and/or tab separated where:
-
-    IP is a valid IPv4 address
-    HOST is the name returned by `hostname` on that machine
-    BOARD is the index of the Myricom NIC (0 for the first card, etc.)
-    EP_ID is the MX endpoint ID
 
-You may want to vary the remaining options to obtain the optimal performance
-for your platform.
+You may want to vary the options to obtain the optimal performance for your
+platform.
 
     n_waitd sets the number of threads that process completed MX requests
 (sends and receives). In our testing, the default of 1 performed best.
@@ -111,13 +97,13 @@ of the flow-control system in Lustre. Increasing this value may improve performa
 but it requires more memory since each message requires at least one page.
 
     board is the index of the Myricom NIC. Hosts can have multiple Myricom NICs
-and this identifies which one MXLND should use. This value must match the board
-value in your MXLND hosts file for this host.
+and this identifies which one MXLND should use.
 
     ep_id is the MX endpoint ID. Each process that uses MX is required to have at
 least one MX endpoint to access the MX library and NIC. The ID is a simple index
-starting at 0. This value must match the endpoint ID value in your MXLND hosts 
-file for this host.
+starting at 0. When used on a server, the server will attempt to use this end-
+point. When used on a client, it specifies the endpoint to connect to on the 
+management server.
 
     polling determines whether this host will poll or block for MX request com-
 pletions. A value of 0 blocks and any positive value will poll that many times