Running Hibernate Search with Elasticsearch on Pivotal CF

From local directory based index to Elasticsearch in no time
September 20, 2016 by Michael

This post has been featured on This Week in Spring – September 20, 2016 and on the Hibernate Community Newsletter 19/2016.

Two weeks ago, I wrote a post on how to use Hibernate Search with Spring Boot. The post got featured on the Hibernate community newsletter as well as on Thorbens blog Thoughts on Java.

I ended the the post saying that a downside for a fully cloud based application is the fact, that the default index provider is directory based.


There’s a solution for that, too: In upcoming Hibernate Search 5.6 there’s an integration with Elasticsearch.

I didn’t try this out with my Tweet Archive, but with the site of my JUG, which runs happily on Pivotal CF.


  • Use local, directory based Lucene index during development
  • Use Elastic Search integration when deployed to Pivotal CF (“The cloud”)

Steps taken

First of all, you have to add the dependencies

with hibernate-search.version being 5.6.0.Beta2 at the moment.

The annotations at entity level are exactly the same as in my previous post, but for your convince, here’s the post entity, which I wanted to make searchable:

Again, I have configured a language discriminator at entity level with @AnalyzerDiscriminator(impl = PostLanguageDiscriminator.class), but we come later to this.

To make Hibernate Search use the Elastic Search integration, you have to change the index manager. In a Spring Boot application this can be done by setting the following property: = elasticsearch

And that’s exactly all there is to switch from a directory based, local Lucene index to Elasticsearch. If you have a local instance running, for example in doctor, everything works as before, the indexing as well as the querying.

The default host is, but we’re not gonna use that in the cloud. Pivotal IO offers Searchly at their marketplace, providing Elastic Search. If you add this to your application, you’ll get the credentials via an URL. The endpoint then can be configured like this in Spring = ${}

Here I am making use of the fact that environment variables are evaluated in properties. The vcap property is automatically added by the Pivotal infrastructure and contains the mentioned secure URL. And that’s it. I have added a simple search by keyword method to my Post repository, but that I had already covered in my other post:

The actual frontend accessible through is nothing special, you can just browse the sources or drop me a line if you have any questions.

More interesting is the language discriminator for the posts. It looks like this:

It returns the name of the posts language. Elasticsearch offers build-in language specific analyzers, “english” and “german” are both available.

What, if I want to use a local index for testing and Elasticsearch only on deployment? I would have to define those analyzers in that profile. The right way to do it is a Hibernate @Factory like this:

and a containing =


To use Hibernate Search with your JPA entities, basically follow the steps described here.

If you want to use named Analyzers from Elastic Search, that aren’t available for locale Lucene, add analyzers with the same name (and maybe a similar functionality as well) through a Hibernate @Factory and configure them in If you’re at it, you may want to configure the index path into a directory which is excluded from your repo:

Relevant part of = ${user.dir}/var/default/index/ =

In your prod properties, or in my case, in switch from the default index manager to “elasticsearch” and also configure the endpoint:

Relevant part of = elasticsearch = ${} = MERGE

Happy searching and finding 🙂

One comment

  1. amir wrote:

    Do you know how i can config elastic search in java class ?
    like this:
    org.hibernate.cfg.Configuration configuration = new org.hibernate.cfg.Configuration();
    java.util.Properties settings = new java.util.Properties();
    settings.put(org.hibernate.cfg.Environment.DRIVER, “com.mysql.cj.jdbc.Driver”);
    settings.put(org.hibernate.cfg.Environment.URL, “jdbc:mysql://”);
    settings.put(org.hibernate.cfg.Environment.USER, “admin”);
    settings.put(org.hibernate.cfg.Environment.PASS, “admin”);
    settings.put(, “”);
    settings.put(, “YELLOW”);
    settings.put(, “CREATE”);
    settings.put(org.hibernate.cfg.Environment.PROVIDER, “org.hibernate.jpa.HibernatePersistenceProvider”);

    Posted on May 29, 2020 at 1:22 PM | Permalink
One Trackback/Pingback
  1. Java Web Weekly, Issue 143 | Baeldung on September 22, 2016 at 10:50 PM

    […] >> Running Hibernate Search with Elasticsearch on Pivotal CF [] […]

Post a Comment

Your email is never published. We need your name and email address only for verifying a legitimate comment. For more information, a copy of your saved data or a request to delete any data under this address, please send a short notice to from the address you used to comment on this entry.
By entering and submitting a comment, wether with or without name or email address, you'll agree that all data you have entered including your IP address will be checked and stored for a limited time by Automattic Inc., 60 29th Street #343, San Francisco, CA 94110-4929, USA. only for the purpose of avoiding spam. You can deny further storage of your data by sending an email to, with subject “Deletion of Data stored by Akismet”.
Required fields are marked *