Skip to end of metadata
Go to start of metadata
Before you begin:
Please note that if you try to re-import same project several times, then you must delete previously imported data before the next attempt.

Importing Issues from Redmine

This document covers importing issues from a Redmine instance to YouTrack server using the Python Client Library.

Version compatibility note
  • Current implementation of the import script is compatible with YouTrack 4.x REST API and Python 2.6.
  • YouTrack supports import from Redmine 1.4.6 and higher
  • Depending on Redmine version, some import options are not supported:
    • User groups import is supported starting with Redmine 2.1
    • Role permissions import is supported starting with Redmine 2.2

To import issues from a Redmine server to YouTrack:

  1. In your Redmine instance, ensure that REST support is enabled: open Administration > Settings > Authentication tab and select the "Enable REST web service" check box.
  2. Download the latest version of YouTrack's Python Client Library and unzip it.
  3. Ensure that Python is installed in your system.
  4. If needed, correct the default mapping file.
  5. Run the script. The script supports two authentication options for Redmine: using login/password pair or using the API key. Thus, you can use either of them with the respective command:
    Please note that you should use user accounts with administrator permissions. Otherwise, some data might not be imported.
    • To run import with API key authentication use -a option:
      Parameter Description
      r_url Redmine URL
      api_key Redmine API Key. Redmine API key can be found on your user account page.
      y_url YouTrack base URL
      y_user YouTrack user
      y_password YouTrack user's password
      project_id Redmine project identifier
    • To run import using login/password pair, use the following command:
      Parameter Description
      r_url Redmine URL
      r_user Redmine user
      r_password Redmine user's password
      y_url YouTrack base URL
      y_user YouTrack user
      y_password YouTrack user's password
      project_id Redmine project identifier

That's it.

If you run the script with -h option, then short help file will be displayed.

Import notes

Redmine REST API does not support watchers and tags, thus they are not imported to YouTrack.

TimeTracking Import Support

Import of work items is currently not supported and will be available in YouTrack 4.2.
"SpentTime" field is not imported from Redmine. Data is taken from imported work items.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.