How to change user information in Cloud to Server migration

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

The content on this page relates to platforms that are not supported by JIRA applications. Consequently, Atlassian can not guarantee providing any support for it. Please be aware that this material is provided for your information only and using it is done at your own risk.

Problem

When migrating Jira projects from cloud to on-premise, usernames, user Full Names, or e-mails can be modified to match the company's user guidelines. 

For example, cloud usernames are set in unique long strings, and Full Name and email are retrieved as mail providers, as the image below:

Depending on the company user guideline, the data can be modified to match, as example, a LDAP naming convention. 



Steps for the change

Similarly to how to migrate user contributions to a new username the Jira Administrator shall edit the xml files from Cloud backup. With the steps:

ActionExample
Create a Cloud backup as seen here

Find the usernames to be modified in the entities.xml file present in the backup zip.

After mapping the username from entities.xml to the name to be used, use text substitution tools to modify both entities.xml and activeobjects.xml into new files, to be zipped.

(note from this procedure you can also modify e-mail, names, etc)

Example using unix sed to modify user string 606b70aea23f99007526df25 to dalves:

mkdir jira-export;
sed 's/606b70aea23f99007526df25/dalves/g' activeobjects.xml \ 
 > jira-export/activeobjects.xml;
sed 's/606b70aea23f99007526df25/dalves/g' entities.xml \ 
 > jira-export/entities.xml;
zip jira-export.zip jira-export
Transfer the new zip files, with modified data, to Jira import folder (jira-home/import) and proceed with the data restore.








Last modified on Dec 18, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.