Atlassian：Confluence升级

Atlassian：Confluence升级

在本指南中，我们将引导您使用安装程序将您的 Confluence 站点升级到 Windows 或 Linux 上的最新 Confluence 版本。

如果您有当前的软件维护，可以升级到任何更高版本。 请参阅我们的许可常见问题解答以了解更多信息。 

 

其他升级 Confluence 的方法：

• 手动 – 不使用安装程序升级服务器或单节点数据中心。

• 停机的集群 – 升级您的数据中心集群。

• 无需停机的集群 - 滚动升级到兼容的错误修复版本，无需停机。

不应使用 XML 备份来升级 Confluence。

在你开始之前

在升级 Confluence 之前，您需要回答几个问题。 

哪种升级方法是最佳选择？	您可以选择使用安装程序进行升级，也可以使用 zip 或 tar.gz 文件手动升级。 在大多数情况下，安装程序是升级 Confluence 实例的最简单方法。 如果您符合以下条件，则需要手动升级： 作为本次升级的一部分，移动到另一个操作系统或文件位置。 从Confluence 3.5或更早版本升级 从Confluence 5.6或更早版本升级，并且之前使用EAR/WAR发行版将Confluence部署到现有的应用服务器。  执行滚动升级，并且需要单独升级每个节点。
你有资格升级吗？	要检查您的许可证的软件维护是否是最新的，请转到配置 > 常规配置 > 疑难解答和支持工具，并确保许可证支持期未过期。   软件维护：在此期间的任何时候都可以升级。   如果你的支持期已经过期，请按照提示更新你的许可证，并在升级前重新申请。
我们支持的平台有变化吗？	查看你要升级的Confluence版本的支持平台页面。这将给你提供关于支持的操作系统、数据库和浏览器的信息。 最好知道： Confluence安装程序包括Java（JRE）和Tomcat，所以你不需要单独升级这些。 如果你需要升级你的数据库，请务必阅读你计划升级到的Confluence版本（以及任何介于两者之间的版本）的升级说明，以检查你可能需要进行的任何数据库配置更改。
你需要改变你的环境吗？	较新的 Confluence 版本有时需要更改您的环境，例如提供更多内存或调整您的反向代理设置。 最好知道： 我们使用升级说明来传达会影响您的更改，例如： 对支持的数据库、内存要求或其他将影响你的环境的变化。 在这个版本中发生重大变化或被删除的功能。 你可能需要在升级后立即在你的实例或环境中采取的行动。 阅读你要升级的版本和介于两者之间的版本的说明是很重要的。例如，如果你要从5.8升级到5.10，你应该阅读5.9和5.10的升级说明。

 

计划你的升级

创建一个自定义的升级计划

计划升级？你可以在Confluence中立即生成一个定制的升级计划。 前往 配置> 常规配置 > 计划你的升级

你需要安装一个兼容版本的故障排除和支持工具应用程序。 

1. 确定你的升级路径

使用下面的表格来确定从当前版本到最新版本Confluence的最有效升级路径。

您的版本	推荐升级到Confluence 7的路径
2.7或更早	升级到2.7.4，然后升级到3.5.17，并遵循以下路径。
2.8至3.4	升级到3.5.17，并遵循以下路径。
3.5	升级到5.0.3，并遵循以下路径。
4.0至4.3	升级到5.10.x，并遵循下面的路径。
5.0至7.x	直接升级到最新版本的Confluence 7。

如果你要升级到下一个错误修复更新（例如，从7.9.0到7.9.4），你可以在不停机的情况下升级。

 

 

Confluence 7是一次重大升级

请务必检查Confluence升级矩阵，做一个完整的备份，并在升级你的生产站点之前在非生产环境中测试你的升级。

企业版本

长期支持版本是一个功能版本，在其整个两年的支持窗口期间，得到回传的关键安全更新和关键错误修复。如果你每年只能升级一次，可以考虑升级到长期支持版本。 

长期支持版本最初被称为企业版。

2. 完成升级前的检查

• 检查你计划升级的版本（以及任何介于两者之间的版本）的升级说明。 

• 转到配置 > 常规配置 > 计划你的升级，然后选择你想升级的版本。这将运行一些升级前的检查。 

• 转到配置 > 常规配置 > 故障排除和支持工具，运行健康检查。 

• 如果你的许可证中包含的软件维护期已经过期，你可以继续使用Confluence，但你需要在升级前更新。

• 进入 >常规配置>许可细节，按照提示更新你的许可。

• 如果你使用的是嵌入式（试用）数据库，你应该在升级前迁移到另一个数据库。参见嵌入式H2数据库以了解更多信息。

• 数据库的字符编码必须设置为UTF+8（或Oracle数据库的AL32UTF8）。除非你有正确的字符编码，否则你将无法升级到当前的Confluence版本。

 

• 进入配置>管理应用程序，向下滚动到Confluence更新检查，检查你的市场应用程序的兼容性。

• 选择你打算升级的版本，然后点击检查。

 

如果你有不兼容的附加组件...

如果你的用户依赖特定的市场应用，你可能想等到它们兼容了再升级Confluence。供应商通常会在主要版本发布后很快更新他们的应用程序。

最好知道：

• 如果一个应用程序还不兼容，你可以在升级时暂时停用它。

• 在新版本发布后，Atlassian实验室和其他免费应用程序的兼容性信息通常不会立即提供。在许多情况下，应用程序仍然可以工作，所以在升级你的生产站点之前，请在测试站点中试一试。

 

3. 在测试环境中升级Confluence

• 创建一个当前生产环境的暂存副本。 

• 请参阅为升级Confluence创建一个暂存环境，以帮助创建一个环境来测试你的升级。

• 按照下面的步骤来升级你的测试环境。 

•  

• 在升级你的生产环境之前，测试任何不支持的用户安装的应用程序、自定义（如自定义主题或布局）和代理配置（如果可能）。   

升级Confluence

4. 备份 

• 备份你的数据库并确认备份是正确创建的。 

• 如果你的数据库不支持在线备份，你就需要先停止Confluence。  

一旦你确认你的数据库备份是成功的，你可以选择禁用升级恢复文件的自动生成，因为这个过程对于中等规模或较大的网站来说可能需要很长时间。

• 备份你的安装目录
  安装程序将完全替换这个目录，所以你添加的任何文件（如keystore或SSL证书）都不会被保留。安装向导会在开始升级前备份这个目录，但你也应该先手动备份。 
   

• 备份你的主目录。  
  安装向导给你提供的选项是，作为安装过程的一部分，你也可以备份你的主目录，但你也应该在开始升级前手动备份这个目录。 
    

我的主目录在哪里？

你可以在<installation-directory>/confluence/WEB-INF/classes/confluence-init.properties文件中找到主目录的位置。

这是你的搜索索引和附件存储的地方。如果你在Confluence主目录之外存储附件，你也应该备份你的附件目录。 

 

5. 下载Confluence

下载适合你的操作系统的安装程序。 

 

6. 运行安装程序

• 运行安装程序

运行该.exe文件。我们建议使用Windows管理员帐户。

如果提示允许升级向导对你的计算机进行修改，请选择 "是"。如果你不这样做，安装向导对你的操作系统的访问将受到限制，任何后续的安装选项将受到限制。

 

• 改变到你下载Confluence的目录，然后执行此命令，使安装程序可执行。

$ chmod a+x atlassian-confluence-X.X.X-x64.bin

其中X.X.X是你下载的Confluence版本。

接下来，运行安装程序——我们建议使用 sudo 运行安装程序：

$ sudo ./atlassian-confluence-X.X.X-x64.bin

您还可以选择以 root 用户权限运行安装程序。

  

• 按照提示升级 Confluence：
   

  • 出现提示时，选择升级现有的 Confluence 安装（对于 Linux 用户，这是选项 3）。

  • 确保向导建议的现有 Confluence 安装目录正确（如果您在同一台机器上安装了多个 Confluence，这一点尤其重要）。

  • 强烈建议备份 Confluence 主页。 这将创建 Confluence 主目录和安装目录的 .zip 备份。

  • 安装向导会通知您 Confluence 安装目录中的自定义设置。 记下这些，因为您以后需要重新应用它们。

安装向导通知你自定义的能力取决于你现有的 Confluence 实例是如何安装的：

• 如果你当前的Confluence实例是用安装程序安装的，向导将检查整个Confluence安装目录。

• 如果你当前的Confluence实例是手动安装的，它将只检查Confluence安装目录下的confluence子目录。安装向导不会通知你在任何其他目录中的修改，例如对bin目录下的启动脚本的修改或对server.xml文件的修改（如SSL配置）。 

你不会收到关于你添加到安装目录中的文件的通知，所以一定要先把它们备份。

• 该向导将关闭你的Confluence实例并继续进行升级。一旦完成，它将重启Confluence，然后你可以在浏览器中启动Confluence，确认升级成功。
   
  取决于你的实例的大小和要运行的升级任务的数量，这个步骤可能需要几分钟或几个小时。

升级后

7. 复制你的数据库驱动程序

如果你使用的是Oracle或MySQL数据库，你需要从现有的Confluence安装目录中复制jdbc驱动jar文件到新安装目录中的confluence/WEB-INF/lib。

Microsoft SQL和Postgres用户可以跳过这一步。  

8. 如果需要的话，重新安装服务（仅Windows）。

如果你在Windows上以服务形式运行Confluence，你应该删除现有的服务，然后通过运行<install-directory>/bin/service.bat重新安装服务。

这将确保服务获得最新的JVM选项。 

9. 重新应用任何修改

在升级过程中，向导从你现有的Confluence安装中迁移了以下内容。

• 你的<install-directory>/conf/server.xml文件中的TCP端口值。 

• <install-directory>/confluence/WEB-INF/classes/confluence-init.properties中的Confluence主目录的位置。
    

所有其他定制，包括你的<install-directory>/bin/setenv.sh / setenv.bat文件中的CATALINA_OPTS参数，都需要手动重新应用。  

 

任何其他配置、定制（包括<install-directory>/conf/server.xml文件中的任何其他修改）、<install-directory>/bin/setjre.sh或setjre.bat中你自己的Java安装路径或添加到安装目录中的其他文件在升级期间不会被迁移，需要手动重新应用。

• 停止你升级后的Confluence实例。

• 编辑每个文件，并在升级后的Confluence安装目录中重新应用定制的文件。

• 复制任何其他文件（如keystore或SSL证书）。

• 重新启动升级后的Confluence实例。

我们强烈建议你在升级生产实例之前在测试实例中测试你的定制，因为Confluence可能已经发生了变化，使你的定制无法使用。

手动编辑新文件，而不是复制旧文件，因为这些文件中的默认配置可能在不同的Confluence版本中有所改变。

 

10. 更新你的应用程序（附加组件）

你可以更新任何与新版本的Confluence兼容的应用程序。

• 转到

 > 管理应用

• 将您的应用更新到受支持的版本。

在这个阶段，清除插件缓存会很有用。 了解如何执行此操作

这是可选的，但可用于避免第三方应用程序和插件出现任何问题。

 

11. 更新您的反向代理并检查您是否可以访问 Confluence

如果您要从 Confluence 5.x 升级到 Confluence 6.x，则需要修改您的反向代理（如果使用）以添加 Synchrony，这是协作编辑所必需的。 有关您需要对代理配置进行的更改的详细信息，请参阅代理和 SSL 注意事项。

升级完成后，您应该访问 Confluence（通过您的反向代理，而不是直接）并且：

• 前往配置 > 一般配置 > 协作编辑，检查Synchrony状态是否运行。 

• 编辑任何页面，检查你的浏览器是否可以连接到Synchrony。

如果Synchrony没有运行，或在编辑器中看到错误，请参见 "协作编辑的故障排除"，因为你可能有一个配置错误的反向代理。 

故障排除

出了什么问题吗？

如果你需要重试升级，你必须先恢复升级前的备份。  不要尝试再次运行升级，或者在升级失败后再次启动旧版本的Confluence。 

 

• 不能继续升级，因为许可证已过期
  如果你的许可证已经过期，并且在升级前没有更新和重新申请，你将在升级过程中收到错误。有关如何解决这个问题的信息，请参见升级超过当前许可期限。

• 由于与反病毒软件有冲突，无法继续升级
  一些反病毒或其他互联网安全工具可能会干扰Confluence的升级过程，并阻止该过程成功完成，特别是当你把Confluence作为一个Windows服务运行时。如果你的防病毒/互联网安全工具遇到或预计会遇到这样的问题，请在进行Confluence升级前先禁用该工具。

• 数据库不支持在线备份
  升级向导会提示你使用数据库的备份工具备份你的数据库。如果你的数据库不支持在线备份，请停止升级进程，关闭Confluence，进行数据库备份，然后再次运行安装程序，继续升级。

• 升级需要很长的时间
  如果你有一个非常大的数据库（即数据库备份需要很长的时间来完成），将confluence.upgrade.recovery.file.enabled系统属性设置为false会加速升级过程。只有在执行升级前有一个备份数据库和验证备份的过程时，才应该使用它。

• Confluence不能启动
  不兼容的市场应用有时会阻止Confluence的成功启动。你可以在启动Confluence时暂时禁用所有用户安装的应用程序来解决这个问题。参见启动和停止Confluence获取更多信息。

• 协作编辑错误
  如果Synchrony没有运行，或者你看到一个错误，请前往故障排除协作编辑，了解如何在你的环境中启动和运行协作编辑。最常见的问题是配置错误的反向代理或端口8091对Synchrony不可用。   

升级后空间目录为空
如果你从Confluence 6.3或更早的版本升级，有一个已知的问题，即空间目录中不出现空格。你需要在升级后重新索引你的网站来解决这个问题。

 

你也可以参考Confluence知识库中的升级故障排除指南，或者从Atlassian Answers社区查看答案。