# Rally 0.4.7 released

**URL:** <https://discuss.elastic.co/t/rally-0-4-7-released/71060>\
**Category:** Announcements\
**Created:** [January 10, 2017, 10:24am UTC](https://discuss.elastic.co/t/rally-0-4-7-released/71060 "2017-01-10T10:24:54Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![danielmitterdorfer](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/danielmitterdorfer/32/110510_2.png) [@danielmitterdorfer](https://discuss.elastic.co/u/danielmitterdorfer)\
**Post date:** [January 10, 2017, 10:24am UTC](https://discuss.elastic.co/t/rally-0-4-7-released/71060/1 "2017-01-10T10:24:54Z")

</div>

We've just released Rally 0.4.7.

## How to...?

- ... upgrade: `pip3 install --upgrade esrally`
- ... install: `pip3 install esrally`

Note: Depending on your system setup you probably need to prepend these commands with `sudo`.

Please follow the [quickstart](https://esrally.readthedocs.io/en/stable/quickstart.html) for a first time install though.

### Changes

- We have added a [reference documentation that explains every element of a track](http://esrally.readthedocs.io/en/stable/track.html)
- You can now [define meta-data on different levels of track](http://esrally.readthedocs.io/en/stable/track.html#meta) which will then be added as meta-data to your metrics record (this is only relevant if you use the Elasticsearch metrics store).
- Several usability improvements such as better error messages in some cases

The [changelog](https://github.com/elastic/rally/milestone/21?closed=1) contains the complete list of changes.

All users are recommended to upgrade to this version.

### Deprecations

Note: This is only relevant if you [define your own tracks](http://esrally.readthedocs.io/en/current/adding_tracks.html).

As you can now [define meta-data in tracks](https://github.com/elastic/rally/issues/183), the track format changes slightly. Previously, you specified the properties `description`, `short-description` and `data-url` in a `meta` element. You need to define these properties now on the top-level structure of a track.

Before (now deprecated):

```auto
{
    "meta": {
        "description": "This is an example track that ....",
        "short-description": "Example track",
        "data-url": "https://example.org/corpora/example-track"
    }
}

```

You should change this to:

```auto
{
    "description": "This is an example track that ....",
    "short-description": "Example track",
    "data-url": "https://example.org/corpora/example-track"
}

```

Rally will also issue warnings if you run an affected track, e.g.:

```auto
Track 'my-custom-track' uses deprecated syntax: The element 'description' is contained in a meta-block. Please move this element to the top-level.
Track 'my-custom-track' uses deprecated syntax: The element 'short-description' is contained in a meta-block. Please move this element to the top-level.

```

### Breaking Changes

We will remove the "tiny" track next week as it was never meant as a proper track but only for integration testing in Rally. As a reminder, it is possible to run any track with the flag `--test-mode`, e.g.:

```auto
esrally --distribution-version=5.0.0 --track=geonames --test-mode

```

This mode is experimental and at the moment only meant for development. Hence it is (intentionally) not well documented. Should you develop your own tracks and be interested in it, please create a discussion topic and we'll see how to proceed based on your interest.

## What's next?

We are currently working hard on [remote-provisioning of single node Elasticsearch instances](https://github.com/elastic/rally/issues/184) which will be released in the next planned release 0.5.0. After that we will [expand remote provisioning capabilities to multi-node clusters](https://github.com/elastic/rally/issues/71).

## Questions and Feedback

If you have questions or feedback, please just post in the [Rally forum](https://discuss.elastic.co/c/elasticsearch/rally).

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [July 5, 2017, 9:46pm UTC](https://discuss.elastic.co/t/rally-0-4-7-released/71060/2 "2017-07-05T21:46:46Z")

</div>