Exporting Projects Using ALM Robot

You can export multiple ALM projects in parallel to your archive folder.


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

To export 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 box, enter a name for your activity.
    2. In the Type box, select Export.
    3. The Archive Folder field is read-only, indicating the target projects will be exported to 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. 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.

      You can select all projects, all projects in a specific domain, or specific projects.

      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.

      The dependency between linked projects and template projects is not reserved after the export. You have to manually link them.

    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.