Importing data from Trac

This import path has been deprecated and will be removed in Jira 8.4

In Jira 8.4, we will drop support for built-in importers that are dedicated to specific applications, including this one. You will still be able to import data to Jira, provided that you use the CSV or JSON format. For more info, see End of Support announcements.

The Jira Importers plugin, which is bundled with Jira, allows you to import data from Trac from a compressed Trac environment.

(info) Our main website highlights some top reasons why people migrate from Trac to Jira. Version 2.6.1 or later of the Jira Importers Plugin is compatible with Trac versions 0.12.2 to 1.0.1.

On this page:

Preparing Trac data for import into Jira

Compress your Trac environment:

  1. Access your Trac environment.
  2. If you use SQLite (the Trac default), PostgreSQL or MySQL for your Trac database, ensure your database URL (defined in Trac's conf/trac.ini file) is also reachable from Jira server (using 'localhost' or a UNIX socket will not work).
  3. Zip the contents of Trac Environment without any leading directories.

Running the Trac Import Wizard

Before you begin, please back up your Jira data.

  1. Log in to Jira as a user with the Jira Administrators global permission.
  2. Select Administration > System > Import & Export > External System Import.
  3. Select Trac to open the Trac Import Wizard: Setup page.
  4. On the Trac Import Wizard: Setup page, select your compressed Trac environment file, which you prepared above.
  5. Leave the Use an existing configuration file checkbox cleared if you do not have a configuration file or if you want to create a new configuration file. Configuration files specify a mapping between fields in Trac and those in Jira.
    • If you select this option, you will be asked to specify an Existing Configuration File.
    • If you do not select this option, then at the end of the Trac Import Wizard, Jira will create a configuration file which you can use for subsequent Trac imports (for re-use at this step of the Trac Import Wizard).
  6. Click the Next button to proceed to the Setup project mappings step of the Trac Import Wizard.
  7. On the Setup project mappings  page, select which Trac projects you wish to import into Jira.
    • Start typing the name (or key) of a project that already exists in Jira or use the drop-down menu to select an existing Jira project.
    • Select Create New from the drop-down menu and in the resulting Add A New Project dialog box, type the following:
      1. A new project Name.
      2. A new project Key.
        (info) This will be used as the prefix for all issue IDs in your Jira project.
      3. The Project Lead.
  8. Click the Next button to proceed to the Setup custom fields step of the Trac Import Wizard.
    (info) This step will almost always appear because at least one Trac field is not likely match an existing Jira field.
  9. Custom Fields: If your Trac system contains any custom fields, you can either choose to import into an existing Jira custom field or have the importer automatically create a new custom field in Jira.
  10. (info) Regardless of whether you specify mapping, the importer will automatically create a Jira custom field for each extra Trac field, unless you un-check the 'Create new custom fields' option on the final 'Import Data' screen (see Screenshot 2 below).
  11. Field Value Mappings:
    • 'Priority' field — If you don't specify mappings, the importer will automatically create missing values in Jira and will ensure that the issues are migrated with the correct priority
    • Usernames — If you don't specify mapping, the importer will automatically map Trac usernames to Jira usernames (lowercase).
      (info) Regardless of whether you specify mapping, Jira will automatically create usernames for missing users.
    • 'Status' field — It is mandatory to map the Trac 'Status' field to specific values of the Jira 'Status' field, as the Jira 'Status' field is integral to Jira workflow (to learn more, please see Working with workflows and Managing your workflows).
    • 'Resolution' field — If you don't specify mapping, the importer will create corresponding Resolutions in Jira instead of using the existing ones.
    • 'Maximum issues and failures' — If you wish, specify a maximum number of failed issues after which the importer will stop. If you want the import to continue regardless of any failures, leave this field blank. If your Trac instance has a large number of issues, it's generally a good idea to run first the importer on a limited number of issues (e.g. 100), then manually inspect the imported issues to confirm whether your configuration file was specified correctly. When the results are satisfactory, you can run the import with no limit.
  12. The importer will display updates as the import progresses, then a success message when the import is complete. You can download the import log if you wish.

Congratulations, you have successfully imported your Trac projects into Jira! If you have any questions or encounter any problems, please contact Atlassian support.

Tips for importing Trac data into Jira fields

The import process converts Trac data as follows:

In Trac

In Jira

Import Notes

Project Environment

Project

Each Trac Environment is imported as a Jira project. You can either specify an existing Jira project as the target, or the importer will automatically create a project for you at time of import.

Ticket Type

Issue Type

You can configure mapping of Trac Ticket Types to specific Jira Issue Types.

Ticket #External Issue IDThe Trac Ticket number is captured in a Jira custom field. The import is not designed to have the Jira issue number match the Trac ticket number.

Status

Status

You can configure mapping of specific Trac values to specific Jira values.

Summary

Summary


Description

Description


Versions

Versions

Versions are imported from Trac (if you choose), and are set to the Un-Released and Un-Archived state.

Component

Components

You can choose to have the importer automatically create your Trac components in Jira, or choose to have bugs imported into no component in Jira.

Comments

Comments


Priority

Priority (or a custom field)

You can choose to map one of either the Trac Priority field or the Trac Severity field (see below) to the built-in Jira Priority field, and the other to a custom field. (Alternatively, you can choose to map both the Trac Priority field and the Trac Severity field to Jira custom fields.) When importing into the Jira Priority field, you can configure mapping of specific Trac values to specific Jira values.

Severity

Priority (or a custom field)

You can choose to map one of either the Trac Priority field or the Trac Severity field (see below) to the built-in Jira Priority field, and the other to a custom field. (Alternatively, you can choose to map both the Trac Priority field and the Trac Severity field to Jira custom fields.) When importing into the Jira Priority field, you can configure mapping of specific Trac values to specific Jira values.

Milestone

Milestone

Jira will create this as a custom field.

Attachments

Attachments

Attachments are extracted from the Trac Environment and saved to disk. To specify the location on disk, see Configuring file attachments.

Resolution

Resolution

You can configure mapping of specific Trac values to specific Jira values.

CC

Watcher


Keywords

Labels


User

User

The importer will automatically create Jira users for any Trac users who do not exist in Jira.

  • Passwords from Trac are not imported. Users from Trac will need to get their passwords emailed to them.
  • If you are using External User Management, the import process will not be able to create Jira users; instead, the importer will give you a list of any new users that need to be created. You will need to create the users in your external user repository before commencing the import.
  • If you have a user-limited license (e.g. personal license), and the number of required users is larger than the limit, then the import will be stopped. A page will be displayed showing a list of users that can't be created.

Other fields

Custom fields

If your Trac system contains any custom fields, you can choose to map them to specific Jira custom fields. If your custom fields don't yet exist in Jira, the importer can automatically create them for you.

Last modified on Sep 9, 2019

Was this helpful?

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