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

このページは、Jira Server から Cloud への移行で発生する可能性のある問題のトラブルシューティングに役立ちます。移行に役立つ KB (ナレッジ ベース) 記事の広範なリストをぜひご参照ください。

このページの使用方法

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

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

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

このページは、移行の過程で問題が発生する可能性のある場所に基づいて分割されています。

移行実行前

[移行オプションを選択] 画面で移行オプションを選択したあと、Jira Cloud Migration Assistant が Server と Cloud のデータを確認するためにいくつかのチェックを実行します。これらのチェックに基づき、[移行前チェック] 画面にエラーと警告が表示されます。チェックを展開して問題の詳細を確認したあと、エラーまたは警告を修正します。

移行前チェックに関連するさまざまな記号を次の表に示します。

記号

説明

必要なアクション

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

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

移行の次のステップに進めます。

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

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

警告メッセージを展開して、詳細と関連リンクを表示できます。

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

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

エラー メッセージを展開して、詳細と関連リンクを表示できます。

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

灰色のエラーは、予期しないエラーのためにチェックが完了しなかったことを意味します。

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

[移行前チェック] 画面で発生する一般的なエラーの一部に関する修正 / KB 記事のリストを次に示します。

メッセージ

修正/KB 記事

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

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) による移行時のプロジェクト名とプロジェクト キーの競合

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

情報: 共有されている E メールのチェックを完了しました。成功: いいえ

Cloud への移行時に重複するメール アドレスを解決する

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

情報: 無効な E メールのチェックを完了しました。成功: いいえ

Cloud への移行時に無効なメール アドレスを解決する

データ準備エラー

これらのエラーは、[Pre-migration checks (移行前チェック)] 画面のデータ準備チェックにあるログ ファイル (ダウンロード可能な ZIP ファイル) に記録されます。

エラー

修正

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

エラー <projectKey> プロジェクトエクスポート ID <issueTypeId> の課題タイプにリンクされた ID <requestTypeId> のリクエスト タイプを移行できませんでした

解決するには、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 を実行したら、移行を再試行できます。

移行実行後

これらのエラーは、移行の失敗または不完全な移行の結果である可能性があります。エラー ログをダウンロードして、すべてのエラーを表示できます。

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

  1. [移行を確認] 画面で [ログとレポート] タブに移動します。

  2. [エラー ログ] で [ダウンロード] を選択します。

移行の実行後に発生する可能性のあるエラーのトラブルシューティングに役立つナレッジ ベース記事のリストを次に示します。

一般的なエラー

エラー

修正/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 サーバーがクラッシュする

Jira Service Management 固有のエラー

エラー

修正/KB 記事

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

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

 

詳細情報とサポート

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

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

その他のヘルプ