xref: /spdk/scripts/perf/nvme/README (revision e50cc5fd4552e8bc0dec2426bd8d9293ab19e22f)
1*cc439ec2SJohn KariukiThese scripts are used to perform benchmark testing with fio.
2*cc439ec2SJohn KariukiThe run_fio_test.py is the main script that runs the performance test and parses the test results.
3*cc439ec2SJohn KariukiUsers 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.
4*cc439ec2SJohn KariukiThe run_fio_test.py puts the test results in a csv file named <hostname>_<num ssds>_perf_output.csv.
5*cc439ec2SJohn KariukiThe run_fio_test.sh script demonstrates how to invoke the run_fio_test.py script with the
6*cc439ec2SJohn Kariukiinput parameters: path_to_fio_conf, path_to_ioengine and num_ssds. The run_fio_test.sh script will
7*cc439ec2SJohn Kariukicall the SPDK setup.sh script to unbind NVMe devices from the kernel driver and bind them to the uio driver.
8*cc439ec2SJohn KariukiWe include a sample fio configuration file that includes the parameters we use in our test environment.
9*cc439ec2SJohn KariukiThe run_fio_test.py will append the NVMe devices to the end of the configuration file. The number of
10*cc439ec2SJohn KariukiNVMe devices used is specified using the num_ssds parameter.
11*cc439ec2SJohn Kariuki
12*cc439ec2SJohn KariukiUsage: ./run_fio_test.sh
13