Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  • Upgrade the QAS Server and QAS ClientConvert 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

...

Complete the readiness  

...

If User want to upgrade with Basic java project, they can skip the maven conversion and directly do the update project from server portal. ( This will be irreversible user cannot opt for maven project once upgrade is completed) 

...

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 custom action 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

...

ensure that the project you want to convert is selected 

    • .

    • 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. Save the “pom.xml” file. 

  7. Now open the project.class file of your java project. 

  8. Add a comment <comment>maven</comment> and close the pojects.json file. 

...

  1. Now Install Qualitia 9.0 Server. Refer Installation and Setup for more details.

  2. Launch server portal and click Update project tab. 

  3. Click Update

  4. Activate the license. 

  5. Download QAS - Client form the server portal. Refer Installation and Setup for more details.

  6. Once QAS - Client installation is complete 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.

Info

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 this the Maven Repository or directly on google and open link with Maven Repository Repository. 

  • Copy the dependency code and paste it in your projects  pom.xml file Example dependency code (for understanding) projects “pom.xml” file.  

    • Example:

      • <dependency> 

       
      • <groupId>net.minidev</groupId> 

       
      • <artifactId>accessors-smart</artifactId> 

       
      • <version>1.2</version> 

      • </dependency> 

  • Save the `pom“pom.xml` xml” file. 

  • Open project.class file of your java project 

  • Add comment <comment>maven</comment> 

  • Close the pojects.json file 

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

  • Launch server portal  

  • Click on Update project tab 

  • Click on Update button 

  • Activate license 

  • Download client form server portal 

  • Install client  

  • Login to qualitia 9.0 

💡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.

🔧 Got trouble? Let’s fix! 

  • Error: Failed to execute mojo org.apache…

  • Resolution: Add space in the pom.xml file where the error is occurring and save the file.