第一部分 版本升级指引
第二部分 升级方法和具体步骤
总结
参考文献及资料
背景Elasticsearch集群的版本升级是一项重要的集群维护工作。本篇文章参考官方文档,将详细介绍相关细节。
第一部分 版本升级指引 1.1 同步升级Elastic Stack组件对于Elasticsearch的生态圈组件需要同步升级,具体配套版本可以参考官方提供的升级指南。
https://www.elastic.co/cn/products/upgrade_guide
1.2 索引兼容性Elasticsearch对于老版本的索引(index)兼容性如下:
Elasticsearch 6.x兼容Elasticsearch 5.x中创建的索引,但不兼容Elasticsearch 2.x或更旧版本的索引。
Elasticsearch 5.x兼容Elasticsearch 2.x中创建的索引,但不不兼容Elasticsearch1.x或更旧版本的索引。
如果升级过程中遇到索引不兼容场景,升级后集群将无法正常启动。
1.3 版本升级路线Elasticsearch版本升级具体路线总结如下:
序号 原版本 升级目标版本 支持的升级类型1 5.x 5.y 滚动升级(其中 y > x)
2 5.6 6.x 滚动升级
3 5.0-5.5 6.x 集群重启
4 <5.x 6.x reindex升级
5 6.x 6.y 滚动升级(其中 y > x)
6 1.x 5.x reindex升级
7 2.x 2.y 滚动升级(其中 y > x)
8 2.x 5.x 集群重启
9 5.0.0 pre GA 5.x 集群重启
10 5.x 5.y 滚动升级(其中 y > x)
关于Elasticsearch的版本序列需要特别说明一下。Elasticsearch版本序列不是连续递增的,从2.4.x版本后直接跳跃到5.0.x。所以对于5.x版本,如果按照严格顺序递增编号,应该是3.x。之所以没有连续编号,主要是为了保持ELK(Elasticsearch 、 Logstash 、 Kibana)整体版本的统一。
其中第4种情况,小于5.x其实就是2.x和1.x。由于6.x对于更低版本的索引不兼容,所以需要对原集群的中索引实施reindex。方案分别为:
1.3.1 2.x升级到6.x按照上面的升级路线有两种升级方案:
方案1:先由2.x升级到5.6版本(reindex升级索引版本),然后由5.6升级到6.x(滚动升级);
方案2:创建全新的6.x集群,然后将旧集群中的索引数据远程reindex到新集群中;
1.3.2 1.x升级到6.x同样有两个方案:
方案1:先由1.x升级到2.4.x版本(reindex升级索引版本),最后按照上面2.x升级到6.x的方案实施;
方案2:创建全新的6.x集群,然后将旧集群中的索引reindex到新集群中;
第二部分 升级方法和具体步骤集群升级路线中,针对不同的版本之间升级,一共有三种升级方案:滚动升级、集群重启、reindex。下面将分别介绍。
2.1 滚动升级所谓滚动升级指的是集群中节点逐个将版本升级至目标(高)版本,升级期间集群保持对外服务不中断。这种升级方案都是针对同一个大版本内的升级,即x.y升级到x.z(z>y)。特别的,5.6升级到6.x也是支持使用滚动升级方式的。
https://www.elastic.co/guide/en/elasticsearch/reference/current/rolling-upgrades.html
通常滚动升级的步骤如下:
第1步 禁用副本分片(shards)分配在下宕升级节点前,需要提前禁止副本分片的分配。
节点下宕后,副本分配进程会等待index.unassigned.node_left.delayed_timeout(默认情况下为1分钟),然后再开始将该节点上的分片复制到群集中的其他节点,这会导致大量I/O。由于节点很快将重新启动,所以并不需要重新分配。
API命令如下:
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": "primaries" } } 第2步 执行同步刷新重启集群时如果translog过大,日志回放恢复数据耗时较长,建议手动同步刷新,减少translog。
注意:这个过程较为缓慢。
POST _flush/synced 第3步 停止机器学习作业如果集群中运行了机器学习任务,需要停止任务运行。
参考:https://www.elastic.co/guide/en/elastic-stack-overview/6.8/stopping-ml.html
第4部 下宕待升级节点并安装主版本和插件对升级节点实施下宕,开始文件系统的升级。
第5步 启动节点启动节点,并用下面的API检查节点是否加入集群。
GET _cat/nodes 第6步 重启分片分配节点加入集群后,设置启用分片分配开始使用该节点。
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": null } }在升级下一个节点前,等待集群分片完成。可以通过下面的API检查集群状态:
GET _cat/health?v等待集群的状态由red变成yellow,再到green。说明集群完成所有主分片和副分片的分配。
第7步 重复升级其他节点重复滚动升级集群其他节点。
第8步 重启机器学习任务如果集群中有机器学习任务,需要从新启动。
2.2 集群整体重启