Skip to content

Commit 68a28c9

Browse files
authored
[DOCS] Add deprecation docs for incompatible builds (#77730) (#77964)
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 c9ee98e commit 68a28c9

File tree

1 file changed

+26
-4
lines changed

1 file changed

+26
-4
lines changed

docs/reference/migration/migrate_7_11.asciidoc

Lines changed: 26 additions & 4 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,20 +121,41 @@ settings of the transform.
120121
====
121122
//end::notable-breaking-changes[]
122123

123-
////
124124
[discrete]
125125
[[deprecated-7.11]]
126126
=== Deprecations
127127

128-
The following functionality has been deprecated in {es} 7.10
128+
The following functionality has been deprecated in {es} 7.11
129129
and will be removed in 8.0
130130
While this won't have an immediate impact on your applications,
131131
we strongly encourage you take the described steps to update your code
132-
after upgrading to 7.10.
132+
after upgrading to 7.11.
133133

134134
NOTE: Significant changes in behavior are deprecated in a minor release and
135135
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[]

0 commit comments

Comments
 (0)