CentOS Dolphin更新与升级指南

CentOS环境下Dolphin更新与升级指南

一、明确Dolphin所指对象

在CentOS系统中，“Dolphin”主要有两种常见指向：一是Apache DolphinScheduler（分布式工作流调度系统），二是KDE Plasma桌面环境的默认文件管理器。以下指南将分别针对这两种情况进行详细说明。

二、Apache DolphinScheduler（调度系统）更新与升级步骤

1. 升级前准备工作

• 数据备份：备份DolphinScheduler元数据库（MySQL/PostgreSQL）、conf/目录下的所有配置文件、resources/目录下的自定义脚本及JAR包等资源，避免升级过程中数据丢失。
• 版本兼容性检查：确认当前版本是否支持直接升级到目标版本（如从1.x升级到3.x需逐步升级），并检查JDBC驱动、ZooKeeper等依赖组件版本是否符合目标版本要求。
• 环境检查：确保服务器CPU、内存、磁盘空间满足新版本最低要求；停止所有正在运行的调度任务，防止任务状态丢失。

2. 升级步骤

• 停止所有服务：根据部署方式停止DolphinScheduler服务。若为集群部署，可通过sh ./script/stop-all.sh命令停止全部服务。
• 数据库升级：修改./bin/env/dolphinscheduler_env.sh中的数据库配置，手动下载所需JDBC驱动jar包并放入./tools/libs目录；执行sh ./tools/bin/upgrade-schema.sh脚本完成数据库结构升级。
• 服务升级：修改bin/env/install_config.conf配置文件（根据伪集群或集群部署调整相关参数），运行sh ./bin/start-all.sh重启所有服务。

3. 升级后验证

• 服务状态检查：通过curl http://localhost:12345/dolphinscheduler/actuator/health命令检查API健康状态，使用tail -n 100 logs/api-server.log查看日志确认无异常。
• 任务执行验证：手动触发一个测试工作流，验证调度、任务执行、告警通知功能是否正常，检查历史任务状态是否完整迁移。
• 功能兼容性验证：确认原有API接口、自定义插件、租户配置等功能正常，UI操作（如工作流定义、任务依赖配置）无报错。

4. 回滚方案

• 数据库恢复：使用升级前的数据库备份文件恢复元数据库。
• 服务回滚：停止新版本服务，恢复旧版本安装目录，使用旧版本配置文件启动服务。

三、KDE Dolphin文件管理器（桌面应用）更新与升级步骤

1. 使用YUM/DNF包管理器更新（推荐普通用户使用）

• 更新系统包：
  • CentOS 7：sudo yum update -y
  • CentOS 8及以上：sudo dnf update -y（若未安装DNF，可通过sudo yum install dnf安装）。
• 更新KDE Plasma及Dolphin：
  • CentOS 7：sudo yum update @kde-plasma-desktop -y（更新整个KDE Plasma桌面环境，包含Dolphin）
  • CentOS 8及以上：sudo dnf upgrade @kde-plasma-desktop -y。
• 重启Dolphin：更新完成后，在终端输入dolphin命令重启文件管理器，或在图形界面中重新打开。

2. 从源码编译安装（高级用户，获取最新特性）

• 安装依赖项：

  sudo yum groupinstall "Development Tools" -y  # 安装开发工具链
  sudo yum install qt5-qtbase-devel qt5-qtdeclarative-devel kdelibs-devel -y  # 安装Dolphin依赖的Qt及KDE库
  ```。  
  

• 下载并编译源码：
  • 访问KDE Dolphin官方网站或GitHub仓库（如https://download.kde.org/stable/dolphin/）下载最新稳定版源码（如dolphin-5.x.x.tar.xz）；
  • 解压并进入目录：tar -xf dolphin-5.x.x.tar.xz && cd dolphin-5.x.x；
  • 创建构建目录并编译：

    mkdir build && cd build
    cmake ..  # 配置编译选项
    make -j$(nproc)  # 编译（使用多核加速）
    sudo make install  # 安装到系统目录
    ```。  
    

• 重启Dolphin：编译安装完成后，在终端输入dolphin命令启动最新版本。

3. 使用KDE软件中心更新（图形界面操作）

• 打开KDE软件中心（Application Menu → Software Center）；
• 搜索“Dolphin”，进入详情页面；
• 若有可用更新，点击“Update”按钮即可完成更新。

四、注意事项

• 备份数据：无论是DolphinScheduler还是KDE Dolphin，升级前均需备份关键数据（如数据库、配置文件、个人文件），防止意外丢失。
• 检查兼容性：更新前确认新版本与系统环境（如CentOS版本、依赖组件）兼容，避免出现无法启动或功能异常的问题。
• 查看日志：若升级或更新过程中出现错误，可通过查看相关日志（如DolphinScheduler的logs/api-server.log、KDE的~/.xsession-errors）定位问题。
• 遵循官方文档：优先参考Apache DolphinScheduler官方升级指南（如GitHub Wiki）或KDE Plasma社区文档，获取最新、最准确的更新步骤。