...

A smart debugger greatly enhances the effectiveness of test case development by simulating test execution in debug mode. Users can strategically place breakpoints within test steps, allowing Jenkins to pause execution at these designated points. The test steps which has breakpoint won't be executed until the user resumes the test execution. For the Automation Developers, while developing the testcase itself they can use this testcase debugger feature for validating the testcases. It also makes the testcase development and execution more efficient by giving additional options while executing the testcases. This will provide the capability to do unit level testing over the testcases.

Configurations in Orchestration

...

1. Copy the jar file to the VM where Debugger Service to be deployed.
2. Create 2 directories debugger-service and logs in VM.
3. Copy the jar file to debugger-service directory.

4. Run the below command from debugger-service directory to bring the Debugger Service up in the VM.

   nohup java -XX:+UseSerialGC -Dlog4j2.formatMsgNoLookups=true -jar debuggerservice-0.0.1-SNAPSHOT.jar > logfile.log 2>&1 &

5. debuggerservice.log file will be created in the logs directory and we can check the real time logs of the Debugger Service using this file.

Steps for Smart Debugger Execution

1. In step builder page at the top, developer can find a debugger icon. Click on the icon to open the testcase debugger popup.

2. In the debugger popup, developer can see configuration options to start the execution.


After starting the execution, click on EXECUTION LOGS panel to see the execution logs.
Image Added

3. At the bottom of the page, automation developer can see the available steps from the testcase loaded in table.

4. Functionalities:

    Status involved in step execution:
        * YET_TO_START
        * IN_PROGRESS
        * PAUSED
        * PASS
        * FAIL

    * Output: Step output will be added in output column of the table.

    * By using Checkboxes at the left side, automation developer can select/unselect the steps for the execution. So, if automation developer wants to execute sepecific steps they can select the steps on demand for the execution.

    * Click on PAUSE button to pause the execution and use the PLAY button to resume the execution.

    * Automation Developers can see the Jenkins execution logs using the Jenkins icon at the top right corner.

Image Added

For the test execution team, separate dashboard was there under Manage Test Trigger menu. This option is available under Manage Test Trigger tab → Test Case Debugger

Image Added

To start the debugger execution, please follow the below steps: 

1. Select Testcase Type

    * Scriptless - To load the Scritless testcases (i.e. created from Build Testcase page)
    * Scripted - To load the scripted testcases (i.e. Testcases that has its own scripts in Test projects).

2. Select Environment Type and enter valid Device Mac of the Rack Device.

3. Upon the previous inputs Testcase IDs will be populated in Test case ID select box. Select the test case from the drop down.

4. After giving all the inputs click on Load Steps button at the left side.

5. After loading the steps into the table present in Available Steps division, click on the START button to start the execution.