Versions Compared

Key

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

...

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

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

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

  10. Launch server portal and click Update project tab. 

  11. Click Update

  12. Activate the license. 

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

  14. 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:

...

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

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

...