背景

Jira Cloud Migration Assistant を使用してソフトウェア プロジェクトまたはユーザーとグループを移行しているときに、アクションを促す警告やエラーがアプリケーションによって表示されることがあります。このドキュメントでは、よくある移行のエラーの基本的なトラブルシューティング手順をご紹介します。

環境

• Jira Cloud Migration Assistant 1.0 以降

移行エラーのダウンロード方法

移行の実行後にエラーが発生した旨が表示されます。移行のステータスは Incomplete と表示されます。

詳細なエラー ログのダウンロード方法

これにより、試行した移行のエラーを含む .log ファイルを格納した zip ファイルがダウンロードされます。

エラー メッセージのトラブルシューティングを行う方法

エラー メッセージ

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) に含まれる、移行されていない古いアカウントです。

修正

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

2. 権限スキームからユーザーを取り除いたり削除したりする方法についてはこちらのヘルプ ドキュメントをご確認ください。

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

エラー メッセージ

ERROR YYY project-export We couldn't export Work Log XXXXX.

Reason: java.lang.IllegalArgumentException: MRI entity id must not be blank.

説明

There are blank values in worklog tables that are not compatible with our cloud database constraints. This can happen in on-premise due to this behaviour .

修正

エラー メッセージ

ERROR YYY project-import We couldn't import Screen 'XYZ Screen Name'.

Reason: IllegalArgumentException: Tab name must not be blank.

説明

Jira に空白の画面名があります。

修正

UI を通じて空白の画面タブを見つけ、それらを更新します。

1. Jira で [画面] に移動します

2. エラー ログから、影響を受けている画面を見つけます。

3. [構成] をクリックします。

4. 空白の画面タブを見つけます。

5. 空白のタブに名前を追加します。

6. Jira Cloud Migration Assistant を通じて移行を再実行します。

エラー メッセージ

ERROR YYY project-import We couldn't import Field Layout Item XXXXX-customfield_XXXXX.

Reason: Field customfield_XXXXX does not exist in 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].

説明

過去に移行済みのエンティティがソースまたはターゲットのサイトで更新または削除されたため、移行に失敗しました。Jira Cloud Migration Assistant がデータを移行する方法をこちらでご確認ください。

修正

この方法を軽減するには、2 つの方法があります。

• テスト サイトでこの問題が発生した場合、ターゲットのクラウド サイトをワイプして再度開始することで移行をリセットすることをご検討ください。ワイプ プロセスの詳細についてはこちらのドキュメントをご確認ください。

または

• ターゲット サイトをリセットすることができない場合はアトラシアン サポートにお問い合わせください。

エラー メッセージ

ERROR YYY project-export We couldn't export Project Role 'Role_name'.

Reason: java.lang.IllegalArgumentException: Reference "role_name" is not a group reference.

ERROR YYY project-import We couldn't import Project Role Association XXXXX.

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

説明

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

修正

この方法を軽減するには、2 つの方法があります。

• 対象のロールやグループを再作成し、移行を再実行する前にソースのサーバーでそれらが存在するようにします。

または

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

Jira プロジェクトでの権限やロールの編集方法についてはこちらのドキュメントをご確認ください。

エラー メッセージ

ERROR YYY project-export Board 'YYYY' is shared to users of other projects: group_name

Please remove these share permissions and re-create them after migration.

説明

移行に、移行に含まれないグループと共有されているボードが含まれています。

修正

ボードの共有フィルターを編集して参照を取り除きます。

1. エラー ログに記載されているボードに移動します

2. [ボード] > [構成] の順にクリックします。

3. [一般] > [フィルター] > [フィルター共有の編集] を選択します。

4. エラー ログに記載されているユーザーまたはグループを、対象のボードから削除します。

5. Jira Cloud Migration Assistant を通じて移行を再実行します。

エラー メッセージ

ERROR YYY project-import We couldn't import Issue YYY-XXX.

Reason: Issue can be assigned to only closed sprints, and one active or future sprint during migration..

説明

ターゲットのサイトとソースのスプリントとの間に不一致があります。

• 過去にアクティブなスプリントを持っていたが、そのスプリントがアクティブではなくなったプロジェクトを、クラウドに再移行しようとしています。

• プロジェクトがクラウドで削除されたが、プロジェクトの削除時にスプリントが削除されませんでした。

• プロジェクトがクラウドに再移行されました。

修正

1. ソースのサイトでスプリントから課題を削除し、移行を再実行します。

2. クラウドでアクティブなスプリントをサーバーでクローズし、移行を再試行します。

3. これらの移行済みのスプリントをクラウド サイトから削除する方法については「Jira Cloud でスプリントを削除する」をご確認ください。

エラー メッセージ

ERROR YYY project-export Notification Scheme - [Default Notification Scheme] with id - [10000] has missing reference to group - [BBB-group]. Verify if group - [BBB-group] is valid.

説明

This can occur if the notification scheme in migration scope has references to a group that no longer exists.

修正

1. Go to Settings > Issues.
2. Scroll to "Notification schemes".
3. Next to the named notification scheme, click on "Notifications" in the Action column.
4. Search for references to the "BBB-group" group and click the "Delete" link.
5. Repeat this for all references to "BBB-group". This will remove all references to this non-existent group.
6. Jira Cloud Migration Assistant を通じて移行を再実行します。

エラー メッセージ

We couldn't import Issue Watcher Association XXXX.

Reason: Insertion of IssueWatcherAssociations did not complete

説明

This error can be replicated if multiple users are sharing the same e-mail address in your source instance.

修正

1. サーバー インスタンスで次の SQL を実行することで重複を確認します。

   select lower_email_address,count(lower_email_address) from cwd_user group by lower_email_address having count(lower_email_address) > 1

2. ユーザーのメール アドレスのいずれかを削除または更新し、一意になるようにします。
3. Jira Cloud Migration Assistant を通じて移行を再実行します。

エラー メッセージ

We couldn't import Issue Watcher Association XXXX.

Reason: Insertion of IssueWatcherAssociations did not complete

説明

This error can be replicated if multiple users are sharing the same e-mail address in your source instance.

修正

1. サーバー インスタンスで次の SQL を実行することで重複を確認します。

   select lower_email_address,count(lower_email_address) from cwd_user group by lower_email_address having count(lower_email_address) > 1

2. ユーザーのメール アドレスのいずれかを削除または更新し、一意になるようにします。
3. Jira Cloud Migration Assistant を通じて移行を再実行します。

エラー メッセージ

We found some email addresses that are connected to multiple users. To migrate, all users will need to have a unique email address.

Click on the user number to see which users the email is connected to.

説明

 各ユーザーは一意のメール アドレスを持つ必要があります (大文字と小文字は区別されません)。Jira Cloud Migration Assistant が、Jira のユーザー テーブルまたは同期されたアイデンティティ プロバイダーで同じメール アドレスを持つ複数のユーザーを検出した場合、このエラーが表示されます。

修正

1. ユーザーのメール アドレスを一意になるように更新するか、サイトまたはアイデンティティ プロバイダーから完全に削除できます。

2. Jira Software サーバー インスタンスでユーザーのメール アドレスを削除または編集する方法についてはこちらの手順に従ってください。

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

ヒント: 大量のユーザーが存在し、UI を通じた重複の確認が難しい場合は、ソース インスタンスで次の SQL を実行して、ユーザー テーブルで複数回参照されているメール アドレスを取得できます。

select lower_email_address,count(lower_email_address) from cwd_user group by lower_email_address having count(lower_email_address) > 1

SELECT s.filtername, s.authorname as owner, s.reqcontent as jql, s.DESCRIPTION,sp.entityid, sp.sharetype, sp.PARAM1 FROM searchrequest s JOIN sharepermissions sp ON sp.entityid = s.ID WHERE sp.entitytype = 'SearchRequest' ORDER BY filtername;

SELECT filtername, authorname as owner, reqcontent as jql, DESCRIPTION FROM searchrequest WHERE ID NOT IN (SELECT entityid FROM sharepermissions WHERE entitytype = 'SearchRequest') ORDER BY filtername;

select * from (select t.*, jw.workflowname,  unnest(xpath('//action[@name="' || t.action || '"]/results/unconditional-result/post-functions/function/arg[@name="class.name"]/text()', 
             (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as post_function_class from jiraworkflows jw
             join (select id, unnest(xpath('//*/action/@name',  (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as action from jiraworkflows) t on t.id = jw.id ) a where post_function_class::text not like 'com.atlassian.jira%'

select * from (select t.*, jw.workflowname,  unnest(xpath('//action[@name="' || t.action || '"]/validators/validator/arg[@name="class.name"]/text()', 
             (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as validators from jiraworkflows jw
             join (select id, unnest(xpath('//*/action/@name',  (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as action from jiraworkflows) t on t.id = jw.id ) a where validators::text not like 'com.atlassian.jira%'

select * from (select t.*, jw.workflowname,  unnest(xpath('//action[@name="' || t.action || '"]/restrict-to/conditions/condition/arg[@name="class.name"]/text()', 
             (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as conditions from jiraworkflows jw
             join (select id, unnest(xpath('//*/action/@name',  (regexp_replace(descriptor, '\<\![^\<]+\>', ''))::xml)) as action from jiraworkflows) t on t.id = jw.id ) a where conditions::text not like 'com.atlassian.jira%'

select * from notificationscheme;

SELECT * FROM "AO_60DB71_CARDCOLOR" WHERE color IS NULL OR val IS NULL OR strategy IS NULL;