復元に失敗した XML バックアップのトラブルシューティング

サイトまたはスペースのバックアップの作成またはインポート時にエラーが発生する場合

XML バックアップの復元の試行時のエラーの解決

データベースのわずかな破損によってエラーが発生する場合があります。DB ルールに違反している XML バックアップ ファイルのエントリーを見つけて、そのエントリーを修正し、XML バックアップを再作成する必要があります。

1. On the instance being restored, follow the instructions to disable batched updates (for simpler debugging), log SQL queries and log SQL queries with parameters at http://confluence.atlassian.com/display/DOC/Enabling+detailed+Hibernate+logging
2. Once all three changes have been made, restart Confluence
3. Attempt another restore
4. Once the restore fails, check your log files to find out what object could not be converted into XML format. For Confluence Standalone users, check your Confluence install directory under the /logs/ and check both atlassian-confluence.log and catalina.out file. The correct file will contain SQL debug output.
5. ファイルの一番下までスクロールし、データベース制約の違反に関する最後のエラーを特定します。例:

   2006-07-13 09:32:33,372 ERROR [confluence.importexport.impl.ReverseDatabinder] endElement net.sf.hibernate.exception.ConstraintViolationException: 
     could not insert: [com.atlassian.confluence.pages.Attachment#38]
   net.sf.hibernate.exception.ConstraintViolationException: could not insert: [com.atlassian.confluence.pages.Attachment#38]
   ...
   Caused by: java.sql.SQLException: ORA-01400: cannot insert NULL into ("CONFUSER"."ATTACHMENTS"."TITLE")
   at oracle.jdbc.driver.DatabaseError.throwSqlException(DatabaseError.java:112)
   at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:331)
   at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:288)
   

   この例では、attachment テーブルの ID = 38 の行でタイトルが null になっていることを示しています。
6. 作成されたバックアップのあるサーバーに移動します。作成されたバックアップからコピーを取得する必要があります。これを行わないと、DBA ツールを使用してデータベースの手動バックアップを復元することができません。
7. Open a DBA tool and connect to the original database instance and scan the table names in the schema. You will have to modify a row in one of these tables
8. テーブルを特定するには、catalina.out を開き、例外の最初の行を確認します。以下は、データベースでのオブジェクトとテーブル間のマッピングを確認するための概要です。
   • ページ、ブログ投稿、コメント --> CONTENT テーブル
   • 添付ファイル --> ATTACHMENTS テーブル
9. 上記の例のエラーを修正するには、attachment テーブルに移動し、id が 38 の attachment オブジェクトを見つけます。このオブジェクトのタイトルは null です。ガイドとして他の添付ファイルのタイトルを使用してタイトルを指定します。異なるエラーの場合も、適切にデータベースを修正してください。
10. Once the entry has been corrected, create the XML backup again
11. Import the backup into the new version
12. If the import succeeds, revert the changes made in http://confluence.atlassian.com/display/DOC/Enabling+detailed+Hibernate+logging to re-enable disable batched updates and turn off log SQL queries and log SQL queries with parameters
13. Confluence を再起動します。

この問題の再発を防ぐ方法

1. 組み込みデータベースを使用している場合、これは評価用にバンドルされており、突然停電が発生した場合、完全なトランザクションの整合性を提供しないため、本番環境での使用には外部データベースを推奨していることに注意してください。外部データベースに移行する必要があります。
2. 最新より前のバージョンの Confluence を使用している場合、この時点でアップグレードを検討する必要があります。

関連トピック

Administrators Guide