Project Configurator for Jira Server and DC

Import Simulation

Import Simulation is highly recommended before every import task! It provides an overview of the configuration changes that will be applied to the target, giving you the flexibility to refine the content of your import.

The Import Simulation page is a preview of the changes that would be applied when the actual import is launched. You can launch a simulation by selecting the First Run a Simulated Configuration Import option on the Import Projects screen. When you click Import Projects, the simulation is launched and the results are displayed in a tree format (Import Operations Tree) on the results page. If you are using a version of PC prior to 3.0.0, you should use the Import Conflict Detection report.

You can use the Import Operations Tree to view and manage the simulation results:

  • Expand and collapse categories, individual objects, or concrete changes

  • View the separation of changes to new objects from changes to objects that already exist at the target instance

  • Enable or disable individual changes or groups of changes

  • Detect missing dependencies and requirements

  • Recalculate dependencies on demand

  • Text download of all the import information

import simulation arrow

Import Simulation Results

When the simulation has loaded, the Import Operations Tree is displayed with all your configuration action options enabled. Review the configuration changes that will be applied to your target instance before clicking Apply Configuration.

imp sim 02

Understand Your Results

The Import Operations Tree has four categories identified by color:


  • Objects displayed in blue exist in the target and are modified during the actual import.

  • Objects displayed in green do not exist in the target. These are created during the actual import. Changes associated with newly created objects are also displayed in green.

  • Objects displayed in yellow are warnings that you might want to review before proceeding with the import. There are no actions associated with warnings.

  • Objects displayed in red are considered errors. These changes are not migrated. You can choose to resolve the errors before proceeding with an actual import. If you do perform an import with errors, the objects are skipped but the import will still be completed.

Do not be alarmed if the simulation shows several errors. Often, a single error will trigger multiple associated errors. For example, a Software project type cannot be created because the number of users with access to Jira Software has exceeded the license. This will trigger errors for all changes in that project including creation of versions, components, assigning users to roles, assigning schemes, and creating filters, and dashboards related to that project. Review groups of errors to identify the root cause and make any necessary changes you identify before running the simulation again.

Navigate the Import Operations Tree

  • You can expand and collapse a category by clicking the arrows at the left of the tree.

  • The colored icons at the left of each category show the number of actions, warnings, and errors.

  • You can disable or re-enable any actions by clicking the colored icons next to the object titles. The example below shows the Modify action enabled for User, Admin. Note that errors are always skipped from the import.



  • Apply Configuration: Proceeds to the actual import after you have reviewed your simulation and made any desired changes.

  • Back to Options: Returns to the Import Options page.

  • Recalculate: After disabling or re-enabling any configuration changes, click Recalculate to update the configuration settings with your changes before selecting Apply Configuration.

  • Expand All: Expands the operations tree to the detailed view.

  • Fold All: Collapses the operations tree to show only the action titles.

  • Download: Allows you to download the results in a text file.