Cloud 移行を計画する
Atlassian Server または Data Center 製品の移行準備に役立つドキュメント。
このページは、Jira Cloud Migration Assistant を使用する際に発生する可能性のある問題のトラブルシューティングにお役立てください。
このページの使用方法
Ctrl+F または Command+F (Mac の場合) このページで押してエラー メッセージの詳細を検索フィールドに入力し、関連する KB 記事を検索します。
このページは、移行のどの段階にあるかに応じて、いくつかのカテゴリに分割されています。
既知の問題
移行実行前
移行実行後
アトラシアン サポートへの問い合わせ方法
移行または移行済みのデータに影響する可能性のある既知の問題の一覧を次に示します。
トピック | 説明 |
---|---|
データの整合性 | ご利用の Jira Server サイトが高度にカスタマイズされている場合、移行時に他の問題が発生する可能性があります。たとえば、必須フィールドに null 値が使用されている場合、これは Cloud サイトではサポートされていないため、移行は失敗します。移行前にインスタンス データのクリーン アップを行うことをお勧めします。 |
不完全な移行とプロジェクト | incomplete (不完全) ステータスが表示される場合、一部の情報は移行されていますが、少なくとも 1 個のエンティティの移行が行えていません。たとえば、プロジェクトの移行には成功したが、カスタム フィールドの値に null 値が使用されているために 1 件の課題の移行に失敗している可能性があります。このような場合、実際のすべてのデータは完了していても、プロジェクトは incomplete (不完全) と表示されます。多くの場合、このステータスが表示されても移行に問題はありません。エラー ログをダウンロードして問題の原因を確認できます。 |
移行前のサーバーでの変更 | サーバー サイトへの変更を行った場合は、すべてのデータを最新の状態にするため 10 分以上待ってから移行を行うようにします。 |
プロジェクト キーの変更 | 移行前または移行中にサーバーでプロジェクト キーを変更することを選択した場合、すべての構成、フィルター、およびボードが新しいプロジェクト キーで更新されていることを確認してから新しい移行を試行するようにします。 |
移行に含まれていないプロジェクトや課題へのリンク | 小規模なバッチでの移行を行うことを選択した場合、未移行のプロジェクトまたは課題へのリンクは、リンクされた項目が移行されるまでは欠落した状態になります。 |
履歴エントリでの参照情報の欠落 | 履歴エントリが、欠落しているリンクまたは添付ファイルを参照している場合、履歴エントリは移行されません。リンクされた課題またはプロジェクトが後から移行された場合、履歴エントリが更新されます。 |
Jira ボードでの結果の不一致 | 移行アシスタントでは、ボードの JQL 課題フィルターが移行後に適切な結果を返しているかどうかのチェックを行いません。ボードのフィルターが未移行のプロジェクトまたはフィールドをメンションしている場合は、移行後にそのボードで同じ結果が返されない可能性があります。この問題を解決するには、移行後にボードの JQL フィルターを編集します。ボード フィルターの詳細をご確認ください。 |
移行後の Jira Align に関する問題 | Jira Align を使用する場合は、移行前、移行中、移行後に追加の手順を完了する必要があります。問題がある場合は、リンク先のページを参照するか、アトラシアン サポートに連絡してください。Jira Align を移行する方法をご確認ください |
移行を実行する前に確認できることが 2 つあります。
移行前チェック
移行前のレポート
移行前チェックは、すべての移行で必須のステップです。ここでは、設定が正しく行われており、データを Cloud に移行できることを確認します。移行前チェックを実行して、その結果を確認してから Jira 移行を行いましょう。
ここでは、移行前チェックで表示されるステータスを簡単にご説明します。
記号 | 説明 |
---|---|
チェックに合格しました。移行を続行できます。 | |
移行を続行できますが、潜在的な問題に注意する必要があります。警告メッセージを展開すると詳細が表示されます。 | |
エラーが解決されるまで、移行を続行できません。エラー メッセージを展開すると詳細が表示されます。 | |
予期しないエラーのため、チェックが完了しませんでした。チェックを更新するか、アトラシアン サポートにお問い合わせください。 |
チェックによって表示される一般的な問題と、それを解決するために必要なステップをご説明します。
メッセージ | 修正/KB 記事 |
---|---|
現在、移行サービスを更新しています。 | Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。 |
ユーザー数の上限をチェックできませんでした。 | Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。 |
クラウド サイトのプロジェクトをチェックできませんでした。 | Jira Cloud Migration Assistant の認証トークンの有効期限が切れている可能性があります。 |
クラウド サイトのプロジェクトをチェックできませんでした。 | クラウド サイトが移行できない可能性があります。理由と修正方法は次のとおりです。 理由 1: サンドボックスが削除されました。 修正:
理由 2: クラウド サイトが見つからなかったか、使用していないために Jira Cloud サブスクリプションが非アクティブ化されました。
|
プロジェクトはクラウド サイトにすでに存在します | 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 ファイルをダウンロードできます。 ファイルの内容は以下の通りです。
目標 目標は、エイリアスを個別のメール アドレスに変更するか、対応するユーザーを削除することです。 制限を超えたエイリアスに対してだけ行えば十分です。 ただし、クラウド サブスクリプションはユーザーごとに請求されるため、余分なユーザーを削除または非アクティブ化することをお勧めします。 問題を解決する この問題を解決するには、CSVファイルを使用して対応するユーザーを特定し、更新または削除します。
|
データ準備チェックに関連するエラーと、それを解決するために必要なステップをご説明します。エラーはログ ファイル (ダウンロード可能な zip ファイル) に記録されます。
エラー コード | エラー | 修正/KB 記事 |
---|---|---|
JCMA 124 | エラー [JCMA 124] <プロジェクト キー> プロジェクトのエクスポート: ボード「<ボード名>」に無効な管理者が割り当てられています: 「<グループ名>」。 | ボードに有効な管理者を割り当てるには、次の手順に従ってください。
|
JCMA 149 | エラー [JCMA 149] <プロジェクト キー> プロジェクトのエクスポート: ワークフロー「<ワークフロー名>」にある課題キー「<課題キー>」の課題タイプ「<課題タイプ名>」に「<課題ステータス>」ステータスがありません。 | 有効なステータスを割り当てるには、次の手順に従います。
|
JCMA 510 | エラー [JCMA 510] <プロジェクト キー> プロジェクトのエクスポート: ID <課題タイプ ID> の課題タイプにリンクされた ID <リクエスト タイプ ID> のリクエスト タイプを移行できませんでした 解決するには、ID <issueTypeId> の課題タイプを ID <projectId> のプロジェクトの課題タイプ スキームに追加します | このエラーを修正するには、ステップ A とステップ B を実行します。 ステップ A: Jira Service Management プロジェクトのリクエスト タイプに使用される課題タイプのリストを作成します。 リストを作成するには、次の手順に従ってください。
ステップ B: ステップ A で作成した課題タイプのリストに基づいて、[現在のスキームの課題タイプ] リストに不足している課題タイプを確認して追加します。 不足している課題タイプを追加するには、次の手順に従ってください。
ステップ A とステップ B を実行したら、移行を再試行できます。 |
JCMA 147 | エラー [JCMA 147] <プロジェクト キー> プロジェクトのエクスポート: カンバン/スクラム ボード「<ボード名>」はクラウド上のビジネス プロジェクト「<プロジェクト名>」にリンクできません。 | エラー XXX プロジェクトのエクスポート: カンバン/スクラム ボード [XXXX] を Cloud 上のビジネス プロジェクト [XXXX] にリンクできません。 |
JCMA 151 | エラー [JCMA 151] <プロジェクト キー> プロジェクトのエクスポート: トランジション「<トランジション名>」のワークフロー「<ワークフロー名>」は、無効な画面にリンクされています。 | ワークフロー トランジションに有効な画面を割り当てる方法は次のとおりです。
|
JCMA 701 | エラー CROSS-PROJECT-DATA project-export Exception Message generated on executing query for fetching arPlanPermissions -> <例外メッセージ> | エラーを解決するには、次のナレッジベース記事を使用してください。 |
JCMA 152 | エラー <project key> プロジェクトエクスポート: 課題 <issue type> に無効な課題タイプが割り当てられています。 | 課題タイプを割り当てるには、次の手順に従います。
|
JCMA 130 | ERROR <プロジェクト キー> project-export: フィルター「<フィルター名>」に所有者が割り当てられていないか、フィルターがもはや存在しません。 | エラーを解決するには、ナレッジベース記事の「削除済みのユーザーが所有するフィルター」セクションを参照してください。 |
Cloud Migration Assistant は、アプリの移行に影響する可能性のある問題がないか、アプリをチェックする際に、エラーと警告を一覧表示します。アプリの移行前チェックに関する詳細をご確認ください。
また、アプリ ベンダー チェックも提供しています。これは、アプリ ベンダー (Marketplace パートナー) がインスタンスで実行するチェックで、アプリのデータをクラウドへ移行する際に影響する可能性のある問題を特定して、解決手順を提示します。
移行前のレポートは、移行された項目、注意が必要な事項、ユーザー、グループ、設定項目の概要など、移行の詳細を含む zip アーカイブです。これによって、移行の開始前に移行対象となるデータの検証や潜在的な問題の検出に使用できます。
移行前のレポートをダウンロードするには、次の手順に従います。
移行計画を開きます。
[移行を確認する] 画面に進みます。
[ログとレポート] タブを選択します。
移行前のレポートをダウンロードします。
レポートは多数のエントリで構成されており、次の表に示すように、問題の要約、説明、解決策も含まれています。
問題の要約 | 問題の説明 | ソリューション |
---|---|---|
カスタム フィールド設定がサポートされていない | <custom_field_type_name> カスタム フィールド タイプの移行はサポート対象外です。したがって、このフィールドの設定は移行されず、ワークフロー スキームやフィルターなど、このフィールドを参照するアイテムが機能しなくなる可能性があります。 | このカスタム フィールドが必要である場合は、クラウド サイトで再作成して、CSV インポートで移行後に課題を更新します。次のドキュメントの「CSV でエンティティを追加する」セクションをご参照ください。 |
カスタム フィールド設定がサポートされていない | <custom_field_name> カスタム フィールドの移行はサポート対象外であるため、この課題の値は移行されません。 | このフィールド値が必要である場合は、CSV インポートで移行後に課題を更新します。次のドキュメントの「CSV でエンティティを追加する」セクションをご参照ください。 |
課題タイプがサポートされていない | 移行中に、<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 以外のファイル名を割り当ててから、移行を実行する必要があります。 |
ガジェットがサポートされていない | このガジェットはサポート対象外であるため、移行されません。 |
|
部分的に移行されたガジェット | このガジェットの移行中にエラーが見つかったため、設定なしで移行されます。エラーの詳細は、サポート zip の作成時に生成されるログ ファイルをご参照ください。 |
|
移行が失敗した場合や移行が不完全である場合は、次の項目を確認します。
エラー ログ
アプリ移行の進捗ログ
移行後のレポート
エラー ログをダウンロードするには、次の手順に従います。
移行計画を開きます。
[移行を確認する] 画面に進みます。
[ログとレポート] タブを選択します。
エラー ログをダウンロードします。
エラー ログに表示される一般的なエラーのリストを次に示します。
エラー | 修正/KB 記事 |
---|---|
ERROR <Project_Key> project-import | |
ERROR <Project_Key> project-import 依存関係が <Number_of_Occurrences> 個が欠落しているため、プロジェクト バージョン <Version_Name> をインポートできませんでした: プロジェクト <Project_Key> | |
<Project Key> project-import | |
com.atlassian.jira.migration.orchestratorclient.OrchestratorClientErrorException: 移行連携のリクエストが失敗しました | |
ERROR <Project_Key> project-export | |
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 | |
ERROR <Project_Key> project-export | |
ERROR <Project_Key> project-export | Jira Server がインデックスの再作成中、または再ランク付けの操作中に LexoRankIntegrityException エラーをスローする |
sun.security.validator.ValidatorException: | |
java.net.UnknownHostException: <AMAZON_S3_URL> | |
課題 ABCD-12345 をインポートできませんでした。理由: DataAccessException: java.sql.SQLException: すでに PSQL_TOO_MANY_CONNECTIONS 例外がこのワークコンテキストで発生しています。次の getConnection をスキップします。これによって他のアイテム X 個が失敗しました。 | |
java.lang.OutOfMemoryError: Java ヒープ領域 | |
ERROR YYY project-import We couldn't import Permission Scheme 'XYZ scheme'. Reason: IllegalStateException: Errors: {holder.parameter=User 'user.name' does not exist} | 移行で選択されたプロジェクトに、無効または存在しないユーザーを参照している権限スキームが関連付けられています。これらのユーザーは多くの場合、Crowd や外部のアイデンティティ プロバイダー (IdP) に含まれる、移行されていない古いアカウントです。 修正:
|
ERROR YYY project-import We couldn't import Field Layout Item XXXXX-customfield_XXXXX. 理由: フィールド customfield_XXXXX が FieldLayout XXXXX に存在しません。 ERROR YYY project-import We couldn't import Project YYY. Reason: IllegalArgumentException: Issue type scheme [XXXXX] does not exist. ERROR YYY project-import We couldn't import Project YYY. Reason: IllegalArgumentException: Workflow scheme [XXXXX] does not exist. ERROR YYY project-import We couldn't import Issue YYY-XXXX. Reason: NullPointerException: There is no step in workflow [workflow] linked to status [status]. | これは、移行元サイトまたは移行先サイトから以前に移行したエンティティを更新または削除した結果です。 この問題を回避するには、次のいずれかを実行します。
|
ERROR YYY project-import We couldn't import Project Role Association XXXXX. Reason: IllegalArgumentException: Project role [XXXXX] does not exist | 移行するプロジェクトに、存在しなくなったグループを参照しているロールまたは権限スキームがあることを示します。 この問題を回避するには、次のいずれかを実行します。
|
ERROR <Project_Key> project-import 権限スキーム '<Project_Key> Standard 権限スキーム' をインポートできませんでした。理由: IllegalStateException: エラー: {holder.parameter=Group '<group name> ' は存在しません} |
|
Jira Service Management 固有のエラーを次に示します。
エラー | 修正/KB 記事 |
---|---|
ERROR <Project_Key> project-export | Jira の Microsoft SQL Server データベースの照合を手動で修正する方法 | Jira | アトラシアン ドキュメント
|
このセクションでは、アプリ移行の進捗ログに表示される警告メッセージの詳細と、それらの解決方法に関する提案を示します。
アプリのログ ファイルに複数の警告メッセージが表示される場合や、アプリ移行が停滞しているように思える場合は、次を行ってください。
Marketplace パートナーに連絡して、ログ ファイルとクラウド サイトの URL を提供する。
Marketplace パートナーが警告を解決するためにアトラシアンシアンの支援を必要とする場合は、アトラシアン サポートに連絡する。
警告メッセージ | 詳細 | 修正 |
---|---|---|
Server アプリで例外が発生しました | サーバー アプリでエラーが発生した可能性があります。サーバー アプリでのその後の移行処理も停止し、アプリ移行がタイムアウトする可能性があります。 | アプリの移行が完了しない場合は、Marketplace パートナーに連絡して、次の情報を提供してください。
サーバーの例外に関してアトラシアンのサポートが必要な場合、Marketplace パートナーがアトラシアン サポートへの連絡をあなたに指示する場合があります。 |
アプリ移行の開始について Cloud アプリに通知できませんでした。 | アプリの移行が開始されたことを Cloud アプリで通知しようとしたときに、失敗エラーが発生しました。Cloud アプリに通知するために複数回再試行したことにより、正常な応答として返されませんでした。 | Cloud アプリのアップデートが完了しない場合は、Marketplace パートナーに連絡して、次の情報を提供してください。
|
移行後のレポートは、移行された項目と移行されなかった項目、注意が必要な事項など、移行の詳細を含む zip アーカイブです。移行後のレポートを移行前のレポートと比較して、重要な項目がすべて移行されたことを確認することもできます。
移行後のレポートをダウンロードするには、次の手順に従います。
移行計画を開きます。
[移行を確認する] 画面に移動します。
[ログとレポート] タブを選択します。
移行後のレポートをダウンロードします。
このレポートには多くのエントリが含まれており、そのうちの問題の概要、説明、および解決策は 、移行前のレポートで説明されているものと同じです。
このページを参照しても問題を解決できない場合は、サポートにお問い合わせください。
サポート チームが迅速に対応できるように、サポート zip をアトラシアン サポート チームと共有することをおすすめします。サポート zip の作成方法をご確認ください。
移行をサポートする多数のチャンネルをご用意しています。
移行の詳細な計画情報や FAQ については、Atlassian Cloud 移行センターを参照してください。
技術的な問題が発生していたり、戦略やベスト プラクティスで支援が必要な場合、お問い合わせください。
また、アトラシアン コミュニティもご利用ください。
エキスパートによる支援が必要な場合、アトラシアン パートナーにご相談ください。
アトラシアン サーバー製品のサポートは 2024 年 2 月に終了します。サーバーのサポート終了スケジュールで詳細をご参照ください。
この内容はお役に立ちましたか?