Confluence Cloud から Data Center への移行

このページは、現在 Confluence Cloud を利用しており、Confluence Data Center（オンプレミスの Confluence インスタンス）への移行を検討中の方を対象としています。

はじめる前に

このプロセスを開始する前に、いくつかの点を理解しておく必要があります。

最小の Confluence バージョン

Confluence Cloud からは Confluence Data Center 6.0 以降に移行できます。以前のバージョンの Confluence Data Center へのクラウド・データのインポート（インスタンス全体または個々のスペース）はサポートされていません。

We recommend installing either the latest version of Confluence, or the latest Enterprise release. The Confluence Upgrade Matrix will help you choose the right version for your organization.  

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

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

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

Not all apps are available for both Cloud and Data Center. When planning your migration, we recommend you check that your essential apps are available for Data Center in the Atlassian Marketplace and make a list of the ones you'll need to reinstall. 

テンプレート

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

However, any custom templates you may have created in your Confluence Cloud site will not be migrated. You'll need to re-create your templates once your migration is complete. 

また、Confluence Data Center ではビルトイン・テンプレート（ブループリントとも呼ばれます）の数が限られているため、以前使用していた既定のテンプレートの一部が使用できない場合があることに注意してください。 

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

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

移行のアプローチ

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

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

A space by space migration involves exporting each space individually, and importing these files into Confluence Data Center one at a time. This means you can choose which spaces you want to migrate, or migrate in stages over time. Users and groups are not automatically migrated. If you've connected Confluence Data Center to an external user directory, or have already populated your new site with user accounts, we'll attempt to attribute content to the right people on import. 

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

Where you choose to host Confluence Data Center is up to you. See Supported Platforms to find out which operating systems and databases are supported. 

You can use any database listed on the Supported Platforms page, but you don't already have a database server, we recommend PostgreSQL, which is what Confluence Cloud is run on. 

ライセンス

You will need a new license to migrate to Confluence Data Center. Your existing Confluence Cloud license can't be used. You can get a new license at https://my.atlassian.com. You'll also need new licenses for any paid Marketplace apps. 

アカウントの可視性

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

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

移行の手順

このページでは、サイト全体の移行について説明します。

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

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

1. まだアクセスしていない場合は、Confluence Cloud インスタンスにアクセスします。

2. 右上隅の歯車アイコン () を選択して Confluence 管理を開きます。

3. 左側のナビゲーションで [設定] > [Atlassian Marketplace] を見つけます。

4. [アプリを管理] を選択します。 

5. すべてのユーザー インストール アプリを記録しておきます。 

6. Go to https://marketplace.atlassian.com and look up each app to see if a Data Center edition is available. 

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

この手順はアプリのホスト方法によって異なります。 

See Confluence Installation Guide for links to all the installation options.  

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

Confluence Cloud インスタンスをエクスポートする方法。

1. サイト管理者として Confluence Cloud サイトにログインします。

2. 右上隅の歯車アイコン () を選択して Confluence 管理を開きます。

3. 左側のナビゲーションで [設定] > [バックアップ マネージャー] を見つけます。

4. プロンプトに従って、XML ファイルをダウンロードします。 

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

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

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

ホーム ディレクトリからインポートする方法。 

1. エクスポート ファイルを <confluence-home>/restore. にコピーします。
   (このディレクトリが置かれている場所がわからない場合は、バックアップと復元 画面にパスが一覧表示されています)

2. > [一般設定] > [バックアップと復元] の順に移動します。 

3. [ホーム ディレクトリからインポート] で、サイト エクスポート ファイルを選択します。

4. インデックスが自動的に作成されるよう、[インデックスを作成] が選択されていることを確認します。

5. インポートを選択します。

See Restoring a Site for more information about the import process. 

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

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

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

1. Confluence を停止します。

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

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

   
   See Configuring System Properties for more information on using system properties.

3. Start Confluence manually (don't start Confluence as a service).

4. ユーザー名 recovery_admin と、システム プロパティで指定した一時パスワードを使用して Confluence にログインします。 

5. > [ユーザー管理] > [ユーザーを追加] の順に移動します。

6. 新しいシステム管理アカウントの詳細情報を入力して [保存] をクリックします。強力なパスワードを使用するようにします。 

7. [グループの編集] を選択し、confluence-administrators グループを選択します。これはシステム管理者の権限を持つスーパーグループです。 

8. ログアウトし、新しいアカウントで正常にログインできることを確認します。

9. Confluence を停止します。 

10. <installation-directory>/bin/setenv.sh または setenv.bat を編集し、システム プロパティを削除します。 

11. 通常の方法 (手動またはサービスとして起動) で Confluence を再起動します。 

See Restore Passwords To Recover Admin User Rights for more information on this process. 

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

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

1. 管理者として Confluence Data Center にログインします。

2. > [アプリの管理] に移動します。

3. プロンプトに従って、ステップ 1 で特定したアプリを検索またはアップロードします。これらのアプリについては、新しいライセンスを購入する必要があります。 

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

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

Jira などの複数の Cloud アプリをご利用の場合は、アプリケーション リンクの変更が必要になる場合があります。 

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

1. > [一般設定] > [アプリケーション リンク] に移動します。

2. プロンプトに従って、誤った場所を指しているアプリケーション リンクを確認して更新します。 

If you're unable to remove the Jira Cloud application link from your Confluence instance after the import, you'll need to remove those references directly from the Confluence database. See Alternative Methods of Deleting Application Links in Confluence.

トラブルシューティング

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

• Confluence Data Center でページが読み込めない

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

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

If your Confluence Cloud instance 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  APL-1144 for a workaround. 

You can also edit the XML file prior to importing it into Confluence Data Center, or by bulk editing those references in Confluence database. See How to bulk update Jira Issue Macro to point to a different Jira instance.

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

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

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

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