如何手动将WSO2 API Manager 4.0升级至4.1或4.2版本？

核心升级步骤说明 #

绝对不能仅替换文件+保留deployment.toml就完成升级，必须结合数据库脚本执行和配置迁移，具体步骤如下：

• 下载目标版本（4.1或4.2）的全新安装包，解压至独立目录，禁止覆盖原有4.0安装目录
• 迁移配置文件：
  • 从4.0的<APIM_4.0_HOME>/repository/conf目录复制deployment.toml到新安装包对应目录，但需对比目标版本默认的deployment.toml，合并新增的配置项，不能直接覆盖后忽略差异
  • 复制自定义证书、角色权限、租户配置等文件（如<APIM_4.0_HOME>/repository/conf/security下的证书、<APIM_4.0_HOME>/repository/conf/identity下的自定义身份提供者配置）到新目录对应位置
• 数据库升级：
  • 目标版本安装包内自带数据库升级脚本，路径为<APIM_TARGET_HOME>/dbscripts/apim/，根据你使用的数据库类型（MySQL、PostgreSQL等）进入对应子目录
  • 先完整备份原有4.0的所有数据库（含APIM、Identity、Registry等）
  • 按版本顺序执行升级脚本：从4.0升4.1执行4.0_to_4.1系列脚本，从4.1升4.2执行4.1_to_4.2系列脚本，禁止跳步
• 迁移运行时数据：
  • 复制4.0目录下<APIM_4.0_HOME>/repository/deployment/server中的API定义、网关配置、序列等自定义内容到新目录对应位置
  • 复制<APIM_4.0_HOME>/repository/resources下的自定义资源（如自定义主题、错误页面）到新目录

常见疑问解答 #

• 为什么不能直接替换文件？：4.0到4.1/4.2不仅有配置项变更，核心组件依赖、目录结构也有调整，直接覆盖会导致组件加载失败
• 数据库必须执行脚本吗？：是的，每个版本都会调整数据库表结构、数据（如新增字段、修改索引、迁移数据），不执行脚本会导致API Manager启动失败或功能异常
• 找不到官方升级文档怎么办？：可在目标版本安装包的<APIM_TARGET_HOME>/docs目录找到离线升级指南，或通过dbscripts目录下的脚本文件名推断升级路径

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