forked from elastic/built-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathupgrading-elastic-stack.html
370 lines (350 loc) · 19.3 KB
/
upgrading-elastic-stack.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
<!DOCTYPE html>
<html lang="en-us">
<head>
<meta charset="UTF-8">
<title>Upgrade to Elastic 8.3.3 | Elastic Installation and Upgrade Guide [8.3] | Elastic</title>
<meta class="elastic" name="content" content="Upgrade to Elastic 8.3.3 | Elastic Installation and Upgrade Guide [8.3]">
<link rel="home" href="index.html" title="Elastic Installation and Upgrade Guide [8.3]"/>
<link rel="up" href="index.html" title="Elastic Installation and Upgrade Guide [8.3]"/>
<link rel="prev" href="installing-elastic-stack.html" title="Installing the Elastic Stack"/>
<link rel="next" href="upgrade-elastic-stack-for-elastic-cloud.html" title="Upgrade on Elastic Cloud"/>
<meta class="elastic" name="product_version" content="8.3"/>
<meta class="elastic" name="product_name" content="Elastic Stack"/>
<meta class="elastic" name="website_area" content="documentation"/>
<meta name="DC.type" content="Learn/Docs/Elastic Stack/Installation and Upgrade/8.3"/>
<meta name="DC.subject" content="Elastic Stack"/>
<meta name="DC.identifier" content="8.3"/>
<meta name="robots" content="noindex,nofollow"/>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<script src="https://cdn.optimizely.com/js/18132920325.js"></script>
<link rel="apple-touch-icon" sizes="57x57" href="/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="/apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="/apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="/apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="/apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="/apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-icon-180x180.png">
<link rel="icon" type="image/png" href="/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="/android-chrome-192x192.png" sizes="192x192">
<link rel="icon" type="image/png" href="/favicon-96x96.png" sizes="96x96">
<link rel="icon" type="image/png" href="/favicon-16x16.png" sizes="16x16">
<link rel="manifest" href="/manifest.json">
<meta name="apple-mobile-web-app-title" content="Elastic">
<meta name="application-name" content="Elastic">
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="/mstile-144x144.png">
<meta name="theme-color" content="#ffffff">
<meta name="naver-site-verification" content="936882c1853b701b3cef3721758d80535413dbfd" />
<meta name="yandex-verification" content="d8a47e95d0972434" />
<meta name="localized" content="true" />
<meta name="st:robots" content="follow,index" />
<meta property="og:image" content="https://static-www.elastic.co/v3/assets/bltefdd0b53724fa2ce/blt280217a63b82a734/6202d3378b1f312528798412/elastic-logo.svg" />
<meta property="og:image:width" content="500" />
<meta property="og:image:height" content="172" />
<link rel="shortcut icon" href="/favicon.ico" type="image/x-icon">
<link rel="icon" href="/favicon.ico" type="image/x-icon">
<link rel="apple-touch-icon-precomposed" sizes="64x64" href="/favicon_64x64_16bit.png">
<link rel="apple-touch-icon-precomposed" sizes="32x32" href="/favicon_32x32.png">
<link rel="apple-touch-icon-precomposed" sizes="16x16" href="/favicon_16x16.png">
<!-- Give IE8 a fighting chance -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
<link rel="stylesheet" type="text/css" href="/guide/static/styles.css" />
</head>
<!--© 2015-2022 Elasticsearch B.V. -->
<!-- All Elastic documentation is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. -->
<!-- http://creativecommons.org/licenses/by-nc-nd/4.0/ -->
<body>
<!-- Google Tag Manager -->
<script>dataLayer = [];</script><noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-58RLH5" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= '//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-58RLH5');</script>
<!-- End Google Tag Manager -->
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-12395217-16"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-12395217-16');
</script>
<!-- Google Tag Manager for GA4 -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-KNJMG2M');</script>
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-KNJMG2M" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager for GA4-->
<div id='elastic-nav' style="display:none;"></div>
<script src='https://www.elastic.co/elastic-nav.js'></script>
<div class="main-container">
<section id="content" >
<div class="content-wrapper">
<section id="guide" lang="en">
<div class="container-fluid">
<div class="row pb-3">
<div class="col-12 order-2 col-md-4 order-md-1 col-lg-3 h-almost-full-md sticky-top-md" id="left_col">
<!-- The TOC is appended here -->
</div>
<div class="col-12 order-1 col-md-8 order-md-2 col-lg-7 order-lg-2 guide-section" id="middle_col">
<!-- start body -->
<div class="page_header">
<strong>IMPORTANT</strong>: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
<a href="../current/index.html">current release documentation</a>.
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="/guide/">Elastic Docs</a></span>
<span class="chevron-right">›</span><span class="breadcrumb-link"><a href="index.html">Elastic Installation and Upgrade Guide [8.3]</a></span>
</div>
<div class="navheader">
<span class="prev">
<a href="installing-elastic-stack.html">« Installing the Elastic Stack</a>
</span>
<span class="next">
<a href="upgrade-elastic-stack-for-elastic-cloud.html">Upgrade on Elastic Cloud »</a>
</span>
</div>
<div class="chapter">
<div class="titlepage"><div><div>
<h1 class="title"><a id="upgrading-elastic-stack"></a>Upgrade to Elastic 8.3.3<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/stack-docs/edit/8.3/docs/en/install-upgrade/upgrading-stack.asciidoc">edit</a></h1>
</div></div></div>
<p>Before you upgrade to 8.3.3, it’s important to take some preparation steps.
These steps vary based on your current version:</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<a class="xref" href="upgrading-elastic-stack.html#prepare-to-upgrade-8x" title="Prepare to upgrade from an earlier 8.x version">Upgrade from an earlier 8.x version</a>
</li>
<li class="listitem">
<a class="xref" href="upgrading-elastic-stack.html#prepare-to-upgrade" title="Prepare to upgrade from 7.x">Upgrade from 7.x</a>
</li>
</ul>
</div>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>Upgrading from a release candidate build, such as 8.0.0-rc1 or
8.0.0-rc2, is not supported. Pre-releases should only be used for testing in a
temporary environment.</p>
</div>
</div>
<h3><a id="prepare-to-upgrade-8x"></a>Prepare to upgrade from an earlier 8.x version<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/stack-docs/edit/8.3/docs/en/install-upgrade/upgrading-stack.asciidoc">edit</a></h3>
<div class="olist orderedlist">
<ol class="orderedlist">
<li class="listitem">
<p>Review the breaking changes for each product you use and make the necessary
changes so your code is compatible with 8.3.3:</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<a class="xref" href="apm-breaking-changes.html" title="APM breaking changes">APM 8.3.3 breaking changes</a>
</li>
<li class="listitem">
<a class="xref" href="beats-breaking-changes.html" title="Beats breaking changes">Beats 8.3.3 breaking changes</a>
</li>
<li class="listitem">
<a class="xref" href="elasticsearch-breaking-changes.html" title="Elasticsearch breaking changes">Elasticsearch 8.3.3 breaking changes</a>
</li>
<li class="listitem">
<a class="xref" href="security-breaking-changes.html" title="Elastic Security breaking changes">Elastic Security 8.3.3 breaking changes</a>
</li>
<li class="listitem">
<a class="xref" href="kibana-breaking-changes.html" title="Kibana breaking changes">Kibana 8.3.3 breaking changes</a>
</li>
<li class="listitem">
<a class="xref" href="logstash-breaking-changes.html" title="Logstash breaking changes">Logstash 8.3.3 breaking changes</a>
</li>
</ul>
</div>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
Make sure you check the breaking changes for each minor release up to 8.3.3.
</li>
<li class="listitem">
If you are using machine learning datafeeds that contain discontinued search or query
domain specific language (DSL), the upgrade will fail. In 5.6.5 and later, the
Upgrade Assistant provides information about which datafeeds need to be updated.
</li>
</ul>
</div>
</div>
</div>
</li>
<li class="listitem">
If you use any Elasticsearch plugins, make sure there is a version of each plugin that is
compatible with Elasticsearch version 8.3.3.
</li>
<li class="listitem">
Test the upgrade in an isolated environment before upgrading your production
cluster.
</li>
<li class="listitem">
<p>Make sure you have a current snapshot before you start the upgrade.</p>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>You cannot downgrade Elasticsearch nodes after upgrading.
If you cannot complete the upgrade process,
you will need to restore from the snapshot.</p>
</div>
</div>
</li>
<li class="listitem">
If you use a separate <a href="/guide/en/elasticsearch/reference/8.3/monitoring-production.html" class="ulink" target="_top">monitoring cluster</a>, you should upgrade the monitoring cluster before the production cluster. In general, the monitoring cluster and the clusters being monitored should be running the same version of the stack. A monitoring cluster cannot monitor production clusters running newer versions of the stack. If necessary, the monitoring cluster can monitor production clusters running the latest release of the previous major version.
</li>
</ol>
</div>
<h3><a id="prepare-to-upgrade"></a>Prepare to upgrade from 7.x<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/stack-docs/edit/8.3/docs/en/install-upgrade/upgrading-stack.asciidoc">edit</a></h3>
<p>To upgrade to 8.3.3 from 7.16 or earlier, <span class="strong strong"><strong>you must first upgrade to 7.17</strong></span>.
This enables you to use the <span class="strong strong"><strong>Upgrade Assistant</strong></span> to identify and resolve issues,
reindex indices created before 7.0, and then perform a rolling upgrade.</p>
<p><span class="strong strong"><strong>Upgrading to 7.17 before upgrading to 8.3.3 is required
even if you opt to do a full-cluster restart of your Elasticsearch cluster.</strong></span>
Alternatively, you can create a new 8.3.3 deployment and reindex from remote.
For more information, see <a class="xref" href="upgrade-elastic-stack-for-elastic-cloud.html#upgrading-reindex" title="Reindex to upgrade">Reindex to upgrade</a>.</p>
<p>Beats and Logstash 7.n are compatible with Elasticsearch 8.3.3
to give you flexibility in scheduling the upgrade.</p>
<div class="note admon">
<div class="icon"></div>
<div class="admon_content">
<h3>Remote cluster compatibility</h3>
<p>If you use cross-cluster search, note that 8.3.3 can only search remote clusters running the previous minor version or later.
For more information, see <a href="/guide/en/elasticsearch/reference/8.3/modules-cross-cluster-search.html" class="ulink" target="_top">Searching across clusters</a>.</p>
<p>If you use cross-cluster replication, a cluster that contains follower indices must run the same or newer version as the remote cluster.
For more information, see <a href="/guide/en/elasticsearch/reference/8.3/xpack-ccr.html" class="ulink" target="_top">Cross cluster replication</a> for version compatibility matrix.</p>
<p>You can view your remote clusters from <span class="strong strong"><strong>Stack Management > Remote Clusters</strong></span>.</p>
</div>
</div>
<div class="olist orderedlist">
<ol class="orderedlist">
<li class="listitem">
<p>Use the <a href="/guide/en/kibana/7.17/upgrade-assistant.html" class="ulink" target="_top">Upgrade Assistant</a>
to prepare for your upgrade from 7.17 to 8.3.3.
The <span class="strong strong"><strong>Upgrade Assistant</strong></span> identifies deprecated settings and guides
you through resolving issues and reindexing indices created before 7.0.
Make sure you have a current snapshot before making configuration changes
or reindexing.</p>
<p><span class="strong strong"><strong>You must resolve all critical issues before proceeding with the upgrade.</strong></span></p>
</li>
<li class="listitem">
<p>Review the deprecation logs from the <span class="strong strong"><strong>Upgrade Assistant</strong></span> to
determine if your applications are using features that are not supported
or behave differently in 8.x.
See the <a class="xref" href="elastic-stack-breaking-changes.html" title="Breaking changes">breaking changes</a> for more information
about changes in 8.3.3 that could affect your application.</p>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>Make sure you check the breaking changes for each minor 8.x release
up to 8.3.3.</p>
</div>
</div>
</li>
<li class="listitem">
<p>Make the recommended changes to ensure that your applications
continue to operate as expected after the upgrade.</p>
<div class="note admon">
<div class="icon"></div>
<div class="admon_content">
<p>As a temporary solution, you can submit requests to 8.x
using the 7.x syntax with the REST API compatibility mode.
While this enables you to submit requests that use the old syntax,
it does not guarantee the same behavior.
REST API compatibility should be a bridge to smooth out the upgrade process,
not a long term strategy.
For more information, see <a href="/guide/en/elasticsearch/reference/8.3/rest-api-compatibility.html" class="ulink" target="_top">REST API compatibility</a>.</p>
</div>
</div>
</li>
<li class="listitem">
If you use any Elasticsearch plugins, make sure there is a version of each plugin that is
compatible with Elasticsearch version 8.3.3.
</li>
<li class="listitem">
Test the upgrade in an isolated environment before upgrading your production
cluster.
</li>
<li class="listitem">
<p>Make sure you have a current snapshot before you start the upgrade.</p>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>You cannot downgrade Elasticsearch nodes after upgrading.
If you cannot complete the upgrade process,
you will need to restore from the snapshot.</p>
</div>
</div>
</li>
<li class="listitem">
If you use a separate <a href="/guide/en/elasticsearch/reference/8.3/monitoring-production.html" class="ulink" target="_top">monitoring cluster</a>, you should upgrade the monitoring cluster before the production cluster. In general, the monitoring cluster and the clusters being monitored should be running the same version of the stack. A monitoring cluster cannot monitor production clusters running newer versions of the stack. If necessary, the monitoring cluster can monitor production clusters running the latest release of the previous major version.
</li>
</ol>
</div>
</div>
<div class="navfooter">
<span class="prev">
<a href="installing-elastic-stack.html">« Installing the Elastic Stack</a>
</span>
<span class="next">
<a href="upgrade-elastic-stack-for-elastic-cloud.html">Upgrade on Elastic Cloud »</a>
</span>
</div>
</div>
<!-- end body -->
</div>
<div class="col-12 order-3 col-lg-2 order-lg-3 h-almost-full-lg sticky-top-lg" id="right_col">
<div id="sticky_content">
<!-- The OTP is appended here -->
<div class="row">
<div class="col-0 col-md-4 col-lg-0" id="bottom_left_col"></div>
<div class="col-12 col-md-8 col-lg-12">
<div id="rtpcontainer">
<div class="mktg-promo" id="most-popular">
<p class="aside-heading">Most Popular</p>
<div class="pb-2">
<p class="media-type">Video</p>
<a href="https://www.elastic.co/webinars/getting-started-elasticsearch?baymax=default&elektra=docs&storm=top-video">
<p class="mb-0">Get Started with Elasticsearch</p>
</a>
</div>
<div class="pb-2">
<p class="media-type">Video</p>
<a href="https://www.elastic.co/webinars/getting-started-kibana?baymax=default&elektra=docs&storm=top-video">
<p class="mb-0">Intro to Kibana</p>
</a>
</div>
<div class="pb-2">
<p class="media-type">Video</p>
<a href="https://www.elastic.co/webinars/introduction-elk-stack?baymax=default&elektra=docs&storm=top-video">
<p class="mb-0">ELK for Logs & Metrics</p>
</a>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</section>
</div>
<div id='elastic-footer'></div>
<script src='https://www.elastic.co/elastic-footer.js'></script>
<!-- Footer Section end-->
</section>
</div>
<script src="/guide/static/jquery.js"></script>
<script type="text/javascript" src="/guide/static/docs.js"></script>
<script type="text/javascript">
window.initial_state = {}</script>
</body>
</html>