中文标题【升级 Confluence】
在这个指南中，我们将会与你一同对最新的 Confluence 站点在 Windows 或者 Linux 平台进行安装和更新。
如果你的 Confluence 安装实例是当前的许可证的话，那么对 Confluence 进行升级是免费的。请参考页面 Licensing FAQ 中的内容来获得更多的信息。
对 Confluence 进行升级的其他方法：
XML 备份文件不能在升级的时候使用。
本页面中的内容：
在你开始之前
在你对 Confluence 进行升级之前，你需要对下面的一些问题进行了解。
| 使用安装文件的升级方式是否适合你？ | |
你是否具有升级资格？ |
希望对你当前运行 Confluence 的实例的许可证是否当前，你可以进入
如果你的许可证支持以及过期了，请在对 Confluence 进行升级之前按照提示的步骤来对许可证进行更新。
|
我们支持的平台是否有了改变？ | |
| 你是否需要修改你的环境？ |
计划你的升级
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 及其后续版本中可用）。你的软件维护包含在你许可证有效期内，如果你的许可证已经过期了的话，你还是可以使用 Confluence 的，但是在升级之前你需要更新你的许可证。
进入
> 基本配置（General Configuration） > 许可证明细（License Details）根据提示来更新你的许可证。进入
> 插件（Add-ons） 然后向下移动到 Confluence 升级检查（Confluence Update Check）来检查你插件的兼容性。
选择你计划升级的版本然后单击 检查（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 以确定本次升级安装已经成功了。
根据你安装实例的不同和你进行升级的步骤的选择不同，安装升级的过程可能从几分钟到几个小时。
升级以后
7. 拷贝你的数据库驱动
confluence/WEB-INF/lib ，这个目录在你的新安装目录下。如果你使用的是 Microsoft SQL 和 Postgres 数据库，你可以忽略这个步骤。
8. 重新应用任何修改
在升级和和整合的过程中，Confluence 安装下面的配置将会被修改：
- TCP 端口的值，在
<install-directory>/conf/server.xml文件中。 - Confluence home 目录的位置，在
<install-directory>/confluence/WEB-INF/classes/confluence-init.properties属性文件中。
所有其他的自定义配置，包括 CATALINA_OPTS 参数，这个参数在你的 <install-directory>/bin/setenv.sh / setenv.bat 文件中，都需要手动修改。
9. 更新你的反向代理，并且确定 Confluence 能够正常访问
如果你正在计划从 Confluence 5.x 升级 Confluence 6.x 你需要修改你的服务器反向代理（如果你使用了的话），并且添加 Synchrony，Synchrony 在协同编辑中使用。请参考 Proxy and SSL considerations 页面中的内容来获得更多的信息，你需要对你的反向代理来进行配置。
一旦你的升级完成，你将可用访问 Confluence（通过代理访问，不是直接访问）并且：
- 进入 > 基本配置（General Configuration） > 协同编辑（Collaborative editing） 然后检查 Synchrony 的状态是否在运行（running）。
- 对任何页面在浏览器中进行编辑，并且确定你能够连接 Synchrony。
如果 Synchrony 没有运行或者你可以在编辑器中查看到错误，请访问 Troubleshooting Collaborative Editing 页面获得建议的修改步骤，有可能是你的反向代理没有配置正确。
问题解决
升级的时候遇到了问题了吗？
如果你想尝试重新进行升级的话，你需要首先重新恢复老的备份。不要尝试再次对 Confluence 进行升级或者在升级失败后重新启动老的 Confluence。