查找JFrog Artifactory 5.6.2升级至6.23.33专业版的官方操作文档

首先明确官方验证过的合规升级路径：禁止从5.6.2直接跨版本升级到6.23.33，必须经过中间过渡版本，完整路径为 5.6.2 → 6.0.1 → 6.23.33，跳过中间版本会触发数据库表结构不兼容、元数据损坏、配置丢失等问题，官方不提供跳过版本升级的问题排查支持。

升级前强制准备项（官方文档明确要求） #

• 全量冷备份：停止当前运行的Artifactory进程，完整备份以下内容：
  • $ARTIFACTORY_HOME/etc 全目录（含系统配置、仓库配置、密钥文件）
  • Filestore 构件存储目录
  • 数据库全量备份（内置Derby库直接备份$ARTIFACTORY_HOME/derby目录，外接数据库执行对应数据库全量dump）
    备份完成后必须验证备份文件完整性，确认可正常恢复后再继续操作
• 环境预检：
  • 登录5.6.2管理员后台，等待所有后台任务（仓库索引、垃圾清理、仓库复制、构件迁移）全部执行完成，临时关闭所有定时任务
  • 提前准备JDK 8环境，要求版本为1.8u202及以上，6.x系列不支持JDK7、JDK9及以上版本
  • 若部署了自定义Groovy插件，提前对照6.x插件API规范做兼容性调整，5.x版本的自定义插件在6.x环境下会直接加载失败
• 端口、权限校验：确认Artifactory运行用户对安装目录、存储目录有完整读写权限，所需端口未被占用

标准升级操作流程 #

1. 先升级至过渡版本6.0.1
   • 停止5.6.2版本服务，确认进程完全退出无残留
   • 按照你当前的部署方式（压缩包/RPM/Debian/Docker）部署6.0.1版本，部署时保留原有etc目录的所有配置，不要覆盖
   • 启动6.0.1服务，持续观察$ARTIFACTORY_HOME/logs/artifactory.log日志，等待数据库表结构自动升级完成、服务完全启动，这个过程根据数据量不同耗时数分钟到半小时不等，禁止中途杀进程
   • 服务启动后验证核心功能：管理员登录、仓库浏览、构件上传下载、权限校验、用户组配置全部正常，确认无报错后停止6.0.1服务
2. 从6.0.1升级至目标版本6.23.33
   • 部署6.23.33版本安装包，同样保留原有etc目录配置
   • 启动服务，观察日志等待配置迁移、表结构升级完成
   • 服务启动后依次执行全量仓库元数据重建、手动触发一次垃圾清理，验证所有业务功能正常后即可对外开放使用

官方明确的升级禁忌 #

升级过程中禁止手动修改数据库表结构，所有结构升级由服务启动时自动完成，手动修改会触发版本校验失败导致服务无法启动
集群部署场景下必须先升级主节点，主节点升级完成验证正常后再逐个升级从节点，禁止不同版本节点同时接入集群
升级后第一次登录管理员后台时，若弹出版本变更确认提示，确认所有配置项正常后再开放普通用户访问权限

内容的提问来源于stack exchange，提问作者Sangamnath Kharade