Cloud 移行を計画する
Atlassian Server 製品の移行準備に役立つドキュメント。
このページは、Jira Cloud Migration Assistant を使用する際に発生する可能性のある問題のトラブルシューティングにお役立てください。
このページの使用方法
Ctrl+F または Command+F (Mac の場合) このページで押してエラー メッセージの詳細を検索フィールドに入力し、関連する KB 記事を検索します。
このページは、移行のどの段階にあるかに応じて、いくつかのカテゴリに分割されています。
既知の問題
移行実行前
移行実行後
アトラシアン サポートへの問い合わせ方法
移行または移行済みのデータに影響する可能性のある既知の問題の一覧を次に示します。
トピック | 説明 |
---|---|
データの整合性 | ご利用の Jira サーバー サイトが高度にカスタマイズされている場合、移行時に他の問題が発生する可能性があります。たとえば、必須フィールドに null 値が使用されている場合、これはクラウド サイトではサポートされていないため、移行は失敗します。移行前にサーバー データのクリーン アップを行うことをおすすめします。 |
不完全な移行とプロジェクト | incomplete (不完全) ステータスが表示される場合、一部の情報は移行されていますが、少なくとも 1 個のエンティティの移行が行えていません。たとえば、プロジェクトの移行には成功したが、カスタム フィールドの値に null 値が使用されているために 1 件の課題の移行に失敗している可能性があります。このような場合、実際のすべてのデータは完了していても、プロジェクトは incomplete (不完全) と表示されます。多くの場合、このステータスが表示されても移行に問題はありません。エラー ログをダウンロードして問題の原因を確認できます。 |
移行前のサーバーでの変更 | サーバー サイトへの変更を行った場合は、すべてのデータを最新の状態にするため 10 分以上待ってから移行を行うようにします。 |
プロジェクト キーの変更 | 移行前または移行中にサーバーでプロジェクト キーを変更することを選択した場合、すべての構成、フィルター、およびボードが新しいプロジェクト キーで更新されていることを確認してから新しい移行を試行するようにします。 |
移行に含まれていないプロジェクトや課題へのリンク | 小規模なバッチでの移行を行うことを選択した場合、未移行のプロジェクトまたは課題へのリンクは、リンクされた項目が移行されるまでは欠落した状態になります。 |
履歴エントリでの参照情報の欠落 | 履歴エントリが、欠落しているリンクまたは添付ファイルを参照している場合、履歴エントリは移行されません。リンクされた課題またはプロジェクトが後から移行された場合、履歴エントリが更新されます。 |
Jira Software ボードでの結果の不一致 | 移行アシスタントでは、ボードの JQL 課題フィルターが移行後に適切な結果を返しているかどうかのチェックを行いません。ボードのフィルターが未移行のプロジェクトまたはフィールドをメンションしている場合は、移行後にそのボードで同じ結果が返されない可能性があります。この問題を解決するには、移行後にボードの JQL フィルターを編集します。ボード フィルターの詳細をご確認ください。 |
移行を実行する前に確認できることが 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) による移行時のプロジェクト名とプロジェクト キーの競合 |
複数のユーザーが同じメール アドレスを持っています。 | |
無効なメール アドレスです |
データ準備チェックに関連するエラーと、それを解決するために必要なステップをご説明します。エラーはログ ファイル (ダウンロード可能な 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> に無効な課題タイプが割り当てられています。 | 課題タイプを割り当てるには、次の手順に従います。
|
Cloud Migration Assistant は、アプリの移行に影響する可能性のある問題がないか、アプリをチェックする際に、エラーと警告を一覧表示します。アプリの移行前チェックに関する詳細をご確認ください。
また、アプリ ベンダー チェックも提供しています。これは、アプリ ベンダー (Marketplace パートナー) がインスタンスで実行するチェックで、アプリのデータをクラウドへ移行する際に影響する可能性のある問題を特定して、解決手順を提示します。
移行前のレポートは、移行された項目、注意が必要な事項、ユーザー、グループ、設定項目の概要など、移行の詳細を含む 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 ヒープ領域 |
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 月に終了します。サーバーのサポート終了スケジュールで詳細をご参照ください。
この内容はお役に立ちましたか?