Merge branch 'client-hostfile' of git://github.com/bengland2/fio
authorJens Axboe <axboe@fb.com>
Thu, 7 May 2015 19:46:24 +0000 (13:46 -0600)
committerJens Axboe <axboe@fb.com>
Thu, 7 May 2015 19:46:24 +0000 (13:46 -0600)
1  2 
fio.1

diff --combined fio.1
index e54e419b2f5852733c7312a44defcf0345be7591,78f060590c6005187c4bea528f745a0b7b04e28a..e5451b1696f7a6b16754bf576a3531a8f81fd321
--- 1/fio.1
--- 2/fio.1
+++ b/fio.1
@@@ -93,7 -93,7 +93,7 @@@ Start a backend server, with \fIargs\f
  Background a fio server, writing the pid to the given pid file.
  .TP
  .BI \-\-client \fR=\fPhost
- Instead of running the jobs locally, send and run them on the given host.
+ Instead of running the jobs locally, send and run them on the given host or set of hosts.  See client/server section.
  .TP
  .BI \-\-idle\-prof \fR=\fPoption
  Report cpu idleness on a system or percpu basis (\fIoption\fP=system,percpu) or run unit work calibration only (\fIoption\fP=calibrate).
@@@ -1265,12 -1265,6 +1265,12 @@@ is to replay the IOPS onto the major/mi
  from.  Setting \fBreplay_redirect\fR causes all IOPS to be replayed onto the
  single specified device regardless of the device it was recorded from.
  .TP
 +.BI replay_align \fR=\fPint
 +Force alignment of IO offsets and lengths in a trace to this power of 2 value.
 +.TP
 +.BI replay_scale \fR=\fPint
 +Scale sector offsets down by this factor when replaying traces.
 +.TP
  .BI write_bw_log \fR=\fPstr
  If given, write a bandwidth log of the jobs in this job file. Can be used to
  store data of the bandwidth of the jobs in their lifetime. The included
@@@ -1911,8 -1905,35 +1911,35 @@@ to load a local file as well. This is d
  
  fio \-\-client=server \-\-remote-config /path/to/file.fio
  
- Then the fio serer will open this local (to the server) job file instead
+ Then fio will open this local (to the server) job file instead
  of being passed one from the client.
+ If you have many servers (example: 100 VMs/containers), you can input a pathname 
+ of a file containing host IPs/names as the parameter value for the \-\-client option.
+ For example, here is an example "host.list" file containing 2 hostnames:
+ host1.your.dns.domain
+ .br
+ host2.your.dns.domain
+ The fio command would then be:
+ fio \-\-client=host.list <job file>
+ In this mode, you cannot input server-specific parameters or job files, and all
+ servers receive the same job file.
+ In order to enable fio \-\-client runs utilizing a shared filesystem from multiple hosts,
+ fio \-\-client now prepends the IP address of the server to the filename. For example, 
+ if fio is using directory /mnt/nfs/fio and is writing filename fileio.tmp, 
+ with a \-\-client hostfile
+ containing two hostnames h1 and h2 with IP addresses 192.168.10.120 and 192.168.10.121, then
+ fio will create two files:
+ /mnt/nfs/fio/192.168.10.120.fileio.tmp
+ .br
+ /mnt/nfs/fio/192.168.10.121.fileio.tmp
  .SH AUTHORS
  
  .B fio