Upgrade projects using ALM Robot

With ALM Robot, you can automatically upgrade multiple ALM projects in parallel to your new version of ALM.

Before you upgrade projects

Consider the following before upgrading projects using ALM Robot:

  • ALM Robot does not support upgrading multiple projects in one activity when their database schemas are stored in different database types or versions. Each activity must contain projects based on the same database instance.

  • ALM Robot cannot upgrade projects with the Service Test Management extension enabled.

  • The following table explains what ALM Robot performs and does not perform in the project upgrade process:

    Tasks that ALM Robot can perform

    ALM Robot can perform the following tasks:

    • Deactivate active projects.
    • Undo checkouts of entities in version-controlled projects.
    • Copy projects' repositories to a new repository server, as needed.

    • Restore projects.
    • Verify, repair, and upgrade projects.
    • Once project upgrade is successfully completed, ALM Robot automatically removes the projects from the original ALM instance.
    • Activate any projects that were deactivated before the upgrade.
    What ALM Robot does not perform

    ALM Robot does not perform any post upgrade activities, such as project validation, updating required changes that result from an ALM server change, aligning integrations, and so on.

  • For other considerations, see ALM Robot prerequisites.

Back to top

Upgrade projects using ALM Robot

Follow the steps below to upgrade projects using ALM Robot.

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

  2. Click Add Activity to open the wizard.

  3. In the Activity Settings page of the wizard, define the following and click Next.

    Activity Name Enter a name for your activity.
    Type Select Upgrade.
    Select Projects Source

    Determine the source location of the projects to be upgraded. The source depends on where your site administration database schema is located.

    • Target. Select Target as the source if you want to select projects from the ALM instance you are currently working on.

      Note: If the ALM source includes version-controlled projects that have not been upgraded yet, and those projects have entities checked out, you must run the Upgrade activity using the Origin option.

    • Origin. Select Origin as the source if you want to select projects from another ALM instance.

    Target Details

    Specify the URL, Base Repository Path, and Database of the Target source.

    Origin Details

    Only applicable when you select Origin as the source.

    Specify the following details for the Origin source.

    • Origin Instance. Select an ALM instance (environment) from which you will select the projects to upgrade.

      If no environments are defined, click Edit Env list to add environments. For details on adding ALM environments, see Customize ALM Robot.

    • Copy project repositories. Select this option as a default to copy repositories of all selected projects from the Origin's base repository path to the Target's base repository path.

      If you do not select the Copy projects repositories option, you must manually copy the repository to the base repository path on the destination server before running the upgrade. The repository folder structure must be preserved when copying the repository folders.


      • You can remove repositories of specific projects from this selection in the Project Settings page of the wizard.

      • You cannot copy a repository that resides on a network mounted drive on Windows.

      • To copy a repository on Linux, it must be mounted on a shared folder on the ALM server where ALM Robot is running. This path must be specified in the Origin Repository Path field.

      • When copying a repository, the user who runs the ALM service must have the relevant read credentials for the shared repository.

    • Origin Repository Path. Required only when you select Copy projects repositories. Enter the network shared path to the Origin's base repository path. This path must be accessible from the server where ALM Robot is running.

  4. In the Project Selection page of the wizard, select the projects to upgrade and click Next.

    To select projects:

    1. From the list of projects and domains, select the projects to upgrade.

      The Dependencies column indicates any project dependencies. Projects that have lab extensions are dependent on Lab_Project, and projects that are linked to a template are dependent on the template project.

    2. Click the right arrow to move the selected projects to the Selected Projects & Rank pane.

      To remove projects from the selected list, select the projects and click the left arrow .

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


      • Lab_Project is always ranked first when selected, followed by template projects. All other projects are added to the Selected Projects & Rank pane in the same order as they appear in the Projects Tree.

      • Lab_Project is located in the DEFAULT domain.
      • 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. For details, see ALM Site Parameters.

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

  5. In the Project Settings page of the wizard, define the settings for specific projects and click Next.

    To define the settings of a project, under Project Name, select the project, and perform one of the following, according to the project source you selected. See Select Projects Source.

  6. In the Summary page of the wizard, review the activity summary.

  7. Click Submit to start the validation process.

    If the validation process is completed successfully, the activity begins processing. The dashboard window opens. See Monitor ALM Robot activities.

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

Back to top

See also: