YouTrack Standalone 7.0 Help

Import from Redmine

Importing Issues from Redmine

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

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:
    • To run import with API key authentication use -a option:
      python redmine2youtrack.py -a api_key r_url y_url y_user y_password [project_id ...]

      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:
      python redmine2youtrack.py r_url r_user r_pass y_url y_user y_password [project_id ...]

      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.

Important 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.

Last modified: 29 September 2016