0、说明：本篇是基于DolphinScheduler 3.1.3升级到3.1.4版本的升级。

背景：在使用DolphinScheduler 3.1.3版本的过程中发现前端部分页面有显示时间差的问题，具体如下；

其他部分显示的时间都是和本地时间一致的，只有任务实例的提交时间、开始时间、结束时间部分和本地的时间相差13个小时。通过更改页面的时区无法实现时间的正常显示；

此时官网已经发布了3.1.4最新版本，且修复了一些已知的bug；于是决定升级到最新版本，看是否能解决此问题；

最新版本修复bug

https://github.com/apache/dolphinscheduler/releases/tag/3.1.4

?

升级准备：

1、下载最新的二进制安装包，或者通过最新的源码编译；

下载地址：https://dolphinscheduler.apache.org/zh-cn/download/3.1.4

?

2、DolphinScheduler 元数据备份

DolphinScheduler 在版本的改动上是有一些不向前兼容的更改，如果升级中版本的跨越涉及到，需要做对应的调整；

具体的说明可以参考官网的说明：https://dolphinscheduler.apache.org/zh-cn/docs/3.1.4/guide/upgrade/incompatible

升级过程中都会有升级失败的风险，所以如果想在升级失败的状态下回滚，就需要把存储的元数据做备份，这里是以mysql的数据备份为例，其他的请结合数据库的具体情况来定；

3、修改新版本的配置

解压最新的安装到到特定的目录

编辑对应的配置文件，这里涉及的到的配置文件包含下面几项，具体的内容参考《1、Dolphin3 安装篇》；

• install_env.sh 一键部署工具依赖的配置，工具将依赖此配置来部署集群的服务节点；
• dolphinscheduler_env.sh 服务在启动运行中依赖的配置环境；
• common.properties 配置文件在每个服务组件都有用到，这里没有通过统一的配置文件进行分发，需要我们分别手动配置；
• alert-server/conf/common.properties
• api-server/conf/common.properties
• master-server/conf/common.properties
• worker-server/conf/common.properties

说明：这里只有一处是需要修改的，就是新版本的安装目录的配置要和旧版本的安装目录不相同，具体更改如下；

cat /home/dolphin3/apache-dolphinscheduler-3.1.4-bin/bin/env/dolphinscheduler_env.sh

?

4、更新数据库

执行数据库的升级，需要保证“3”步骤中dolphinscheduler_env.sh 文件中关于数据库链接的配置和老版本的完全一致；

另外需要下载对应数据库的驱动程序包到./tools/libs 目录下；

使用的是mysql的话，可以直接下载mysql-connector-java-8.0.16.jar 使用；

同时也需要把mysql-connector-java-8.0.16.jar拷贝到其他模块的lib目录下；

执行数据库升级脚本

注意：在执行这个步骤就需要把老集群完全停掉了；

5、启用最新版本的服务

等待脚本执行完成，然后检查所有的服务状态；

6、验证新版本功能

登录web页面，选定时区，再次执行任务就可以正常显示时间了。

总结:整体的升级过程不算很复杂，只需要在中间的配置过程中保证配置上和老集群保持一致。