RDK Resources
[*RDK Preferred*]
Code Management Facility
RDK Forums
[RDK Conferences]
RDK Support
Archives
Papers & Presentations Archive
CDRouter is a comprehensive test tool for Cable/DSL/SOHO/Edge and wireless routers and other similar IP devices. The test suite contains several types of tests including functional, conformance, negative, denial of service, and scaling. CDRouter test suite simulates a networking environment by creating LAN clients, providing an ISP connection to the device under test, and exercising different protocol and traffic flows. CDRouter can create IP hosts and services that appear to be operating out in the Internet.
Previously, we utilized the CDRouter UI to trigger CDRouter test executions and review CDRouter execution results. However, after the integration of CDRouter into Automatics, we now have the capability to execute all 1.0 ,3.0 test cases and CDRouter test cases exclusively through Automatics.
APIs available
https://support.qacafe.com/cdrouter/cdrouter-web-api/packages#list-packages
2. To get the list of test scripts/test names in a package, we can use webAPI mentioned in below link
https://support.qacafe.com/cdrouter/cdrouter-web-api/packages#get-a-package
3.To get the device configs, we can use webAPI mentioned in below link
https://support.qacafe.com/cdrouter/cdrouter-web-api/devices#list-devices
4.To get the test configs, we can use webAPI mentioned in below link
https://support.qacafe.com/cdrouter/cdrouter-web-api/configs#list-configs
APIs available
Inputs to be passed are package name, device config and test config
On success, it will return 200 response code and status of execution will be Pending initially.
We can think of background thread checking for updates of running jobs from cdrouter.
https://support.qacafe.com/cdrouter/cdrouter-web-api/jobs#get-a-job
3. To get execution result of job, we can use webAPI mentioned in below link. The input to the restapi result id and in output we overall status count of all test cases.
"loops": 5, "tests": 2552, "pass": 0, "fail": 1150
APIs required
Existing Pages | Purpose | Changes Expected |
---|---|---|
Trigger Execution Manually Page | User can select CDRouter packages trigger executions | New Drop Down for selecting CD Router Tests via Test Source |
Job Manager Page | User can view the progress of CD Router package executions - Each job will show the status of single package | No change in UI |
Execution Results Page | To view overall execution results like Total script count, and its pass and fail count | No change in UI |
Detailed Execution Results Page | To view the execution results of each test script (in cd router each test case contains only one step) | No change in UI |
Manage script page | To map cdrouter package with automatics automation id | No change in UI |
From the Trigger Execution Manually Page, user can select the Cd Router tests for execution.
Adding 2 new tables to automatics DB:
https://support.qacafe.com/cdrouter/cdrouter-web-api/.
Following diagram shows the interaction among Automatics CD Router service and CD Router Automation Engine
Note: Before Triggering a testcase user has to enable the corresponding package by navigating to job manager page and enable the package and click on edit script details button and map the device.(All the steps are explained under JOB Manager page please go through it for more clarification)
1. Navigate to the Automatics URL, login and select 'Trigger Execution Manually' from the 'Manage Trigger Drop-down'.
2. Enter the build name and Select the Execution Environment Type, quick test if needed. Click on next button if all the mandatory fields are added.
3. Select the corresponding Automation ID and click on Next button.
4. Enter the Device mac address and click on Trigger Job button you can see a pop-up that execution is triggered successfully.
Manage Script Page
Steps to select only CD router testcases.
1. Navigate to manage scripts page by selecting 'Manage scripts' under Test Manager drop down.
2. Under Filter drop down scroll till 'Select Test Source' tab and select 'CDRouter' from the drop down and click on filter button.
3. User can see all the CDRouter testcases that are present.
Editing TestScript Details of CDRouter testcases
1. Navigate to Manage Scripts page under 'Test Manager' drop down and filter the CDRouter Testcases following the above steps. (ManageScripts →filter → Select CDRouter under 'Select TestSource' → click filter)
2. Now click on the Edit Script Details Icon corresponding to the testcase to be edited.
3. Now user can see a pop-up, check all the mandatory fields to entered/changed. update the corresponding fields and click on next button.
4. Under 'Select Test Source' drop down user should select CDrouter.
5. User should enter the mandatory fields and click save button to save the changes.
Job Manager
When the user triggers the job and navigating to the Manage Test Trigger page, user can verify the job status depending on their testcase (RDKV or RDKB) and selecting the Job Manager button can able to see the triggered Job.
To find the execution results by clicking this button Once testcase triggered successfully. Following image will be available.
User can find the full execution logs by clicking this button. . User can get the full execution logs and find out the pass and failure steps in detail.
By clicking this icon we can see the child Jobs name. After that click on this icon . Then CDRouter Execution logs will be available in the Jenkins icon. We can verify pass and failures of all the steps.