admin-guide/nfs/nfs-rdma.rst

2 Setting up NFS/RDMA
14 This document describes how to install and setup the Linux NFS/RDMA client
17 The NFS/RDMA client was first included in Linux 2.6.24. The NFS/RDMA server
23 RDMA adapters.
29 nfs-rdma-devel@lists.sourceforge.net mailing list.
35 use with NFS/RDMA.
37 - Install an RDMA device
46   The first kernel release to contain both the NFS/RDMA client and server was
55   An NFS/RDMA mount point can be obtained by using the mount.nfs command in
57   version with support for NFS/RDMA mounts, but for various reasons we
73   these to create an NFS/RDMA enabled mount command), the installation
105 - Install a Linux kernel with NFS/RDMA
107   The NFS/RDMA client and server are both included in the mainline Linux
113 - Configure the RDMA stack
115   Make sure your kernel configuration has RDMA support enabled. Under
118   InfiniBand support is required for all RDMA devices (IB, iWARP, etc.)].
133   The NFS/RDMA code will be enabled automatically if NFS and RDMA
134   are turned on. The NFS/RDMA client and server are configured via the hidden
138     #. N if either SUNRPC or INFINIBAND are N, in this case the NFS/RDMA client
142        in this case the NFS/RDMA client and server will be built as modules
144     #. Y if both SUNRPC and INFINIBAND are Y, in this case the NFS/RDMA client
147   Therefore, if you have followed the steps above and turned no NFS and RDMA,
148   the NFS/RDMA client and server will be built.
152 Check RDMA and NFS Setup
155 Before configuring the NFS/RDMA software, it is a good idea to test
157 In particular, it is a good idea to verify that the RDMA stack
161 - Check RDMA Setup
163   If you built the RDMA components as modules, load them at
205 NFS/RDMA Setup
214 - On the server system, configure the /etc/exports file and start the NFS/RDMA server.
225     The "insecure" option must be used because the NFS/RDMA client does
231 - Load and configure the RDMA drivers
247   If the NFS/RDMA server was built as a module (CONFIG_SUNRPC_XPRT_RDMA=m in
248   kernel config), load the RDMA transport module:
267   Instruct the server to listen on the RDMA transport:
271     $ echo rdma 20049 > /proc/fs/nfsd/portlist
275   If the NFS/RDMA client was built as a module (CONFIG_SUNRPC_XPRT_RDMA=m in
276   kernel config), load the RDMA client module:
283   command to mount the NFS/RDMA server:
287     $ mount -o rdma,port=20049 <IPoIB-server-name-or-address>:/<export> /mnt
289   To verify that the mount is using RDMA, run "cat /proc/mounts" and check
292   Congratulations! You're using NFS/RDMA!