November 18, 2010 Engineering

0.13.0 Released

By Shay Banon

ElasticSearch version 0.13.0 has just been released. You can download it here. This release includes important bug fixes (most important one is a possible corruption in the index data) and some new features, including:

More Mapping Features

Support for a new IP (ipv4) type (that is automatically detected) allowing to do range queries (for example) on IP ranges. More enhancements to dynamic templates matching, a compression threshold on the source field, and an analyzer mapping field.

Explicit Shard Routing Control

Up until 0.13, documents were routed to the relevant shard based on their respective type and id values. In this version, they are not routed only by the id value by default (check the upgrade notes below), and they can be routed based on a custom value. This means that doing searches can be much faster when knowing in advance the list of routing values the search should executed on.

For example, when indexing a blog post as a single document, and a blog comment as another document, the comment document can be routed to the same shard as the blog post using the blog post id. This means that when wanting to search only on things relating to a specific blog post, only a single shard needs to be searched on and not all shards of that index.

This is very similar to the multi indices feature (and the ability to search on several of them), but provides a much higher control of routing within an index.

Improved Support for Large Number of Indices

Large number of indices now consume much less resources on the cluster as a whole, and a new API allowing to close and open an index has been added.

Many More Smaller Features

There are many more smaller features, with the list available here under the 0.13 tag.

Upgrade Notes

Two important nodes when upgrading to 0.13:

The first, due to the change in the default routing mechanism of routing only based on the id and not the type, existing systems upgrading to the new version must set the cluster.routing.operation.use_type to true in order to maintain the same hashing mechanism as in previous releases.

The second, the location of the index files have changed. It used to be stored under the “work” directory, but it has been moved to a new “data” directory. This means two things, if you are using the default, then rename the work directory under the installation to data. If was being explicitly set, change the setting to

This was done in order to simplify the management of files elasticsearch created. Now, there are three places where data is created: for index related data information, path.logs for the location of the logs, and for temporal data.