diff --git a/docs/adding_tracks.rst b/docs/adding_tracks.rst index daa915be8..f2e8df9bb 100644 --- a/docs/adding_tracks.rst +++ b/docs/adding_tracks.rst @@ -672,7 +672,7 @@ If you use this idiom you can refer to the ``clients`` variable inside your snip Sharing your track with others ------------------------------ -So far the track is only available on your local machine. To share your track you could check it into version control. To avoid committing the potentially huge data file you can expose it via http (e.g. via an S3 bucket) and reference it in your track with the property ``base-url``. Rally expects that the URL points to the parent path and appends the document file name automatically. +So far the track is only available on your local machine. To share your track you could check it into version control. To avoid committing the potentially huge data file you can expose it via HTTP (e.g. via a cloud bucket) and reference it in your track with the property ``base-url``. Rally expects that the URL points to the parent path and appends the document file name automatically. You should also compress your document corpus to save network bandwidth; `pbzip2 `_ works well, is backwards compatible with ``bzip2`` and makes use of all available cpu cores for compression and decompression. You can create a compressed archive with the following command:: diff --git a/docs/configuration.rst b/docs/configuration.rst index e0f75d712..28d77960e 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -137,7 +137,7 @@ Rally downloads all necessary data automatically for you: * Elasticsearch distributions from elastic.co if you specify ``--distribution-version=SOME_VERSION_NUMBER`` * Elasticsearch source code from Github if you specify a revision number e.g. ``--revision=952097b`` * Track meta-data from Github -* Track data from an S3 bucket +* Track data from a cloud bucket Hence, it needs to connect via http(s) to the outside world. If you are behind a corporate proxy you need to configure Rally and git. As many other Unix programs, Rally relies that the proxy URL is available in the environment variables ``http_proxy`` (lowercase only), ``https_proxy`` or ``HTTPS_PROXY``, ``all_proxy`` or ``ALL_PROXY``. Hence, you should add this line to your shell profile, e.g. ``~/.bash_profile``:: diff --git a/docs/faq.rst b/docs/faq.rst index fd84f7f12..503470823 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -18,7 +18,7 @@ By that you are mimicking what Rally does. Fix any errors that show up here and Where does Rally get the benchmark data from? --------------------------------------------- -Rally comes with a set of tracks out of the box which we maintain in the `rally-tracks repository on Github `_. This repository contains the track descriptions. The actual data are stored as compressed files in an S3 bucket. +Rally comes with a set of tracks out of the box which we maintain in the `rally-tracks repository on Github `_. This repository contains the track descriptions. The actual data are stored as compressed files in a cloud bucket. Each track is documented in README files, including parameters and example data. Will Rally destroy my existing indices? --------------------------------------- diff --git a/docs/race.rst b/docs/race.rst index f67c67899..6a61adc84 100644 --- a/docs/race.rst +++ b/docs/race.rst @@ -32,7 +32,7 @@ This will show the following list:: pmc Full text benchmark with academic papers from PMC 574,199 5.5 GB 21.7 GB append-no-conflicts append-no-conflicts,append-no-conflicts-index-only,append-sorted-no-conflicts,append-fast-with-conflicts,indexing-querying so Indexing benchmark using up to questions and answers from StackOverflow 36,062,278 8.9 GB 33.1 GB append-no-conflicts append-no-conflicts -The first two columns show the name and a description of each track. A track also specifies one or more challenges which describe the workload to run. +The first two columns show the name and a description of each track. A track also specifies one or more challenges which describe the workload to run. To get more details about a given track, `refer to the README files in the rally-tracks repository `_. Starting a Race ---------------