...
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 to 9.x
Run the Readiness Utility.
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.
The migrated custom action projects will be with _java file name. To upgrade from Qualitia 8.x to 9.0 x convert the Java project to maven 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 are getting identified get identified.
Once done check the libraries which are unidentified except Qualitia jar jar.
If some jars remain unidentified unidentified, add them manually.
Once done click "Finish".
...
Eclipse
...
In readiness utility, you will see all the
Advantage:
When we push the basic project to SVN or any version control, all jars are also pushed and the repo size increases. Maven will help keep the repo size lighter as the jars will not be pushed.
The fetching time for the project will be reduced
Upgrade Steps:
...
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).
...
Convert Java project to maven using JBoss Plugin in Eclipse
...
Open Eclipse and navigate to the Java 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 are getting identified
...
Once done check the libraries which are unidentified except Qualitia jar
...
If some jars remain unidentified
...
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.
...
...
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:
Right-click on the Java project, select Configure.
Hovering over Configure will show some configure options. Out of these options, click Convert to Maven Project.
Clicking Convert to Maven Project will open a Maven POM window. Click Finish on this window to continue.
You will see a pop-up Identify Maven Dependencies, uncheck the Qualitia jar and click Finish.
You have successfully created “pom.xml” for your project and also fetched the dependencies for the jar files.
Save the “pom.xml” file.
Now open the project.class file of your java project.
Add a comment <comment>maven</comment> and close the pojects.json file.
Now Install Qualitia 9.0 Server. Refer Installation and Setup for more details.
Launch server portal and click Update project tab.
Click Update.
Activate the license.
Download QAS - Client form the server portal. Refer Installation and Setup for more details.
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:
Go to Help on the Eclipse screen and select Eclipse Marketplace.
Clicking Eclipse Marketplace will open the Eclipse Marketplace screen.
Go to the Search tab on the Eclipse Marketplace screen. Type Jboss in the find section and click enter.
You will see Jboss Tools 4.29.0 Final.
To install Jboss Tools 4.29.0 Final, click Install on the bottom-right corner.
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
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.