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

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

このページの使用方法

Ctrl+F または Command+F (Mac の場合) このページで押してエラー メッセージの詳細を検索フィールドに入力し、関連する KB 記事を検索します。

このページは、移行のどの段階にあるかに応じて、いくつかのカテゴリに分割されています。

  • 既知の問題

  • 移行実行前

  • 移行実行後

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

既知の問題

移行または移行済みのデータに影響する可能性のある既知の問題の一覧を次に示します。

トピック

説明

データの整合性

ご利用の Jira Server サイトが高度にカスタマイズされている場合、移行時に他の問題が発生する可能性があります。たとえば、必須フィールドに null 値が使用されている場合、これは Cloud サイトではサポートされていないため、移行は失敗します。移行前にインスタンス データのクリーン アップを行うことをお勧めします。

不完全な移行とプロジェクト

incomplete (不完全) ステータスが表示される場合、一部の情報は移行されていますが、少なくとも 1 個のエンティティの移行が行えていません。たとえば、プロジェクトの移行には成功したが、カスタム フィールドの値に null 値が使用されているために 1 件の課題の移行に失敗している可能性があります。このような場合、実際のすべてのデータは完了していても、プロジェクトは incomplete (不完全) と表示されます。多くの場合、このステータスが表示されても移行に問題はありません。エラー ログをダウンロードして問題の原因を確認できます。 

移行前のサーバーでの変更

サーバー サイトへの変更を行った場合は、すべてのデータを最新の状態にするため 10 分以上待ってから移行を行うようにします。 

プロジェクト キーの変更

移行前または移行中にサーバーでプロジェクト キーを変更することを選択した場合、すべての構成、フィルター、およびボードが新しいプロジェクト キーで更新されていることを確認してから新しい移行を試行するようにします。 

移行に含まれていないプロジェクトや課題へのリンク

小規模なバッチでの移行を行うことを選択した場合、未移行のプロジェクトまたは課題へのリンクは、リンクされた項目が移行されるまでは欠落した状態になります。 

履歴エントリでの参照情報の欠落

履歴エントリが、欠落しているリンクまたは添付ファイルを参照している場合、履歴エントリは移行されません。リンクされた課題またはプロジェクトが後から移行された場合、履歴エントリが更新されます。 

Jira ボードでの結果の不一致

The migration assistant does not check that  the JQL issue filters on boards are returning the correct results after migration. If a board has a filter that mentions a project or field that is not yet migrated, the board may not return the same results after it is migrated. To fix this issue, edit the board's JQL filter after migrating. Learn more about board filters

移行後の Jira Align に関する問題

If you use Jira Align, you need to complete additional steps before, during, and after the migration. If you’re having problems, see the linked page or contact Atlassian Support. Learn how to migrate Jira Align

移行実行前

移行を実行する前に確認できることが 2 つあります。

  • 移行前チェック

  • 移行前のレポート

移行前チェック

移行前チェックは、すべての移行で必須のステップです。ここでは、設定が正しく行われており、データを Cloud に移行できることを確認します。移行前チェックを実行して、その結果を確認してから Jira 移行を行いましょう。

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

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

記号

説明

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

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

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

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

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

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

このメッセージが引き続き表示される場合は、更新してもう一度チェックするかサポートにお問い合わせください。

予期しないエラーのため、チェックが完了しませんでした。チェックを更新するか、アトラシアン サポートにお問い合わせください。

チェックによって表示される一般的な問題

チェックによって表示される一般的な問題と、それを解決するために必要なステップをご説明します。

メッセージ

修正/KB 記事

現在、移行サービスを更新しています。

Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。

認証トークンの更新方法をご確認ください。

ユーザー数の上限をチェックできませんでした。

Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。

認証トークンの更新方法をご確認ください。

クラウド サイトのプロジェクトをチェックできませんでした。

Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。

認証トークンの更新方法をご確認ください。

クラウド サイトのプロジェクトをチェックできませんでした。

クラウド サイトが移行できない可能性があります。理由と修正方法は次のとおりです。

理由 1: サンドボックスが削除されました。

修正:

  1. 次のようにして、サンドボックスが削除されていないかご確認ください。

    1. Go to admin.atlassian.com, and then select your organization if you have more than one.

    2. Select Apps > Sandbox.

  2. If deleted, contact support for further assistance.

理由 2: クラウド サイトが見つからなかったか、使用していないために Jira Cloud サブスクリプションが非アクティブ化されました。
修正方法:

  1. 次のようにして、クラウドサイトのサブスクリプションがキャンセルされたかどうかをご確認ください。

    1. Go to admin.atlassian.com, and then select your organization if you have more than one.

    2. [請求] を選択します。

  2. If canceled, recover the canceled site.

プロジェクトはクラウド サイトにすでに存在します

JCMAt (Jira Cloud Migration Assistan) による移行時のプロジェクト名とプロジェクト キーの競合

複数のユーザーが同じメール アドレスを持っています。

シンプルなエクスペリエンスで重複したメール アドレスを修正

無効なメール アドレスです

シンプルなエクスペリエンスで無効なメール アドレスを修正

You’ve reached the limit of email aliases for a single email address (1 つのメール アドレスのメール エイリアスの上限に達しました)

このチェックは、1 つのメイン メール アドレスに関連するメール エイリアスの数が 10 個の制限を超えた場合に表示されます。 エイリアスはメイン メール アドレスのバリエーションです (例: charlie+suffix@atlassian.com charlie@atlassian.com)。

クラウド側には制限があり、1 時間に作成できるエイリアスは 10 個だけです。

CSV ファイルをダウンロードする

チェックを確認する際、問題の解決に役立つ CSV ファイルをダウンロードできます。 ファイルの内容は以下の通りです。

  • 制限を超えた場合のすべてのメール エイリアス (最初の 10 個を含む) を一覧表示します。 複数のメイン メール アドレスに関連するエイリアスが含まれる場合があります。

  • メインのメール アドレス自体は含まれません。

ゴール

ゴールは、エイリアスを個別のメール アドレスに変更するか、対応するユーザーを削除することです。制限を超えたエイリアスに対してだけ行えば十分です。ただし、クラウド サブスクリプションはユーザーごとに請求されるため、余分なユーザーを削除または非アクティブ化することをお勧めします。

問題を解決する

この問題を解決するには、CSVファイルを使用して対応するユーザーを特定し、更新または削除します。

  • Jira でユーザーを管理している場合、[管理] > [ユーザー管理] で更新できます。

  • 外部ディレクトリでユーザーを管理している場合は、エイリアスがクラウドにプロビジョニングされないように、ディレクトリのユーザーを更新することをお勧めします。

データ準備エラー

Here are errors related to the Data preparation check, and how to resolve them. They are recorded in the log file (available as a downloadable ZIP file).

Some ZIP files also contain a CSV file with a list of errors that can be remediated inflight, without making any changes to your source instance.

You can edit and upload the Remediable CSV back to resolve select errors.

Additionally, you can also:

  • Apply remediations from your previous migration to new migration plans.

  • Copy remediations to a cloud site.

Read how to apply remediation

エラー コード

エラー

修正/KB 記事

Remediable errors

JCMA 107

Issue has no issue type.

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid issue type ID for each affected project and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. [修正] 列で、影響を受ける各プロジェクトに有効な課題タイプ ID を入力します。

  5. Select Upload ZIP to upload the updated CSV.

JCMA 109

Issue has no default priority.

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid priority ID for each affected project and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid priority ID for each affected project.

  5. Select Upload ZIP to upload the updated CSV.

 

 

JCMA 120

Board has no owner

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid user key for each affected board and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid user key for each affected board.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 130

Filter has no owner

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid user key for each affected filter and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid user key for each affected filter.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 133

Group reference not found (filter subscription)

 

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid entity ID and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid entity ID.

  5. Select Upload ZIP to upload the updated CSV.

既存のエンティティ ID が入力内容によって上書きされます。

JCMA 133

Group reference not found (issue security level permission)

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid entity ID and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid entity ID.

  5. Select Upload ZIP to upload the updated CSV.

既存のエンティティ ID が入力内容によって上書きされます。

JCMA 135

A board is referring to a filter that doesn’t exist

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid filter ID and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid filter ID.

  5. Select Upload ZIP to upload the updated CSV.

既存のフィルター ID が入力内容によって上書きされます。

JCMA 149

Issue has an invalid status

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid issue status ID for each affected project and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid issue status ID for each affected project.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 152

Issue is assigned an issue type that doesn’t exist in the project’s scheme

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a valid issue type ID for each affected project and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in the valid issue type ID for each affected project.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 155

Project component name is missing

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Enter a valid component name for each affected project, then select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, enter a valid component name for each affected project.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 158

Swimlane has invalid JQL

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Enter a valid JQL string and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, enter a valid JQL string.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 158

Quick filter has invalid JQL

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Enter a valid JQL string and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, enter a valid JQL string.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 516

Custom field ID is invalid in the Time metric

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select a custom field ID that belongs to the project and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, fill in a valid custom field ID for each affected project.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 522

JSM project contains a time metric with a duplicate name

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Enter a unique name for your SLA and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, enter a unique name for your SLA.

  5. Select Upload ZIP to upload the updated CSV.

JCMA 523

A JSM request type references an issue type that isn’t associated with the project

この問題を解決するには、次の手順に従います。

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Select an issue type ID that belongs to the project’s issue type scheme and select Apply.

  3. Select Rerun after you’ve applied all the changes.

You can also fix this issue in bulk:

  1. Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.

  2. Download the ZIP file.

  3. Unzip the folder and open the CSV file.

  4. In the Fix column, enter an issue type ID that belongs to the project’s issue type scheme.

  5. Select Upload ZIP to upload the updated CSV.

Other data preparation errors

JCMA 124

エラー [JCMA 124] <プロジェクト キー> プロジェクトのエクスポート: ボード「<ボード名>」に無効な管理者が割り当てられています: 「<グループ名>」。

ボードに有効な管理者を割り当てるには、次の手順に従ってください。

  1. 管理者を割り当てるボードを開きます。

  2. [ボード] > [設定] の順に移動します。

  3. [管理者] フィールドで、編集アイコンにカーソルを合わせてクリックします。

  4. エラー ログに記載されている無効なグループを削除します。

  5. ユーザーまたはグループの名前を入力します。名前を入力し始めると、ユーザーとグループの候補リストが表示されます。

  6. 編集が完了したら Enter キーを押します。

JCMA 147

エラー [JCMA 147] <プロジェクト キー> プロジェクトのエクスポート: カンバン/スクラム ボード「<ボード名>」はクラウド上のビジネス プロジェクト「<プロジェクト名>」にリンクできません。

プロジェクトを別のテンプレートまたはタイプに変換する

JCMA 151

エラー [JCMA 151] <プロジェクト キー> プロジェクトのエクスポート: トランジション「<トランジション名>」のワークフロー「<ワークフロー名>」は、無効な画面にリンクされています。

ワークフロー トランジションに有効な画面を割り当てる方法は次のとおりです。

  1. [設定] > [課題] の順に選択します。 

  2. [ワークフロー] で [ワークフロー] を選択します。

  3. 影響を受けたワークフロー名を探して、[編集] を選択します。

  4. 図から、影響を受けたトランジションを選択します。

  5. 画面の右側で [編集] を選択して画面名を変更します。

  6. [保存] を選択します。

  7. 手順 4 から 6 を繰り返して、複数のトランジションを修正します。

JCMA 510

エラー [JCMA 510] <プロジェクト キー> プロジェクトのエクスポート: ID <課題タイプ ID> の課題タイプにリンクされた ID <リクエスト タイプ ID> のリクエスト タイプを移行できませんでした

解決するには、ID <issueTypeId> の課題タイプを ID <projectId> のプロジェクトの課題タイプ スキームに追加します

このエラーを修正するには、ステップ A とステップ B を実行します。

ステップ A: Jira Service Management プロジェクトのリクエスト タイプに使用される課題タイプのリストを作成します。

リストを作成するには、次の手順に従ってください。

  1. Jira Server または Data Center で [設定] > [プロジェクト] の順に移動します。

  2. エラーが見つかった Jira Service Management プロジェクトを検索します。

  3. クリックして [プロジェクト設定] 画面を開きます。

  4. [リクエスト タイプ] を選択します。

  5. [課題タイプ] 列で、すべての課題タイプをリストダウンします。たとえば、タスク、サービス リクエストなどです。

ステップ B: ステップ A で作成した課題タイプのリストに基づいて、[現在のスキームの課題タイプ] リストに不足している課題タイプを確認して追加します。

不足している課題タイプを追加するには、次の手順に従ってください。

  1. [設定] > [課題] の順に移動します。

  2. 左のパネルから、[課題タイプ スキーム] を選択します。

  3. Jira Service Management プロジェクトの関連する課題タイプ スキームについて、[編集] を選択します。

  4. 不足している課題タイプを [利用可能な課題タイプ] から [現在のスキームの課題タイプ] にドラッグします。

  5. [保存] をクリックします。

ステップ A とステップ B を実行したら、移行を再試行できます。

JCMA 701

エラー CROSS-PROJECT-DATA project-export Exception Message generated on executing query for fetching arPlanPermissions -> <例外メッセージ>
例外の原因 -> <例外の原因>

エラーを解決するには、次のナレッジベース記事を使用してください。

Marketplace apps checks

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

More about pre-migration checks for Marketplace apps

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

More about app vendor checks

移行前のレポート

移行前のレポートは、移行された項目、注意が必要な事項、ユーザー、グループ、設定項目の概要など、移行の詳細を含む zip アーカイブです。これによって、移行の開始前に移行対象となるデータの検証や潜在的な問題の検出に使用できます。

移行前のレポートをダウンロードするには、次の手順に従います。

  1. 移行計画を開きます。

  2. [移行を確認する] 画面に進みます。

  3. [ログとレポート] タブを選択します。

  4. 移行前のレポートをダウンロードします。

レポートは多数のエントリで構成されており、次の表に示すように、問題の要約、説明、解決策も含まれています。

問題の要約

問題の説明

ソリューション

カスタム フィールド設定がサポートされていない

<custom_field_type_name> カスタム フィールド タイプの移行はサポート対象外です。したがって、このフィールドの設定は移行されず、ワークフロー スキームやフィルターなど、このフィールドを参照するアイテムが機能しなくなる可能性があります。

このカスタム フィールドが必要である場合は、クラウド サイトで再作成して、CSV インポートで移行後に課題を更新します。次のドキュメントの「CSV でエンティティを追加する」セクションをご参照ください。

Jira Cloud Migration Assistant で移行される情報

カスタム フィールド設定がサポートされていない

<custom_field_name> カスタム フィールドの移行はサポート対象外であるため、この課題の値は移行されません。

このフィールド値が必要である場合は、CSV インポートで移行後に課題を更新します。次のドキュメントの「CSV でエンティティを追加する」セクションをご参照ください。

Jira Cloud Migration Assistant で移行される情報

課題タイプがサポートされていない

移行中に、<issue_type_name_A> 課題タイプは <issue_type_name_B> 課題タイプに名前が変更されます。

移行後に課題タイプをチェックして、正常に機能することをご確認ください。一部の JQL 参照が影響を受け、移行後の更新が必要となる場合があります。

通知スキームがサポートされていない

通知スキームはサポート対象外であるため、移行されません。

既定の通知スキームは、クラウド サイト内の各プロジェクトに割り当てられます。移行後に権限をご確認ください。

ワークフローの条件で設定または参照が欠如している

ワークフローは移行されますが、ワークフローの <transition_name> トランジションの条件がスキップされるため、クラウド サイトの権限に影響する可能性があります。

移行後にワークフローをチェックして、権限が正しく設定されていることをご確認ください。移行前に影響を受ける可能性のあるワークフローを特定するには、次のページから SQL クエリを実行します。

Jira Cloud Migration Assistant のエラーや移行に関連しないエンティティのトラブルシューティング

ワークフローのトランジションで設定または参照が欠如している

 

<transition_validator_name> バリデーターはサポート対象外です。ワークフローは移行されますが、ワークフローの <transition_name> トランジションのバリデーターがスキップされるため、クラウド サイトの権限に影響する可能性があります。

移行後にワークフローをチェックして、権限が正しく設定されていることをご確認ください。移行前に影響を受ける可能性のあるワークフローを特定するには、次のページから SQL クエリを実行します。

Jira Cloud Migration Assistant のエラーや移行に関連しないエンティティのトラブルシューティング

ワークフローの事後操作で設定または参照が欠如している

<name> 事後操作はサポート対象外です。ワークフローは移行されますが、<name> トランジションの事後操作がスキップされるため、クラウド サイトのワークフローに影響する可能性があります。

移行後にワークフローをチェックして、正常に機能することをご確認ください。移行前に影響を受ける可能性のあるワークフローを特定するには、次のページから SQL クエリを実行します。

Jira Cloud Migration Assistant のエラーや移行に関連しないエンティティのトラブルシューティング

カスタム イベント タイプがサポートされていない

イベント タイプ <event_type_name> の通知は、移行のサポート対象外です (カスタム イベントの課題)。この課題の値は移行されません。

このフィールド値が必要である場合は、CSV インポートで移行後に課題を更新します。

添付ファイルのファイル名が null である

ファイル名に null 値が使用されている添付ファイルはサポート対象外となり、移行されません。

この添付ファイルがクラウド サイトに必要である場合は、まずサーバー上の指定された添付ファイル ID に null 以外のファイル名を割り当ててから、移行を実行する必要があります。

ガジェットがサポートされていない

このガジェットはサポート対象外であるため、移行されません。

  1. サーバーで [ダッシュボード] メニューに移動して、CSV ファイルの [エンティティ ID またはキー] 列に表示されているダッシュボードを選択します。

  2. [エンティティ名] 列に表示されているサポート対象外のガジェットで、[...] > [削除] の順に選択します。

  3. クラウド サイトで、移行したダッシュボードを開いて [編集] を選択します。

  4. [ガジェットを追加] リストから目的のガジェットを特定して [追加] を選択します。

  5. ガジェットを追加したら、[完了] を選択します。

View the list of supported gadgetsView the list of supported gadgets

部分的に移行されたガジェット

このガジェットの移行中にエラーが見つかったため、設定なしで移行されます。エラーの詳細は、サポート zip の作成時に生成されるログ ファイルをご参照ください。

サポート zip の作成ステップ

  1. ログ ファイルから、影響を受けたガジェットと対応するダッシュボードを特定します。

  2. クラウド サイトでこのダッシュボードを開きます。

  3. [編集] を選択します。

  4. 影響を受けたガジェットで [...] > [設定] の順に選択します。

  5. このガジェットの設定値を更新します。

  6. [保存] を選択します。

移行実行後

移行が失敗した場合や移行が不完全である場合は、次の項目を確認します。

  • エラー ログ

  • Marketplace app migration progress logs

  • 移行後のレポート

エラー ログ

エラー ログをダウンロードするには、次の手順に従います。

  1. 移行計画を開きます。

  2. [移行を確認する] 画面に進みます。

  3. [ログとレポート] タブを選択します。

  4. エラー ログをダウンロードします。

一般的なエラー

エラー ログに表示される一般的なエラーのリストを次に示します。

エラー

修正/KB 記事

 ERROR <Project_Key> project-import
We couldn't import Project Component <Project_Component_Name>.
Reason: name: A component with the name <Project_Component_Name> already exists in this project...
This caused <Number_of_Items> other items to fail.

プロジェクト コンポーネントをインポートできない - JCMA エラー

ERROR <Project_Key> project-import 依存関係が <Number_of_Occurrences> 個が欠落しているため、プロジェクト バージョン <Version_Name> をインポートできませんでした: プロジェクト <Project_Key>
これによって他のアイテム <Number_of_Issues> 個が失敗しました。サーバー サイトの依存関係が欠落している理由をご確認ください。

依存関係が欠落しているため、プロジェクト バージョンをインポートできない: プロジェクト - JCMA エラー

 <Project Key> project-import
依存関係が 1 つ欠落しているため、課題 <Project Key>-<Issue Number> をインポートできませんでした:
カスタム フィールド「スプリント」これによって他のアイテム <Number of Ocurrences> 個が失敗しました。
サーバー サイトの依存関係が欠落している理由をご確認ください。

1 つの依存関係が欠落しているため、課題をインポートできない: カスタム フィールド「スプリント」

com.atlassian.jira.migration.orchestratorclient.OrchestratorClientErrorException: 移行連携のリクエストが失敗しました
com.atlassian.jira.migration.orchestratorclient.OrchestratorServerErrorException: サーバーへのリクエストの送信に失敗しました

サーバーまたは移行連携へのリクエストが JCMA で失敗する

 ERROR <Project_Key> project-export
ワークフロー: [Workflow_Name] トランジション [Transition_Name] ワークフローのルール条件/バリデーターまたは事後操作 [Workflow_Rule_Name] で [Value_Reference_Name] を参照する [Config_Name] の設定値が欠落しています。
ワークフロー ルールで欠落している設定値または参照がないか再確認してください。

Workflow missing config values or references - JCMA エラー

ERROR <project-key> project-import コメント <comment-id> (課題: <issue-key>、ユーザー: <user>、日時: <timestamp>) をインポートできませんでした。理由: コメント本文の文字数を超過している例外: メッセージがありません。

ERROR <project-key> project-import 課題 <issue-key> をインポートできませんでした。理由: 説明: 入力されたテキストが長すぎます。最大 32,767 文字の制限を超えています。

JCMA のエラー メッセージ「コメント本文の文字数を超過している例外: メッセージがありません」または「入力されたテキストが長すぎます。最大 32,767 文字を超えています」

 ERROR <Project_Key> project-import
依存関係が 1 つ欠落しているため、課題 <Issue_Key> をインポートできませんでした: プロジェクト <Project_Dependency_Key>
これによって他のアイテム <Number_of_Items> 個が失敗しました。
サーバー サイトの依存関係が欠落している理由をご確認ください。

依存関係が欠落しているため、課題をインポートできませんでした: プロジェクト - JCMA エラー

ERROR <Project_Key> project-export
ワークフロー: [Workflow_Name] トランジション: [Transition_Name]
には、ワークフロー ルール バリデーター [Validator_Name] の構成 hidFieldsList
でサポートされていないカスタム フィールド参照があります。
ワークフロー ルールで欠落している設定値または参照がないか再確認してください。

Jira Cloud Migration Assistant 経由で移行されるワークフロー ルール

ERROR <Project_Key> project-export
課題 <Issue_ID> をエクスポートできませんでした。
理由:
com.atlassian.greenhopper.manager.lexorank.LexoRankIntegrityException:
ランク フィールド [id=<Field_ID>] の最大マーカー行と最低ランク行が <X> 行と一致する必要があります。

既知のすべてのアジャイル LexoRank エラーのリスト

Jira Server がインデックスの再作成中、または再ランク付けの操作中に LexoRankIntegrityException エラーをスローする

sun.security.validator.ValidatorException:
PKIX パスの構築に失敗しました:
sun.security.provider.certpath.SunCertPathBuilderException:
要求されたターゲットへの有効な証明書パスが見つかりません

"PKIX Path Building Failed" エラーによって SSL サービスに接続できない

java.net.UnknownHostException: <AMAZON_S3_URL>
java.net.ConnectException: 接続が拒否されました (接続が拒否されました)

Jira Cloud Migration Assistant を使用した移行に備えてファイアウォールを準備する

課題 ABCD-12345 をインポートできませんでした。理由: DataAccessException: java.sql.SQLException: すでに PSQL_TOO_MANY_CONNECTIONS 例外がこのワークコンテキストで発生しています。次の getConnection をスキップします。これによって他のアイテム X 個が失敗しました。

PostgreSQL データベースの使用時にユーザー固有の接続制限が原因で「致命的な接続が多すぎます」エラーが発生する

java.lang.OutOfMemoryError: Java ヒープ領域

OutofMemory Java ヒープ スペース エラーが発生して Jira サーバーがクラッシュする

エラー YYY project-import 権限スキーム 'XYZ scheme' をインポートできませんでした。

理由: IllegalStateException: エラー: {holder.parameter=User 'user.name' は存在しません}

移行で選択されたプロジェクトに、無効または存在しないユーザーを参照している権限スキームが関連付けられています。これらのユーザーは多くの場合、Crowd や外部のアイデンティティ プロバイダー (IdP) に含まれる、移行されていない古いアカウントです。

修正:

  1. サーバー/DC インスタンスの対象の権限スキームから、参照されているユーザーを削除します。

  2. Remove or delete users from permission schemes.

  3. Jira Cloud Migration Assistant を使って移行を再実行します。

エラー YYY project-import フィールド レイアウト アイテム XXXXX-customfield_XXXXX をインポートできませんでした。

理由: フィールド customfield_XXXXX が FieldLayout XXXXX に存在しません。

エラー YYY project-import プロジェクト YYY をインポートできませんでした。

Reason: IllegalArgumentException: Issue type scheme [XXXXX] does not exist.

エラー YYY project-import プロジェクト YYY をインポートできませんでした。

Reason: IllegalArgumentException: Workflow scheme [XXXXX] does not exist.

エラー YYY project-import 課題 YYY-XXXX をインポートできませんでした。

Reason: NullPointerException: There is no step in workflow [workflow] linked to status [status].

これは、移行元サイトまたは移行先サイトから以前に移行したエンティティを更新または削除した結果です。

この問題を回避するには、次のいずれかを実行します。

エラー YYY project-import プロジェクト ロールの関連付け XXXXX をインポートできませんでした。

Reason: IllegalArgumentException: Project role [XXXXX] does not exist

移行するプロジェクトに、存在しなくなったグループを参照しているロールまたは権限スキームがあることを示します。

この問題を回避するには、次のいずれかを実行します。

  • 移行を再実行する前に、対象のロールやグループを再作成してソースに存在するようにします。又は

  • プロジェクトの権限を編集し、移行を再実行する前にそれらのロールやグループへの参照を削除するようにします。

Jira プロジェクトでの権限とロールの編集に関する詳細

ERROR <Project_Key> project-import 権限スキーム '<Project_Key> Standard 権限スキーム' をインポートできませんでした。理由: IllegalStateException: エラー: {holder.parameter=Group '<group name> ' は存在しません}
エラーメッセージ: []
エラー理由: [VALIDATION_FAILED]。これによって他の 377987 アイテムが失敗しました。

  • Add the required <group name> to the Jira access on cloud.

  • サーバーからクラウドへのプロジェクトの再移行

Jira Service Management 固有のエラー

Jira Service Management 固有のエラーを次に示します。

エラー

修正/KB 記事

ERROR <Project_Key> project-export
課題 <Issue_ID> をエクスポートできませんでした。
理由: com.querydsl.core.QueryException:
<SQL_QUERY> の SQLServerException がキャッチされました

Jira の Microsoft SQL Server データベースの照合を手動で修正する方法 | Jira | アトラシアン ドキュメント

 

Exceeded the limit of Asset Objects allowed per custom field in an issue.

Each issue can have limited number of Asset Objects linked to a custom field on Cloud.

In your next migration, we recommend that you reduce the number of Asset Objects in your migration. Read how to reduce the count of Asset Objects

If you’ve concerns with the existing limits, contact support.

Exceeded the limit of Select attributes in Object history.

Object history can only have up to 100 Select attributes.

If you’ve concerns with the existing limits, contact support.

Exceeded the limit of unique constraints per object type.

Each object type can have a maximum of 2 attributes with unique constraints in Cloud. Any additional unique constraints will be marked non-unique when migrated.

In your next migration, we recommend that you reduce the number of unique constraints per object type to 2. Read how to reduce the count of unique constraints

Attributes with duplicate values are no longer marked as unique.

If Object attributes have duplicate values, they are marked as non-unique, even if they were configured as unique in Data Center.

In your next migration, we recommend that you delete duplicate values. Read how to delete duplicate values

Exceeded the maximum cardinality for the URL, Email, and Select attributes.

The maximum supported limit for URL, Email, and Select attribute types is 50 in Cloud. We have migrated only 50 values, randomly selected within the limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend deleting URLs, Emails, and Select attributes that are not required.

Exceeded the maximum cardinality in an attribute.

The maximum supported limit for an attribute is 20,000. We couldn’t migrate additional values beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend deleting attributes that are not required.

Exceeded the combined character limit for the URL, Email, and Select attributes.

The character limit for URL, Email, and Select attributes is 2700 characters. We couldn’t migrate additional data beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend reducing the character count.

Exceeded the total character limit for the TextArea attribute.

The character limit for all TextArea attribute values is 10,000. We couldn’t migrate additional data beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend reducing the character count.

Exceeded the maximum character limit for the Text attribute.

The character limit for a text attribute value is 255 characters. We couldn’t migrate additional data beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend reducing the character count.

Assets Query Language (AQL) for this entity couldn't be fully resolved.

We couldn’t resolve Assets Query Language (AQL) for this entity due to one or more of the following reasons:

  • It references an unsupported reference function.

  • It references unsupported connectedTickets.

  • It references an unsupported custom field ID.

  • It references objectSchemaId missing from the data copy.

Contact support for help.

Exceeded the limit of Name and/or Description fields in the Object Type Attribute

The character limit for Name and Description fields is 255 characters. We couldn’t migrate additional data beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend reducing the character count.

Exceeded limit of Regex validation field in Object Type Attribute

The character limit for Regex validation field in Object Type Attribute is 128 characters. We couldn’t migrate additional data beyond this limit.

You can contact support to understand what data has not been migrated.

In your next migration, we recommend reducing the character count.

Marketplace app migration progress logs

このセクションでは、アプリ移行の進捗ログに表示される警告メッセージの詳細と、それらの解決方法に関する提案を示します。

アプリのログ ファイルに複数の警告メッセージが表示される場合や、アプリ移行が停滞しているように思える場合は、次を行ってください。

  • Marketplace パートナーに連絡して、ログ ファイルとクラウド サイトの URL を提供する。

  • Marketplace パートナーが警告を解決するためにアトラシアンシアンの支援を必要とする場合は、アトラシアン サポートに連絡する。

警告メッセージ

詳細

修正

Server アプリで例外が発生しました

サーバー アプリでエラーが発生した可能性があります。サーバー アプリでのその後の移行処理も停止し、アプリ移行がタイムアウトする可能性があります。

アプリの移行が完了しない場合は、Marketplace パートナーに連絡して、次の情報を提供してください。

サーバーの例外に関してアトラシアンのサポートが必要な場合、Marketplace パートナーがアトラシアン サポートへの連絡をあなたに指示する場合があります。

アプリ移行の開始について Cloud アプリに通知できませんでした。

アプリの移行が開始されたことを Cloud アプリで通知しようとしたときに、失敗エラーが発生しました。Cloud アプリに通知するために複数回再試行したことにより、正常な応答として返されませんでした。

Marketplace パートナーがアプリの移行を開始できるようにするには、クラウド アプリに通知する必要があります。このエラーにより、アプリの移行がタイムアウトする可能性があります。

Cloud アプリのアップデートが完了しない場合は、Marketplace パートナーに連絡して、次の情報を提供してください。

移行後のレポート

移行後のレポートは、移行された項目と移行されなかった項目、注意が必要な事項など、移行の詳細を含む zip アーカイブです。移行後のレポートを移行前のレポートと比較して、重要な項目がすべて移行されたことを確認することもできます。

移行後のレポートをダウンロードするには、次の手順に従います。

  1. 移行計画を開きます。

  2. [移行を確認する] 画面に移動します。

  3. [ログとレポート] タブを選択します。

  4. 移行後のレポートをダウンロードします。

This report contains many entries, out of which the problem summary, description, and solution is same as described in the pre-migration report or includes some additional data such as: “JQL for this entity couldn't be fully resolved”. In this case, use the JQL article for a resolution.

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

If you’re unable to fix the problem using this page, contact support.

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

詳細情報とサポート

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

Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.

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

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