Migrating users between user directories
Using the 'migrate users from one directory to another' functionality
This functionality allows for the following scenarios:
- Migrate all users from JIRA Internal to Delegated LDAP
- Migrate all users from Delegated LDAP to JIRA Internal
- Migrate all users from Delegated LDAP to Delegated LDAP
However, it cannot be used for any of the following scenarios:
- Migrating a specific set of users or one single user from one directory to another
- Connector user directories — these can be easily identified, as they have a Synchronize option
- Migrating groups only
- Migrating users without their groups
It also has the following features:
- If you, the currently logged-in user, are in the directory to be migrated from, your user data will not be migrated.
- Users and groups will not be migrated if they already exist in the target directory. For example, consider a user that exists in JIRA Internal and JIRA Delegated LDAP but has different groups in JIRA Internal: when migrating from JIRA Internal to the JIRA Delegated LDAP, that user will be skipped and the groups will not be migrated.
To migrate users:
- If the username needs to be changed as part of the migration, rename them (see Managing users for instructions).
- Choose > User Management.
- Choose User Directories.
- Choose Additional Configuration & Troubleshooting (section) > Migrate users from one directory to another.
- This option will not appear if there are no valid directories to migrate from/to.
- Select the from and to directories and migrate the users:
- You will be shown a message telling you whether the migration was successful or not. In these example screenshots, only 61 out of 62 users could be migrated, as the user doing the migration was logged into the JIRA Internal Directory.
Migrating users by changing the directory order
This method is only applicable if moving users from the JIRA Internal Directory into an LDAP Connector and when LDAP will manage all their groups. Migrating users in this method will not move across any groups as the groups are separate from the JIRA Internal Directory to the LDAP Connector.
- Add the LDAP Connector, as detailed in Connecting to an LDAP directory.
- Move the new user directory, so that it is ordered before the JIRA Internal Directory:
When users login, they will login to the LDAP Connector rather than the JIRA Internal Directory provided the usernames are identical.
Migrating users manually
If the user migration does not fall into the above scenario, you can migrate users by modifying the database. See this knowledge base article for instructions on how to do this: Migrate local group memberships between directories. When - JRA-27868Getting issue details... STATUS is completed, JIRA will handle this in product.