如果你现在正在将 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