Confluence 6 从 WIKI 标记整合到基于 XHTML 的存储格式

Posted 2021-10-21 huyuchengus

如果你现在正在将 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 的某一个缓存设置，有关自定义缓存的设置请参考 Cache Performance Tuning 页面中的，很有可能会导致缓存被迅速占满使用。

 

https://www.cwiki.us/display/CONF6ZH/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format