From adde7ea5333337427495a85a00cffe5a9cb10653 Mon Sep 17 00:00:00 2001 From: Alexey Marchuk Date: Tue, 8 Feb 2022 18:16:19 +0300 Subject: [PATCH] doc/nvmf: Update nvmf_create_transport example Some users refer to this document as an example of "gold" RDMA configuration. But some parameters of RDMA transport are not optimal for good performance, e.g. `-c 0` disables in-capsule data, that reduces IOPS of write operations with small payload; `-m 4` allows to have only 4 qpairs per controller, that doesn't allow to have more than 4 IO qpairs. This patch sets several parameters which are default for RDMA. Signed-off-by: Alexey Marchuk Reported-by: Mike Gerdts Change-Id: I118bb032eaf7f38e981d06ee312b36c7f0c8322a Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/11454 Tested-by: SPDK CI Jenkins Community-CI: Broadcom CI Reviewed-by: Shuhei Matsumoto Reviewed-by: Tomasz Zawadzki --- doc/nvmf.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/nvmf.md b/doc/nvmf.md index 34fecae58..b19fff19c 100644 --- a/doc/nvmf.md +++ b/doc/nvmf.md @@ -152,13 +152,13 @@ working with NVMe over Fabrics specific RPCs can be found on the @ref jsonrpc_co Start the nvmf_tgt application with elevated privileges. Once the target is started, the nvmf_create_transport rpc can be used to initialize a given transport. Below is an example where the target is started and configured with two different transports. -The RDMA transport is configured with an I/O unit size of 8192 bytes, 4 max qpairs per controller, -and an in capsule data size of 0 bytes. The TCP transport is configured with an I/O unit size of +The RDMA transport is configured with an I/O unit size of 8192 bytes, max I/O size 131072 and an +in capsule data size of 8192 bytes. The TCP transport is configured with an I/O unit size of 16384 bytes, 8 max qpairs per controller, and an in capsule data size of 8192 bytes. ~~~{.sh} build/bin/nvmf_tgt -scripts/rpc.py nvmf_create_transport -t RDMA -u 8192 -m 4 -c 0 +scripts/rpc.py nvmf_create_transport -t RDMA -u 8192 -i 131072 -c 8192 scripts/rpc.py nvmf_create_transport -t TCP -u 16384 -m 8 -c 8192 ~~~