Page Comparison

Qualitia seamlessly supports Jenkins, an open source automation server written in Java. It is a cross-platform, continuous integration, and continuous delivery application that increases your productivity. It integration with Continuous integration tools like Jenkins, TeamCity, and Bamboo.  It enables developers to find and solve defects in a code base rapidly and to automate testing of their builds. If your test case is for mobile applications, ensure that the Appium Server is up and running on the designated node when executing test

When you want to execute your test cases using CI tools.

...

1. Download Jenkins and JRE 6, 7/JDK 1.6, 1.7.
2. Install JRE 6, 7/JDK 1.6, 1.7.
3. Open the Command Prompt window and browse to the bin folder where JRE 6, 7/JDK 1.6, 1.7 exists.
4. Execute command java -jar "<Jenkins installation location>\jenkins.war" httpport=<port number>.

Default port is 8080.
Image Removed
Post successful execution of command, a message is displayed confirming Jenkins installations in the Command Prompt window.

1. Open URL:http://localhost:8080.

This launches Jenkins' dashboard.

...

Once you have installed Jenkins, you can proceed for Jenkins configurations.

1. Open URL:http://localhost:8080.
2. Enter the Administrator password.

Take the Administrator password from the initialAdminPassword file located in the .jenkins\secrets folder.

1. Click Continue.
2. Jenkins asks to install plugins. Skip to install plugins for now clicking the X icon from the top right corner of the window and click Start using Jenkins button.
3. Go to Jenkins > Manage Jenkins > Manage Plugins.

Image Removed

Access the Available tab.

A list of available plugins is displayed to select and install.

1. Select HTML Publisher Plugin, Email Extension Plugin, Environment File Plugin, and Environment Injector Plugin.
2. Click Install without Restart.

Post successful installation; go to the Jenkins' dashboard.

1. Click New Item.
2. Enter the item name, select Freestyle project, and then click OK.

You are navigated to new job configuration page.

1. In the Build section, click Add build step and then select Execute windows batch command.
2. In the Command text box, enter the command to execute qualitia-offline.xxxx.jar.

For example: <drive name where offline package is saved>:\cd<location where offline package is saved>\Offline package qualitia-offline.xxxx.jar
d: cd D:\Qualitia\offline packagequalitia-offline.xxxx.jar

1. Click Add Build Step and select Inject environment variables.

Note: This step has to be followed by step 12; otherwise Qualitia Reports will not be visible through Jenkins.

1. Update Properties File Path for the file qer.properties along with the file name.

This file is located in the Offline Package. For example: <Offline Package location>\qer.properties

1. In the Post-build Actions section, click the Add Post build action button and select Publish HTML reports.
2. In the Publish HTML reports section, enter the values as mentioned below:

• HTML directory to archive: $qualitiareportpath
• Index page[s]: $reportfilename
• Report title: Qualitia Report
• Select the Keep past HTML reports check box.

1. Click Save.
2. On the top left corner of the screen, click Jenkins > Manage Jenkins > Configure System.
3. In the E-mail Notification section, click the Advanced button and fill up the information that includes;

• SMTP server,
• Default user e-mail suffix,
• Select the Use SMTP Authentication check box,
• Enter User Name,
• Enter password,
• Select the Use SSL check box,
• SMTP port,
• Reply-To Address, and
• Charset

Below is an example for reference.
Image Removed

1. Select the Test configuration by sending test e-mail check box, update the e-mail address and click Test Configuration.

System notifies in case of any errors. Recheck the settings in case of any errors. Refer to the screenshot below for correct values of Extended E-mail Notification section.
Image Removed
Note: Multiple email addresses can be added by separating them using ','. Subject and content of the email can be changed as per your company requirements.

1. Click Save.
2. To enable this email notification for any project, from Jenkins' dashboard, click the project name and click Configure in the left pane.
3. In the Post Build Actions section, click Add post-build action and select Editable Email Notification.
4. Click Advanced Settings button.
5. Click the Add Trigger button and select the status from the list for which you wish to get notifications.
6. Select the status for which you wish to receive the email notifications.
7. Click Save.

...

Once all the settings are configured successfully, you can proceed to execute the test cases and view reports respectively.

1. Access Jenkins' dashboard.
2. Click the down arrow near project name and then click Build Now.

Image Removed
You can view the complete build history in the left pane under Build History.
Image Removed

1. User will also see execution of the Test Cases involved in the Offline Package.
2. Once the build is successfully generated, click > Qualitia Report.
3. Qualitia Offline Package execution report is displayed in the browser.

Image Removed

1. User can view earlier reports by selecting the respective Build and going to Qualitia Report of that build.
2. User can click on the zip link to download the zip of the Qualitia Report folder/files.

...

The Parallel Execution approach works on Linux. You need to install plugins mentioned below that help in executing test cases.

• xvfb plugin for Jenkins (https://wiki.jenkins-ci.org/display/JENKINS/Xvfb+Plugin)
• Build Flow Plugin for Jenkins (https://wiki.jenkins-ci.org/display/JENKINS/Build+Flow+Plugin)

Once both the plugins are installed,

1. Create a job with a suitable name. For example: Smoke_Suite.
2. Select "Build Flow" from the options and click Ok. It takes you to the Configure section of the Build Flow plugin.
3. Go to Build Triggers and add your script as mentioned below;

parallel(
{build("Smoke_Firefox")},
{build("Smoke_chrome")}
)

...

1. 1. Open the project configuration and select the Start Xvfb before the build, and shut it down after check box.
   2. In the Execute Shell text box under the Build section, run the qualitia.offline.jar. Refer to the command mentioned below.

cd /home/qualitia/QualitiaOffline
java -jar qualitia-offline-3.9.1.jar smoke.propertiessbrowsertype=googlechrome ScreenCaptureMode=BROWSER

It is recommended to keep the ScreenCaptureMode as BROWSER when running parallel executions.
Execute Tests in Parallel
Once offline jobs and respective settings are configured successfully, you can execute tests in parallel executing the Build Flow accordingly. As per the example mentioned above, this executes both "Smoke_Firefox" and "Smoke_Chrome" concurrently.
Once execution is completed, you can go to reports on the build flow job and check the results. , you must set the CI_Tool property in the qualitia.properties file accordingly. 

If your test case is for mobile applications, ensure that the Appium Server is up and running on the designated node when executing test cases using CI tools.