Confluence Migration Assistant による移行のトラブルシューティング

このページは、Confluence Cloud Migration Assistant を使用する際に発生する可能性のある問題のトラブルシューティングにお役立てください。

スペース選択画面では、一部のスペース情報が計算できない場合、そのようなスペースのデータは警告付きで「--」と表示されます。この場合は次の 2 つのオプションがあります。

  • 次に予定されているジョブが実行されるまで待つ (ジョブは 24 時間ごとに実行されます。その後、更新されたスペース データを使用できます)

  • [Confluence 管理] > [管理] > [予定されたジョブ] からジョブを手動で実行するか、ジョブのスケジュールを変更する

ただし、ジョブを手動で実行する前に、[予定されたジョブ] 画面で次の点を確認してください。

  • [次回実行日時] の日時を確認する: この時間がサーバーの現地の日時に基づいて現在から 5 〜 10 分以内に収まる場合は、予定されたジョブを手動で開始するのではなく、自動的に処理されるのを待ちます。

  • [最終実行日時] の日時を確認する: サーバーの現地時間が [最終実行日時] の日時から 5 〜 10 分後以内の場合は、ジョブの再実行を遅らせます。進行中の計算がまだバックグラウンドで行われている可能性があるため、この予防措置が必要となります。[履歴] 画面に表示される [終了日] の時間はジョブ スケジュールが終了した時点を表したものに過ぎず、計算が完了したことを示すものではありません。

上記の点を考慮に入れてもジョブを手動で実行する必要がある場合は、以下を実行します。

  1. [Confluence 管理] > [管理] > [予定されたジョブ] に移動します。

  2. [ジョブ] 列で [scheduledjob.desc.migration-plugin:interval-space-statistic-calculation] というジョブを見つけます。

  3. In the Actions column for this job, select Run to run the job or Edit to change the job’s schedule. Learn more about scheduled jobs

移行前チェック

移行前チェックは、すべての移行で必須のステップです。ここでは、設定が正しく行われており、データを Cloud に移行できることを確認します。移行前チェックの表示方法をご確認ください。

ステータスをチェックする

ここでは、移行前チェックで表示されるステータスを簡単にご説明します。

記号

説明

チェックに成功しました。

チェックに合格しました。移行を続行できます。

警告メッセージを展開して詳細と関連リンクを表示する

移行を続行できますが、潜在的な問題に注意する必要があります。警告メッセージを展開すると詳細が表示されます。

エラー メッセージを展開して詳細と関連リンクを表示する

エラーが解決されるまで、移行を続行できません。エラー メッセージを展開すると詳細が表示されます。

システム チェック

メッセージ

説明

必要なアクション

Migration Assistant が最新ではありません。

このメッセージは、使用している Cloud Migration Assistant が最新版ではないことを示しています。

サポートされている最新版の Cloud Migration Assistant にアップデートしてください。

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

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

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

次のグループは管理者アクセスを管理しているため、ブロックリストに登録済みで、次のグループは一切移行されません: "site-admins"、"system-administrators"、"atlassian-addons"、 "atlassian-addons-admin"。上記のグループのユーザーは引き続き移行されますが、ユーザーをいずれかのブロックリスト グループに追加する場合は、移行後に手動で追加する必要があります。

スペース チェック

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

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

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

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

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

アプリ固有のチェック

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

アプリの移行前チェックに関する詳細をご確認ください。

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

アプリベンダー チェックに関する詳細をご確認ください。

移行エラー

これは、移行が失敗した場合に表示される一般的なエラーのリストです。

エラー

修正

Error: Failed to add user to groups due to requesting user lacking permissions (エラー: リクエストしたユーザーには権限がないため、ユーザーをグループに追加できませんでした)

このエラーは、移行先のクラウド サイトに対する組織管理者と製品管理者の権限がないために発生します。必要な権限を取得してから、移行をやり直してください。

ユーザーに管理者権限を付与する

Error: Failed to execute export for query (エラー: クエリのエクスポートを実行できませんでした)

Import to cloud failed.Message: ERROR: duplicate key value violates unique constraint "AO_187CCC_SIDEBAR_LINK_pkey" (クラウドへのインポートに失敗しました。メッセージ: エラー: 重複するキー値が一意制約に違反しています "AO_187CCC_SIDEBAR_LINK_pkey")

Reach out to the support team. They will make some changes to the cloud site database which will allow migrations to go through.

アトラシアン サポートへの問い合わせ方法

このページを参照しても問題を解決できない場合は、サポートにお問い合わせください

For a quicker response from the support team, it’s recommended that you share a support zip with the Atlassian Support team. Learn how to create a Support ZIP


詳細情報とサポート

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

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

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。