Skip to content

Commit b6af7e1

Browse files
authored
[DOCS] Add deprecation docs for incompatible builds (#77730) (#77962)
We deprecated the `es.unsafely_permit_handshake_from_incompatible_builds` system property in 7.11 with PR #65601. However, we didn't add a related item to the 7.11 deprecation docs. This adds the missing item. Relates to #65753.
1 parent cc64cd3 commit b6af7e1

File tree

2 files changed

+27
-5
lines changed

2 files changed

+27
-5
lines changed

docs/reference/migration/migrate_7_11.asciidoc

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ See also <<release-highlights>> and <<es-release-notes>>.
1313
* <<breaking_711_rest_changes>>
1414
* <<breaking_711_search_changes>>
1515
* <<breaking_711_transform_changes>>
16+
* <<breaking_711_transport_deprecations>>
1617

1718
//NOTE: The notable-breaking-changes tagged regions are re-used in the
1819
//Installation and Upgrade Guide
@@ -120,7 +121,6 @@ settings of the transform.
120121
====
121122
//end::notable-breaking-changes[]
122123

123-
////
124124
[discrete]
125125
[[deprecated-7.11]]
126126
=== Deprecations
@@ -136,4 +136,26 @@ the old behavior is supported until the next major release.
136136
To find out if you are using any deprecated functionality,
137137
enable <<deprecation-logging, deprecation logging>>.
138138

139-
////
139+
[discrete]
140+
[[breaking_711_transport_deprecations]]
141+
==== Transport deprecations
142+
143+
//tag::notable-breaking-changes[]
144+
[[deprecate-unsafely_permit_handshake_from_incompatible_builds]]
145+
.The `es.unsafely_permit_handshake_from_incompatible_builds` system property is deprecated.
146+
[%collapsible]
147+
====
148+
*Details* +
149+
The `es.unsafely_permit_handshake_from_incompatible_builds` system property is
150+
now deprecated.
151+
152+
{es} verifies that communicating pairs of nodes of the same version are running
153+
the same build and using the same wire format. You can bypass this check by
154+
setting `es.unsafely_permit_handshake_from_incompatible_builds` to `true`.
155+
Skipping this check is unsafe and not recommended.
156+
157+
*Impact* +
158+
To avoid deprecation warnings, discontinue use of the system property. Instead
159+
ensure that all nodes of the same version are running the same build.
160+
====
161+
//end::notable-breaking-changes[]

docs/reference/migration/migrate_7_12.asciidoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -91,14 +91,14 @@ SSL/TLS versions on your JDK].
9191
//end::notable-breaking-changes[]
9292

9393
[discrete]
94-
[[deprecated-7.11]]
94+
[[deprecated-7.12]]
9595
=== Deprecations
9696

97-
The following functionality has been deprecated in {es} 7.10
97+
The following functionality has been deprecated in {es} 7.12
9898
and will be removed in 8.0
9999
While this won't have an immediate impact on your applications,
100100
we strongly encourage you take the described steps to update your code
101-
after upgrading to 7.10.
101+
after upgrading to 7.12.
102102

103103
NOTE: Significant changes in behavior are deprecated in a minor release and
104104
the old behavior is supported until the next major release.

0 commit comments

Comments
 (0)