Page tree
Skip to end of metadata
Go to start of metadata

中文标题【手动升级 Confluence】

在本指南中,我们将会帮助你使用 zip / tar.gz 文件将你的 Confluence 安装实例在 Windows 或者 Linux 版本中升级到最新的版本。

升级到任何最新的版本都是免费的,如果你具有当前的软件维护许可证的话。请参考我们的 Licensing FAQ 来找到更多的信息。


对 Confluence 进行升级的其他方法:

XML 备份文件 不应该 应用到 Confluence 的升级中。

本页中的内容:

开始升级之前

在你对 Confluence 进行升级之前,你需要询问一下下面的问题。

手动升级的方式是否适合你? 
 告诉我更多...


你可以选择使用安装程序,zip 或者 tar.gz 文件进行升级。在大部分情况下,使用安装程序为升级你 Confluence 安装实例最简便的方法。如果你遇到了下面的情况,那么你需要手动进行升级了:

  • 你现在移动到其他的操作系统或者文件的路径属于本次升级的一部分。
  • 你正在从 Confluence 3.5 或者早期版本上进行升级。
  • 你正在从 Confluence 5.6 或者早期版本上进行升级,但是这些早期版本使用的是 EAR/WAR 分发包来进行部署到一个已经存在的应用服务器上的。

你的系统可以进行升级吗?

 告诉我更多...


希望对你当前运行 Confluence 的实例的许可证是否当前,你可以进入  > 基本配置(General Configuration) > 问题检查和支持工具(Troubleshooting and support tools 来确定你的许可证支持是否过期了。

  1. 软件维护(Software maintenance:在这个时间区间内进行升级。

如果你的许可证支持以及过期了,请在对 Confluence 进行升级之前按照提示的步骤来对许可证进行更新。

我们支持的平台是否被修改了?

 告诉我更多...

请查看 Supported Platforms 页面中的内容来获得你升级的 Confluence 支持的平台。在这个页面中我们给出了 Confluence 支持的操作系统,数据库和浏览器。

你应该了解:

  • 如果你需要对你的 Java 进行升级,请记住更新你的的 JAVA_HOME 变量到新的版本路径。
  • Confluence 的安装器中包含有 Tomcat,因此你不需要单独安装新的 Tomcat。
  • 如果你需要对你的数据库也进行升级的话,请确定将你的数据库升级到 Confluence 支持的数据库版本(或者任何之间的版本)。并且确定对数据库进行必要的修改。
你需要对环境进行修改吗?
 告诉我更多...


更新的 Confluence 版本有时候需要要求修改你的环境,例如提供更多的内存或者调整反向代理设置。

你应该了解:

我们使用 升级日志 来告诉你 Confluence 的升级版本将会对你产生什么影响,例如:

  • 修改支持的数据库,内存的需求,和其他的修改将会影响到你的 Confluence 运行环境。
  • Confluence 将会进行的重大修改和从这次发行版本中删除的内容。
  • 当你升级完成后,你应该对你 Confluence 安装实例马上进行的操作。

针对你进行升级的 Confluence 版本之间,这些信息是非常重要的,你应该有所了解。例如,如果你从 Confluence 的 5.8 版本升级到 5.10 版本,你应该阅读 Confluence 5.9 和 5.10 版本的发行备注。

规划你的升级

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. 完成预升级检查


  1. 针对你计划升级的版本查看 Upgrade Notes 页面来了解升级的内容(和版本直接的内容)。
      

  2. 进入  > 基本配置(General Configuration) > 问题检查和支持工具(Troubleshooting and support tools 来运行健康检查(Confluence 及其后续版本中可用)。

     许可证已过期?

    你的软件维护包含在你许可证有效期内,如果你的许可证已经过期了的话,你还是可以使用 Confluence 的,但是在升级之前你需要更新你的许可证。

    进入  > 基本配置(General Configuration) > 许可证明细(License Details根据提示来更新你的许可证。

     还在使用的是嵌入式数据库?

    如果你使用的是 嵌入式数据库(测试用),你需要在升级 整合到其他的数据库(Migrating to Another Database)

    这个数据库是针对 Confluence 进行评估使用的,我们不推荐在生产环境中使用这个数据库。请参考 Embedded H2 Database 来获得更多的信息。

     数据库字符集不正确?

    数据库的字符集必须设置为 UTF+8(如果你使用的是 Oracle 数据库,那么需要设置为 AL32UTF8 )。如果你的数据库字符集不正确的话,你将没有办法升级 Confluence 到当前最新的版本。

      

  3. 进入   > 插件(Add-ons) 然后向下移动到 Confluence 升级检查(Confluence Update Check)来检查你插件的兼容性。
      

  4. 选择你计划升级的版本然后单击 检查(Check)

     如果你有不兼容的插件...

    如果你的使用依赖一些特定的插件,那么你需要等待这些插件变得可用的时候才考虑对 Confluence 进行升级。Confluence 的插件提供商通常在主要版本更新后较短的时间内都会进行更新。

    你需要了解:

    • 如果你的升级不兼容的话,你可以临时的禁用插件。
    • Atlassian Labs 和其他免费的插件通常不会在新版本发布后马上可用。在绝大部分情况下这些插件还是可以使用的。你可以在对服务器版本进行升级之前先在测试站点中先进行测试。

3. 在测试环境中升级 Confluence

  1. 创建一个从当前生产环境中拷贝数据的策略。
    请参考 Create a staging environment for upgrading Confluence 页面中的内容来获得如何创建一个升级的测试环境。
      
  2. 请按照升级的步骤来在你的测试环境中进行升级。
      

  3. 在对正式服务器进行升级之前,测试任何不支持的用户自定义安装的应用,自定义配置(例如主题和布局)和反向代理服务器配置(如果你安装了的话)。


升级 Confluence

4. 备份 

  1. 备份你的数据库,并且确定的你的数据库备份已经被正确的创建了。
    如果你的数据库不支持在线备份的话,你需要首先停止 Confluence 的运行。
      
  2. 备份你的 Confluence 安装目录(installation directory)Confluence Home 目录(home directory)
      

     我的 home 目录在哪里?

    你可以在 <installation-directory>/confluence/WEB-INF/classes/confluence-init.properties 配置文件中找到你 Home 目录定义的路径。

    在 Home 目录中保存有你的附件和查找索引。如果你的附件文件没有保存在 Home 目录中,那么你还需要对你的附件文件另行进行备份。

5. 下载 Confluence

针对你的操作系统不同,下载正确的安装文件 - https://www.atlassian.com/software/confluence/download

6. 解压文件然后升级 Confluence

  1. 停止 Confluence.
    如果你希望提供不间断访问的话,请参考 Using read-only mode for site maintenance 页面来将 Confluence 修改为只读模式。
      
  2. 解压(unzip)文件到目录中,这个目录是你的新安装目录,而且这个目录与当前的运行目录不能相同。
    备注:针对 Windows 自带的解压归档文件会出现一些问题。我们推荐使用 7Zip 或 Winzip。
      
  3. 编辑  <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties 文件来指向你已经存在的 Confluence home 目录。
      

  4. 如果你现在使用的是 Oracle 或者 MySQL 数据库的话,你需要从你当前已经存在的 Confluence 安装路径下的 JDBC 驱动,拷贝到新的安装路径下面,这个文件位于 confluence/WEB-INF/lib 目录下。
      

  5. 有下面一些更进一步的步骤需要进行:
    • 你通过 Windows 服务(Windows Service)的方式来运行 Confluence

       单击这里延伸阅读...

      如果你在 Windows 中通过服务的方式来运行 Confluence 的话,你需要在 Windows 的命令行中输入下面的命令:

      <Installation-Directory>\bin\service.bat remove Confluence

      在对 Confluence 进行卸载的时候,停止和删除已经存在的 Confluence 服务非常重要。有关更多Confluence 以 Windows 服务方式运行的方法,请参考 Start Confluence Automatically on Windows as a Service 页面中的内容。

      (warning) 通过 Confluence 安装器删除已经安装的 Confluence 服务,你需要运行 <confluence auto installer installation folder>\UninstallService.bat.

    • 如果你使用 JIRA 应用或者 LDAP 用户管理

       单击这里延伸阅读...

      如果你使用 Jira 或者 LDAP 来对用户进行管理,从老的 Confluence 安装实例中拷贝下面的文件到新的 Confluence 升级安装实例中。

      • <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml

      • <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml

    • 如果你使用 Crowd 来进行用户管理

       单击这里延伸阅读...

      如果你正在使用 Crowd 来对进行用户管理,从你老的 Confluence 安装实例中拷贝下面的文件到新的 Confluence 安装实例:

      • <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml

      • <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml (如果你从 Confluence 2.2 或者后续版本进行升级)

      • <Installation-Directory>/confluence/WEB-INF/classes/crowd.properties
    • 如果你的 Confluence 运行在不同的端口(不是默认的 8090)
       

       Click here to expand...

      如果你的 Confluence 没有运行在 8090端口,请更新 <Installation-Directory>\conf\server.xml 文件来更改你使用的端口。

  6. 重启你的 Confluence,你应该不会看见 Confluence 的启动配置向导。

进行升级以后

7. 重新安装服务(仅针对 Windows)

如果你的 Confluence 安装实例在 Windows 中是以服务来运行的话,你需要删除已经存在的 Windows 服务,然后重新安装 Windows 服务。可以通过运行 <install-directory>/bin/service.bat 来进行安装。

请确定你的服务获得最新的 JVM 选项。

8. 重新应用任何修改

如果你对你的 Confluence 安装实例进行了自定义(例如对 SSL 进行了配置,在 server.xml 文件中,或者在 confluence-init.properties 文件中配置了 CATALINA_OPTS 或者 JAVA_OPTS 参数 ),你需要在你安装完成后执行后面的操作:

  1. 停止你已经升级的 Confluence 安装实例。
  2. 在你新的 Confluence 安装实例的安装目录中应用相关的自定义文件。
  3. 重新启动更新后的 Confluence 实例。

我们强烈建议,在对这些配置应用到生产环境之前,在测试环境中对你的自定义配置进行测试,以确定这些自定义的配置能够没有问题的应用到新的 Confluence 版本中。

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 进行再次启动。

 在升级过程中遇到的一些常见问题...


  • 因为许可证过期了而不能进行升级
    如果你的许可证已经过期了,但是你再升级时候还没有对许可证进行更新,你将会在升级的过程中收到许可证的提示。请参考 upgrading beyond current license period 页面中的内容页来解决这个问题。
  • 协同编辑错误
    如果 Synchrony 没有运行,或者你看到了错误,请访问  Troubleshooting Collaborative Editing 页面来获得有关协同编辑的更多信息。最常见的问题就是反向代理没有正确配置或者 Synchrony 使用的 8091 端口不可用。

你也可以参考 Confluence 知识库中的 Upgrade Troubleshooting 内容,或者访问 Atlassian Answers 中 Confluence 社区里面的解决方案。

  • No labels