diff --git a/docs/reference/migration/index.asciidoc b/docs/reference/migration/index.asciidoc index 3bd5aa4655d06c..a239177b449351 100644 --- a/docs/reference/migration/index.asciidoc +++ b/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. -- <> when deprecated functionality is used. -- <> that scans a cluster's configuration -and mappings for deprecated functionality. - -For more information about {minor-version}, -see the <> and <>. -For information about how to upgrade your cluster, see <>. - -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> - --- +include::migration_intro.asciidoc[] + +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> include::migrate_7_17.asciidoc[] include::migrate_7_16.asciidoc[] @@ -67,3 +37,4 @@ include::migrate_7_3.asciidoc[] include::migrate_7_2.asciidoc[] include::migrate_7_1.asciidoc[] include::migrate_7_0.asciidoc[] + diff --git a/docs/reference/migration/migrate_7_17.asciidoc b/docs/reference/migration/migrate_7_17.asciidoc index a367090b5fed78..78e123424c8144 100644 --- a/docs/reference/migration/migrate_7_17.asciidoc +++ b/docs/reference/migration/migrate_7_17.asciidoc @@ -9,34 +9,15 @@ your application to {es} 7.17. See also <> and <>. +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[] @@ -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 <>. -// 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[] diff --git a/docs/reference/release-notes.asciidoc b/docs/reference/release-notes.asciidoc index 6114b1161ed7bc..b5be5a0e9e142a 100644 --- a/docs/reference/release-notes.asciidoc +++ b/docs/reference/release-notes.asciidoc @@ -6,6 +6,7 @@ This section summarizes the changes in each release. +* <> * <> * <> * <> @@ -22,6 +23,8 @@ This section summarizes the changes in each release. * <> * <> * <> +* <> +* <> * <> * <> * <> @@ -57,6 +60,7 @@ This section summarizes the changes in each release. * <> * <> * <> +* <> * <> * <> * <> @@ -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[] diff --git a/docs/reference/release-notes/7.17.6.asciidoc b/docs/reference/release-notes/7.17.6.asciidoc new file mode 100644 index 00000000000000..90e0fb22fe9ed3 --- /dev/null +++ b/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 <>. + +[[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]) + + diff --git a/docs/reference/release-notes/highlights.asciidoc b/docs/reference/release-notes/highlights.asciidoc index 43a706735295e7..b119befa2d6140 100644 --- a/docs/reference/release-notes/highlights.asciidoc +++ b/docs/reference/release-notes/highlights.asciidoc @@ -1,14 +1,13 @@ [[release-highlights]] == What's new in {minor-version} -// tag::notable-highlights[] -{es} 7.17 is a compatibility release for the 7.17 Elastic Stack and contains -no major enhancements. -// end::notable-highlights[] +coming::[{minor-version}] +Here are the highlights of what's new and improved in {es} {minor-version}! +ifeval::[\{release-state}\"!=\"unreleased\"] For detailed information about this release, see the <> and <>. - +endif::[] // Add previous release to the list Other versions: @@ -23,13 +22,13 @@ Other versions: | {ref-bare}/7.9/release-highlights.html[7.9] | {ref-bare}/7.8/release-highlights.html[7.8] | {ref-bare}/7.7/release-highlights.html[7.7] -| {ref-bare}/7.6/release-highlights-7.6.0.html[7.6] -| {ref-bare}/7.5/release-highlights-7.5.0.html[7.5] -| {ref-bare}/7.4/release-highlights-7.4.0.html[7.4] -| {ref-bare}/7.3/release-highlights-7.3.0.html[7.3] -| {ref-bare}/7.2/release-highlights-7.2.0.html[7.2] -| {ref-bare}/7.1/release-highlights-7.1.0.html[7.1] -| {ref-bare}/7.0/release-highlights-7.0.0.html[7.0] +| {ref-bare}/7.6/release-highlights.html[7.6] +| {ref-bare}/7.5/release-highlights.html[7.5] +| {ref-bare}/7.4/release-highlights.html[7.4] +| {ref-bare}/7.3/release-highlights.html[7.3] +| {ref-bare}/7.2/release-highlights.html[7.2] +| {ref-bare}/7.1/release-highlights.html[7.1] +| {ref-bare}/7.0/release-highlights.html[7.0] // The notable-highlights tag marks entries that // should be featured in the Stack Installation and Upgrade Guide: