aboutsummaryrefslogtreecommitdiffstats
path: root/fbench/README
diff options
context:
space:
mode:
authorArnstein Ressem <aressem@verizonmedia.com>2019-07-25 11:46:19 +0200
committerArnstein Ressem <aressem@verizonmedia.com>2019-07-25 11:46:19 +0200
commit09922ca364a3ff6554cf0d0156c3070f9c0ac3c1 (patch)
treef4379b158f173c1c08d39486bdb518f487a3ef25 /fbench/README
parent4cb1e740cf4f1d771f42b147c5e798f8a5937a1f (diff)
Update vespa-fbench install doc.
Diffstat (limited to 'fbench/README')
-rw-r--r--fbench/README47
1 files changed, 29 insertions, 18 deletions
diff --git a/fbench/README b/fbench/README
index 6627786edfb..5d9ee714a32 100644
--- a/fbench/README
+++ b/fbench/README
@@ -5,24 +5,35 @@ vespa-fbench - fastserver benchmarking program
1 Installing vespa-fbench
-------------------------
-The preferred way of running vespa-fbench is to create your own test
-directory where you place all fbench executables and prepare test
-files. If you have access to the fbench source, you may consult the
-'INSTALL' file for information on how to install fbench. If you have a
-pre-compiled distribution of fbench, simply extract the archive. The
-fbench install directory should contain the following set of files:
-
- README
- bin/vespa-fbench
- bin/vespa-fbench-filter-file
- bin/vespa-fbench-geturl
- bin/plot.pl
- bin/pretest.sh
- bin/vespa-fbench-result-filter.pl
- bin/runtests.sh
- bin/separate.pl
- bin/vespa-fbench-split-file
-
+vespa-fbench is distributed together with Vespa in the published RPM
+and Docker image. Using the pre-built vespa-fbench is preferred, but
+if you have to compile it yourself consult the README.md in
+https://github.com/vespa-engine/vespa.
+
+Installing on Vespa CentOS / RHEL 7:
+ yum-config-manager --add-repo \
+ https://copr.fedorainfracloud.org/coprs/g/vespa/vespa/repo/epel-7/group_vespa-vespa-epel-7.repo
+ yum -y install epel-release centos-release-scl
+ yum -y install vespa
+
+The above installation provides the follwing vespa-fbench executables:
+ /opt/vespa/bin/vespa-fbench
+ /opt/vespa/bin/vespa-fbench-filter-file
+ /opt/vespa/bin/vespa-fbench-geturl
+ /opt/vespa/bin/vespa-fbench-result-filter.pl
+ /opt/vespa/bin/vespa-fbench-split-file
+
+Additional utilities referenced in this document can be fetched from
+https://github.com/vespa-engine/vespa/tree/master/fbench/util:
+ plot.pl
+ pretest.sh
+ runtests.sh
+ separate.pl
+
+It is also possible to use Docker to directly execute vespa-fbench by
+using the pre-built Vespa docker image:
+ docker run --entrypoint /opt/vespa/bin/vespa-fbench \
+ docker.io/vespaengine/vespa <your fbench options>
2 Benchmark overview
--------------------