1. 确定你升级路径
使用下面的表格来确定最佳的升级路径来让你的Confluence 从当前版本升级到最新的 Confluence 版本。
你的版本 |
推荐升级到 Confluence 的升级路径 |
|---|---|
| 2.7 或者更早 | 升级到 2.7.4 然后升级到 3.5.17，然后按照下面的升级路径。 |
| 2.8 到 3.4 | 升级到 3.5.17，然后按照下面的升级路径。 |
| 3.5 | 升级到 5.0.3 ，然后升级到最新的 Confluence 6。 |
4.0 到 4.3 |
升级到 5.10.x ，然后升级到最新的 Confluence 6。 |
5.0 到 6.x |
直接升级到最新的 Confluence 6。 |
Confluence 是一个主要的升级版本
请确定你在对你生产环境上进行升级之前，已经阅读了 Confluence 6.0 Upgrade Notes，进行了必要的备份，进行了测试你的升级（这边测试升级不应该在生产环境上进行测试）。
2. 完成预升级检查
针对你计划升级的版本查看 Upgrade Notes 页面来了解升级的内容（和版本直接的内容）。
进入
> 基本配置（General Configuration） > 问题检查和支持工具（Troubleshooting and support tools） 来运行健康检查（Confluence 及其后续版本中可用）。
进入 and scroll down to the Confluence Update Check to check the compatibility of your add-ons.
选择你计划升级的版本然后单击 检查（Check）。
3. 在测试环境中升级 Confluence
- 创建一个从当前生产环境中拷贝数据的策略。
请参考 Create a staging environment for upgrading Confluence 页面中的内容来获得如何创建一个升级的测试环境。
请按照升级的步骤来在你的测试环境中进行升级。
在对正式服务器进行升级之前，测试任何不支持的用户自定义安装的应用，自定义配置（例如主题和布局）和反向代理服务器配置（如果你安装了的话）。
升级 Confluence
4. 备份
- 备份你的数据库（database）并确定你的备份被正确创建了。
如果你的数据库不能支持在线备份，那么你需要首先停止你的 Confluence 服务。
- 备份你的安装目录（installation directory）
Confluence 安装程序将会完全重写删除这个目录，任何位于这个目录中你添加的内容（例如一个 keystore 或者 SSL 证书）都会被删除。尽管安装程序在安装之前会备份这个目录中的内容，但是你最好还是手动备份你的这个安装目录。
备份你的 Home 目录（home directory）
安装程序将会在安装的过程中给你一个是否需要备份你的 Home 目录的选项作为安装进程的一部分。但是你最好在安装之前备份 Home 目录中的内容。
5. 下载 Confluence
针对你的操作系统的不同下载安装程序：
- 最新的版本 https://www.atlassian.com/software/confluence/download
- 早期的版本 https://www.atlassian.com/software/confluence/download-archives
6. 运行安装程序
运行安装程序
- 按照 Confluence 的安装提示来进行升级：
- 当提示选择 Upgrade an existing Confluence installation （针对 Linux 这个选项是 3）。
- 请确定安装程序建议的 已经存在的 Confluence 安装目录（Existing Confluence installation directory） 是正确的路径，尤其是针对多个 Confluence 安装实例的情况下。
- 强烈建议 备份 Home 目录（Back up Confluence home） 。这个步骤将会为你的 Confluence home 目录和安装目录创建一个 .zip 备份。
安装进程将会通知你自定义 Confluence 安装目录，请记录这个安装目录，你可能还需要在后续的过程中应用这个设置。
- 当提示选择 Upgrade an existing Confluence installation （针对 Linux 这个选项是 3）。
- 安装进程将会关闭 Confluence 实例然后进行升级。一旦安装升级完成后，你可以在浏览器中运行 Confluence 以确定本次升级安装已经成功了。
根据你安装实例的不同和你进行升级的步骤的选择不同，安装升级的过程可能从几分钟到几个小时。
