4 Ceph uses the fio workload generator and benchmarking utility.
6 To fetch the fio sources:
8 git clone git://git.kernel.dk/fio.git
18 The fio engine for rbd is located in the fio tree itself, so you'll need to
21 If you install the ceph libraries to a location that isn't in your
22 LD_LIBRARY_PATH, be sure to add it:
24 export LD_LIBRARY_PATH=/path/to/install/lib
26 To build fio with rbd:
28 ./configure --extra-cflags="-I/path/to/install/include -L/path/to/install/lib"
31 If configure fails with "Rados Block Device engine no", see config.log for
32 details and adjust the cflags as necessary.
34 To view the fio options specific to the rbd engine:
38 See examples/rbd.fio for an example job file. To run:
40 ./fio examples/rbd.fio
45 This fio engine allows you to mount and use a ceph object store directly,
46 without having to build a ceph cluster or start any daemons.
48 Because the ObjectStore is not a public-facing interface, we build it inside
49 of the ceph tree and load libfio_ceph_objectstore.so into fio as an external
52 To build fio_ceph_objectstore:
54 mkdir build && cd build
55 cmake -DWITH_FIO=ON -DFIO_INCLUDE_DIR=/path/to/fio -DCMAKE_BUILD_TYPE=Release /path/to/ceph
56 make -C src/test/fio install
58 If you install the ceph libraries to a location that isn't in your
59 LD_LIBRARY_PATH, be sure to add it:
61 export LD_LIBRARY_PATH=/path/to/install/lib
63 To view the fio options specific to the objectstore engine:
65 ./fio --enghelp=libfio_ceph_objectstore.so
67 The conf= option requires a ceph configuration file (ceph.conf). Example job
68 and conf files for each object store are provided in the same directory as
73 ./fio /path/to/job.fio