HoneyMoose

在签名的章节中，我们主要是针对没有完全合并完成余下的为合并内容的异常处理。最常见的情况是内容以及被合并了，但是页面使用 wiki 标记的内容没有被合并，通常这些 wiki 标记的内容使用了 'unmigrated-wiki-markup' 宏。任何使用了这个宏的页面将会显示在合并报告中。这部分的内容还是可以查看和编辑的，但是因为使用了是 wiki 的标记，这部分的内容没有办法使用富文本编辑器的所有功能。 通常遇到这部分的情况的页面是页面中使用了未知的宏（unknown macro）或者使用的宏不能兼容 Confluence 4.x。 有下面 2 种办法可以修正这个问题： 安装一个与 Confluence 4.x 兼容的宏，请参考  Plugin Development Upgrade FAQ for 4.0  页面中的内容。 对页面进行编辑，删除使用不兼容宏的部分的内容。 不管你选择哪种解决方案，你可以尝试强制合并所有的内容（包括模板中的内容）以及使用 'unmigrated-wiki-markup' 宏，这个特性可以在  <Confluence Address>/admin/unmigratedcontent.action  中找到。 备注 我们将 Confluence 的存储格式定义为 'XHTML-based'。实际上，正确的说法应该是被称为 XML，因为 Confluence 存储的格式并不完全与 XHTML 的定义相同。实际上 Confluence 在存储中还包括了有关宏的自定义元素以及更多。我们使用术语 'XHTML-based' 来进行定义，因为在我们的存储格式中 HTML 占了大部分的内容。 https://www.cwiki.us/display/CONF6ZH/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format

如果在系统合并的时候有任何内容的合并失败的话，一个 Confluence 的管理员可以再次重新启动内容合并（请参考前面页面的内容）。只有内容还是使用 wiki 格式的才会被合并，因此重新合并所需要的时间总是会少于原始内容合并所需要的时间的。 希望手动运行内容合并： 在你的浏览器中打开下面的链接：  <Confluence Address>/admin/force-upgrade.action 在  运行的升级任务（Upgrade task to run）  下拉列表中，选择  wikiToXhtmlMigrationUpgradeTask  。 选择  强制升级（Force Upgrade） 。 https://www.cwiki.us/display/CONF6ZH/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format

为了监控升级的过程，你应该查看  application log  日志中的输出。 通常日志经常将会显示多个日志实例，这个实例是定义在日志的 INFO 级别的，通常格式如下： WikiToXhtmlMigrationThread-n - Migrated 2500 of 158432 pages, this batch migrated 500/500 without error 针对每一个独立的页面，可能会显示很多日志的消息，但是任何错误将会显示一个独立合并日志，一旦所有的内容都被处理完成后。下面是一个有关报表的基本显示内容： Wiki to XHTML Exception Report: Summary: 0 settings values failed. 0 PageTemplates failed. 2 ContentEntityObjects failed. Content Exceptions: 1) Type: page, Id: 332, Title: Release Notes 1.0b3, Space: DOC - Confluence 4.0 Beta. Cause: com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro link is unknown.. Message: The macro link is unknown. 2) Type: comment, Id: 6919, Title: null, Global Scope. Cause: com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro mymacro is unknown.. Message: The macro mymacro is unknown. 在报表中的每一部分定义了在合并过程中可能会导致异常的内容和显示的异常。 在绝大部分情况下，如果合并到新 XHTML 存储格式的错误内容将会显示在这里，...

如果你现在正在将 Confluence 从一个老的版本升级到  Confluence 4.0 或者更新的版本  （例如从 Confluence 3.5.x 或者更老的版本），在升级的过程中一个内容整合过程也会进行。这个过程将不会对你的升级造成伤害，因为你已经存在内容是不会被重写的。作为替代，合并进程将会创为每一个 wiki 的页面创建一个新的版本。这个新版本将会使用一个新的 XHTML 的存储格式，所以你可以在 Confluence 的富文本编辑器中进行编辑。 另外，你现在正在将 Confluence 从一个老的版本升级到  Confluence 4.3 或者更新的版本 ，升级程序将会自动的合并你的页面模板，请参考  Migration of Templates from Wiki Markup to XHTML-Based Storage Format  页面中的内容。 注意： 尽管这个合并过程是无害的，但是你还是必须要在升级的过程中对你的数据库进行备份，同时也需要对 home 目录中的内容进行备份，当你决定对 Confluence 进行任何的 修改或者升级 的时候，这个步骤必不可少。 合并进程 基于你 Confluence 安装的大小，从 Wiki 标记页面合并到新的 XHTML 页面的过程可能需要耗费比较多的时间。具体合并所需要的时间也比较难估计，多个因素都会对这个时间造成影响。基于一个大致的估算，一个有 130,000 页面，总计大致 700MB 的内容，合并需要耗费 6 分钟左右。 下面的配置属性可以进行修改以便以对升级的过程进行控制： 属性 用途 默认值 confluence.wiki.migration.threads 内容合并使用的线程数量 4 confluence.wiki.migration.batch.size 每个批量处理的数量 500 confluence.wiki.migration.versioncomment 关联到早期版本中的页面评论 "Migrated to Confluence 4.0" （有关 Confluence 属性配置的内容，请参考  这篇文档 ）。 再次提示，针对 Confluence 的安装，每个系统的安装可...

这个页面中的文章将会为 Confluence 管理员为  Confluence 升级完成后  提供检查列表以确保 Confluence 的升级顺利完成。这个检查列表没有包含所有需要检查的错误，但是将会检查会通常出现错误的地方。 在你之前 当你在 Confluence 完成升级后，你应该能够在  atlassian-confluence.log  日志文件中看到下面的信息： 2010-03-08 08:03:58,899 INFO [main] [atlassian.confluence.upgrade.AbstractUpgradeManager] entireupgradeFinished Upgrade completed successfully 如果你没有在日志中看到如上面内容类似的信息话，这表明你的升级有可能没有顺利完成。请查看  Upgrade Troubleshooting  文档来了解推荐的修改步骤。 升级检查列表 下面是你再升级完成后需要进行的检查列表 1. 编辑器 编辑页面来确定你的浏览器能够正常的进行协同编辑，这个通常是在协同编辑的时候需要的。如果你的协同编辑不能够正常工作的话，请参考  Troubleshooting Collaborative Editing  页面中的内容。 2. 布局和菜单 请访问  Confluence dashboard  页面来检查所有的内容都能够被正常的显示了。在不同的浏览器之间进行测试，你要确保你环境使用的浏览器使用没有问题。同时，请确定你界面的  layout  能够正常显示，并且菜单也是能够正常单击的。 3. 搜索 请尝试  searching for content  这个功能。例如尝试搜索页面，附件或者用户名。对返回的结果进行检查。 4. 权限 请决定你可以访问页面具有  view restrictions  功能的页面，如果你具有访问权限的。如果你有编辑页面权限的话，请确定你可以对页面进行编辑。请确定这个页面的子页面也具有相同的权限设置。请尽可能多的访问具有页面限制的页面，以确定页面限制...

这个页面将会对你在进行 Confluence 升级的时候超过了当前许可证的期限进行升级的情况。 许可证警告 在升级的过程中，你将会在 Confluence 的应用程序日志（ log file ）中看到类似下面的错误提示信息。 Related pages: Upgrading Beyond Current Licensed Period Upgrading Beyond Current Licensed Period ERROR [confluence.upgrade.impl.DefaultUpgradeManager] runUpgradePrerequisites Current license is not valid: SUPPORT_EXPIRED 当你尝试通过你的浏览器访问 Confluence 的时候，你将会看到下面的警告信息： 升级 Confluence 许可证 进入  my.atlassian.com  页面来查看你的许可证或者来购买一个新的许可证。 根据系统提示的警告信息来将你许可证的 Key 应用到你的系统中。 重启 Confluence 来让 Confluence 的许可证进行激活。现在你可以和正常使用的情况一样来登录 Confluence 了。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Beyond+Current+Licensed+Period

升级的时候遇到了问题了吗？ 如果你想尝试重新进行升级的话， 你需要首先重新恢复老的备份 。不要尝试再次对 Confluence 进行升级或者在升级失败后重新启动老的 Confluence。   在升级过程中的一些常见问题... 因为许可证过期了，不能进行升级 如果你的许可证已经过期了，但是还没有收到新的许可证的话，在升级的过程中将会收到升级错误的提示。请参考  Upgrading Beyond Current Licensed Period  页面中的内容。 因为防病毒软件的问题不能进行升级 一些防病毒软件或者其他的一些互联网安全工具将会干扰 Confluence 的升级或者阻止升级到的正常完成，尤其是你将 Confluence 运行在 Windows 服务器的情况下。如果你在升级的时候遇到了的问题，那么你需要在升级之前将防病毒软件和互联网工具先禁用。 数据库不支持在线备份 在升级工具中将会弹出备份你的数据库选项并提示你使用数据库备份工具进行备份。如果你的数据库不支持在线备份的话，停止升级进程，关闭 Confluence，然后进行你的数据库备份，然后再次运行升级程序来进行升级。 升级过程需要很长时间 如果你的数据库非常大的话（例如，备份可能需要很长时间才能完成），设置   confluence.upgrade.recovery.file.enabled   system property  为 false 来加快升级过程。这个通常只针对大数据库和在升级的时候进行数据库备份来进行配置。 Confluence 不能启动 不兼容的 Confluence 市场应用会阻止 Confluence 的正常启动。你可以从对这些插件和应用进行查看并且对阻止启动的插件和应用进行临时的禁用。请参考  Start and Stop Confluence  页面中的内容。 协同编辑错误 如果同步编辑没有运行或者你看到了错误，请参考  Troubleshooting Collaborative Editing  页面来让同步编辑启动并且在你的环境中运行。最常见的问题是反向dialing配置错误或者端口 8091 不能被协同编辑进程使用。 你可以参考  U...

7. 拷贝你的数据库驱动 如果你现在使用的是 Oracle 或者 MySQL 数据库的话，你讲要重新拷贝 jdbc 驱动的 jar 文件到你已经存在的 Confluence 安装目录中  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）  然后检查 Sync...

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.    选择你计划升级的版本然后单击...

在这个指南中，我们将会与你一同对最新的 Confluence 站点在 Windows 或者 Linux 平台进行安装和更新。 如果你的 Confluence 安装实例是当前的许可证的话，那么对 Confluence 进行升级是免费的。请参考页面  Licensing FAQ  中的内容来获得更多的信息。 对 Confluence 进行升级的其他方法： 手动升级  – 使用 Confluence 安装器进行升级。 数据中心  – 升级你的数据中心集群。 XML 备份文件 不能 在升级的时候使用。 在你对 Confluence 进行升级之前，你需要对下面的一些问题进行了解。 使用安装文件的升级方式是否适合你？ 告诉我更多 ... 你可以选择使用安装程序，zip 或者 tar.gz 文件进行升级。在大部分情况下，使用安装程序为升级你 Confluence 安装实例最简便的方法。如果你遇到了下面的情况，那么你需要 手动进行升级 了： 你现在移动到其他的操作系统或者文件的路径属于本次升级的一部分。 你正在从  Confluence 3.5 或者早期版本 上进行升级。 你正在从  Confluence 5.6 或者早期版本 上进行升级，但是这些早期版本使用的是  EAR/WAR 分发包 来进行部署到一个已经存在的应用服务器上的。 你是否具有升级资格？ 告诉我更多 ... 希望对你当前运行 Confluence 的实例的许可证是否当前，你可以进入   >  基本配置（ General Configuration）  >  问题检查和支持工具（Troubleshooting and support tools）  来确定你的许可证支持是否过期了。 软件维护（Software maintenance） ：在这个时间区间内进行升级。 如果你的许可证支持以及过期了，请在对 Confluence 进行升级之前按照提示的步骤来对许可证进行更新。 我们支持的平台是否有了改变？ 告诉我更多 ... 请查看  Supported Platf...

在 Windows 中以独立启动方式安装。 你可以将安装文件拷贝到任何你希望运行的目录中，下面的步骤中。我们没有将 Archiva 安装成服务，所以你需要通过控制台的方式来进行启动。 Windows 独立启动安装步骤 在 Windows 环境下请参考下面的步骤进行安装 下载安装程序 进入 Archiva 的项目的下载页面中，请单击链接： https://archiva.apache.org/download.cgi  来下载你需要的版本。 针对 Windows 的环境，我们选择使用 zip 版本。 解压缩 你可以将下载的压缩文件解压缩到任何文件夹下面。 因为启动的时候是不需要检查路径的，但是你需要安装 JDK，根据我们的经验，针对最新版本的，你需要安装 JDK 1.8， 否则你可能会遇到启动错误。 因为安装程序使用的是 zip，你可以使用任何解压缩工具来进行解压缩。 这里我们解压缩到文件夹：C:\Users\yhu\Dkits\2.23 中。 启动 Archiva 在 cmd 命令行中，进入你 Archiva 的文件夹中，然后进入这个文件夹的 bin 目录中。 然后运行 ./archiva console 命令，如果你能够看到下面的输出，则表示 Archiva 已经启动成功了。 PS C:\Users\yhu\Dkits\ 2.23 \bin> ./archiva console wrapper  | --> Wrapper Started as Console wrapper  | Launching a JVM... jvm  1      | Wrapper (Version  3.2 . 3 ) http: //wrapper.tanukisoftware.org jvm  1      |   Copyright  1999 - 2006   Tanuki Software, Inc.  All Rights Reserved. jvm  1  ...

CloudAMQP 有多种账号级别，请参考下面的链接的内容访问你可以注册的级别： https://www.cloudamqp.com/plans.html 作为测试来说，你可以注册免费的的消息。 你可以选择免费的账号。 输入电子邮件 在注册界面中输入电子邮件后单击 Sign Up 来创建账号。 到邮箱中检查 当你输入电子邮件提交后，系统将会发送一个电子邮件到你提交的邮箱中。 你可以到你的电子邮箱中查看发过来的电子邮件。 系统提示电子邮件已经发送成功。 电子邮箱中收到的进行注册的电子邮件。 单击邮件中的链接进行注册。 创建一个账号 输入密码来在系统中创建账号 创建新的实例 你可以在账号创建成功的界面中开始创建新的实例。 然后你就可以在新创建的实例中开始进行消息测试了。