xref: /spdk/scripts/perf/nvme/README (revision b30d57cdad6d2bc75cc1e4e2ebbcebcb0d98dcfa)
1These scripts are used to perform benchmark testing with fio.
2The run_fio_test.py is the main script that runs the performance test and parses the test results.
3Users can populate test parameters for different fio workloads in the lists (q_depth, io_size, workload_type, mix, core_mask and run_time) at the top of the run_fio_test.py script.
4The run_fio_test.py puts the test results in a csv file named <hostname>_<num ssds>_perf_output.csv.
5The run_fio_test.sh script demonstrates how to invoke the run_fio_test.py script with the
6input parameters: path_to_fio_conf, path_to_ioengine and num_ssds. The run_fio_test.sh script will
7call the SPDK setup.sh script to unbind NVMe devices from the kernel driver and bind them to the uio driver.
8We include a sample fio configuration file that includes the parameters we use in our test environment.
9The run_fio_test.py will append the NVMe devices to the end of the configuration file. The number of
10NVMe devices used is specified using the num_ssds parameter.
11
12Usage: ./run_fio_test.sh
13