Skip to content

Commit 3e4501c

Browse files
Editing migration guide
1 parent 2b86942 commit 3e4501c

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/reference/migration/migrate_8_19.asciidoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,9 @@ to mitigate the impact.
3232
*Details* +
3333
In earlier versions of {es} the `discovery-ec2` plugin was based on the AWS SDK v1. AWS will withdraw support for this SDK before the end of the life of {es} {minor-version} so we must migrate to the newer AWS SDK v2.
3434
Unfortunately there are several differences between the two AWS SDK versions which may require you to adjust your system configuration when upgrading to {es} {minor-version} or later. These differences include, but may not be limited to, the following items.
35+
3536
* AWS SDK v2 does not support the EC2 IMDSv1 protocol.
37+
3638
* AWS SDK v2 does not support the `aws.secretKey` or
3739
`com.amazonaws.sdk.ec2MetadataServiceEndpointOverride` system properties.
3840
@@ -45,6 +47,7 @@ Unfortunately there are several differences between the two AWS SDK versions whi
4547
*Impact* +
4648
If you use the `discovery-ec2` plugin, test your upgrade thoroughly before upgrading any production workloads.
4749
Adapt your configuration to the new SDK functionality. This includes, but may not be limited to, the following items.
50+
4851
* If you use IMDS to determine the availability zone of a node or to obtain
4952
credentials for accessing the EC2 API, ensure that it supports the IMDSv2
5053
protocol.
@@ -68,6 +71,7 @@ Adapt your configuration to the new SDK functionality. This includes, but may no
6871
*Details* +
6972
In earlier versions of {es} the `repository-s3` plugin was based on the AWS SDK v1. AWS will withdraw support for this SDK before the end of the life of {es} {minor-version} so we must migrate to the newer AWS SDK v2.
7073
Unfortunately there are several differences between the two AWS SDK versions which may require you to adjust your system configuration when upgrading to {es} {minor-version} or later. These differences include, but may not be limited to, the following items.
74+
7175
* AWS SDK v2 requires users to specify the region to use for signing
7276
requests, or else to run in an environment in which it can determine the
7377
correct region automatically. The older SDK would try to determine the
@@ -77,6 +81,7 @@ Unfortunately there are several differences between the two AWS SDK versions whi
7781
`us-east-1` if no better value could be found.
7882
7983
* AWS SDK v2 does not support the EC2 IMDSv1 protocol.
84+
8085
* AWS SDK v2 does not support the
8186
`com.amazonaws.sdk.ec2MetadataServiceEndpointOverride` system property.
8287
@@ -92,14 +97,17 @@ Unfortunately there are several differences between the two AWS SDK versions whi
9297
longer has any effect.
9398
9499
* AWS SDK v2 does not support the `log-delivery-write` canned ACL.
100+
95101
* AWS SDK v2 counts 4xx responses differently in its metrics reporting.
102+
96103
* AWS SDK v2 always uses the regional STS endpoint, whereas AWS SDK v2
97104
could use either a regional endpoint or the global
98105
`https://sts.amazonaws.com` one.
99106
100107
*Impact* +
101108
If you use the `repository-s3` module, test your upgrade thoroughly before upgrading any production workloads.
102109
Adapt your configuration to the new SDK functionality. This includes, but may not be limited to, the following items.
110+
103111
* Specify the correct signing region using the
104112
`s3.client.${CLIENT_NAME}.region` setting on each node. {es} will try and
105113
determine the correct region based on the endpoint URL and other data

0 commit comments

Comments
 (0)