summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorBen England <bengland@redhat.com>2015-05-07 15:33:40 -0400
committerBen England <bengland@redhat.com>2015-05-07 15:33:40 -0400
commit39b5f61e0c8f52c941e7eef4e97f417057150721 (patch)
tree3e993a0bcd6438115c2a2e03c4e24e78ac386063 /README
parent08633c32740c7b5b08dd057749f611d7f13b55a7 (diff)
downloadfio-39b5f61e0c8f52c941e7eef4e97f417057150721.tar.gz
fio-39b5f61e0c8f52c941e7eef4e97f417057150721.tar.bz2
document changes to --client syntax and behavior
Diffstat (limited to 'README')
-rw-r--r--README29
1 files changed, 27 insertions, 2 deletions
diff --git a/README b/README
index 18d1c4fc..3d8fcbff 100644
--- a/README
+++ b/README
@@ -172,7 +172,7 @@ $ fio
--warnings-fatal Fio parser warnings are fatal
--max-jobs Maximum number of threads/processes to support
--server=args Start backend server. See Client/Server section.
- --client=host Connect to specified backend.
+ --client=host Connect to specified backend(s).
--remote-config=file Tell fio server to load this local file
--idle-prof=option Report cpu idleness on a system or percpu basis
(option=system,percpu) or run unit work
@@ -311,9 +311,34 @@ to load a local file as well. This is done by using --remote-config:
fio --client=server --remote-config /path/to/file.fio
-Then the fio server 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
+host2.your.dns.domain
+
+The fio command would then be:
+
+fio --client=host.list <job file(s)>
+
+In this mode, you cannot input server-specific parameters or job files -- all
+servers receive the same job file.
+
+In order to let fio --client runs use 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
+ /mnt/nfs/fio/192.168.10.121.fileio.tmp
+
Platforms
---------