1 つまたは複数のスペースを復元する
このページでは、XML バックアップのデータを新規または既存の Confluence サイトに復元する方法について説明します。
スペースのバックアップは、Confluence 管理コンソールまたはスペース ツール (単一スペースのバックアップの場合のみ) で作成できます。
ただし、XML スペース バックアップを復元するには、システム管理者権限が必要です。
始める前に
- 同じスペース キーは問題の原因になります。宛先サイトに復元するスペースと同じスペース キーを持つスペースが存在しないことを確認してください。このようなスペースがあると、このタスクは失敗します。
Confluence のアップグレードに、XML エクスポート ファイルを使用すべきではありません。Confluence のアップグレード にしたがって Confluence をアップグレードします。
Confluence Cloud に移行する場合は、Confluence Cloud Migration Assistant アプリを使用してください。これは、Confluence にあらかじめインストールされています。
バックアップが復元できるかどうかを確認する
バックアップを以前のバージョンの Confluence に復元することはできません。
たとえば、Confluence 8.3 で XML バックアップが生成された場合、これを Confluence 7.19 にインポートすることはできません。
バックアップを正常に復元できるかどうかを確認するには、次の操作を実行します。
- [管理]
> [一般設定] > [システム情報] で、使用している Confluence のバージョンを確認します。バージョンは [Confluence バージョン] の横に表示されます。 - XML バックアップが生成された Confluence バージョンを確認します。「XML バックアップの Confluence バージョンを確認する方法」を参照してください。
バックアップを新しいバージョンに復元する場合、バックアップを正常に復元できます。
バックアップを以前のバージョンに復元する場合、この操作はサポートされていないため、インポートに失敗する可能性があります。
Confluence Cloud からスペースを復元 (インポート) する
Confluence Cloud ではユーザーの管理方法が異なるため、Confluence Cloud から Confluence Data Center または Server にスペースを復元する場合、追加の考慮事項があります。
ステップバイステップ ガイドの「Confluence Cloud からのスペースのインポート」を参照してください。
Confluence Data Center または Server からスペースを復元 (インポート) する
XML スペース バックアップを復元する前に、データベースのフル バックアップを実行することをお勧めします。スペースの復元タスクは失敗する場合があり、バックアップがあれば容易にロールバックできます。
1 つまたは複数のスペースを復元する方法は 2 つあります。ファイルをアップロードする方法 (ローカル ドライブ) と、Confluence Server のディレクトリから復元する方法 (restore ディレクトリ) です。
ファイルのアップロードは小規模なスペースにのみ適しています。最良の結果を得るには、restore ディレクトリから復元することをお勧めします。非常に大きなファイルは、復元にかなりの時間がかかる場合があります。
ファイルのアップロード
小規模なスペースをアップロードして復元するには、次の手順を実行します。
- [管理] > [一般設定] > [バックアップとリストア] に移動します。
- [サイトまたはスペースを復元] を選択します。
- [復元の内容] で、[スペース] を選択します。
- [復元元] で、[ローカル ドライブ] を選択します。
- [ファイルを選択] で [ファイルを選択] を選択し、XML バックアップを参照します。
- [アップロードして復元] を選択します。
- 確認メッセージが表示されます。
- もう一度 [アップロードして復元] を選択します。
サーバーから復元する
大規模なスペースの場合、ホーム ディレクトリからの復元は信頼性の高い代替手段です。
ホーム ディレクトリからスペースを復元するには、次の手順を実行します。
- XML バックアップを
<confluence-home>/restore/space.にコピーします。このディレクトリの場所がわからない場合は、「Confluence のホームおよびその他の重要なディレクトリ」を参照してください。 - [管理] > [一般設定] > [バックアップとリストア] に移動します。
- [サイトまたはスペースを復元] を選択します。
- [復元の内容] で、[スペース] を選択します。
- [復元元] で、[restore ディレクトリ] を選択します。
- [ファイルを選択] のドロップダウン メニューで、スペースのエクスポート ファイルを入力または参照します。
- [復元] を選択します。
- 確認メッセージが表示されます。
- [今すぐ復元] を選択します。
スペースのインデックス作成
1 つまたは複数のスペースを復元すると、通常のページ インデックスと同じ方法でインデックスが作成されます。つまり、インデックスを作成するレコードがキューに追加され、これらのレコードをチェックするジョブが用意されます。インデックスの作成は、このジョブでレコードが選択される際に行われます。このため、ユーザーがスペース ディレクトリ内のスペースの確認や復元されたスペース内のコンテンツの検索を行えるようになるまでに、少し時間がかかる場合があります。
Confluence では、1 つまたは複数のスペースを復元するためにサイト全体のインデックスが再作成されることはありません。
グループと権限
元の Confluence サイト内で特定のスペース権限が付与されているユーザーまたはグループがある場合、スペースのインポートでそれらはインポートされません。つまり、これらのグループに制限されているページがある場合、宛先のサイトでこれらのグループを再作成するまでは対象のページを閲覧できない可能性があります。
キャンセルまたは失敗したスペースの復元
スペースの復元を「queued (キューに登録済み)」である間にキャンセルすると、そのタスクはキャンセルされ、その時点でのタスクの詳細が表示されます。
スペースの復元を「in progress (進行中)」の間にキャンセルする必要がある場合は、同じスペースを宛先サイトに復元する前に、すでに処理してインポートしたデータをクリーンアップする必要があります。他のスペースの復元やサイトの復元は可能です。
たとえば、キー A、B、C を持つ各スペースを復元しようとしたが、スペースの復元が失敗するか開始後にキャンセルされた場合、キー D を持つスペースを復元することはできますが、部分的にインポートされたデータを削除するまで、キー A、B、C を持つ各スペースを再度復元することはできません。これらのデータを削除する方法については、失敗したスペースのインポートで残ったスペース データをクリーンアップする方法を参照してください。
トラブルシューティング
スペースのインポートに問題がある場合は、以下のヒントを参照してください。
- ファイルが大きすぎてアップロードできませんか?
これは非常に頻繁に起こる問題です。この問題は、時間内にサーバーにファイルをアップロードできないときに発生します。この問題を回避するには、バックアップ ファイルを<confluence-home>/restore/spaceにドロップし、そこから復元します。 - 以前のバージョンの Confluence にインポートしようとしていますか?
これは不可能です。同じバージョンか、それ以降の互換バージョンにしか、スペースを復元できません。 - 同じスペース キーを持つスペースがすでに存在していますか?
スペース キーは一意であるため、同じスペース キーを持つスペースが存在する場合、既存のスペースを削除してから、新しいスペースを復元する必要があります。 - インポートのタイムアウトやメモリ不足エラーが発生していますか?
復元するスペースの規模が非常に大きい場合は、Confluence で使用可能なメモリを一時的に増やす必要がある可能性があります。「利用可能なメモリを増やして out of memory エラーを修正する方法」を参照してください。 - エクスポート ファイルを Mac 上にダウンロードしましたか?
Confluence でexportDescriptor.propertiesファイルが見つからない旨のエラーが表示された場合、OS X によってバックアップが解凍され、元の zip ファイルがゴミ箱に捨てられた可能性があります。ゴミ箱から元の zip ファイルを回収して、再度復元を試みる必要があります。 - インポートに失敗しましたか?データが無効なため、スペースの復元に失敗することがあります。これにより、データベースにデータが残される場合があります。同じスペースを再度復元しようとする前に、失敗したスペースのインポートで残ったスペース データをクリーンアップする必要があります。
- 十分なディスク容量がありますか?
Confluence では、復元プロセスのさまざまな時点で復元中のバックアップ ファイルのコピーを作成する必要があります。ファイルの複数のコピーを一時的に格納するために十分なディスク容量があることをご確認ください。