はじめる前に

このプロセスを開始する前に、いくつかの点を理解しておく必要があります。移行の準備が整っている場合は、移行ステップにスキップします。

最小の Confluence バージョン

Confluence Cloud からは Confluence Data Center 6.0 以降にのみ移行できます。これより前の Confluence のバージョンには（サイト全体または個別のスペースの）Cloud データをインポートできません。

Confluence の最新バージョンまたは最新のエンタープライズ リリースをインストールすることをおすすめします。Confluence アップグレード マトリクスは、組織に最適なバージョンの選択に役立ちます。  

利用可能な機能およびアプリについて

一部の Cloud 機能は Confluence Data Center では利用できません。また、ナビゲーションとユーザー エクスペリエンスが異なる場所に配置されています。ただし、Confluence の中核となる機能は同様に使用できます。

Marketplace アプリは自動的には移行されません。Confluence Data Center サイトをセットアップするときに、各アプリを再インストールする必要があります。 

すべてのアプリを Cloud と Data Center の両方で利用できるわけではありません。移行を計画する際には、重要なアプリが Atlassian Marketplace の Data Center で利用可能であることを確認して、再インストールする必要があるアプリのリストを作成することをお勧めします。 

テンプレート

テンプレートから作成されたすべてのページが移行されます。 

ただし、Confluence Cloud サイトで作成したカスタム テンプレートは移行されません。移行が完了したら、テンプレートを再作成する必要があります。 

また、Confluence Data Center ではビルトイン テンプレート (ブループリント) の範囲が遥かに小さいため、以前使用していた既定のテンプレートの一部が使用できない場合があります。ブループリントの完全なリストについてはこちらをご確認ください。

Team Calendars と Questions のデータについて

現在、Confluence Cloud から Confluence Questions と Team Calendars のデータをエクスポートする方法がないため、これらを移行することはできません。 

移行のアプローチ

サイト全体を一度に移行することも、チームのコンテンツをスペースごとにインポートすることもできます。 

サイト全体の移行では、サイト全体をエクスポート（バックアップ）し、このファイルを Confluence Data Center にインポートします。このエクスポートにはユーザーとグループが含まれます。アーカイブされたスペースと個人用スペースを含む、すべてのスペースが移行されます。 

方法については、以下の移行ステップをご確認ください。 

スペース単位の移行では、各スペースを個別にエクスポートし、これらのファイルを Confluence Data Center に 1 つずつインポートします。つまり、移行するスペースを選択することも、時間をかけて段階的に移行することもできます。ユーザーとグループは自動では移行されません。Confluence Data Center を外部ユーザー ディレクトリに接続しているか、ユーザー アカウントがある新しいサイトが用意されている場合は、コンテンツを適切なユーザーに帰属させる処理がインポート時に行われます。

スペースを 1 つずつ移行する予定の場合は「スペースを Confluence Cloud からインポートする」をご参照ください。

インフラストラクチャとデータベース

「サポート対象プラットフォーム」で、Confluence Data Center でサポートされているオペレーティング システムとデータベースをご確認ください。

「サポート対象プラットフォーム」ページのリストに記載されている任意のデータベースを使用できますが、既存のデータベース サーバーがない場合は Confluence Cloud が実行されている PostgreSQL をお勧めします。 

ライセンス

Confluence Data Center に移行するには新しいライセンスが必要になります。現在の Confluence Cloud ライセンスを使用することはできません。新しいライセンスは https://my.atlassian.com から入手できます。Confluence Data Center ではライセンスの無料トライアルを利用できます。有料の Marketplace アプリにも新しいライセンスが必要です。 

アカウントの可視性

Confluence クラウドでは、各ユーザーは自分のプロファイル情報を公開するかどうか選択することができます。この設定により、クラウドサイトがサーバーに移行された時、ユーザーの姓名等のアカウント情報が含まれないことがあります。

サイトエクスポートをする際、サイト管理者としてログインしていれば、メールアドレスは常にサイトエクスポートに含まれ、ユーザー作成時にユーザー名として利用されます。ユーザーはメールアドレスでログインでき、移行されなかった情報を更新することが可能です。 

移行の手順

このページでは、サイト全体の移行について説明します。スペースを 1 つずつ移行したい場合は「Confluence Cloud からスペースをインポートする」を参照してください。 

ステップ 1: アプリを確認する

アプリに互換性があるかどうかを確認するには、次の手順を実行します。

1. Confluence Cloud で、[設定] > [アプリの管理] に進みます。 
2. すべてのユーザー インストール アプリを記録しておきます。 
3. https://marketplace.atlassian.com に移動して各アプリを確認し、Server または Data Center エディションを利用できるかどうかを確認します。 

ステップ 2：Confluence Data Center をインストールする

この手順はアプリのホスト方法によって異なります。すべてのインストール オプションへのリンクについては、「Confluence インストール ガイド」をご参照ください。

ステップ 3: Confluence Cloud サイトをエクスポートする

Confluence Cloud サイトをエクスポートするには、次の手順を実行します。

1. サイト管理者として Confluence Cloud サイトにログインします。
2. Confluence Cloud で、[設定] > [バックアップ マネージャ] に進みます。
3. プロンプトに従ってサイトのバックアップを作成し、XML ファイルをダウンロードします。 

ファイルには、すべてのスペースとページ (添付ファイルを含む)、すべてのユーザーとグループが含まれます。 

ステップ 4: Confluence Cloud のサイト エクスポート ファイルをインポートする

サイトのエクスポート ファイルが非常に小さい (25 MB 未満) 場合を除き、ホーム ディレクトリ経由でインポートすることをおすすめします。  

ホーム ディレクトリからサイトをインポートするには、次の手順を実行します。 

1. エクスポート ファイルを <confluence-home>/restore/site.  にコピーします。
2. [管理] > [一般設定] > [バックアップとリストア] に移動します。 
3. [ホーム ディレクトリからインポート] で、サイト エクスポート ファイルを選択します。
4. インデックスが自動的に作成されるよう、[インデックスを作成] が選択されていることを確認します。
5. インポートを選択します。

サイトのインポート プロセスの詳細については、「サイトを復元する」をご参照ください。 

ステップ 5：システム管理権限を復元する

サイトのエクスポート ファイルをインポートすると、Confluence のインストール時に作成されたシステム管理者アカウントを含む、すべてのユーザー アカウントが上書きされます。既存のクラウド サイト管理者アカウントに、Confluence Data Center のシステム管理権限が自動的に付与されることはありません。 

システム管理権限を復元するには、次の手順を実行します。

1. Confluence を停止します。

2. <installation-directory>/bin/setenv.sh または setenv.bat を編集して、次のシステム プロパティを追加します。<your-password> を独自の一時的なパスワードで置き換えます。 

   -Datlassian.recovery.password=<your-password>

   
   システム プロパティを使用する方法の詳細については、「システム プロパティを構成する」参照してください。

3. Confluence を開始 (手動) します。Confluence をサービスとして起動しないでください。
4. ユーザー名 recovery_admin と、システム プロパティで指定した一時パスワードを使用して Confluence にログインします。 
5. [管理] > [ユーザー管理] > [ユーザーの追加] に移動します。
6. 新しいシステム管理アカウントの詳細情報を入力して [保存] をクリックします。強力なパスワードを使用するようにします。 
7. [グループの編集] を選択し、confluence-administrators グループを選択します。これはシステム管理権限を持つスーパー グループです。 
8. ログアウトし、新しいアカウントで正常にログインできることを確認します。
9. Confluence を停止します。 
10. <installation-directory>/bin/setenv.sh または setenv.bat を編集し、システム プロパティを削除します。 
11. 通常の方法 (手動またはサービスとして起動) で Confluence を再起動します。 

このプロセスの詳細については、「パスワードを復元して管理ユーザー権限を回復する」を参照してください。 

ステップ 6: 任意のアプリをインストールする

アプリを再インストールするには、次の手順を実行します。

1. 管理者として Confluence Data Center にログインします。
2. [管理] > [アプリの管理] に移動します。
3. プロンプトに従って、ステップ 1 で特定したアプリを検索またはアップロードします。これらのアプリについては、新しいライセンスを購入する必要があります。 

Team Calendars と Questions のデータはエクスポートに含まれず、現時点で Cloud から移行することはできない点にご注意ください。 

ステップ 7: アプリケーション リンクを確認する

Jira Software などの複数の Cloud 製品を使用している場合は、アプリケーション リンクの変更が必要になる場合があります。 

アプリケーション リンクを削除または更新するには、次の手順に従います。

1. [管理] > [一般設定] > [アプリケーション リンク] に移動します。
2. プロンプトに従って、誤った場所を指しているアプリケーション リンクを確認して更新します。 

インポート後に Jira Cloud のアプリケーション リンクを Confluence から削除できない場合、Confluence データベースから参照情報を直接削除する必要があります。「Confluence でアプリケーション リンクを削除する代替方法」を参照してください。

トラブルシューティング

Cloud サイトのインポート時に発生する可能性のあるいくつかの既知の問題があります。 

新しいサイトでページを読み込めない

インポート後にページの読み込みで問題が発生した場合は、ポートが変更されている可能性があるため、[管理] > [一般設定] に移動してベース URL をご確認ください。 

ユーザー管理画面が表示されない

This is a fairly uncommon problem caused by a dark feature flag that is included in your Cloud site export file. See CONFSERVER-35177 - Getting issue details... STATUS  for a workaround.

Jira 課題マクロが壊れている

If your Confluence Cloud site has macros that depend on the Application Links back to a Jira Cloud instance, and you are migrating Jira as well, these references will need to be updated to work properly. See Unable to locate Jira server for this macro. It may be due to Application Link configuration.  for a workaround. 

Confluence Data Center にインポートする前に、XML ファイルの編集や Confluence データベースにおけるこれらの参照の一括編集も実行できます。「別の Jira インスタンスを示すよう Jira 課題マクロを一括更新する方法」をご参照ください。

ユーザーのメンションが異常です

When a page with user mentions is migrated from Confluence Cloud to Confluence Data Center using either site or space migration, the mentions display as "broken link". For a Cloud-to-Cloud migration via Confluence Data Center, the mentions display as "@unlicensed user". See CONFSERVER-79583 - Getting issue details... STATUS  for the workaround.

壊れたアンカー リンク

Confluence Cloud replaces anchor macros with web links that are not compatible with Data Center versions after migration. See CONFSERVER-79006 - Getting issue details... STATUS for the workaround.

ユーザーのお気に入り (スター付きページ、後で読むために保存したページ) が見つからない

If you find that some of your users' favorites (pages saved for later) are missing due to CONF-36348 - Getting issue details... STATUS . See How to restore missing favorites after import from XML for more information.

全幅のスペース テンプレートが原因でスペースのインポートが失敗するか不完全になる

If you import an XML space from Confluence Cloud containing space templates with the full-width property it will result in a failed import, or only a partial import. See CONFSERVER-80146 - Getting issue details... STATUS  for a workaround.

一部のユーザー アカウントが欠落しているか、ユーザーの詳細情報なしで作成されている

Confluence Cloud のユーザーは、プロファイルの公開範囲を変更できます。すべてのユーザー データがエクスポートに含まれるようにするためには、サイト管理者にエクスポート実施を依頼してください。