要約

Server または Data Center から Cloud に移行する際には、Migration Assistant アプリで一連の事前チェックを実行し、ソース インスタンスに重複したメール アドレスを持つユーザーが存在しないことを確認します。Cloud では、メール アドレスがプライマリ識別子であるため、一意なものでなければなりません。Jira および Confluence から移行されたコンテンツは、メール アドレスに基づいて Cloud のユーザーにリンクされます。

特定する

次のいずれかの方法を使用して、重複したメール アドレスを持つユーザーを特定します。

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

Migration Assistant を使用してユーザーを評価し、同じメール アドレスを共有しているユーザーを特定できます。この評価は、移行前であればいつでも実行できます。

重複したアドレスを持つユーザーを特定するには、次の手順に従います。

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

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

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

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

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

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

Confluence では、上記の評価方法は使用できません。ただし、新しい移行プランを作成し、事前チェックを実行することでソース インスタンスをスキャンすることが可能です。重複したメール アドレスがあると、次のように表示されます。

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

データベースで次のクエリを実行することで、無効なメール アドレスを持つユーザーを特定することもできます。

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

ソリューション

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

ユーザー ディレクトリ内で有効かつ一意なメール アドレスを手動で作成して更新する

有効かつ一意なメール アドレスを手動で作成できます (例:user@atlassian.com)。そして、LDAP サーバー、Server または Data Center インスタンスなど、使用しているユーザー ディレクトリでそれらを更新してください。

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

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

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

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

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

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

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

「Migration Assistant でユーザーを自動的に特定する」セクションで説明した評価が完了したら、次のステップとして、Migration Assistant で重複したメール アドレスを修正できます (無効なメール アドレスの修正後)。このアプローチを選択した場合、ソース ディレクトリのユーザーは更新されず、移行中に Cloud で作成されたユーザーだけが更新されることに注意してください。

重複したメール アドレスを自動的に修正するには、次の手順に従います。

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

2. 結果が表示されたら、[Fix invalid emails (無効なメールを修正)] を選択します。無効なメール アドレスの修正は、重複修正の前提条件となるステップです。

3. [無効なメール アドレスを修正する] ページが表示されたら、[Fix duplicated emails (重複したメールを修正)] を選択します。

4. いずれかのオプションを選択して、重複したメール アドレスを修正します。各オプションの詳細については、「重複したメール アドレスを修正する」を参照してください。

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

データベースのユーザー ディレクトリを更新できます。これらのクエリを使用することで、重複したメール アドレスを持つ各ユーザーのメール アドレスが 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);