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

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

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

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

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

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

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

移行アシスタントでは、ボードの JQL 課題フィルターが移行後に適切な結果を返しているかどうかのチェックを行いません。ボードのフィルターが未移行のプロジェクトまたはフィールドをメンションしている場合は、移行後にそのボードで同じ結果が返されない可能性があります。この問題を解決するには、移行後にボードの JQL フィルターを編集します。ボード フィルターの詳細をご確認ください。

Jira Align を使用する場合は、移行前、移行中、移行後に追加の手順を完了する必要があります。問題がある場合は、リンク先のページを参照するか、アトラシアン サポートに連絡してください。Jira Align を移行する方法をご確認ください

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

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

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

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

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

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

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

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

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

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

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

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

修正:

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

   1. admin.atlassian.com にアクセスして、複数の組織がある場合は組織を選択します。

   2. [製品] > [サンドボックス] の順に選択します。

2. 削除された場合は、サポートに連絡して支援をご依頼ください。

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

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

   1. admin.atlassian.com にアクセスして、複数の組織がある場合は組織を選択します。

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

2. キャンセルされた場合は、キャンセルされたサイトを復元してください。

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

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

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

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

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

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

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

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

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

目標

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

問題を解決する

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

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

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

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

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

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

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

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

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

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

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

エラー [JCMA 149] <プロジェクト キー> プロジェクトのエクスポート: ワークフロー「<ワークフロー名>」にある課題キー「<課題キー>」の課題タイプ「<課題タイプ名>」に「<課題ステータス>」ステータスがありません。

有効なステータスを割り当てるには、次の手順に従います。

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

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

3. ワークフロー 列で、影響を受けるワークフローを探してください。

4. ワークフローを開いて、[リンクされたステータス] 列に有効なステータスのリストを表示します。

5. 無効なステータスが割り当てられた課題を開きます。

6. [ワークフロー] リストから有効なステータスを選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

• Jira 用の Microsoft SQL Server データベースの照合順序を手動で修正する方法

• SQL Server の照合順序を更新した後、Advanced Roadmaps for Jira にプランが表示されなくなった

エラー <project key> プロジェクトエクスポート: 課題 <issue type> に無効な課題タイプが割り当てられています。

課題タイプを割り当てるには、次の手順に従います。

1. [プロジェクト] に移動します。

2. 課題タイプを追加するプロジェクトを開きます。

3. [プロジェクト設定] を選択します。

4. [課題タイプ] で課題タイプ スキームを選択します。

5. [アクション] > [別のスキームを使用] の順に移動します。

6. [新しいスキームを作成して現在のプロジェクトに関連付ける] を選択します。

7. 利用可能な課題タイプから、関連するすべての課題タイプを追加します。

8. OK を選択します。

9. [プロジェクトのインデックス再作成] > [プロジェクトのインデックス再作成を開始] の順に選択して、変更を保存します。

10. [更新] > [確認] の順に選択して、プロセスを完了します。

ERROR <プロジェクト キー> project-export: フィルター「<フィルター名>」に所有者が割り当てられていないか、フィルターがもはや存在しません。

エラーを解決するには、ナレッジベース記事の「削除済みのユーザーが所有するフィルター」セクションを参照してください。

Jira Cloud Migration Assistant ですべてのボードとフィルターを移行する方法

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

<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. ガジェットを追加したら、[完了] を選択します。

サポート対象のガジェットのリストを表示

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

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

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

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

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

3. 編集を選択します。

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

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

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

 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. 権限スキームからユーザーを削除します。

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 アイテムが失敗しました。

• 必要な<group name> をクラウド上のJira製品アクセス権に追加します。

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

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

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

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

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

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

• アプリ移行のステータス、サーバーの例外の警告に関するわかりやすい説明

• クラウド サイトの URL

• アプリの進捗ログ全体

• Marketplace パートナーがサーバーの例外に対処できる詳細な方法

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

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

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

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

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

• アプリの移行状況と、この警告の明確な説明

• クラウド サイトの URL

• アプリの進捗ログ全体

• Marketplace パートナーがサーバーの例外に対処できる詳細な方法