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. このジョブの [アクション] 列で、[実行] を選択してジョブを実行するか、[編集] を選択してジョブのスケジュールを変更します。予定されたジョブの詳細についてはこちらをご確認ください。

移行前チェック

移行前チェックは、すべての移行で必須のステップです。ここでは、設定が正しく行われており、データを 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 パートナー) がインスタンスで実行するチェックで、アプリのデータをクラウドへ移行する際に影響する可能性のある問題を特定して、解決手順を提示します。

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

Migration errors

Here’s a list of generic errors shown when a migration fails.

エラー

修正

Error: Failed to add user to groups due to requesting user lacking permissions

This errors occurs because you don’t have organization admin and product admin permissions to the cloud site you are migrating to. Start the migration again after you have the required 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"

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

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

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

サポート チームが迅速に対応できるように、サポート zip をアトラシアン サポート チームと共有することをおすすめします。サポート zip の作成方法をご確認ください。


詳細情報とサポート

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

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

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

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