Jenkins

You need to install Jenkins in order to execute offline package using Jenkins.

Jenkins Installation

Follow the below-mentioned steps to install Jenkins.

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

   The default port is 8080.
   

   If Jenkins version is greater than 1.651 then execute the following command:

   java -Dhudson.model.DirectoryBrowserSupport.CSP= -jar “<Jenkins installation location>\jenkins.war”.

   The reason for the change is Jenkins 1.625.3 introduced the Content-Security-Policy that disables DirectoryBrowserSupport due to which Qualitia HTML report cannot get published.

   Please note that Jenkins needs to be started using above command only. If you use Jenkins as service, you won’t be able to see the browser during test case execution.

   
   Post successful execution of the command, a message is displayed confirming Jenkins installations in the Command Prompt window.

5. Open URL:http://localhost:8080.
   This launches Jenkins’ home page.

If client and server are two different systems then the client should be run manually using the command prompt with the administrator privileges (i.e. Run as Administrator).

Jenkins Configurations

Once installed successfully, configure Jenkins for execution following below-mentioned steps.

1. Navigate to URL:http://localhost:8080.
   This launches Jenkins homepage.
2. Go to Jenkins > Manage Jenkins > Manage Plugins.
3. Install HTML Publisher Plugin, Email-Ext Plugin, and EnvInject Plugin.
4. On Jenkins home page, go to New Job.
5. Enter the job name as per user understanding.
6. Select the Build a free-style software project option. 
7. Click OK.
   The user will be directed to New Job configuration page.
8. Scroll down to Build section and select the first option.
9. Click the Add Build Step button and select Execute Windows batch command.
   The below screen appears.
10. Update the commands that lead to the location and execution of QualitiaOffline.exe.
    For example: <drive name where offline package is saved>:\cd <location where the offline package is saved>\Offline package QualitiaOffline.exe.
11. From Add Build Step button, select Inject Environment Variables.
     This step has to be followed by step 10, otherwise Qualitia Reports will not be visible through Jenkins.
12. Update the path for the file qer.properties along with the filename.
    This file is generated and saved where offline package is saved during execution of the test cases. For example; <Offline Package location>\qer.properties
13. Go to Post-build Actions section.
14. Click Add Post-build action and select Publish HTML Report.
    Below screen appears.
15. Update the values under respective columns as shown below.
16. Select Jenkins > Manage Jenkins > Configure System.
17. Scroll down to the Email Notification section.
18. Click the Advanced tab.
19. Enter valid values for the respective fields.
    Below is the screenshot for example.
20. Select the Test Configuration by sending test e-mail check box and enter the valid email address.
21. Click Test Configuration button.
    You would be notified on the successful execution of step 21.
22. If there is any error message, recheck the setting values.
23. To enable this email notification for a Project/Job, navigate to Project Configuration.
24. Scroll down to Post Build Actions section.
25. Click Add post-build action and select Email Notification.
26. Provide recipient details.
27. Click Save.