Hibernate Search 7.0 is in limited support mode:
We recommend that you upgrade to a newer series if possible or look for paid support. See also the Maintenance policy. |
Compatibility
Java | 11, 17 or 21 |
Hibernate ORM | 6.4 |
Elasticsearch server | 7.10 - 8.12 |
OpenSearch server | 1.3 - 2.11 |
Apache Lucene | 9.8 |
Not compatible with your requirements? Have a look at the other series.
See also the Compatibility policy and Maintenance policy.
Documentation
Documentation for Hibernate Search 7.0 can be accessed through the links below:
You can find more documentation for all series on the documentation page.
How to get it
Hibernate Search 7.0 is in limited maintenance mode: we recommend that you upgrade to a newer series if possible or look for paid support. See also the Maintenance policy. |
More information about specific releases (announcements, download links) can be found here.
Getting started
Hibernate Search 7.0 is in limited maintenance mode: we recommend that you upgrade to a newer series if possible or look for paid support. See also the Maintenance policy. |
If you want to start using Hibernate Search 7.0, please refer to the getting started guide:
Migrating
If you need to upgrade from a previous series, please refer to the migration guide:
What's new
Latest release announcement (2024-04-10): 7.0.1.Final.
A detailed list of new features, improvements and fixes in this series can be found on our issue tracker.
Dependency upgrades
- Java
-
Hibernate Search is now using JDK 11 as a baseline and can work on JDK 11, 17 or 21. Compatibility with JDK 8 was dropped.
- Hibernate ORM
-
Hibernate Search now depends on Hibernate ORM 6.4 as it fully switched to Jakarta EE. There are no
-orm6
/-jakarta
artifacts or Java EE compatibility anymore.
- Lucene
-
The Lucene backend now uses Lucene 9.8. Upgrading requires reindexing, see the migration guide for details.
- Elasticsearch
-
The Elasticsearch backend works with Elasticsearch 8.10/8.11/8.12 as well as other versions that were already compatible — except for the following versions whose compatibility was dropped, because they already reached their end of life:
-
5.x/6.x
-
7.0-7.9
-
- OpenSearch
-
The Elasticsearch backend works with OpenSearch 2.10 and 2.11 as well as other versions that were already compatible — except for versions 1.0, 1.1 and 1.2 whose compatibility was dropped, because they already reached their end of life.
Hibernate Search BOM
Hibernate Search now offers a BOM providing dependency management for all of its published artifacts. It can be imported as part of your dependency management to keep the versions of Hibernate Search artifacts aligned:
<dependencyManagement>
<dependencies>
<!-- Import Hibernate Search BOM to get all of its artifact versions aligned: -->
<dependency>
<groupId>org.hibernate.search</groupId>
<artifactId>hibernate-search-bom</artifactId>
<version>7.0.1.Final</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- Any other dependency management entries -->
</dependencies>
</dependencyManagement>
<!-- ... -->
<dependencies>
<!-- Declare dependencies -->
<dependency>
<groupId>org.hibernate.search</groupId>
<artifactId>hibernate-search-mapper-orm</artifactId>
<!-- The version is managed by the BOM above -->
</dependency>
<dependency>
<groupId>org.hibernate.search</groupId>
<artifactId>hibernate-search-backend-elasticsearch</artifactId>
<!-- The version is managed by the BOM above -->
</dependency>
<!-- Any other dependency entries -->
</dependencies>
Amazon OpenSearch Serverless experimental compatibility
Hibernate Search now has incubating compatibility with Amazon OpenSearch Serverless.
Amazon OpenSearch Serverless has certain limitations compared to a regular OpenSearch cluster and may not support all operations a regular cluster does. Compatibility with Amazon OpenSearch Serverless must be enabled explicitly by setting the backend version property:
hibernate.search.backend.version=amazon-opensearch-serverless
See this section of the reference documentation for more information, in particular about limitations.
Compatibility with Hibernate ORM’s discriminator-based multi-tenancy
Hibernate Search can now index Hibernate ORM entities
that take advantage of
discriminator-based multi-tenancy in the database (@TenandId
).
Maven artifact renamings
Some Hibernate Search Maven artifacts have been renamed:
-
Maven artifacts related to JSR-352 artifacts were renamed to reflect the move to the Jakarta EE specification:
-
hibernate-search-mapper-orm-batch-jsr352-core
was renamed tohibernate-search-mapper-orm-jakarta-batch-core
. -
hibernate-search-mapper-orm-batch-jsr352-jberet
was renamed tohibernate-search-mapper-orm-jakarta-batch-jberet
.
-
-
The artifact
hibernate-search-mapper-orm-coordination-outbox-polling
was renamed tohibernate-search-mapper-orm-outbox-polling
.
Development versions (SNAPSHOTS)
The latest development versions of Maven artifacts for Hibernate Search are published to the OSSRH snapshots repository.
You should only need those (unstable) versions for testing recently merged patches, and should never use them in production.
To consume these artifacts, you may need to configure your build tool to fetch artifacts
from
https://oss.sonatype.org/content/repositories/snapshots
and to enable snapshots:
Releases in this series
Hibernate Search 7.0 is in limited maintenance mode: we recommend that you upgrade to a newer series if possible or look for paid support. See also the Maintenance policy. |
Compatibility with Elasticsearch 8.12, a few fixes and documentation updates.
Maven artifacts Download Resolved issues Release announcement
One bugfix; otherwise identical to 7.0.0.CR2.
Maven artifacts Download Resolved issues Release announcement
Compatibility with Elasticsearch 8.11, upgrade to Hibernate ORM 6.4.0.Final, other bugfixes and improvements
Maven artifacts Download Resolved issues Release announcement
Compatibility with Hibernate ORM’s discriminator-based multi-tenancy, compatibility with Elasticsearch 8.10 and OpenSearch 2.9/2.10/2.11, dropped compatibility with EOL’d Elasticsearch versions 7.0-7.9 and OpenSearch versions 1.0-1.2, upgrade to Hibernate ORM 6.3.1.Final, upgrade to Lucene 9.8, some Maven artifact renamings, other bugfixes and improvements
Maven artifacts Download Resolved issues Release announcement
JDK 11 as a baseline, switch to Jakarta EE, compatibility with ORM 6.3 without -orm6
artifacts, upgrade to Lucene 9 in the Lucene backend, published Hibernate Search BOM, experimental compatibility with Amazon OpenSearch Serverless, dropped compatibility with EOL’d Elasticsearch versions 5.x - 6.x, other bugfixes and improvements
Maven artifacts Download Resolved issues Release announcement