elastic / elastic/stack-docs

Upgrade Guide - Incorrect upgrade path

未关闭
#121 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
主要语言
Java
星标
105
派生
249
PR 合并指标
30 天内没有已合并 PR

描述

**to reproduce:**
- First off, we need some information about your stack.
- 5.0-5.5
- no Cloud
- Do you use X-Pack?
- yes
- Which X-Pack features do you use?
- Security
- Transport Layer Security (TLS) is required as of 6.0
- no
- Do you have any indices that were created in 2.x?
- no
- Upgrading from 5.x to 6.3
- Upgrade to 5.6 first

Which returns:
> Here you go!
> These are the steps you need to take to upgrade to 6.3.
> Upgrade to 5.6
> Back up your data.
> Use the Elasticsearch Migration plugin to check for upgrade issues.
> Address any 5.x breaking changes that affect your applications:
> Elasticsearch breaking changes
> Upgrade one node at a time to Elasticsearch 5.6.
> Install Elasticsearch 5.6.
> Install X-Pack.
> Restart the node.
>
> Prepare to upgrade to 6.3
> Back up your data.
> Address any 6.0 breaking changes that affect your applications:
> Elasticsearch breaking changes
> If you're using the default changeme password, change your password.
> Check the Elasticsearch deprecation log.
> Upgrade to 6.3
> Upgrade Elasticsearch to 6.3.
> You can perform a rolling upgrade to Elasticsearch 6.3.
> Remove the X-Pack plugin before restarting Elasticsearch.
> Run bin/elasticsearch-plugin remove x-pack.

However, 6.x requires TLS
The path is therefore missing to enable TLS and the full cluster restart that comes with it.

Instead of the above, the upgrade to 6.x should follow the following path (taken from selecting "jump straing to 6.3" in the last question). In fact, going to 5.6 does not bring any benefits in this case and we should consider removing that question when TLS is not enabled. 5.6 is only required if you plan to roll to 6.x, which is not possible in this case:

> Perform a Full Cluster Restart Upgrade to 6.3
> Stop sending data to your cluster.
> Shut down your cluster and install Elasticsearch 6.3 on all nodes.
> Remove the X-Pack plugin before restarting Elasticsearch.
> Run bin/elasticsearch-plugin remove x-pack.
> Enable Transport Layer Security (TLS) to secure cluster communications.
> TLS is required as of 6.0 to prevent unidentified nodes from joining a cluster and encrypt inter-node communications.
> Restart your Elasticsearch cluster.
> Create a temporary super user and upgrade the internal .security index.
> Delete the temporary super user.

贡献指南

这个仓库没有索引到贡献指南

调研方向

首先,跟踪一个不使用 Cloud、启用 X-Pack Security、不使用 TLS 且没有 2.x 索引的 5.0–5.5 集群的 upgrade-guide 路径。将其 6.3 输出与文档中“jump straight to 6.3”的 full-cluster-restart 路径进行比较;完成的标准是生成的步骤包含 TLS 和所需的重启,而不是错误地经由 5.6。

由索引模型根据 Issue 内容生成。

评估

技术栈
elasticsearch
领域
documentation
Issue 类型
文档
难度
3/5
预计耗时
1-2 天
活跃度
停滞
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。