このページでは、XML バックアップのデータを新規または既存の Confluence サイトに復元する方法について説明します。

You can create a space backup in the Confluence administration console or in Space tools for single-space backups only.

However, to restore an XML space backup you'll need System Administrator permissions.

始める前に

  • 同じスペース キーは問題の原因になります。宛先サイトに復元するスペースと同じスペース キーを持つスペースが存在しないことを確認してください。このようなスペースがあると、このタスクは失敗します。

  • Confluence のアップグレードに、XML エクスポート ファイルを使用すべきではありません。Confluence のアップグレードにしたがって Confluence をアップグレードします。

  • If you are migrating to Confluence Cloud, use the Confluence Cloud Migration Assistant app. This is pre-installed with your Confluence installation.

バックアップが復元できるかどうかを確認する

バックアップを以前のバージョンの Confluence に復元することはできません。 

たとえば、Confluence 8.3 で XML バックアップが生成された場合、これを Confluence 7.19 にインポートすることはできません。


バックアップを正常に復元できるかどうかを確認するには、次の操作を実行します。

  • Check which Confluence version you are using in Administration menu , then General Configuration> System Information. The version will be listed next to Confluence Version.
  • Check which Confluence version your XML backup was generated from. See How to Determine XML Backup Confluence Version.

(tick) バックアップを新しいバージョンに復元する場合、バックアップを正常に復元できます。

(error) バックアップを以前のバージョンに復元する場合、この操作はサポートされていないため、インポートに失敗する可能性があります。

On this page:

関連ページ

Confluence Cloud からスペースを復元 (インポート) する

Confluence Cloud ではユーザーの管理方法が異なるため、Confluence Cloud から Confluence Data Center にスペースを復元する場合、追加の考慮事項があります。

See Import a space from Confluence Cloud for a step-by-step guide.

Confluence Data Center からスペースを復元（インポート）する

(warning) XML スペース バックアップを復元する前に、データベースのフル バックアップを実行することをお勧めします。スペースの復元タスクは失敗する場合があり、バックアップがあれば容易にロールバックできます。

1 つまたは複数のスペースを復元する方法は 2 つあります。ファイルをアップロードする方法 (ローカル ドライブ) と、Confluence Server のディレクトリ (restore ディレクトリ) から復元する方法です。

ファイルのアップロードは小規模なスペースにのみ適しています。大規模なスペースで最良の結果を得るには、restore ディレクトリから復元することをお勧めします。非常に大きなファイルは復元に時間がかかる場合があります。

ファイルのアップロード

小規模なスペースをアップロードして復元するには、次の手順を実行します。

  1. Go to Administration menu , then General Configuration > Backup and restore 
  2. [サイトまたはスペースを復元] を選択します。
  3. [復元の内容] で、[スペース] を選択します。
  4. [復元元] で、[ローカル ドライブ] を選択します。
  5. [ファイルを選択] で [ファイルを選択] を選択し、XML バックアップを参照します。
  6. [アップロードして復元] を選択します。
  7. 確認メッセージが表示されます。
  8. もう一度 [アップロードして復元] を選択します。

サーバーから復元する

大規模なスペースの場合、ホーム ディレクトリからの復元は信頼性の高い代替手段です。

ホーム ディレクトリからスペースを復元するには、次の手順を実行します。 

  1. Copy the XML backup to <home-directory>/restore/space/. If you're not sure where this directory is located, see Confluence Home and other important directories for information on how to locate your home directory.
  2. Go to Administration menu , then General Configuration > Backup and restore. 
  3. [サイトまたはスペースを復元] を選択します。
  4. [復元の内容] で、[スペース] を選択します。
  5. [復元元] で、[restore ディレクトリ] を選択します。
  6. [ファイルを選択] のドロップダウン メニューで、スペースのエクスポート ファイルを入力または参照します。
  7. [復元] を選択します。
  8. 確認メッセージが表示されます。
  9. [今すぐ復元] を選択します。

スペースのインデックス作成

1 つまたは複数のスペースを復元すると、通常のページ インデックスと同じ方法でインデックスが作成されます。つまり、インデックスを作成するレコードがキューに追加され、これらのレコードをチェックするジョブが用意されます。インデックスの作成は、このジョブでレコードが選択される際に行われます。このため、ユーザーがスペース ディレクトリ内のスペースの確認や復元されたスペース内のコンテンツの検索を行えるようになるまでに、少し時間がかかる場合があります。

Confluence では、1 つまたは複数のスペースを復元するためにサイト全体のインデックスが再作成されることはありません。

グループと権限

元の Confluence サイト内で特定のスペース権限が付与されているユーザーまたはグループがある場合、スペースのインポートでそれらはインポートされません。つまり、これらのグループに制限されているページがある場合、宛先のサイトでこれらのグループを再作成するまでは対象のページを閲覧できない可能性があります。

キャンセルまたは失敗したスペースの復元 

スペースの復元を「queued (キューに登録済み)」である間にキャンセルすると、そのタスクはキャンセルされ、その時点でのタスクの詳細が表示されます。

スペースの復元を「in progress (進行中)」の間にキャンセルする必要がある場合は、同じスペースを宛先サイトに復元する前に、すでに処理してインポートしたデータをクリーンアップする必要があります。他のスペースの復元やサイトの復元は可能です。

For example, if you attempted to restore Spaces with keys A, B, and C, but the space restore failed or was canceled after it had already started, you will still be able to restore the Space with key D, but you can’t restore Spaces with keys A, B, or C again until you’ve removed any partially imported data. See Clean up leftover space data from a failed space import to learn how to remove this data.

トラブルシューティング

スペースのインポートに問題がある場合は、以下のヒントを参照してください。 

  • ファイルが大きすぎてアップロードできませんか?
    これは非常に頻繁に起こる問題です。この問題は、時間内にサーバーにファイルをアップロードできないときに発生します。この問題を回避するには、バックアップ ファイルを <home-directory>/restore/space にドロップし、そこから復元します。 
  • 以前のバージョンの Confluence にインポートしようとしていますか?
    これは不可能です。同じバージョンか、それ以降の互換バージョンにしか、スペースを復元できません。 
  • 同じスペース キーを持つスペースがすでに存在していますか?
    スペース キーは一意であるため、同じスペース キーを持つスペースが存在する場合、既存のスペースを削除してから、新しいスペースを復元する必要があります。
  • Is the import timing-out or causing out-of-memory errors? 
    If the space to be restored is very large, you may need to temporarily increase the memory available to Confluence. See How to fix out-of-memory errors by increasing available memory.
  • エクスポート ファイルを Mac 上にダウンロードしましたか?
    Confluence で exportDescriptor.properties ファイルが見つからない旨のエラーが表示された場合、OS X によってバックアップが解凍され、元の zip ファイルがゴミ箱に捨てられた可能性があります。ゴミ箱から元の zip ファイルを回収して、再度復元を試みる必要があります。
  • Did your import fail?  Sometimes restoring a space may fail because of invalid data. This can lead to data being left behind in your database. You'll need to clean up leftover space data from a failed space import before you attempt to restore the same spaces again.
  • 十分なディスク容量がありますか?
    Confluence では、復元プロセスのさまざまな時点で復元中のバックアップ ファイルのコピーを作成する必要があります。ファイルの複数のコピーを一時的に格納するために十分なディスク容量があることをご確認ください。