Document toolboxDocument toolbox

Header

(v2) Upgrade from 8.4, 8.5, 8.6 to 9.0

Owned by Vrushank Salaskar
Last updated: Jan 16, 2024Version comment
3 min read

Let’s update the older versions of Qualitia Automation Studio (QAS) to the latest v9.0 and learn more about all the new features.

To upgrade QAS from 8.4, 8.5, 8.6 versions to QAS 9.0 follow the below steps:

  • Convert Java to Maven.

  • Migrate all the projects created in the previous versions to ensure that the old test cases and tasks are compatible with QAS 9.0. QAS client 9.0 does not support the projects that are not migrated successfully.

📚Prerequisites

  • Qualitia 8.4 or above.

  • Eclipse should be installed, with Jboss plugin.

  • Should have Git 2.39.1 or above version.

  • Java 1.8. 

Upgrade to 9.x

  1. Run the Readiness Utility.

  2. Go to the Readiness workspace, you will see folders Qualitia 8 and Qualitia 9. Oualitia 8 folder contains all the 8.x data and Qualitia 9 contains the migrated projects and databases.

  3. The migrated projects will be with _java file name. To upgrade from Qualitia 8.x to 9.x convert the Java project to Maven using Jboss Plugin in Eclipse.

    • Open Eclipse and navigate to the Java project you want to convert. 

    • Select the project you want to convert in the "Convert to Maven Project" dialog.

    • Go to next screen.

    • Jboss screen will open where all the libraries get identified. 

    • Once done check the libraries which are unidentified except Qualitia jar. 

    • If some jars remain unidentified, add them manually. 

    • Once done click "Finish". 

    • Eclipse will generate a basic “pom.xml” file for your project. This file contains the project configuration, dependencies, and other build settings.

Convert to Maven

To convert the project to Maven, follow the below steps:

  1. Right-click on the Java project, select Configure.

  2. Hovering over Configure will show some configure options. Out of these options, click Convert to Maven Project.

  3. Clicking Convert to Maven Project will open a Maven POM window. Click Finish on this window to continue.

  4. You will see a pop-up Identify Maven Dependencies, uncheck the Qualitia jar and click Finish.

  5. You have successfully created “pom.xml” for your project and also fetched the dependencies for the jar files.

  6. Check your project is running without any errors before uploading it to 9.0

    • Add 8.6 jar manually under <dependencies> and provide absolute path of the jar.

    • Example:

      • <dependency> 

      • <groupId>net.minidev</groupId> 

      • <artifactId>accessors-smart</artifactId> 

      • <version>1.2</version>

      • <scope>system</scope>

      • <systemPath></systemPath> 

      • </dependency>

    • Once all the dependencies are added, right-click on the project and select Run As.

    • Selecting Run As will open a list, click on Maven clean.

    • Now again go to the list under Run As and click Maven Built.

    • You can move to 9.0 if the run is completed without any errors.

    • If there are any errors, you need to resolve those to move to 9.0.

  7. Save the “pom.xml” file. 

  8. Open project.class file of your java project 

  9. Add comment <comment>maven</comment> 

  10. Close the pojects.json file 

  11. Install qualitia 9.0 server (All steps as per fresh install) 

  12. Launch server portal  

  13. Click on Update project tab 

  14. Click on Update button 

  15. Activate license 

  16. Download client form server portal 

  17. Install client  

  18. Login to qualitia 9.0

Install Jboss Plugin in Eclipse

Follow the steps to install Jboss before initiating the conversion:

  1. Go to Help on the Eclipse screen and select Eclipse Marketplace.

  2. Clicking Eclipse Marketplace will open the Eclipse Marketplace screen.

  3. Go to the Search tab on the Eclipse Marketplace screen. Type Jboss in the find section and click enter.

  4. You will see Jboss Tools 4.29.0 Final.

  5. To install Jboss Tools 4.29.0 Final, click Install on the bottom-right corner.

  6. You have successfully installed Jboss Plugin.

The Jboss helps convert all the jars used in the 8.x project into dependences. Later, it fetches all the dependencies from the maven repository and add those to ‘pom.xml.’

Add Dependencies Manually

To add the unidentified dependencies Manually follow below steps:

  • Copy the jar file name and search for that jar on the Maven Repository or directly on google and open link with Maven Repository. 

  • Copy the dependency code and paste it in your projects “pom.xml” file.  

    • Example:

      • <dependency> 

      • <groupId>net.minidev</groupId> 

      • <artifactId>accessors-smart</artifactId> 

      • <version>1.2</version> 

      • </dependency> 

  • Save the “pom.xml” file. 

💡Golden Nuggets: Best Practices for Successful Upgrade

  1. Check your project is running without any errors before uploading it to 9.0:

    • Add 8.6 jar manually under <dependencies> and provide absolute path of the jar.

    • Example:

      • <dependency> 

      • <groupId>net.minidev</groupId> 

      • <artifactId>accessors-smart</artifactId> 

      • <version>1.2</version>

      • <scope>system</scope>

      • <systemPath></systemPath> 

      • </dependency>

    • Once all the dependencies are added, right-click on the project and select Run As.

    • Selecting Run As will open a list, click on Maven clean.

    • Now again go to the list under Run As and click Maven Built.

    • You can move to 9.0 if the run is completed without any errors.

    • If there are any errors, you need to resolve those to move to 9.0.

 

Footer