サイトを復元する
本ページでは、XML サイト エクスポート ファイルのデータを既存の Confluence サイトに復元する方法について説明します。
新しいサイトにデータをインポートしたい場合は、セットアップ時にバックアップから復元する を参照してください。
この機能を実行するには システム管理者 権限が必要です。
サイト エクスポート ファイルをインポートすると、
- データベース内の既存の Confluence コンテンツはすべて上書きされます。作業を開始する前に、データベースをバックアップしてください。
- ユーザーは Confluence からログアウトされます。インポートしようとしているファイルに含まれるログイン詳細を把握していることを確認してください。
はじめる前に：
- すべてのコンテンツが置き換えられます。 サイトをインポートすると、コンテンツやユーザーのすべてが置き換えられます。作業を開始する前に、データベースをバックアップしてください。
- スペースを選択して復元することはできません。サイト全体のバックアップから 1 つのスペースを選択して復元することはできません。
バージョンの互換性。 Confluence は以前の多くの Confluence バージョンからサイトのバックアップを受け入れます。バックアップと復元画面で受け入れ可能なバージョンを確認できます。インポートは Confluence の以降のバージョンにのみ可能で、前のバージョンにはインポートできません。
最良の結果を得るには、同じバージョンの Confluence 同士でインポートとエクスポートを行います。
- Confluence のアップグレードに、XML エクスポート ファイルを使用すべきではありません。Confluence のアップグレード にしたがって Confluence をアップグレードします。
エクスポートの互換性確認
サイトのエクスポートを正常に復元できることを確認するには、
- インポート先の Confluence サイトを起動します。
> 一般設定 > バックアップと復元に移動します。 - 許可される Confluence バージョンを確認します。[サイト/スペース バックアップのアップロードと復元] に一覧表示されています。
Confluence 5.9 では次のように表示されます。許可されるバージョンは、使用中の Confluence バージョンによって異なります。
以前のバージョン の Confluence にはインポートできません。
たとえば、サイトのエクスポートが Confluence 5.9 で生成された場合 、Confluence 5.5 にインポートすることはできません。
Confluence クラウドからエクスポートする場合、Confluence 6.0 以降 にしか インポートできません。
Confluence サイトのインポート
サイトのインポート方法は 2 種類あります。ファイルをアップロードするか、Confluence サーバーのディレクトリからインポートします。ファイルのアップロードは小規模サイトにのみ適しています。最良の結果を得るには、復元ディレクトリからインポートすることをお勧めします。
小規模サイトをアップロードし、インポートするには、
- > 一般設定 > バックアップと復元に移動します。
- ファイル選択 を選択して、サイト エクスポート ファイルを参照します。
- あとのステージでインデックスを作成する場合、インデックス作成 のチェックを外します。
- アップロードと復元 を選択します。
復元ディレクトリからサイトをインポートするには、
- エクスポート ファイルを
<confluence-home>/restore.にコピーします。
(このディレクトリが置かれている場所がわからない場合は、バックアップと復元 画面にパスが一覧表示されています) - > 一般設定 > バックアップと復元に移動します。
- Confluence ホーム ディレクトリからのバックアップ復元の下にあるサイト エクスポート ファイルを選択します。
- あとのステージでインデックスを作成する場合、インデックス作成 のチェックを外します。
- 復元 を選択します。
インポート処理中のインデックス作成はオプションです。インデックスが作成されるまでサイトのコンテンツは検索可能になりませんが、非常に大規模なサイトである場合は、インポート完了後に 手動によるインデックス再作成 を選択できます。
Confluence Data Center をお使いの場合
共同編集を有効にして Confluence Data Center を使用している場合は、いくつかの追加手順があります。Synchrony を完全に停止してくださ。また、Confluence ノードを 1 つだけ使用してインポートを実行し、トラフィックがそのノードを使用しないようにすることをお勧めします。
インポートが完了したら、Synchrony を再起動してから、残りのノードを (1 度に 1 つずつ) 再起動します。
トラブルシューティング
サイトのインポートに問題がある場合は、以下のヒントを参照してください。
- ファイルが大きすぎてアップロードできませんか?
これは非常に頻繁に起こる問題です。この問題は、時間内にサーバーにファイルをアップロードできないときに発生します。この問題を回避するには、エクスポート ファイルを<confluence-home>/restoreディレクトリにドロップし、そこからインポートします。 - 以前のバージョンの Confluence にインポートしようとしていますか？
これは不可能です。同じバージョンか、それ以降の互換バージョンにしか、サイトをインポートできません。 - Is the import timing-out or causing out of memory errors?
If the site to be imported is large, you may need to temporarily increase the memory available to Confluence. See Fix java.lang.OutOfMemoryError in Confluence. - ユーザー名またはパスワードが認識されませんか？
インポート処理中にすべてのユーザー データが上書きされました。エクスポートされたサイトから、システム管理者アカウントを使用してログインする必要があります。パスワードがわからない場合は、データベースからパスワードをリセットする必要があります。パスワードを復元して管理者ユーザー権限を回復するを参照してください。 - Confluence Cloud からサイトをエクスポートしていますか?
Confluence 6.0 以降にしかインポートできません。Cloud のエクスポートには、システム管理者アカウントが含まれていません。そのため、Confluence をリカバリ モードで起動し、新しいシステム管理者アカウントを作成して、confluence-administrators グループのメンバーにする必要があります。詳細は、「パスワードを復元して管理者ユーザー権限を回復する」を参照してください。 - エクスポート ファイルを Mac 上にダウンロードしましたか?
Confluence でexportDescriptor.propertiesファイルが見つからない旨のエラーが表示された場合、OS X がバックアップを解凍し、元の zip ファイルをゴミ箱に捨てた可能性があります。ゴミ箱から元の zip ファイルを回収して、再度インポートを試みます。 - Confluence Data Center サイトへインポートする場合は、
サイトのインポートを開始する前に、Synchrony を終了する必要があります。
サイト エクスポートをバックアップとして使用することに関する注意事項
- 本番環境バックアップ戦略を推奨します。Confluence XML インポートは唯一のバックアップ メカニズムとして推奨されていないため、本番用の Confluence サイトのバックアップには、本番環境バックアップ戦略 （これにはデータベースとホーム ディレクトリのバックアップが含まれます）にしたがうことをお勧めします。
- 他のバックアップからの復元。日々のバックアップを行う zip ファイルが何らかの理由で復元できず、データベースと Confluence ホームディレクトリのバックアップの両方を持っている場合、これらのバックアップから復元 することができます。