ivampiresp/Spdk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ae3a9b8f08
Spdk/examples/bdev/fio_plugin/README.md

69 lines
2.2 KiB
Markdown
Raw Normal View History

bdev: Add an example fio plugin Change-Id: I5e0ebb8d452a41ad848b319af9bb978546807d5e Signed-off-by: Ben Walker <benjamin.walker@intel.com> Reviewed-on: https://review.gerrithub.io/366495 Tested-by: SPDK Automated Test System <sys_sgsw@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
2017-06-06 17:24:07 +00:00
# Compiling fio
Clone the fio source repository from https://github.com/axboe/fio
git clone https://github.com/axboe/fio
doc/fio_plugin: remove fio version 3.3 reference Signed-off-by: John Kariuki <John.K.Kariuki@intel.com> Change-Id: I717084b7c08a10b8fd88cf2cdb1863ea4782dc7f Reviewed-on: https://review.gerrithub.io/c/spdk/spdk/+/463942 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2019-08-01 22:10:53 +00:00
cd fio
bdev: Add an example fio plugin Change-Id: I5e0ebb8d452a41ad848b319af9bb978546807d5e Signed-off-by: Ben Walker <benjamin.walker@intel.com> Reviewed-on: https://review.gerrithub.io/366495 Tested-by: SPDK Automated Test System <sys_sgsw@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
2017-06-06 17:24:07 +00:00
doc/fio_plugin: remove fio version 3.3 reference Signed-off-by: John Kariuki <John.K.Kariuki@intel.com> Change-Id: I717084b7c08a10b8fd88cf2cdb1863ea4782dc7f Reviewed-on: https://review.gerrithub.io/c/spdk/spdk/+/463942 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2019-08-01 22:10:53 +00:00
Compile the fio code and install:
bdev: Add an example fio plugin Change-Id: I5e0ebb8d452a41ad848b319af9bb978546807d5e Signed-off-by: Ben Walker <benjamin.walker@intel.com> Reviewed-on: https://review.gerrithub.io/366495 Tested-by: SPDK Automated Test System <sys_sgsw@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
2017-06-06 17:24:07 +00:00
make
doc/fio_plugin: remove fio version 3.3 reference Signed-off-by: John Kariuki <John.K.Kariuki@intel.com> Change-Id: I717084b7c08a10b8fd88cf2cdb1863ea4782dc7f Reviewed-on: https://review.gerrithub.io/c/spdk/spdk/+/463942 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2019-08-01 22:10:53 +00:00
make install
bdev: Add an example fio plugin Change-Id: I5e0ebb8d452a41ad848b319af9bb978546807d5e Signed-off-by: Ben Walker <benjamin.walker@intel.com> Reviewed-on: https://review.gerrithub.io/366495 Tested-by: SPDK Automated Test System <sys_sgsw@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
2017-06-06 17:24:07 +00:00
# Compiling SPDK
Clone the SPDK source repository from https://github.com/spdk/spdk
git clone https://github.com/spdk/spdk
doc/fio_plugin: remove fio version 3.3 reference Signed-off-by: John Kariuki <John.K.Kariuki@intel.com> Change-Id: I717084b7c08a10b8fd88cf2cdb1863ea4782dc7f Reviewed-on: https://review.gerrithub.io/c/spdk/spdk/+/463942 Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com>
2019-08-01 22:10:53 +00:00
cd spdk
bdev: Add an example fio plugin Change-Id: I5e0ebb8d452a41ad848b319af9bb978546807d5e Signed-off-by: Ben Walker <benjamin.walker@intel.com> Reviewed-on: https://review.gerrithub.io/366495 Tested-by: SPDK Automated Test System <sys_sgsw@intel.com> Reviewed-by: Jim Harris <james.r.harris@intel.com> Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
2017-06-06 17:24:07 +00:00
git submodule update --init
Then, run the SPDK configure script to enable fio (point it to the root of the fio repository):
cd spdk
./configure --with-fio=/path/to/fio/repo <other configuration options>
Finally, build SPDK:
make
**Note to advanced users**: These steps assume you're using the DPDK submodule. If you are using your
own version of DPDK, the fio plugin requires that DPDK be compiled with -fPIC. You can compile DPDK
with -fPIC by modifying your DPDK configuration file and adding the line:
EXTRA_CFLAGS=-fPIC
# Usage
To use the SPDK fio plugin with fio, specify the plugin binary using LD_PRELOAD when running
fio and set ioengine=spdk_bdev in the fio configuration file (see example_config.fio in the same
directory as this README).
LD_PRELOAD=<path to spdk repo>/examples/bdev/fio_plugin/fio_plugin fio
The fio configuration file must contain one new parameter:
spdk_conf=./examples/bdev/fio_plugin/bdev.conf
This must point at an SPDK configuration file. There are a number of example configuration
files in the SPDK repository under etc/spdk.
You can specify which block device to run against by setting the filename parameter
to the block device name:
filename=Malloc0
Or for NVMe devices:
filename=Nvme0n1
Currently the SPDK fio plugin is limited to the thread usage model, so fio jobs must also specify thread=1
when using the SPDK fio plugin.
fio also currently has a race condition on shutdown if dynamically loading the ioengine by specifying the
engine's full path via the ioengine parameter - LD_PRELOAD is recommended to avoid this race condition.
When testing random workloads, it is recommended to set norandommap=1. fio's random map
processing consumes extra CPU cycles which will degrade performance over time with
the fio_plugin since all I/O are submitted and completed on a single CPU core.
Reference in New Issue Copy Permalink