Skip to content

Commit

Permalink
Add release notes for 7.17.6
Browse files Browse the repository at this point in the history
  • Loading branch information
mark-vieira committed Aug 23, 2022
1 parent 1fbe8fe commit dd6a262
Show file tree
Hide file tree
Showing 5 changed files with 178 additions and 138 deletions.
71 changes: 21 additions & 50 deletions docs/reference/migration/index.asciidoc
@@ -1,53 +1,23 @@
[[breaking-changes]]
= Migration guide

[partintro]
--
This section describes the breaking changes and deprecations introduced in this release
and previous minor versions.

As {es} introduces new features and improves existing ones,
the changes sometimes make older settings, APIs, and parameters obsolete.
The obsolete functionality is typically deprecated in a minor release and
removed in the subsequent major release.
This enables applications to continue working unchanged across most minor version upgrades.
Breaking changes introduced in minor releases are generally limited to critical security fixes
and bug fixes that correct unintended behavior.

To get the most out of {es} and facilitate future upgrades, we strongly encourage migrating
away from using deprecated functionality as soon as possible.

To give you insight into what deprecated features you're using, {es}:

- Returns a `Warn` HTTP header whenever you submit a request that uses deprecated functionality.
- <<deprecation-logging, Logs deprecation warnings>> when deprecated functionality is used.
- <<migration-api-deprecation, Provides a deprecation info API>> that scans a cluster's configuration
and mappings for deprecated functionality.

For more information about {minor-version},
see the <<release-highlights>> and <<es-release-notes>>.
For information about how to upgrade your cluster, see <<setup-upgrade>>.

* <<breaking-changes-7.17,Migrating to 7.17>>
* <<breaking-changes-7.16,Migrating to 7.16>>
* <<breaking-changes-7.15,Migrating to 7.15>>
* <<breaking-changes-7.14,Migrating to 7.14>>
* <<breaking-changes-7.13,Migrating to 7.13>>
* <<breaking-changes-7.12,Migrating to 7.12>>
* <<breaking-changes-7.11,Migrating to 7.11>>
* <<breaking-changes-7.10,Migrating to 7.10>>
* <<breaking-changes-7.9,Migrating to 7.9>>
* <<breaking-changes-7.8,Migrating to 7.8>>
* <<breaking-changes-7.7,Migrating to 7.7>>
* <<breaking-changes-7.6,Migrating to 7.6>>
* <<breaking-changes-7.5,Migrating to 7.5>>
* <<breaking-changes-7.4,Migrating to 7.4>>
* <<breaking-changes-7.3,Migrating to 7.3>>
* <<breaking-changes-7.2,Migrating to 7.2>>
* <<breaking-changes-7.1,Migrating to 7.1>>
* <<breaking-changes-7.0,Migrating to 7.0>>

--
include::migration_intro.asciidoc[]

* <<migrating-7.17,Migrating to 7.17>>
* <<migrating-7.16,Migrating to 7.16>>
* <<migrating-7.15,Migrating to 7.15>>
* <<migrating-7.14,Migrating to 7.14>>
* <<migrating-7.13,Migrating to 7.13>>
* <<migrating-7.12,Migrating to 7.12>>
* <<migrating-7.11,Migrating to 7.11>>
* <<migrating-7.10,Migrating to 7.10>>
* <<migrating-7.9,Migrating to 7.9>>
* <<migrating-7.8,Migrating to 7.8>>
* <<migrating-7.7,Migrating to 7.7>>
* <<migrating-7.6,Migrating to 7.6>>
* <<migrating-7.5,Migrating to 7.5>>
* <<migrating-7.4,Migrating to 7.4>>
* <<migrating-7.3,Migrating to 7.3>>
* <<migrating-7.2,Migrating to 7.2>>
* <<migrating-7.1,Migrating to 7.1>>
* <<migrating-7.0,Migrating to 7.0>>
include::migrate_7_17.asciidoc[]
include::migrate_7_16.asciidoc[]
Expand All @@ -67,3 +37,4 @@ include::migrate_7_3.asciidoc[]
include::migrate_7_2.asciidoc[]
include::migrate_7_1.asciidoc[]
include::migrate_7_0.asciidoc[]

69 changes: 10 additions & 59 deletions docs/reference/migration/migrate_7_17.asciidoc
Expand Up @@ -9,34 +9,15 @@ your application to {es} 7.17.

See also <<release-highlights>> and <<es-release-notes>>.

coming::[7.17.6]


[discrete]
[[breaking-changes-7.17]]
=== Breaking changes

The following changes in {es} 7.17 might affect your applications
and prevent them from operating normally.
Before upgrading to 7.17, review these changes and take the described steps
to mitigate the impact.

// NOTE: The notable-breaking-changes tagged regions are re-used in the
// Installation and Upgrade Guide
// tag::notable-breaking-changes[]
[discrete]
[[breaking_717_packaging_changes]]
==== Packaging changes

[[windows_msi_installer_package_no_longer_available]]
.The Windows MSI installer package is no longer available.
[%collapsible]
====
*Details* +
We no longer release Windows MSI installer packages for {es}. These packages
were previously released in beta and didn't receive widespread adoption.
*Impact* +
To install {es} on Windows, use the {ref}/zip-windows.html[`.zip` archive
package] instead.
====
There are no breaking changes in {es} 7.17.
// end::notable-breaking-changes[]


Expand All @@ -45,57 +26,27 @@ package] instead.
=== Deprecations

The following functionality has been deprecated in {es} 7.17
and will be removed in 8.0.
and will be removed in a future version.
While this won't have an immediate impact on your applications,
we strongly encourage you take the described steps to update your code
after upgrading to 7.17.

NOTE: Significant changes in behavior are deprecated in a minor release and
the old behavior is supported until the next major release.
To find out if you are using any deprecated functionality,
enable <<deprecation-logging, deprecation logging>>.

// tag::notable-breaking-changes[]

[discrete]
[[deprecations_717_cluster_and_node_setting]]
==== Cluster and node setting deprecations

[[deprecation_for_truststores_with_no_trust_entries]]
.Deprecation for truststores with no trust entries
[%collapsible]
====
*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 {es}
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 {es} 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
{es} version 7.17
*Impact* +
To avoid deprecation warnings, remove any SSL truststores that do not
contain any trusted entries.
====

[discrete]
[[deprecations_717_mapping]]
==== Mapping deprecations

[[camel_case_date_formats_are_deprecated]]
.Camel case date formats are deprecated.
[[set_monitoring_auth_password_cluster_settings_deprecation_level_as_critical]]
.Set monitoring auth.password cluster settings deprecation level as critical
[%collapsible]
====
*Details* +
The use of camel case patterns on date formats is deprecated and will be removed
in {es} 8.0.0.
The corresponding snake case pattern should be used instead.
Changing the deprecation level for the monitoring auth.password settings in cluster state to CRITICAL.
*Impact* +
To avoid deprecation warnings, discontinue use of the camel case pattern.
The upgrade assistant will block 8.0 upgrades on monitoring auth.password set in cluster state.
====
// end::notable-breaking-changes[]

71 changes: 54 additions & 17 deletions docs/reference/release-notes.asciidoc
Expand Up @@ -6,6 +6,7 @@

This section summarizes the changes in each release.

* <<release-notes-7.17.6>>
* <<release-notes-7.17.5>>
* <<release-notes-7.17.4>>
* <<release-notes-7.17.3>>
Expand All @@ -22,6 +23,8 @@ This section summarizes the changes in each release.
* <<release-notes-7.14.2>>
* <<release-notes-7.14.1>>
* <<release-notes-7.14.0>>
* <<release-notes-7.13.4>>
* <<release-notes-7.13.3>>
* <<release-notes-7.13.2>>
* <<release-notes-7.13.1>>
* <<release-notes-7.13.0>>
Expand Down Expand Up @@ -57,6 +60,7 @@ This section summarizes the changes in each release.
* <<release-notes-7.2.0>>
* <<release-notes-7.1.1>>
* <<release-notes-7.1.0>>
* <<release-notes-7.0.1>>
* <<release-notes-7.0.0>>
* <<release-notes-7.0.0-rc2>>
* <<release-notes-7.0.0-rc1>>
Expand All @@ -66,29 +70,62 @@ This section summarizes the changes in each release.

--

include::release-notes/7.17.6.asciidoc[]
include::release-notes/7.17.5.asciidoc[]
include::release-notes/7.17.4.asciidoc[]
include::release-notes/7.17.3.asciidoc[]
include::release-notes/7.17.2.asciidoc[]
include::release-notes/7.17.1.asciidoc[]
include::release-notes/7.17.0.asciidoc[]
include::release-notes/7.16.asciidoc[]
include::release-notes/7.15.asciidoc[]
include::release-notes/7.14.asciidoc[]
include::release-notes/7.13.asciidoc[]
include::release-notes/7.12.asciidoc[]
include::release-notes/7.11.asciidoc[]
include::release-notes/7.10.asciidoc[]
include::release-notes/7.9.asciidoc[]
include::release-notes/7.8.asciidoc[]
include::release-notes/7.7.asciidoc[]
include::release-notes/7.6.asciidoc[]
include::release-notes/7.5.asciidoc[]
include::release-notes/7.4.asciidoc[]
include::release-notes/7.3.asciidoc[]
include::release-notes/7.2.asciidoc[]
include::release-notes/7.1.asciidoc[]
include::release-notes/7.0.asciidoc[]
include::release-notes/7.16.3.asciidoc[]
include::release-notes/7.16.2.asciidoc[]
include::release-notes/7.16.1.asciidoc[]
include::release-notes/7.16.0.asciidoc[]
include::release-notes/7.15.2.asciidoc[]
include::release-notes/7.15.1.asciidoc[]
include::release-notes/7.15.0.asciidoc[]
include::release-notes/7.14.2.asciidoc[]
include::release-notes/7.14.1.asciidoc[]
include::release-notes/7.14.0.asciidoc[]
include::release-notes/7.13.4.asciidoc[]
include::release-notes/7.13.3.asciidoc[]
include::release-notes/7.13.2.asciidoc[]
include::release-notes/7.13.1.asciidoc[]
include::release-notes/7.13.0.asciidoc[]
include::release-notes/7.12.1.asciidoc[]
include::release-notes/7.12.0.asciidoc[]
include::release-notes/7.11.2.asciidoc[]
include::release-notes/7.11.1.asciidoc[]
include::release-notes/7.11.0.asciidoc[]
include::release-notes/7.10.2.asciidoc[]
include::release-notes/7.10.1.asciidoc[]
include::release-notes/7.10.0.asciidoc[]
include::release-notes/7.9.3.asciidoc[]
include::release-notes/7.9.2.asciidoc[]
include::release-notes/7.9.1.asciidoc[]
include::release-notes/7.9.0.asciidoc[]
include::release-notes/7.8.1.asciidoc[]
include::release-notes/7.8.0.asciidoc[]
include::release-notes/7.7.1.asciidoc[]
include::release-notes/7.7.0.asciidoc[]
include::release-notes/7.6.2.asciidoc[]
include::release-notes/7.6.1.asciidoc[]
include::release-notes/7.6.0.asciidoc[]
include::release-notes/7.5.2.asciidoc[]
include::release-notes/7.5.1.asciidoc[]
include::release-notes/7.5.0.asciidoc[]
include::release-notes/7.4.2.asciidoc[]
include::release-notes/7.4.1.asciidoc[]
include::release-notes/7.4.0.asciidoc[]
include::release-notes/7.3.2.asciidoc[]
include::release-notes/7.3.1.asciidoc[]
include::release-notes/7.3.0.asciidoc[]
include::release-notes/7.2.1.asciidoc[]
include::release-notes/7.2.0.asciidoc[]
include::release-notes/7.1.1.asciidoc[]
include::release-notes/7.1.0.asciidoc[]
include::release-notes/7.0.1.asciidoc[]
include::release-notes/7.0.0.asciidoc[]
include::release-notes/7.0.0-rc2.asciidoc[]
include::release-notes/7.0.0-rc1.asciidoc[]
include::release-notes/7.0.0-beta1.asciidoc[]
Expand Down
82 changes: 82 additions & 0 deletions docs/reference/release-notes/7.17.6.asciidoc
@@ -0,0 +1,82 @@
[[release-notes-7.17.6]]
== {es} version 7.17.6

coming[7.17.6]

Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.

[[bug-7.17.6]]
[float]
=== Bug fixes

Cluster Coordination::
* Improve rejection of ambiguous voting config name {es-pull}89239[#89239]

Geo::
* Fix potential circuit breaker leak on `InternalGeoGrid` {es-pull}88273[#88273] (issue: {es-issue}88261[#88261])
* Geo_line aggregation returns a geojson point when the resulting line has only one point {es-pull}89199[#89199] (issue: {es-issue}85748[#85748])
* Port fixed version of Lucene Tessellator into ES 7.17 {es-pull}88213[#88213] (issue: {es-issue}88014[#88014])
* Sort ranges in `geo_distance` aggregation {es-pull}89154[#89154] (issue: {es-issue}89147[#89147])

Infra/Node Lifecycle::
* Fix message for stalled shutdown {es-pull}89254[#89254]

Infra/Scripting::
* Adjust date conversion for execution context in watcher compare condition {es-pull}88467[#88467] (issue: {es-issue}88408[#88408])

Ingest::
* Don't ignore pipeline for upserts in bulk api {es-pull}87719[#87719] (issue: {es-issue}87131[#87131])

Java High Level REST Client::
* [7.17] Fix mount snapshot api ignoring unknown request parameter {es-pull}89061[#89061] (issue: {es-issue}75982[#75982])

Machine Learning::
* Improve trained model stats API performance {es-pull}87978[#87978]

Search::
* Fix validation of `close_pit` request {es-pull}88702[#88702]
* Override bulk visit methods of exitable point visitor {es-pull}82120[#82120]
* Reduce memory usage in field-caps responses {es-pull}88042[#88042]

Snapshot/Restore::
* Avoid capturing `SnapshotsInProgress$Entry` in queue {es-pull}88707[#88707]
* Move Get Snapshots Serialization to Management Pool {es-pull}83215[#83215]
* Report better error for GCS credentials load failure {es-pull}89336[#89336]

Stats::
* Discard intermediate results upon cancellation for stats endpoints {es-pull}82685[#82685] (issue: {es-issue}82337[#82337])

Transform::
* Execute `_refresh` separately from DBQ, with system permissions {es-pull}88005[#88005] (issue: {es-issue}88001[#88001])

[[deprecation-7.17.6]]
[float]
=== Deprecations

Infra/Core::
* Set monitoring auth.password cluster settings deprecation level as critical {es-pull}88351[#88351] (issue: {es-issue}86022[#86022])

[[enhancement-7.17.6]]
[float]
=== Enhancements

Authorization::
* Avoid loading authorized indices when requested indices are all concrete names {es-pull}81237[#81237]

Packaging::
* Change UBI docker user to `elasticsearch` {es-pull}88262[#88262] (issue: {es-issue}88218[#88218])

Performance::
* Warn about impact of large readahead on search {es-pull}88007[#88007]

Security::
* New setting to close idle connections in OIDC back-channel {es-pull}87773[#87773]

[[upgrade-7.17.6]]
[float]
=== Upgrades

Packaging::
* Upgrade to OpenJDK 18.0.2+9 {es-pull}88675[#88675] (issue: {es-issue}88673[#88673])


0 comments on commit dd6a262

Please sign in to comment.