はじめる前に

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

最小の Confluence バージョン

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

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

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

一部のクラウド機能は、Confluence Server または Data Center では利用できません。また、ナビゲーションとユーザー エクスペリエンスが異なる場所があります。ただし、Confluence の中核となる機能は同様に使用できます。 

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

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

テンプレート

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

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

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

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

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

移行のアプローチ

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

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

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

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

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

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

Confluence Server または Data Center のどちらをホストするかは、ユーザー次第です。「サポート対象プラットフォーム」で、サポートされているオペレーティング システムとデータベースをご確認ください。 

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

ライセンス

Confluence Server または Data Center に移行するには、新しいライセンスが必要になります。既存の Confluence Cloud ライセンスは使用できません。新しいライセンスは http://my.atlassian.com から入手できます。また、有料の Marketplace アプリに新しいライセンスが必要です。 

アカウントの可視性

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

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

移行の手順

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

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

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

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

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

この手順は、Server または 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. 
 にコピーします。
   (このディレクトリが置かれている場所がわからない場合は、バックアップと復元 画面にパスが一覧表示されています)
2. [管理] > [一般設定] > [バックアップとリストア] に移動します。 
3. [ホーム ディレクトリからインポート] で、サイト エクスポート ファイルを選択します。
4. インデックスが自動的に作成されるよう、[インデックスを作成] が選択されていることを確認します。
5. インポートを選択します。

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

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

サイトのエクスポート ファイルをインポートすると、Confluence のインストール時に作成されたシステム管理者アカウントを含む、すべてのユーザー アカウントが上書きされます。既存のクラウド サイト管理者アカウントに、Confluence Server または 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 Server または 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 Server または Data Center にインポートする前に XML ファイルを編集したり、Confluence データベースでこれらの参照を一括編集することもできます。「別の Jira インスタンスを示すよう Jira 課題マクロを一括更新する方法」を参照してください。

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

When a page with user mentions is migrated from Confluence Cloud to Confluence Server or 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 のユーザーは、プロファイルの公開範囲を変更できます。すべてのユーザー データがエクスポートに含まれるようにするためには、サイト管理者にエクスポート実施を依頼してください。