為了監控更新的過程,你應該檢視 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 存儲格式的錯誤内容将會顯示在這裡,通常主要原因是是 wiki 标記的内容中使用 'unmigrated-wiki-markup' 宏。這些内容在 Confluence 還是可見的,同時也是能夠在新的 Confluence 中進行修改的。
然而,在一些情況下,批量合并處理的結果是完全失敗了,這種情況主要是資料庫的事務異常沒有被處理,通常這種錯誤将會在日志中進行如下的顯示:
Unable to start up Confluence. Fatal error during startup sequence: confluence.lifecycle.core:pluginframeworkdependentupgrades (Run all the upgrades that require the plugin framework to be available) - com.atlassian.confluence.content.render.xhtml.migration.exceptions.MigrationException: java.util.concurrent.ExecutionException: org.springframework.transaction.UnexpectedRollbackException: Transaction rolled back because it has been marked as rollback-only
Confluence 針對這種情況不能提供更多的報表,同時能夠允許 Confluence 進行正常的啟動而不再嘗試重新合并内容。如果一個使用者嘗試檢視任何沒有合并的内容,這個使用者将會有可能看類似下面的異常:
java.lang.UnsupportedOperationException: The body of this ContentEntityObject ('Page Title') was 'WIKI' but was expected to be 'XHTML'
針對這個問題的解決方案就是在重新開機 Confluence 再次運作站點内容合并。
https://www.cwiki.us/display/CONF6ZH/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format