手順 1. バックアップの作成

データベースの変更を行う前にデータベースのバックアップを作成するようにします。

1. From Jira, create a XML backup site backup.
2. Jira を停止します。
3. ご利用のデータベース管理ツールで、Jira データベースのデータベース バックアップを作成します。

ステップ 2. Jira ユーザー管理の置き換え

Use the SQL below to move groups and users from your External User Directory to Jira by transferring table content. The SQL provided is specific to MySQL and must be modified for other databases.

ディレクトリの ID の検索

1. 次のクエリを実行し、ディレクトリの ID を記録します。これは以降の手順で、<Jira Internal DirectoryID> として参照されます。

   select * from cwd_directory where directory_name = 'Jira Internal Directory' or directory_name = '<LDAP Directory Name>'
   

    Take note of the internal directory ID and the external directory ID you will be migrating from.

複数のディレクトリで同じグループに所属している重複ユーザーを検索して削除する

以降の手順で重複が発生しないようにするため、Jira にグループを移動するときに次の SQL を使用して、外部ディレクトリと内部ディレクトリの両方で同じ名前のグループに所属しているユーザーを検索します。 

1. 異なるディレクトリで同じグループに所属している、同じ名前のユーザーを検索するには、以下のコマンドを実行します。

   SELECT count(*), a.user_name, c.group_name from cwd_user a
   join cwd_membership b on b.child_id = a.id
   join cwd_group c on c.id = b.parent_id group by 2,3 having count(*)>1

   返されたユーザー名とグループをそれぞれ記録しておきます。これは次の手順で必要となります。 

2. 外部ディレクトリで、それぞれのグループからユーザーを削除します。メンバーシップは Jira 内部ディレクトリに残ります。 
3. 上記の SQL を再度実行します。結果が返されなければ、次の手順に移動できます。 

グループを Jira に移動する

1. 内部ディレクトリ内に外部ディレクトリのグループと同じ名前のグループが複数存在する場合があります。これらを見つけるには、次のコマンドを実行します。

   select distinct a.id, a.directory_id, a.group_name, d.directory_name from cwd_group a join cwd_group b on a.group_name=b.group_name join cwd_directory d on d.id=a.directory_id where a.directory_id != b.directory_id;
   

   
   

   1. 前のクエリで結果が返されている場合、重複する各グループ名について、Jira 内部ディレクトリでのそのグループの ID (<internal group id>) と外部ディレクトリでの ID (<external group id>) を見つけます。以下を実行します。

      update cwd_group_attributes set group_id=<internal group id>, directory_id=<Internal Directory ID> where group_id=<External Group ID>;
      update cwd_membership set child_id=<Internal Group ID> where child_id=<External Group ID>;
      update cwd_membership set parent_id=<Internal Group ID> where parent_id=<External Group ID>;
      delete from cwd_group where id=<External Group ID>;
      

2. 外部ディレクトリ内のすべてのグループを Jira 内部ディレクトリに移動します。

   update cwd_group set directory_id=<Internal Directory ID> where directory_id=<External Directory ID>;
   update cwd_membership set directory_id=<Internal Directory ID> where directory_id=<External Directory ID>;
   

ユーザーを Jira 内部ディレクトリに移動

1. 内部ディレクトリ内に外部アプリケーションのユーザーと同じ名前のユーザーが複数存在する場合があります。これらを見つけるには、次のコマンドを実行します。

   select distinct a.id, a.directory_id, a.user_name, d.directory_name from cwd_user a join cwd_user b on a.user_name=b.user_name join cwd_directory d on d.id=a.directory_id where a.directory_id != b.directory_id;
   

   
   

   1. 前のクエリで結果が返されている場合、重複する各ユーザー名について、Jira 内部ディレクトリでのそのユーザーの ID (<internal user id>) と外部アプリケーションでの ID (<external user id>) を見つけます。以下を実行します。

      update cwd_membership set child_id=<Internal User ID> where child_id=<External User ID>;
      update cwd_user_attributes set user_id=<Internal User ID>, directory_id=<Jira Internal ID> where user_id=<External User ID>;
      delete from cwd_user where id=<External User ID>;
      

2. 外部アプリケーション内のすべてのユーザーを Jira 内部ディレクトリに移動します。

   update cwd_user set directory_id=<Internal Directory ID> where directory_id=<External Directory ID>;
   

外部アプリケーション ディレクトリの削除

1. 内部ディレクトリが一番上に来るようにディレクトリの順番を変更し、内部ディレクトリをアクティブ化する必要があります。

   1. ディレクトリが内部ディレクトリと、削除しようとしている外部ディレクトリの 2 つのみの場合、以下を実行します。

      update cwd_directory set directory_position = 0 where id = <Internal Directory ID>;
      

   2. 3 つ以上のディレクトリがある場合、一番上が内部ディレクトリ (directory_position0)、一番下が削除しようとしている外部アプリケーション ディレクトリになるように並べ替える必要があります。

      • 以下のコマンドを使用して、ディレクトリとその順序を表示します。

        select * from cwd_directory order by directory_position;
        

      • 必要な順序になるようにリストの順序を変更します。ディレクトリの順序は次のコマンドを使用して変更できます。

        update cwd_directory set directory_position = <position> where directory_id = <directory id>;
        

   3. 内部ディレクトリが有効であることを確認します。

      • List the internal directory. An enabled directory will have its 'active' column set to '1'

        select id, directory_name, active from cwd_directory where id = <Internal Directory ID>;
        

      • 内部ディレクトリがアクティブでない場合、次のようにしてアクティブ化します。

        update cwd_directory set active = '1' where id = <Internal Directory ID>;
        

2. ディレクトリが正しい順序で配列されたら、外部アプリケーション ディレクトリをディレクトリの順序から削除します。

   
   

   1. 外部アプリケーション ディレクトリはデータベース内の他の複数の表で参照されています。このディレクトリへの残りの参照を削除する必要があります。

      delete from cwd_directory_attribute where directory_id=<External Directory ID>;
      delete from cwd_directory_operation where directory_id=<External Directory ID>;
      

   2. 外部ディレクトリへのすべての参照を削除したら、以下を使用してディレクトリを削除します。

      delete from cwd_directory where id = <External Directory ID>;
      

パスワードのリセット

All users who were in the External Directory you deleted, including admins, will be unable to log in. Their passwords need to be reset by choosing the 'Forgot your password?' link on the login page. 
Alternatively, you can run the following database update to reset users password to 'sphere'

update cwd_user set credential='uQieO/1CGMUIXXftw3ynrsaYLShI+GTcPS4LdUGWbIusFvHPfUzD7CZvms6yMMvA8I7FViHVEqr6Mj4pCLKAFQ==' where lower_user_name in ('user1', 'user2', 'user3')