Importing Projects Using ALM Robot

You can import multiple ALM projects in parallel from your archive folder to an ALM database.


  • This feature is in technical preview. We recommend you do not use it in the production environment.
  • ALM Robot does not support importing Lab_Project.

To import projects using ALM Robot:

  1. In Site Administration, select Tools > ALM Robot. ALM Robot opens.

  2. Click Add Activity to create a new activity for ALM Robot. The Activity Settings page displays.

  3. Define activity settings.

    On the Activity Settings page of the wizard:

    1. In the ActivityName field, enter a name for your activity.
    2. In the Type field, select Import.
    3. The Archive Folder field is read-only, indicating the target projects to be imported are now archived in the [ARCHIVE_BASE_FOLDER]/archive folder.

      [ARCHIVE_BASE_FOLDER] depends on the value of the ARCHIVE_BASE_FOLDER site parameter. Make sure you set a value to the parameter and the ALM server has the read and write permissions of this folder. If the parameter is not set, the base repository path will be used.

    4. In the Database field, select a database the target projects will be imported to.

      If you select an Oracle database, you should also specify the default tablespaces and temp tablespaces.

    5. Click Next to open the Projects Selection page and display the available projects.

  4. Select projects.

    On the Projects Selection page of the wizard:

    1. From the list of projects and domains, select the projects to include in your activity.

      The project names are in the format: <project name>_<username that exported the project>_<date and time when the project was exported>.

      If a project has been exported for multiple time, all its export files are listed. You should select only one export file to import the project.

      After your selection, click to move the selected projects to the Selected Projects & Rank pane.

      To remove projects from the selected list, select the projects and click to remove them from the Selected Projects & Rank pane.

    2. To set the order in the Selected Projects & Rank pane in which the projects will be processed during the upgrade, highlight a project and click the arrows at the top to move the project up or down in the list.


      • Template projects are always ranked first when selected. All other projects are added to the Selected Projects & Rank pane in the same order as they appear in the Projects Tree, but can be moved according to your priorities.

      • By default, ALM Robot can process up to 10 projects simultaneously on each ALM node. To change the default value, edit the ROBOT_MAX_TASKS_PER_NODE site parameter and set it according to your environment performance, as a large value can cause performance degradation.

    3. Note any possible warning messages that may appear at the bottom of the Selected Projects & Rank pane.

    4. Click Next to open the Summary page.

  5. Review the activity summary.

    The Activity Summary shows the configuration of your activity. The Activity Tasks section shows the projects selected for your activity and the changes made per project on the Project Settings page.

    Click Submit. ALM Robot starts the validation process.

    If the validation process is completed successfully, the activity begins processing. The dashboard window opens. See ALM Robot Dashboard Actions for details.

    If ALM Robot detects an error while validating the selected projects, fix the error and click Submit.