Confluence Cloud Migration Assistant を使用して移行する (レガシー)

このドキュメントは変更中です

このページはレガシーとしてマークされましたが、特に 1 ページですべての情報を表示する場合は、コンテンツは正確であり引き続き使用できます。コンテンツの順序をよりきめ細かく分けて手順が明確になった新しいエクスペリエンスをご覧になりたい場合は、Confluence Cloud Migration Assistant にアクセスしてください。

Confluence Cloud Migration Assistant は、 Confluence Server または Data Center から Confluence Cloud への、コンテンツ、ユーザー、およびグループの簡単な移動を支援するアプリです。アトラシアンが構築と保守を行うこのアプリは、無料でインストールして使用できます。

このアプリによって、Cloud に移動するコンテンツを選択して、好きなタイミングで移行を開始できます。移行プロセスの間は、すべての項目の進捗状況を監視できます。

Confluence Cloud Migration Assistant を使用するタイミング

次の場合は、Confluence Cloud Migration Assistant を使用します。

  • Confluence Server または Data Center のユーザーやデータを Confluence Cloud サイトに移動したい

  • Confluence Server または Data Center から Confluence Cloud サイトに移行する前にアプリを評価したい

  • Confluence Server または Data Center から Confluence Cloud へのテスト移行を実行したい

  • アトラシアン株式会社からアプリの使用を推奨された

はじめる前に

Cloud 移行ガイドを必ずご確認ください。このガイドでは、移行プロセスをステップ バイ ステップで説明しており、問題点の特定に役立ちます。

テストまたは本番環境への移行を試行する前に、移行前チェックリストを完了していることをご確認ください。このチェックリストを使用すると、移行に向けて環境やデータを準備して、移行の失敗となる一般的な原因を回避できるようになります。Confluence 移行前チェックリストの詳細をご確認ください。

Confluence Cloud Migration Assistant アプリのインストール

Confluence Server サイトのバージョンが 6.13 以降の場合、Confluence Cloud Migration Assistant は事前にインストールされているため、別途インストール不要です。ただし、アプリの更新を求められる場合があります。 

バージョン 5.10 ~ 6.12 にアプリをインストールするには以下の手順を実行します。

  1. Confluence Server で、 > [アプリを管理] の順に移動します。

  2. [新しいアドオンを検索] を選択します。 

  3. Confluence Cloud Migration Assistant を検索します。 

  4. [インストール] を選択したら完了です。

Migration Assistant を見つける

Migration Assistant を検索するには、次の手順に従います。

  1. [Confluence 管理] に移動し、Atlassian Cloud カテゴリで [移行アシスタント] を選択します。

Confluence Server サイトがファイアウォールの内側にある場合は、ドメイン atlassian.com へのアクセスを許可する必要があります。

移行パスを作成するには、4 つのステップがあります。

  1. アプリを評価する

  2. アプリを準備する

  3. すべてのメール ドメインを確認する

  4. データを移行する

以降のセクションでは、各段階の詳細について説明します。

移行するアプリがない場合は、手順 3 に進んでください。

CCMA ホームページ

以降のセクションでは、各段階の詳細について説明します。

1. アプリを評価する

ステージ 1 と 2 のアプリに関する注意

[アプリを評価] 画面では、自動パスのあるアプリを [ステージ 1] または [ステージ 2] のラベルで分けてリストできます。

  • ステージ 1: このステージのアプリは移行成功率が不明か低いことが判明しています。ステージ 1 のアプリを移行しようとしてアプリ データの移行に失敗する場合は、対応する Marketplace Partner (アプリのベンダー) に問い合わせてサポートを依頼する必要があります。

  • ステージ 2: このステージのアプリは移行成功率が高いことが判明しています。

アプリを評価する際はドキュメントをご参照いただき、自動移行パスのあるアプリのステージを理解することが重要です。

サーバー上のアプリで重要なデータを管理している場合は、そのデータの移行に最適なプロセスについて Marketplace Partner (アプリのベンダー) にご確認ください。

Server にインストールしたアプリを確認して、移行準備中のアプリを評価するには、Confluence Cloud Migration Assistant を使用します。移行前にアプリを評価して (必要に応じて) Cloud サイトの代替アプリを選択すると、肝心なときにアプリによって移行がブロックされるようなリスクを排除できます。アプリの評価方法をご確認ください。

アプリの評価を開始するには、次の手順に従います。

Migration Assistant のホーム画面で [アプリを評価] を選択します。Confluence Cloud Migration Assistant でのアプリ評価に関する詳細をご確認ください。

アプリを評価し終えたら [完了] を選択します。Migration Assistant のホーム画面に戻るので、次のステップとしてアプリの準備を選択できます。

2. アプリを準備する

この段階では 3 つのメイン タスクを実行します。

  • Cloud サイトに接続する

  • アプリをインストールする

  • アプリの移行に同意する

Migration Assistant のホーム画面で [アプリを準備] を選択します。これによって [Cloud に接続] 画面が表示されます。

2.a. Cloud サイトに接続する

このステップでは、任意の Cloud サイトをリンクします。これには 3 つの方法があります。

  • ドロップダウンから既存の Cloud サイトを選択する

  • アトラシアンの Free プランにサインアップする (最大 10 ユーザー、無料の Cloud サイト)

  • 無料の製品トライアルをセットアップする

screenshot_CCMA_connectToCloudScreen

インストール先を選択したら [続行] をクリックします。

2.b. アプリをインストールする

[アプリをインストール] 画面で、次の手順に従います。

  1. リストされている各アプリに対して [アプリのインストール] を選択して、Cloud サイトにインストールします。

  2. 各アプリのサポートとプライバシー ポリシーを読みます。

  3. [続行] を選択します。これによって [アプリの移行に同意] 画面が表示されます。

  • 評価フローを完了するには、この段階で必要なアプリを Cloud にインストールする必要があります。

  • 各アプリのプライバシー ポリシーを確認することを強くお勧めします。 

2.c. アプリの移行に同意する

評価フローを完了するには、各アプリについてアプリの移行を承諾して同意する必要があります。

[アプリの移行に同意する] 画面で、次の手順に従います。

  1. 同意が必要であることが表示されている各アプリの [ポリシーを表示] を選択します。
    次を記載したカードが表示されます。

    1. Marketplace Partner (ベンダー) が read core dataread user data.などでアクセスできるすべての種類のデータ。

    2. Atlassian Marketplace 利用規約Marketplace Partner のプライバシー ポリシーMarketplace Partner 利用規約の各リンク。移行する各アプリについて、これらをお読みになることを強くお勧めします。

  2. このカードで [確認] を選択します。

  3. 該当するすべてのアプリに対して上記のアクションを実行後、[完了] を選択して Migration Assistant ホーム画面に戻ります。

サードパーティ移行の同意に関する詳細は、次のセクションをご参照ください。

 

サードパーティ移行の同意

アプリの移行が実行されると、各 Server アプリから Cloud サイト上の Cloud バージョンの Server アプリにデータが移動されます。各アプリを構築した Marketplace Partner (ベンダー) は、データを移動するための移行パスを作成しています。

このプロセスでアプリ データの移行を実際に実行するのは、アトラシアンではなく Marketplace Partner です。このため、各 Marketplace Partner の契約を確認して同意し、パートナーがデータにアクセスして移行できるようにする必要があります。

各アプリを構築した Marketplace パートナー (ベンダー) は、App Migration Platformとして知られるアトラシアンのプラットフォームを介してデータを移動するための移行経路を作成しました。

特定のアプリを開発した Marketplace Partner (ベンダー) がデータ移行を実行することを理解するのが非常に重要です。アトラシアンは、Marketplace Partner とアプリ ユーザーであるお客様との間のルートとなる App Migration Platform を開発しました。

データのセキュリティと許可されたアクセス スコープ

App Migration Platform を使用すると、Server アプリがアプリ データを Cloud にエクスポートし、Confluence と Jira のマッピングにアクセスします。アクセスは非常に厳密に制御され、データ型リストまたはアクセス スコープに制限されています。

  • ご利用の Server インスタンスにインストールしているアプリを構築した Marketplace Partner は、アプリの移行に必要なアクセス スコープを文書化しています。

  • これらのアクセス スコープは、お客様が Marketplace Partner によるこのデータへのアクセスに同意できるように、Cloud Migration Assistant に表示されます。

特定の情報とアクセス スコープのリストは、アトラシアンの開発者向けドキュメントの [セキュリティ] ページと [アクセス スコープ] ページにあります。詳細は、アトラシアンが推奨する開発者向けデータ プライバシー ガイドラインをお読みください。

移行に同意する

Marketplace Partner アプリごとにアクセス スコープが異なります。このため、各 Marketplace Partner の合意事項を確認して同意し、パートナーがデータにアクセスして移行できるようにする必要があります。

アトラシアンの Cloud サービス利用規約とプライバシー ポリシーは、Cloud サイトにインストールされているアプリには適用されません。各 Marketplace Partnerー (アプリ ベンダーとしても知られる) は、独自のプライバシー ポリシーと利用規約を持っています。移行するデータへのアクセスを許可する前に、各 Marketplace Partner のプライバシー ポリシーと利用規約を確認して同意する必要があります。

次の点について把握しておくことが重要です。

  • 移行に同意する必要があるのは、自動移行パスのあるアプリのみです。

  • サードパーティの移行に同意する場合は、同意をいつでも取り消せます。

  • サードパーティの移行に同意しない場合、そのアプリは Confluence Cloud Migration Assistant を使用して移行できません。

  • Marketplace Partner がアプリを更新する場合は、移行に再度同意する必要があります。

  • アプリの移行に同意した後でも [同意を取り消す] を選択できます。これによって、サードパーティのデータ移行に対する同意が削除されます。もう一度同意するには、[ポリシーを表示] をクリックして同意を再確認します。

次の操作を行っていない場合、[完了] ボタンは無効になります。

  • [アプリを評価] 画面で各アプリにステータスを割り当てた

  • [アプリをインストール] 画面で Cloud に必要なアプリをインストールした

  • [アプリの移行に同意] 画面で各アプリのポリシーを表示して同意した

準備が整えば、アプリ評価は完了です。[完了] をクリックしてホームページに戻ります。 

この表に関する簡単なメモ:

  • アトラシアンの Cloud サービス利用規約とプライバシー ポリシーは、Cloud サイトにインストールされているアプリには適用されません。

  • Cloud サイトにアプリをインストールすると、Atlassian Marketplace の利用規約と Marketplace パートナーのプライバシー ポリシーおよび利用規約に同意したことになります。

  • Cloud サイトにアプリをインストールする前に、プライバシー ポリシーの詳細を確認する必要があります。 

  • 各アプリのプライバシー ポリシーと利用規約は、Atlassian Marketplace のアプリ リストに記載されています。

アプリの移行に関する同意ステータス メッセージ

Status Message

ご確認いただきたい内容

このアプリについてサードパーティによるアプリ データの自動移行に同意しました。

このアプリを移行する準備ができています。

本データ移行ポリシーを確認した上で同意する必要があります。同意がない場合はアプリのデータを移行できません。

このアプリを移行する前に、提供されたポリシーと利用規約を確認する必要があります。

同意済みのポリシーが更新されました。アプリ データを移行する前に、変更内容を確認して再度同意してください。

Marketplace Partner がポリシーに変更を加えた場合は、ポリシーをもう一度確認して同意する必要があります。同意しなかった場合は、アプリ データが同意していない条件下で移行されます。

このアプリは、アプリ データを移行しなくてもクラウド サイトで機能します。インストールしてコア データを移行すれば、すぐに使用できます。

これは、アプリに Server から Cloud に移行すべきデータが含まれていないことを意味します。この場合、Cloud サイトに Cloud バージョンをインストールするだけで終了します。

選択した代替アプリ間では自動移行パスを使用できません。移行サポートを受けるには、アプリ ベンダーにお問い合わせください。

Server 上にあるアプリを置き換えるようにアプリ評価表で代替アプリを選択した場合、移行パスはありません。あるアプリから別のアプリにデータを移行する場合は、両方の Marketplace Partner に連絡する必要があります。

このアプリには自動移行パスがありません。移行サポートを受けるには、アプリ ベンダーにお問い合わせください。

ベンダーによるアプリの移行パスが未構築です。ベンダーにお問い合わせの上、手動による移行プロセスの手順をご確認ください。

このアプリのバージョンは、アプリ データの移行に対応していません。関連するアプリ移行ポリシーに同意するには、Server アプリのバージョンをアップデートする必要があります。

インストールしたアプリはアプリ データ移行をサポートしていますが、アプリ データ移行をサポートするバージョンに Server アプリをアップデートする必要があります。

[ポリシーを表示] をクリックすると、次を一覧するモーダルが表示されます。

  • 当該の Marketplace Partner のアクセス スコープ

  • このアプリを移行するためにアクセス/参照する必要のあるすべての情報

各モーダルには 3 つのリンクが用意されています。

  • Atlassian Marketplace の利用規約 (アプリごとに同じ)

  • Marketplace Partner のプライバシー ポリシー (各アプリに固有)

  • Marketplace Partner の利用規約 (各アプリに固有)

アプリごとにそれぞれ確認することを強くお勧めします。

準備が整えば、アプリ評価は完了です。
[完了] を選択してホームページに戻ります。

移行前に Cloud サイトのデータ競合について確認する

Server と Cloud の各サイトでいくつかの手動チェックを実行することで、問題の発生や移行の失敗のリスクを軽減できます。

1. グループの競合を確認する

Cloud サイト内に、Server サイトと同名のグループが存在していないことを確認します (意図的にマージしようとしている場合を除く)。

Cloud サイト (Jira または Confluence) のグループと同名のグループが Server サイト内に見つかった場合、ユーザーは Server のグループから Cloud のグループにマージされます。Server グループは Cloud グループの権限を継承します。これは、移行している Confluence グループと同名の、Jira 製品アクセスを持つグループにも適用されます。これは、Cloud サイトではすべてのユーザーとグループが一元管理されるためです。

これを防ぐには、移行の実行前に、Server と Cloud のすべてのグループの名前が一意であることを確認する必要があります。

次のグループは管理者アクセスを管理しているため、ブロックリストに登録済みで、移行できません。

  • site-admins

  • system-administrators

  • atlassian-addons

  • atlassian-addons-admin

上記のグループのユーザーは引き続き移行されるため、ユーザーをいずれかのブロックリスト グループに追加する場合は、移行後に手動で追加する必要があります。

2. スペース キーの競合を確認する

移行前に、Server と Cloud の各サイト間に同じスペース キーを持つスペースがないことを確認します。

Server サイトのスペースが Cloud サイトのスペースと同じスペース キーを持っていた場合、移行は失敗します。これは、Confluence Cloud 内の各スペースに、一意のスペース キーが必要なためです。競合が見つかった場合は、次の操作を実行できます。

  • Cloud または Server の各サイトから重複スペースを削除する

  • Cloud サイトをリセットする

  • 対象のスペースの移行をやめる

Migration Assistant が競合を検出した場合、そのスペースは移行されません。

スペース キーの競合が過去のテスト移行によって発生している場合、移行前にクラウド サイトをリセットできます。Confluence Cloud サイトのリセット方法をご確認ください。

3. すべてのメール ドメインを確認する

移行する前に、ユーザーのメール ドメインを確認して、認識できない、または信頼できないメール ドメインからユーザーが移行されないようにする必要があります。これにより、Cloud サイトのセキュリティが向上します。ここで選択したドメインは、今後のすべての移行に適用されます。

ドメインの確認は、"移行アシスタントのホーム" 画面から開始できます。[すべてのメール ドメインを確認する] を選択します。これによって、"すべてのメール ドメインを確認する" 画面が表示されます。

この画面には、すべてのメール ドメインと各ドメインのユーザー数が一覧表示されます。すべてのドメインを "信頼済み" としてマークする必要があります。これによって、信頼できるメール ドメインからのみユーザーを移行できます。

リストされている各ドメインについて、次の 3 つのうち、いずれかの 1 つに決める必要があります。

稟議書

この決断をする条件

必要なアクション

信頼済みドメイン

このドメインが信頼済みであり、権限のないユーザーがいないことを確認している場合

移行を続行できます。

信頼していないドメイン

  • このドメインと、このドメインで作成されたメールを認識できない場合

  • このドメインを使用してメールを作成する組織を信頼していない場合

信頼していないドメインのユーザーを変更する必要があります。メール ドメインを信頼済みにするためにユーザーを確認する方法をご確認ください。

No decision made

そのドメインが信頼できるかどうか分からない場合

ドメインが信頼済みであるか、そのドメインに不正なメールがないかどうかをご確認ください。ドメインの確認後、"信頼済みドメイン" としてマークすると移行を続行できます。

すべてのメール ドメインを確認して、信頼済みとしてマークする必要があります。すべてのドメインを信頼しなくても移行を続行できますが、移行を実行することはできません。

すべてのドメインを信頼済みドメインとしてマークしたあと、[完了] を選択してドメインの確認を完了すると、"移行アシスタントのホーム" 画面に戻ります。

過去に保存した移行がある場合:

  1. 移行ダッシュボードから、新しい移行の作成、または既存の移行を実行できます。メール ドメインを確認するように指示するメッセージが表示されます。

  2. すべてのメール ドメインを確認して、信頼済みとしてマークするには、[ドメインを確認] を選択します。

  3. ドメインをあとで確認したい場合は、[Continue without reviewing (確認しないで続行)] を選択します。この段階では、すべてのドメインを信頼しなくても移行を続行できますが、移行を実行することはできません。

4. データを移行する

次の 5 つの主なステップで、Server または Data Center から Cloud への移行をセットアップして実行します。次のステップに従います。

  1. クラウドに接続

  2. 移行対象を選択

  3. エラーの有無の確認

  4. 移行の確認

  5. 移行

CCMA でデータを移行する

以降のセクションでは各ステップを詳細に説明と併せて、発生する可能性がある一般的なエラーについて解説します。

テスト移行を実行する

最終移行を実行する前に、テストまたはステージング サイトへのテスト移行を行うことを強く推奨します。移行のテスト方法をご確認ください

データの移行を開始するには、次の手順に従います。

  1. Migration Assistant のホーム画面で [データを移行] を選択します。これによって [移行ダッシュボード] が表示されます。

  2. [新しい移行を作成] を選択します。これによって [動作の仕組み] 画面が表示されます。

  3. 画面の情報を確認して [クラウドに接続] を選択し、続行します。

4.a. クラウド サイトに接続する

移行の名前を追加して、[移行ステージを選択] メニュー (本番またはテスト) から移行タグを選んだ上で、移行先のクラウド サイトを選択するように求められます。サーバー サイトと移行先のクラウド サイトの両方で管理者である必要があります。

クラウド サイトに接続する

クラウド サイトに接続済みの場合は、ドロップダウンにそれが表示されます。何も表示されない場合は、新しいクラウド サイトに接続するか、新しいクラウド ライセンスにサインアップする必要があります。

準備が整ったら、サーバー サイトからクラウド サイトへのデータの転送をアトラシアンに許可するチェックボックスをオンにします。このアクセスをアトラシアンに許可できない場合は、Migration Assistant での移行を行えません。代わりにスペース インポートを実行する必要があります。

Confluence Server サイトがファイアウォールの内側にある場合は、ドメイン atlassian.com へのアクセスを許可する必要があります。また、他の Atlassian ドメインへのアクセスを許可する必要がある場合もあります。許可リストに登録する必要がある IP アドレスとドメインについてご確認ください。

4.b. 移行対象を選択する

すべてをまとめて移行することも、いくつかの段階に分割することもできます。

選択肢は次のとおりです。

  • グローバル ページ テンプレートとカスタム システム テンプレート、またはテンプレートの移行をスキップ

  • スペース (その添付ファイルおよび関連する Team Calendar)、またはスペースの移行をスキップ

  • 添付ファイルのみ

  • スペースのすべてまたは一部 (およびそれらの添付ファイル)

  • Confluence ディレクトリのユーザーおよびグループのすべてまたは一部

  • アプリの評価時に [クラウドで必要] とマークしたすべてのアプリ

グローバル テンプレート、スペース、ユーザーとグループ、アプリを選択するためのタスクリスト画面

添付ファイルのみ

他のスペース データを移行する前に、スペースの添付ファイルを移行することを選択できます。次の理由から、最初に添付ファイルを移行することをお勧めします。

  • システムでは、スペース データの前にメディアをクラウド上に配置する必要があるため、スペースを移行した後で添付ファイルを移行すると、一部の添付ファイルがクラウド上で正しくリンクされない場合があります。添付ファイルやメディア データの損失を確実に防ぐため、移行前のタスクとして添付ファイルを移行することを強くお勧めします。[添付ファイルのみ] を選択すると、選択したスペースに関連する添付ファイルのみを移行できます。

  • これによって、残りのスペース データ移行の期間を短縮できます。通常、添付ファイルの数が多いほど、予想されるダウンタイムも長くなります。添付ファイルのみを移行してダウンタイムを短縮する方法についてご確認ください

その後、スペースを移行する必要があります。これにより、スペースと添付ファイル間のリンクが自動的に復元されます。移行アシスタントによって、すでに移行された添付ファイルが認識されてスキップされます。新しい添付ファイルは引き続き移行されます。また、削除済みの添付ファイルのリンクは削除されます。

ユーザーとグループ

テスト移行または UAT の場合、テスト Cloud サイトは製品サイトもホストしている組織に含まれないものを使用することをお勧めします。関連するユーザーとグループのスムースな移行を確保するために、製品サイトは別の組織でホストする必要があります。

ユーザーをすべて移行するか、一部を移行することを選択できます。

すべてのユーザーを移行する場合は、初回の実行時にすべてのユーザーが Cloud サイトに追加されます。以降のそれぞれの移行では、データが Cloud 内にすでに存在するユーザーにリンクされます。大規模なユーザーベースの移行に関する詳細をご確認ください。

ユーザーを移行する場合は、それらのユーザーが Cloud で該当するグループに追加されます。移行後にグループ権限を確認、承認する必要があります。グループ権限を承認すると、ユーザーには Confluence へのアクセス権が与えられ、ユーザーは請求対象に含められます。

ユーザーへの招待は送信されません。ユーザーを招待するには、移行後に管理スペースから招待を送信するか、自身でログインできるように当該ユーザーへリンクを送信します。

ユーザーとグループで [Migrate users related to the selected spaces (選択されたスペースに関係するユーザーを移行)] を選択すると、移行しているスペースに関連付けられている一部のユーザー データが引き続き移行されます。これは、メンション、コメント、ページ履歴をアクティブな状態に保つためです。

必ず移行されるユーザー データには、次の情報が含まれます。

  • 氏名

  • ユーザー名 (移行後に破棄)

  • メール アドレス

このうち、移行しているスペースに直接関連付けられているユーザーに関する情報のみが移行されます。これらのユーザーに対する製品アクセスの付与やグループへの追加は実行されません。これらのユーザーは、Cloud サイトにあるユーザー リストに表示されます。

ユーザーをあとから移行することを選択した場合、それらのユーザーの製品およびグループ アクセスはあとで更新されます。

また、ユーザーとグループを移行しないことを選択して、Cloud に存在しないグループによって付与されたスペース権限がある場合、Confluence Cloud Migration Assistant は各スペース権限を移行しません。このシナリオを回避するには、移行前に Cloud サイトで当該グループを作成することをお勧めします。

ユーザーおよびグループの移行時には、次の点にもご注意ください。

  • 移行エクスペリエンスに影響する可能性のあるユーザー管理への変更を公開しています。admin.atlassian.com の組織で、[ユーザー] と [グループ] の各リストが [ディレクトリ] タブにある場合は、改善されたユーザー管理エクスペリエンスをご利用中です。つまり、複数サイト全体のユーザーとグループが組織にマージされます。

  • ユーザーは、信頼できる情報源としてメール アドレスを使用して移行されます。その後の移行では、移行アシスタントはユーザーを再度移行するのではなく、メール アドレスを使用してユーザーをリンクさせます。大量のユーザーを移行する場合の詳細をご確認ください。 

  • クラウドに移行する前に、すべてのユーザー アカウント (メール アドレス) を検証する必要があります。不明なユーザー アカウントの移行によって、Cloud サイトへの未承認のアクセスを許可することになる可能性があります。たとえば、“email@example.com” など、自分の組織が所有しないメール アドレスのユーザーをサーバー インスタンスに含めると、“@example.com” を所有する何らかのユーザーを Cloud の自分のサイトに招き入れる可能性があります。

  • Confluence Cloud はサブスクリプション ベースで、ユーザー単位で請求が行われます。利用可能なライセンス オプションの詳細をご確認ください。 

  • 外部のユーザー管理システムを使用している場合は、移行前にローカル ディレクトリと同期させることをお勧めします。これは、データを転送する前にユーザーとグループが最新であることを確認するためです。

  • Server サイトにある無効ステータスのユーザーは、アクティブだがすべての製品アクセスを持たないユーザーとして移行されます。つまり、請求時にはアクティブな Confluence ユーザーとして計上されません

  • Cloud サイトにあるグループと同名のグループが Server サイト内に見つかった場合、そのユーザーはサーバーのグループからクラウドのグループにマージされます。

  • グローバル設定とグローバル サイト権限はこのツールでは移行されません。これらは移行後に手動で設定する必要があります。

  • 宛先クラウド サイトにすでにユーザーが存在していて、このアプリでユーザーを移行することを選択した場合は、次のようになります。

    • ユーザーが Cloud で製品アクセスを持っているが Server サイトでステータスが無効にされている場合は、移行後も Cloud 内で製品アクセスを持ちます。

    • ユーザーが Cloud で製品アクセスを持っていないServer サイト内で有効にされている場合は、移行プロセスを通じて製品アクセスが付与されます。

Confluence を Jira Service Management (旧 Jira Service Desk) のナレッジ ベースとして使用している場合は、Jira Service Management ユーザーが Confluence ユーザーとともに移行される可能性もあります。これは、Confluence の cwd_user テーブルに Jira Service Management ユーザーが表示される場合に発生します。

グローバル テンプレート

移行にグローバル テンプレートを追加する方法。

  1. [グローバル テンプレート] セクションで、次のいずれかのオプションを選択します。

  • グローバル ページ テンプレートを移行する

  • カスタム システム テンプレートを移行する

  • すべてのグローバル テンプレートを移行する

  • なし

移行したいグローバル テンプレートのタイプを選択します

2. 準備ができたら、[追加して移行] を選択します。

スペース

スペースのすべてまたは一部を移行する場合は、オプションで [すべて] を選択します。その後、移行するスペースを選択できるようになります。スペースを移行しない場合は、ただちにエラーの確認に移動します。

移行にスペースを追加するには、次の手順に従います。

  1. [スペース] セクションで、次のいずれかのオプションを選択します。

オプション

説明

すべて

選択したすべての Confluence スペースを移行します。

添付ファイルのみ

選択した Confluence スペースから添付ファイルのみを移行します。添付ファイルを事前に移行する方法についてご確認ください。

2. 移行するスペースを選択します。

移行するスペースを選択する
  • Confluence Cloud 移行アシスタント 3.4.14 以降を初めて使用する場合は、現在読み込み中のスペース データの割合を示す読み込み中メッセージがスペース選択画面に表示されます。

  • 一部のスペース情報が計算できない場合、そのようなスペースのデータは警告付きで「--」と表示されます。スペース選択画面のこのような警告の詳細についてはこちらをご確認ください。

  • 移行先の Confluence Cloud サイトにすでに存在するスペース キーを持つスペースは移行できるようになりません。スペース キーの競合の詳細についてはこちらをご確認ください。

スペースの名前かキーを使用して特定のスペースをフィルタリングまたは検索するか、テーブルの次のオプションのいずれかを選択できます。

スペース選択オプション

説明

Select all on this page (このページのすべてのスペースを選択)

特定のページですべてのスペースを移行対象として選択します。

すべて選択

すべてのページですべてのスペースを移行対象として選択します。

Clear all on this page (このページのすべてのスペースをクリア)

特定のページのスペースをすべてクリアします。

全て削除

すべてのページでスペースの選択をすべて解除します。

多数のスペースや添付ファイルがある場合、または Data Center を使用している場合、移行をいくつかに分割して、小さな規模で実行できます。管理するタスクが多い場合、移行アシスタントでタスクの読み込みや処理の速度が低下する場合があります。

スペース選択画面に表示される任意の列でスペースを並べ替えることができます。スペースの移行ステータスと最終編集日を基準にスペースをフィルタリングすることも可能です。以下はスペース選択画面の各機能の簡単な説明です。

スペース選択画面の機能

説明

移行ステータスを基準にスペースを選択して並べ替える

[移行ステータス] フィルターを使用することで、移行ステータスを基準にスペースをフィルタリングできます。スペース移行ステータスには次のものがあります。

  • NOT IN ANY PLAN: スペースはまだどの移行にも追加されていません。

  • QUEUED: スペースは実行待ちの移行にすでに追加されています。

  • RUNNING: スペースは現在移行中です。

  • STOPPED: スペースは移行に追加されましたが、移行は実行時に停止されました。

  • FAILED: スペースの移行に失敗しました。

  • MIGRATED: スペースの移行に成功しました。

[移行ステータス] 列では移行ステータスを基準にスペースが並べ替えられます。

最終編集日を基準にスペースをフィルタリングおよび並べ替える

スペース選択の最終編集フィルター

[最終編集] フィルターを使用することで、添付ファイル、ページ、またはスペースの説明に関連する編集がいつ行われたかを基準にスペースをフィルタリングできます。編集には、閲覧、いいね、コメントは含まれません。

[最終編集] 列では、添付ファイル、ページ、またはスペースの説明が編集されてからの経過時間を基準にスペースを並べ替えることができます。

[ページ] 列を基準にスペースを並べ替える

[ページ] 列では、ブログ、下書き、スペース内の現在のバージョンと以前のバージョンのページの総数を基準にスペースを並べ替えることができます。

[添付ファイル] 列を基準にスペースを並べ替える

[添付ファイル] 列では、スペースの添付ファイルの合計サイズを基準にスペースを並べ替えることができます。

[スペースの種類] 列を基準にスペースをフィルタリングおよび並べ替える

[スペース タイプ] フィルターは、サイトパーソナルかを問わず、スペースのタイプに基づいてスペースをフィルタリングするのに役立ちます。

サイト スペースは共有スペースです。パーソナル スペースは非公開スペースです。

[スペース タイプ] 列では、スペース タイプに基づいてスペースをソートできます。

[Team Calendar] 列を基準にスペースを並べ替える

[Team Calendar] 列では、スペース内の Team Calendar の数を基準にスペースを並べ替えることができます。

Team Calendar は Confluence Cloud Premium および Enterprise の機能として利用できます。Team Calendar データは、Confluence プランの種類に関係なく移行されます。ただし、移行後にこのデータにアクセスするには、Premium にアップグレードしてください。Confluence Cloud Premium へのアップグレードの詳細をご確認ください

移行されない Team Calendar コンポーネント:

  • 内部サブスクリプション: Confluence では、Team Calendar は特定のスペースにリンクされています。内部サブスクリプションにより、チームは別のスペースのカレンダーのイベントを独自の Team Calendar 内に直接表示できます。内部サブスクリプションは移行されません。移行後、Team Calendar には独自のイベントがすべて表示されますが、登録していた他のスペースのカレンダーのイベントは表示されません。これらのイベントを再表示するには、Cloud で内部サブスクリプションを再設定する必要があります。

  • Jira にリンクされた Team Calendar イベント: Team Calendar には、Jira プロジェクトにリンクされたイベントを含めることができます。これらのイベントは、Jira の主要な日付を視覚化するのに役立ちます。ただし、移行プロセスでは、これらの Jira にリンクされたイベントは正しく移行されません。移行プロセスでカレンダーと Jira の接続が変更されるため、これらのイベントは Cloud に表示されません。

3. 準備ができたら、[移行に追加] を選択します。

アプリ

アプリの評価中に「クラウドで必要」とマークしたすべてのアプリを移行することを選択できます。もしくは、この段階ではアプリを移行しないことも選択できます。

4.c. エラーをチェックする

このステップでは、Confluence Cloud Migration Assistant が、次のグループについて移行前チェックを実行しながら、表示すべき警告やエラーを探します。

この画面で [続行してあとで修正] ボタンを選択した場合は、移行の保存後に戻ってきてチェックを確認できます。

CCMA のプリフライト エラーのリスト

Cloud Migration Assistant がチェックする項目の例を以下に示します。

  • Confluence のバージョンが最新かどうか

  • クラウド トークンが有効かどうか

  • ご利用の Migration Assistant アプリが最新かどうか

  • 移行プランのユーザーが、クラウド プランのユーザー制限に収まっているか

  • ご利用のすべてのメール ドメインが信頼済みであるかどうか

  • ユーザーに有効で一意のメール アドレスが紐付けられているかどうか

  • 移行プロセスでのグループの統合

  • クラウド サイトにすでに存在するスペース

  • スペースが公開されオンラインで検索可能

  • アプリ評価が完了したか、またはアプリ評価の決定を変更する必要があるかどうか

  • この移行からアプリを削除する必要があるかどうか

また、移行プロセスでは他の問題が発生する可能性がありますが、このステップでは上述の問題のみを確認します。

以下の表では、リストされた各メッセージの横にある記号の意味について説明します。

記号/メッセージ

説明

必要なアクション

screenshot_error-screen_green-tick

緑のチェックはチェックが合格したことを示します。

移行の次のステップに進んでください。

screenshot_error-message_yellow-warning

黄の警告サインが表示された場合は、このまま続行できますが潜在的な問題を含む可能性があります。

エラー メッセージまたは警告メッセージを展開して、詳細やリンクをご確認してください。

screenshot_error-message_red-error

赤のエラーは、移行を実行する前にエラーを解決する必要があることを意味します。

エラー メッセージまたは警告メッセージを展開して、詳細やリンクをご確認してください。

チェックを理解する

システム チェック

Cloud Migration Assistant は、「Migration Assistant が最新ではない」場合、ユーザーに知らせます。この場合は、サポートされている最新バージョンの CMA にアップグレードする必要があります。

ユーザーとグループのチェック

すべてのユーザーは、有効で一意なメール アドレスを持っている必要があります。無効なメール アドレスや複数のユーザーが同じメール アドレスを使用していることが検出された場合は、エラーが表示されます。移行を実行する前に、これらのメール アドレスを修正する必要があります。

すべてのユーザーを移行することを選択した場合は、Cloud サイトに同名のグループがないかどうかが確認されます。同名のグループが見つかった場合は、Server グループのユーザーが同名の Cloud グループにマージされます。この問題は修正せずに続行できますが、権限昇格が行われていないことを確認することをお勧めします。

次のグループは管理者アクセスを管理しているため、ブロックリストに登録済みで、移行できません。

  • site-admins

  • system-administrators

  • atlassian-addons

  • atlassian-addons-admin

上記のグループのユーザーは引き続き移行されますが、ユーザーをいずれかのブロックリスト グループに追加する場合は、移行後に手動で追加する必要があります。

スペース チェック

スペースを移行する場合は、スペース キーの競合が確認されます。エラーが発生した場合は、次のいずれかを実行できます。

  • Cloud または Server の各サイトから重複スペースを削除する

  • Cloud サイトをリセットする

  • 対象のスペースを移行から削除することで、移行を取りやめる

移行を実行するには、スペース キーのすべての競合を解決する必要があります。

アプリ チェック

Cloud Migration Assistant は、アプリの移行に影響する可能性のある問題がないか、アプリをチェックする際に、エラーと警告を一覧表示します。

また、アプリ ベンダー チェックも提供しています。これは、アプリ ベンダー (Marketplace パートナー) がインスタンスで実行するチェックで、アプリのデータをクラウドへ移行する際に影響する可能性のある問題を特定して、解決手順を提示します。

4.d. 移行を確認する

これは移行のセットアップの最終ステップです。

すべてが適切に指定されており、移行を開始する場合は、[今すぐ実行] をクリックします。後で移行を開始する場合、または修正が必要なエラーがある場合は、[保存] をクリックします。移行を実行するよう選択した場合も、移行は引き続きダッシュボードに保存されます。ダッシュボードでは、すべての移行の進捗状況と詳細を確認できます。

移行の確認

4.e. 移行を管理して実行する

保存した移行は、移行ダッシュボードに一覧表示されます。ここでは、移行に関する詳細の表示、実行、コピー、編集、削除、アーカイブを実行できます。また、移行ステータスのチェック、進捗の監視、実行している移行の停止、新しい移行の作成も行えます。移行はいくつでも作成できます。

移行ダッシュボードのアクションとステータス

ステータスの定義

ステータス

説明

保存済み

移行が保存済みで実行できる状態です。

実行中

現在、移行が進行中です。

完了

移行のすべてのタスクが完了しています。

STOPPED

移行処理が手動で停止されています。停止された移行は再開できません。移行を完全に停止するには、進行中のすべてのステップを先に完了する必要があります。すでに一部のユーザー、グループ、スペースが Confluence Cloud サイトに移行されている場合があります。

未完了

一部のタスクは完了していますが、エラーが発生したか、移行できなかった内容があります。このステータスが表示される場合は、一部のデータ (ユーザー、グループ、スペースなど) が移行されているため、同じプロジェクトを再移行するにはクラウド サイトからこのデータを削除しなければならない可能性があることにご注意ください。また、アプリ移行は、移行が成功または未完了である場合にトリガーされます。

失敗

移行を完了できませんでした。移行先のサイトに選択したエンティティがすでに存在しているか、移行で予期せぬエラーが発生した可能性があります。

移行の進捗

[移行] ダッシュボードで [詳細を表示] オプションを選択すると、移行ページが開いて、移行全体のステータスが表示されます。また、次の進捗も表示されます。

  • 移行前チェック

  • スペース データの移行

  • 添付ファイルの移行

  • ユーザーとグループの移行

  • グローバル テンプレート移行

  • アプリ移行

移行の進捗状況と詳細

データ移行の進捗

この移行ページで、[Data migration progress (データ移行の進捗)] セクションを使用して次の情報を確認します。

  • ユーザーとグループ、グローバル テンプレート、スペースの進捗状況

  • 移行の完了に関するステータス

移行に含まれる Confluence データ

次のテーブルでは、スペース移行のさまざまな進捗ステータスをご説明します。

ステータス

説明

失敗

スペース データの移行中にエラーが見つかり、移行が失敗しました。

完全なパイプ

スペース データの移行が完了しました。

準備完了

スペース データの移行を実行する準備ができています。

実行中

スペース データの移行は進行中で、まだ完了していません。

スキップ

スペースの移行は、次のいずれかの理由で無視されます。

  • サーバー インスタンスにスペースが見つからなくなったため、移行できません。

  • スペースは別の移行によってすでにインポートされているかインポート中です。

未完了

スペース データの移行は未完了です。

アプリ移行の進捗

画面の [App migration progress (アプリ移行の進捗)] セクションを使用して、次の情報を確認します。

  • 各アプリの移行の進捗

  • 移行の完了に関するステータス

アプリの移行の進捗状況
アプリ移行の詳細と進捗

以下の表では、アプリ移行のさまざまな進捗状況を説明します。

アプリの進捗ステータス

説明

成功

アプリ データの移行が完了して成功しました。

未完了

アプリ データの移行は完了していません。

失敗

アプリ データの移行に失敗しました。

実行中

アプリ データの移行はまだ実行中で完了していません。

準備完了

アプリ データの移行を実行する準備ができています。

タイムアウト

アプリ データの移行は完了していません。これは、アプリがデータの移行に許可された期間を超えたためです。アプリのデータの移行を進める方法については、それぞれのアプリのベンダーにお問い合わせください。

アプリ移行の再実行

完全に新しい移行計画を作成しなくても、失敗または未完了のステータスが表示されている個々のアプリに対して、失敗したアプリ移行を再実行できます。この機能を使用すると、Cloud Migration Assistant はアプリの移行を再試行して、以前に失敗した、またはアプリ移行が未完了のままだった問題を解決できます。

アプリを再実行するには、「アプリ移行の進捗」の表で [再実行] を選択します。

再実行の制限

  • 最初の移行を開始してから 12 日以内にアプリ移行を再実行してください。アプリ再実行機能は、12 日間の期限を過ぎたアプリでは使用できなくなります。

  • この機能は、失敗または未完了のステータスが表示されているアプリでのみ使用できます。この機能をサポートしていない特定のアプリでは利用できない場合があります。

移行を完了しない、失敗するなど、アプリの問題がある場合は、Marketplace Partner (アプリのベンダー) に直接連絡してサポートを受ける必要があります。

移行後

移行のタイプによっては、移行の完了後に実行が必要な操作があります。

ユーザーとグループ

ユーザーとグループが正しくセットアップされていることを確認するには、次の手順を実行します。

  • [インポートしたグループを確認] に移動して、グループのメンバーを確認して権限を承認します (無料プランの場合、権限は変更できません。ユーザーとグループは元のサイトと同じ権限を保持します)。

  • 必要に応じて、汎用グループにユーザーを追加します。汎用グループとは、"site-admins"、"system-administrators"、"atlassian-addons"、"atlassian-addons-admin" を指します。

  • 外部のユーザー管理システムを使用している場合は、ユーザーが正しく同期されていることを確認します。

  • 準備が整ったら、ユーザーを招待します。[管理] > [ユーザー] > [詳細の表示] の順に選択し、[招待の再送] を選択します。ユーザーが初めて ログイン すると、新しいパスワードを設定し、個人情報を追加するように求めるメッセージが表示される場合があります。

ユーザー管理エクスペリエンスを改善している場合は、[管理] > [ディレクトリ] > [ユーザー] > [詳細の表示] > [招待の再送] の順に選択します。

スペース

スペースの移行後、それらがスペース ディレクトリに表示されるには時間がかかる場合があります。ただし、直接リンク経由でアクセスすることはできます。

スペースの移行が正常に完了したことを確認するには、次の手順を実行します。

  • コンテンツとスペースを確認するか、ユーザーに自身のコンテンツを確認してもらいます。

  • Former User のインスタンスがあるかどうかを確認します。これは、コンテンツをユーザーに関連付けられなかったことを意味します。

  • [設定] > [アプリケーション リンク] の順に移動して、他の Atlassian 製品をリンクします。

  • Jira マクロ リペアによって、Jira への任意のリンクを更新します。Cloud サイトで [設定] > [Jira Macro Repair (Jira マクロ リペア)] の順に移動して、ステップに従います。

https://confluence.example.com/x/PywS などの Confluence の短縮リンクが、移行後に機能しない場合があります。移行前にこれらを内部リンク (または Confluence サイトに内部リンクがない場合は完全な URL) で置き換えておくと、この問題は発生しないはずです。リンクの詳細をご確認ください。

その他のアクション

以下のアクションを実行することも可能です。

  • レガシー エディターのページを新しいエディターに変換します。ページの変換方法をご確認ください。

  • その後、必要なアプリをインストールして、ユーザーのオンボーディングを実行できます。

移行後アクションの詳細については「Cloud 移行ガイド」をご確認ください。 

詳細情報とサポート

移行をサポートする多数のチャンネルをご用意しています。

アトラシアン サーバー製品のサポートは 2024 年 2 月に終了します。サーバーのサポート終了スケジュールで詳細をご参照ください。

その他のヘルプ