Elasticsearch breaking changes

edit

This list summarizes the most important breaking changes in Elasticsearch 7.17.25. For the complete list, go to Elasticsearch breaking changes.

Packaging changes

edit
The Windows MSI installer package is no longer available.

Details
We no longer release Windows MSI installer packages for Elasticsearch. These packages were previously released in beta and didn’t receive widespread adoption.

Impact
To install Elasticsearch on Windows, use the .zip archive package instead.

Cluster and node setting deprecations

edit
Deprecation for truststores with no trust entries

Details
The use of SSL truststores that do not contain any trusted entries has been deprecated. The various *.ssl.truststore.path settings (for example xpack.security.transport.ssl.truststore.path or xpack.http.ssl.truststore.path) can be used to configure a set of "trust anchors" for SSL certificate verification. In Elasticsearch version 7 and earlier, it was permitted to configure a truststore that did not contain any trust anchors (that is, it was empty, or it contained "private key" entries only). In Elasticsearch version 8 and above, a truststore.path without any trusted certificate entries is no longer accepted, and will cause an error. This configuration is now deprecated in Elasticsearch version 7.17

Impact
To avoid deprecation warnings, remove any SSL truststores that do not contain any trusted entries.

Deprecation for DLS settings

Details
Two settings available in the latest versions of 7.17 are not available in the next major version. Newer versions of 7.17 default to stricter Document Level Security (DLS) rules and the follow settings can be used to disable those stricter DLS rules: xpack.security.dls.force_terms_aggs_to_exclude_deleted_docs.enabled and xpack.security.dls.error_when_validate_query_with_rewrite.enabled. Newer versions, of next major version of Elasticsearch, also default to the stricter DLS rules but don’t allow usage of the less strict rules.

Impact
To avoid deprecation warnings, remove these settings from elasticsearch.yml.

Mapping deprecations

edit
Camel case date formats are deprecated.

Details
The use of camel case patterns on date formats is deprecated and will be removed in Elasticsearch 8.0.0.

The corresponding snake case pattern should be used instead.

Impact
To avoid deprecation warnings, discontinue use of the camel case pattern.