要約

When migrating from Server or Data Center to Cloud, the Migration Assistant apps run a set of pre-checks to verify the source instance doesn’t include users with duplicated email addresses. Since an email address is the primary identifier in Cloud, it must be unique. Migrated content from Jira and Confluence will be linked to users in Cloud based on their email addresses.

特定する

Use one of the following ways to identify users with duplicated email addresses:

Jira Cloud Migration Assistant でユーザーを自動で特定する

You can use the Migration Assistant to assess your users and identify those who share the same email address. You can complete this assessment at any time before migration.

To identify users with duplicated addresses:

1. まず、Jira Cloud Migration Assistant を開きます。

2. [Assess and prepare users (ユーザーの評価と準備)] カードで、[Begin assessing (評価を開始)] を選択します。これにより、空の結果のページが開きます。

3. 評価を開始するには、[Begin assessing (評価を開始)] を選択します。

評価が完了すると、無効なメール アドレスおよび重複したメール アカウントを含む結果が以下のように表示されます。

評価および次のステップに関する詳細は、「移行のためにユーザーを評価および準備する」を参照してください。

Jira Cloud Migration Assistant でユーザーを特定する

For Confluence, the assessment mentioned above is not available. However, you can create a new migration plan and run the pre-checks to scan the source instance. If there are any duplicated email addresses, you will see the following:

データベース上でユーザーを特定する

You can also identify users with invalid email addresses by running the following query in your database.

select lower_email_address,directory_id,count(*) from cwd_user group by 1,2 having count(lower_email_address) > 1;

ソリューション

移行元のユーザー ディレクトリでメール アドレスを手動で修正するか、移行アシスタントで自動オプションの 1 つを選択して、移行中にユーザーを更新することができます。

Manually create valid and unique emails and update them in your user directory

You can manually create email addresses that are valid and unique (e.g. user@atlassian.com) and update them in your user directory, be it an LDAP Server or your Server or Data Center instance.

Server または Data Center インスタンスでユーザーのメール アドレスを更新するには、以下の手順に従ってください。

1.  [管理] > [ユーザー管理] を選択します。

2. ページの一番上にあるフィルターを使用して更新したいユーザーを探します。

3. ユーザー名の隣の[編集]を選択します。

4. メール アドレスを更新して、[更新] を選択します。

移行中に自動でユーザーを更新する (Jira のみ)

このオプションは、Jira Cloud Migration Assistant でのみ利用できます。

After you complete the assessment described in the Identify users automatically in the Migration Assistant section, the Migration Assistant will let you fix duplicated email addresses as the next step (after fixing invalid email addresses. Note that if you choose this approach, we won’t update users in your source directory, but only the ones we create in Cloud during migration.

To automatically fix duplicated email addresses:

1. Migration Assistant の[Assess and prepare users] セクションで、結果を表示します。

2. When viewing the results, select Fix invalid emails. Invalid emails are the first step you need to go through before you get to fixing the duplicates.

3. When viewing the Fix invalid email addresses page, select Fix duplicated emails.

4. Choose one of the options to fix duplicated emails. For more information on each option, see Fix duplicated email addresses.

データベースでユーザーを手動で更新する

You can update users directory in the database. These queries will update the email address of every user whose address is duplicated, using the following format: dupeuser-<id>@domain.com.

クエリは、具体的なドメインを加えたり、形式を変更して調整してください。完了したら、Server または Data Center インスタンスを再起動してください。 

Postgres

update cwd_user 
set email_address = 'dupeuser-' || id || '@domain.com', 
    lower_email_address = 'dupeuser-' || id || '@domain.com'
    where lower_email_address in (select lower_email_address from cwd_user 
group by lower_email_address having count(lower_email_address) > 1);

MySQL

UPDATE cwd_user
SET email_address = CONCAT('dupeuser-',id,'@domain.com'),
    lower_email_address = CONCAT('dupeuser-',id,'@domain.com')
    WHERE lower_email_address in (select lower_email_address from (select lower_email_address from cwd_user
group by lower_email_address having count(lower_email_address) > 1) as t);

MS SQL Server

UPDATE cwd_user
SET email_address = CONCAT('dupeuser-',id,'@domain.com'),
    lower_email_address = CONCAT('dupeuser-',id,'@domain.com')
    WHERE lower_email_address in (select lower_email_address from cwd_user 
group by lower_email_address having count(lower_email_address) > 1);

Oracle

UPDATE cwd_user
SET email_address = 'dupeuser-' || id || '@domain.com',
    lower_email_address = 'dupeuser-' || id || '@domain.com'
    WHERE  lower_email_address in (select lower_email_address from cwd_user 
group by lower_email_address having count(lower_email_address) > 1);