Central Admin doesn’t allow you to choose in which Content Database to create a new Site Collection. With PowerShell its easy:
–ContentDatabase "WSS_Content_SecondDB" `
-Url "http://portal.contoso.com/sites/MyNewSiteCollection" `
-Name "SitecCollectionTest" `
–Description "A Site Collection created in a separate Content Database" `
-OwnerAlias "CONTOSO\Gerben" `
–OwnerEmail "firstname.lastname@example.org" `
Recently I wanted to migrate about 400 issues and 350 attachments from a YouTrack OnDemand instance to a JIRA InCloud instance. JIRA doesn’t provide an importer that is compatible with YouTrack, so I coded a quick .Net C# application that migrated the data for me.
I started with quick list of my must- and nice-to-haves:
||Information to migrate
||Title, description, state and priority
||Attachments belonging to the issue
||Comments, including date and author
||Information to migrate
||Reporter and assignee
|Projects and Issues
||Affected and fixed version information
||Relationship between issues (duplicate/relates-to etc etc)
||Historical information such as when the issue was transitioned from one state to another
I didn’t want to migrate or convert between YouTrack’s WIKI formatting used in issue description/comments and the JIRA way of formatting those fields. In fact it turns out that these formats are very similar, so that was a pleasant surpise when I was finished.
The first choice…REST or Import plugin?
The first choice I had to make was between JIRA’s REST API or JIRA’s JSON Import plugin. I opted for the plugin because the REST-API tends to completely ignore information such as state, dates and users. Being able to control the content of these fields is really crucial for data migration.
Getting the issues out of YouTrack…YouTrack and YouTrackSharp challenges
I already blogged how to get issues and attachments out of YouTrack, so there weren’t too many surprises:
Importing the issues into JIRA
JSON Import documentation
The JSON structure that JIRA can import is documented on Overview and details.
The import plug-in basically does the following. Firstly it will create all the users listed in the JSON. Secondly it will create the projects, components and versions. Thirdly it will import the issues into each project. If the issue contains an attachment, it will download it from the specified URL/webserver into your JIRA instance’s datastore and attach it to the issue. Finally it will create any links between the issues.
Don’t worry about the license limit on the number of users. The plug-in will create them all, but any user above your license limit wont be granted access to the JIRA application and wont count towards the license. Also, after the import is complete, its fine to delete the attachments from your URL.
So the requirements for my application were:
- Be able to list all distinct users that are referenced somewhere in an issue, comment or attachment
- Per project, be able to list all distinct components that are referenced somewhere in an issue
- Per project, be able to list all distinct versions that are referenced somewhere in an issue field
- Be able to list all distinct relationships between issues. These relationships could in theory be cross-project
- Per issue, be able to translate YouTrack’s values for fields into JIRA’s equivalent. Specifically the following:
- YouTrack’s state field to JIRA’s state and resolution
- YouTrack’s default 4 priority values to JIRA’s default 6 priority values
- YouTrack’s name for Issue types to JIRA’s name for Issue types
- Be able to translate YouTrack’s usernames to JIRA’s usernames. I had a few users that existed in both systems with slightly different usernames
- Be able to place the downloaded attachments from YouTrack on webserver that JIRA can access and write that URL into the JSON datastructure.
Jira JSON import gotcha’s
- You are not allowed to supply the resolved date in the issue object. created and updated are fine though
- The JSON import documentation doesn’t make it clear that you can control what the key of an imported issue should be using the
key property of an
issue object. If you don’t supply this property, then JIRA will simply give each issue a key equal to the order in which its listed in the JSON. This will almost always be a problem as its very common for issues to in YouTrack to have been deleted
- YouTrack can handle 1 issue containing multiple attachments with the same name. The JIRA JSON import will throw the following exception and will stop importing more attachments for the issue. I only had 1 issue that had 2 attachments with the same name in YouTrack and I removed one of them
com.atlassian.jira.plugins.importer.external.ExternalException: com.atlassian.jira.web.util.AttachmentException: Could not save attachment to storage: java.io.FileNotFoundException: /data/service/j2ee_jira/catalina-base/temp/jira-importers-plugin-downloader-2621864330368162205.tmp (No such file or directory)
Caused by: com.atlassian.jira.web.util.AttachmentException: Could not save attachment to storage: java.io.FileNotFoundException: /data/service/j2ee_jira/catalina-base/temp/jira-importers-plugin-downloader-2621864330368162205.tmp (No such file or directory)
- YouTrack and Jira have a different interpretation of the direction of the Duplicate issue links.
Assume that in YouTrack the follwing link exists: YouTrack: XXX-27 is duplicated by XXX-1
Then the IssueLink object will look like this:
SourceId "XXX-27" string
TargetId "XXX-1" string
TypeInward "duplicates" string
TypeName "Duplicate" string
TypeOutward "is duplicated by" string
If we translate that to JIRA's JSON format
Then JIRA will report that XXX-27 duplicates XXX-1. Ergo,for the Duplicate type, we need to swap Source and Target
- If you have a private installation of JIRA, then you can control the format of the project key. However, in OnDemand instances, the key is restricted to only upper- and lowercase letters, you cant change that. I had 2 projects in YouTrack whose key contained numbers. I could have written a few lines of code to replace the numbers with some letters, but in my case it was far easier to modify the project in YouTrack and remove the numbers.