galasa

Close menu
Open menu

Upgrading

You can get the latest version of Galasa in Eclipse by completing the following steps:

  1. Launch Eclipse.
  2. Choose Help > Install New Software from the main menu.
  3. Select https://p2.galasa.dev/ in the Work with field to check wether a new version of Galasa is available.
  4. If a new version is available, tick the Galasa box in the main panel, ensuring that Galasa and all child elements are ticked.
  5. Follow the prompts to download and install the new version of Galasa. Eclipse restarts and the latest version is installed.

Upgrading existing tests

If you have a pre-built version of tests that were created against an earlier version of Galasa in your local Maven repository, you need to rebuild those test projects and any associated Managers after ugprading, so that the pom.xml files of those tests and Managers specify the new version of Galasa.

A simple way to do this is to complete the following steps:

  1. Search your Galasa files for the version number against which the tests were created, for example 0.9.0. A filtered list of files containing 0.9.0 is returned.
  2. Check each pom.xml file and replace that version number with the new version number, for example, 0.10.0.

NOTE: Do not update version numbers for non-Galasa dependencies or plug-ins. Only replace the version number for Galasa dependencies, where the groupId is set to dev.galasa, as per the following examples:

<parent>
<groupId>dev.galasa</groupId>
<artifactId>galasa-parent</artifactId>
<version>0.10.0</version>
</parent>
<dependencies>
        <dependency>
            <groupId>dev.galasa</groupId>
            <artifactId>dev.galasa</artifactId>
            <version>0.10.0</version>
            <scope>provided</scope>
        </dependency>
  1. Check that the OBR version in the Galasa preferences references the new version of Galasa.

    If you are using Eclipse, complete the following steps:

    a. Go to Eclipse > Preferences > Galasa on a Mac or Window > Preferences > Galasa on Windows.

    b. Check the OBR Version field is blank, to automatically select the latest version.

    If you are using VS code, complete the following steps:

    a. Go to File > Preferences > Settings and expand the Extensions section.

    b. Select Galasa and check that the Version field is using the default value of LATEST, to automatically select the latest version.

Troubleshooting

If you have problems after completing the steps for upgrading, try running a clean Maven install.

To run a clean Maven install in Eclipse, complete the following steps:

  1. Right click your project and select Run as > Maven clean
  2. Right click your project and select Run as > Maven install

Alternatively, run the mvn clean install command from the command line.

If you are still having issues, you can force a full Maven rebuild by deleting your .m2 repository and creating a new build against your test projects and Managers by running a clean Maven install.