スペースを復元する
Confluence Cloud からのスペースのインポート
Confluence Cloud ではユーザーの管理方法が異なるため、Confluence Cloud から Confluence Server または Data Center にスペースをインポートする場合、追加の考慮事項があります。
ステップバイステップ ガイドの「Confluence Cloud からのスペースのインポート」を参照してください。
Confluence Server または Data Center からのスペースのインポート
スペースをインポートする前に、データベースのフル バックアップを実行することをお勧めします。スペースのインポート プロセスは失敗する場合があり、バックアップがあれば容易にロールバックできます。
スペースのインポート方法は 2 種類あります。ファイルをアップロードするか、Confluence サーバーのディレクトリからインポートします。ファイルのアップロードは小規模なスペースにのみ適しています。最良の結果を得るには、復元ディレクトリからインポートすることをお勧めします。
サイトまたはスペースのエクスポート ファイルのアップロード
小規模なスペースをアップロードするには、
- Go to Administration > General Configuration > Backup and Restore.
- [サイトまたはスペースのエクスポート ファイルのアップロード] で、[ファイルの選択] をクリックし、スペース エクスポート ファイルを参照します。
- あとのステージでインデックスを作成する場合、インデックス作成 のチェックを外します。
- [アップロード/インポート] を選択します。
インポートが完了したら、スペースに直接移動するか、スペース ディレクトリに進むことができます。
ホーム ディレクトリからのインポート
ホーム ディレクトリからのインポートはブラウザを経由してファイルをアップロードする必要がないため、大規模なスペースで特に推奨される代替手段です。
ホーム ディレクトリからスペースをインポートするには、次の手順を実行します。
- スペース エクスポート ファイルを
<confluence-home>/restore.
にコピーします (このディレクトリの場所がわからない場合は、バックアップと復元 画面のパスの一覧をご確認ください)。
- Go to Administration > General Configuration > Backup and Restore.
- [ホーム ディレクトリからインポート] で、スペース エクスポート ファイルを選択します。
- あとのステージでインデックスを作成する場合、インデックス作成 のチェックを外します。
- インポートを選択します。
インポート処理中のインデックス作成はオプションです。インデックスが作成されるまで、インポートしたスペースのコンテンツを検索できませんが、非常に大きなサイトである場合は、インデックスの再作成には時間が長くかかり、サイトのパフォーマンスに影響を与える可能性があります。別の方法として、低ピーク時に インデックスを手動で再作成 できます。
グループと権限
元の Confluence サイト内で特定のスペース権限が付与されているユーザーまたはグループがある場合、スペースのインポートでそれらはインポートされません。つまり、これらのグループに制限されているページがある場合、宛先のサイトでこれらのグループを再作成するまでは対象のページを閲覧できない可能性があります。
インポート前にスペースのサイズを確認する
インポートを試みる前に、エクスポートされたスペースのサイズを確認することが重要です。場合によっては、特定の方法を使用したり、より負荷の低い時間帯にインポートを完了したりする必要があるためです。
zip ファイルの合計サイズによって、ブラウザからファイルをアップロードできるか、ホーム ディレクトリ方式を使用する必要があるかが決まります。
entities.xml ファイルのサイズは、ページ、バージョン、コメントなどのエンティティの量を示すものです。非常に大きい場合は、インポートにかなりの時間がかかることがあります。
エクスポートされたスペース内の entities.xml
のサイズを確認するには、次の手順に従います。
- スペースのエクスポート ファイルを解凍します。
entities.xml
ファイルに移動し、そのファイルのサイズを確認します。そのための方法は、使用しているオペレーティング システムによって異なります。
トラブルシューティング
スペースのインポートに問題がある場合は、以下のヒントを参照してください。
- ファイルが大きすぎてアップロードできませんか?
これは非常に頻繁に起こる問題です。この問題は、時間内にサーバーにファイルをアップロードできないときに発生します。この問題を回避するには、エクスポート ファイルを<confluence-home>/restore
ディレクトリにドロップし、そこからインポートします。 - 以前のバージョンの Confluence にインポートしようとしていますか?
これは不可能です。スペースは、同じバージョンか、それ以降の互換バージョンにのみインポートできます。 - Confluence Cloud からスペースをエクスポートしていますか?
このファイルは Confluence 6.0 以降にのみインポートできます。過去のバージョンにインポートしようとすると、重大な問題を引き起こす可能性があります。その他の考慮事項については、「Confluence Cloud からのスペースのインポート」を参照してください。 - 同じスペース キーを持つスペースがすでに存在していますか?
スペース キーは一意であるため、同じスペース キーを持つスペースが存在する場合、既存のスペースを削除してから、新しいスペースをインポートする必要があります - インポートのタイムアウトやメモリ不足エラーが発生していますか?
インポートするスペースが非常に大きい場合、Confluence で使用可能なメモリを一時的に増やす必要がある可能性があります。「利用可能なメモリを増やして out of memory エラーを修正する方法」を参照してください。 - エクスポート ファイルを Mac 上にダウンロードしましたか?
Confluence でexportDescriptor.properties
ファイルが見つからない旨のエラーが表示された場合、OS X がバックアップを解凍し、元の zip ファイルをゴミ箱に捨てた可能性があります。ゴミ箱から元の zip ファイルを回収して、再度インポートを試みます。 - インポートに失敗しましたか? プロセスがタイムアウトしたり、メモリが不足したりすると、スペースのインポートが失敗する場合があります。これにより、データベースにデータが残される場合があります。詳細は、「スペースのインポートが失敗した後、残ったスペース データによって再度インポートできない」を参照してください。
- 十分なディスク容量はあるでしょうか。
Confluence は、インポート プロセス中のさまざまなポイントで、インポート中のファイルのコピーを作成する必要があります。サイト エクスポート ファイルの複数のコピーを一時的に格納するために十分なディスク領域があることをご確認ください。
Confluence 5.3 以前からスペースを復元するための回避策
Confluence 5.3 以前のバージョンから Confluence の新しいバージョンにスペースをインポートする必要がある場合、一時的な Confluence インストールを使用して、スペースのエクスポートを正しいバージョン番号にアップグレードします。
- スペースのエクスポート元であるバージョンと同じ Confluence のバージョンをダウンロードします(Confluenceの旧バージョンは Confluence ダウンロード アーカイブ から取得できます)。
- そのバージョンの Confluence を一時的なサーバーにインストールします。
- この一時的な Confluence サイトにスペースをインポートします。
- 一時的なサイト上の Confluence をスペースをインポートしたいサイトと同じバージョンにアップグレードします(手順については、Confluence のアップグレード を参照してください)。
- 一時的な Confluence サイト(今はこのサイトは正しいバージョン番号になっています)からスペースをエクスポートします。
- 本番用の Confluence サイトにスペースをインポートします。