Confluence 6 在升級過程當中查看合併日誌

爲了監控升級的過程，你應該查看 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