IMPORTANT:
在升级 Kibana 之前:
请参考重要变更文档。
在升级生产服务之前请先在测试环境测试升级。
使用 Elasticsearch 的 snapshots 特性备份数据。除非存在备份数据,否则版本 不能向前回滚 。
如果使用了自定义插件,检查其是否有兼容版本。
从不同的 Kibana 版本进行升级,过程也不相同。请参考以下表格决定需要按照哪个过程进行升级:
当前版本
目标版本
支持的升级类型
3.x
5.x
全新安装
4.0 or 4.1
5.x
标准升级及索引重建
4.x >= 4.2
5.x
标准升级
5.0.0 pre GA
5.x
标准升级及索引重建
5.x
5.y
标准升级 (where y > x)
IMPORTANT:只要是从 Kibana 4.1 或 4.0 升级上来的,就需要进行索引重建。
即使您现在运行的 Kibana 版本为 4.2 或更高,如果之前是从 Kibana 4.0 或 4.1 升级过来的,您仍需要进行一次标准升级及索引重建来升级到 5.x。
这是因为 Elasticsearch 需要对所有在 Elasticsearch 2.0 之前创建的索引进行重建,哪怕目前工作的版本是 Elasticsearch 2.x。
升级到 5.x 的过程只需要进行一次索引重建。
NOTE:由 Kibana 4.x 保存的查询、视图和仪表板一般兼容 5.x。
标准升级
标准升级是升级 Kibana 最直接的方法,仅支持 4.2 及以上的版本。
如果您之前没有升级过 Kibana,参考该表格来验证您的版本是否支持标准升级。
NOTE:如果您从 Kibana 中保存或导出过依赖 Elasticsearch Query DSL 的对象,确保参考过 Elasticsearch 重要变更文档并且按照其指引进行过必要的修复。
用 deb 或 rpm 包进行升级
在当前系统中使用相应的命令停止当前运行的 Kibana 进程。
使用 rpm 或 dpkg 安装新的包。所有的文件应该被放置到相应的位置并且配置文件不应该被覆盖。
NOTE:Kibana 4.x 的配置文件路径不同于 5.0+,所以如果您是从 4.x 升级的,您需要把配置从原有的配置文件(/opt/kibana/config/kibana.yml)拷贝到新的配置文件(/etc/kibana/kibana.yml)。
确保您移动或者升级了重要变更文件中指明的配置项,否则 Kibana 将无法启动。
运用以下方法升级插件:删除已存在的插件,使用 kibana-plugin 脚本重新安装相应的版本。参考插件文档获取更多信息。
在当前系统中使用相应的命令启动新的 Kibana 进程。
用 zip 或 tar.gz 压缩包进行升级
将 zip 或 tar.gz 压缩包解压到一个新的文件夹,确保 config 或 data 文件夹没有被覆盖。
将原来安装的 config 文件夹下的所有文件拷贝到新安装目录中。确保您移动或者升级了重要变更文件中指明的配置项,否则 Kibana 将无法启动。
将原来安装的 data 文件夹下的所有文件拷贝到新安装目录中。
使用 kibana-plugin 脚本重新安装相应的版本。参考插件文档获取更多信息。
关闭原 Kibana 进程。
开启新 Kibana 进程。
重建索引进行标准升级
无论何时对一个含有早于 Elasticsearch 2.0 版本创建的 .kibana 索引的 Kibana 进行升级,都必须在 Elasticsearch 中进行一次索引重建。
例如,从 Kibana 4.1 或 4.0 直接升级或者从之前由 4.1 或 4.0 升级上来的 4.2+ 进行升级。
重建索引是从已有的索引升级语法、映射而创建一个新索引的过程。尽管这支持手动进行,我们仍然推荐使用在 Elasticsearch 重建索引升级指南中提到的 Elasticsearch 迁移插件。
NOTE:Elasticsearch 迁移插件创建一个新版本的 .kibana 索引并创建一个 索引别名 指向它。Kibana 5.0 支持这个索引别名,但是如果想在 Elastic stack 升级的过程中运行 Kibana 4.x,就需要配置 4.x 安装时指向该版本索引,使用 kibana.yml 文件中的 kibana.index 配置项进行配置。
一旦重建索引完成了,就可以遵循标准升级的指引继续升级。
全新安装
Kibana 4.0 进行了一次重要的架构重构,导致底层的 .kibana 索引模式改变很大,以至于从 Kibana 3.x 升级需要重建所有的视图、仪表板等。
如果您需要从 3.x 升级,请遵循安装指引来安装 Kibana,然后手动重建查询、视图和仪表板。