This lab guide is for use with the yarnlab dCloud for wrangler_ “Webex Dedicated Instance (DI) Wrangler tool (partnering with Yarnlab)” https://dcloud2-rtp.cisco.com/content/demo/915839 (note that it is availible in other regions also)
The test_mate lab guide below uses the same VM but you do not have to complete the wrangler_ lab as a prerequsite to this lab
Test_mate PVT
Test_mate is an automated UC testing platform, providing Migration, Assurance and Accreditation testing. This lab will be utilising the PVT ( Postchange Verification Testing)
We are going to set up Test_mate to control Two Jabber Clients on the Source Cluster to perform Onnet calls and to simulate incoming and outgoing PSTN calls.
To simulate a remote PSTN endpoint, a pretend PSTN configuration with a fictitious PSTN number will be created on the Target Cluster and a sip trunk between them.
Note: It's recommended to have a remote session with ad1 to perform Test_mate configuration in firefox. Once Test_mate is controlling the Jabber phones, wkst1 and wkst2 will be displaying screen pops and playing sounds.
Configuration on Target CUCM
Procedure
Configure the following Partitions on the Target Cluster
Partition | Description |
PT_TestmateIncoming | PT_TestmateIncoming |
PT_TestmateOut | PT_TestmateOut |
PT_TestmateDN | PT_TestmateDN |
Configure the Following Calling Search Spaces on the Target Cluster
Calling Search Space | Partition |
CSS_TestmateIncoming | PT_TestmateIncoming |
CSS_TestmateOut | PT_TestmateOut |
CSS_TestmateInternal | PT_TestmateDN |
Configure a new Siptrunk on the Target Cluster
Field | Value |
Product | SIP Trunk |
Device Protocol | SIP |
Device Name | Testmate_Target_source |
Device Pool | default |
Remote-Party-Id | Uncheck |
Asserted-Identify | Uncheck |
InBound Calls – Calling Search Space | CSS_TestmateIncoming |
Sip Destination Address | cucm1.dcloud.cisco.com dest port 5060 |
Sip Trunk Security Profile | Non Secure Sip Trunk Profile |
Sip Profile | Standard SIP Profile |
Create CTI Routepoint on Target Cluster
Field | Value |
Device Name | Testmate_T_RP |
Device pool | Default |
Calling Search Space | CSS_TestmateOut |
Create CTI Routepoint Line 1 on Target Cluster
Field | Value |
Directory Number | 4201 |
Route Partition | PT_TestmateDN |
Alerting Name | +61999994201 |
Calling Search Space | CSS_TestmateInternal |
Display Caller id | +61999994201 |
External Phone Number Mask | +61999994201 |
Create CTI Routepoint Line 2 on Target Cluster
Field | Value |
Directory Number | 4202 |
Route Partition | PT_TestmateDN |
Alerting Name | +61999994202 |
Calling Search Space | CSS_TestmateInternal |
Display Caller id | +61999994202 |
External Phone Number Mask | +61999994202 |
Create Translation Pattern on Target Cluster
Field | Value |
Translation Pattern | \+6199999.42XX |
Partition | PT_TestmateIncoming |
Calling Search Space | CSS_TestmateInternal |
Called Party Transformation | PreDot |
Create Route Pattern on Target Cluster
Field | Value |
Route Pattern | \+1972555XXXX |
Partition | PT_TestmateOut |
Gateway/Route List | testmate_target_source |
Call Classification | OffNet |
Calling Party Transformation | Ticked Use Calling Party’s External Phone Mask |
Create Application user on Target Cluster
Field | Value |
User id | Testmate_t_jtapi |
Password | dCloud123! |
Available devices | Associate Testmate_T_RP |
Add following Access Control Groups | Standard Audit Users Standard CCM Super Users Standard CTI Allow Call Monitoring Standard CTI Allow Call Park Monitoring Standard CTI Allow Control of All Devices Standard CTI Allow Control of Phones supporting Connected Xfer and conf Standard CTI Allow Control of Phones supporting Rollover Mode Standard CTI Enabled Standard CTI Allow Calling Number Modification |
Configuration on Source CUCM
Create Sip Trunk on the Source Cluster
Field | Value |
Product | SIP Trunk |
Device Protocol | SIP |
Device Name | Testmate_source_target |
Device Pool | dCloud-DP |
InBound Calls – Calling Search Space | dCloud_CSS |
Remote-Party-Id | Uncheck |
Asserted-Identify | Uncheck |
Sip Destination Address | cucm-p.dcloud.cisco.com dest port 5060 |
Sip Trunk Security Profile | Non Secure Sip Trunk Profile |
Sip Profile | dCloud Standard SIP Profile |
Create Route Pattern on Source Cluster
Field | Value |
RoutePattern | \+619999942XX |
Partition | dCloud_PT |
Gateway/Route List | testmate_Source_target |
Call Classficaiton | OffNet |
Calling Party Transformation | Ticked Use Calling Party’s External Phone Mask |
Create Application user on Source Cluster.
Field | Value |
User id | Testmate_s_jtapi |
Password | dCloud123! |
Add following Access Control Groups | Standard Audit Users Standard CCM Super Users Standard CTI Allow Call Monitoring Standard CTI Allow Call Park Monitoring Standard CTI Allow Control of All Devices Standard CTI Allow Control of Phones supporting Connected Xfer and conf Standard CTI Allow Control of Phones supporting Rollover Mode Standard CTI Enabled Standard CTI Allow Calling Number Modification |
Configuration of Yarnman Admin Interconnects
We will create two new CUCM interfaces with the jtapi users we created above for the Source and Target Cluster. These accounts will be used to control the Jabber Endpoints and CTI Route point.
Note: If you have previously configured yarnman, we can’t reuse the existing interfaces as the CUCM administrator account doesn’t allow control of CTI route points.
Add a 2nd interconnect service. Click on Services > Add Service > Interconnect Service.
Call the service name Interconnect Service2, Bind to standalone, and press submit.
Confirm you have two interconnect services
Note: you may only have 1 interconnect service if you haven’t completed the wrangler lab; repeat the above to add another.
Configure jade-berlin
Click on Nodes > Standalone.
Scroll down to click on Download Jtapi/Jar
Use the publisher address of the source cluster.
Restart the Jade-Berlin service
Configure CUCM interfaces
Create two new CUCM interfaces with the following details
Interface Name | Description |
Testmate_source | 198.18.133.3 |
Testmate_target | 198.18.133.23 |
Click on Interfaces > Add Interface and select CUCM / Cisco Unified Commutations Manager/ CallManager
select CUCM / Cisco Unified Commutations Manager/ CallManager
Associate the interface to the Arm. Click on Arm Bindings
Select standalone and press bind to arm
Press Updater/Set Credentials
Enter in the details of the Application user created earlier and press use for all interfaces, followed by submit
Interface Name | Ip Address | Username | Password |
Testmate_source | 198.18.133.3 | Testmate_s_jtapi | dCloud123! |
Testmate_target | 198.18.133.23 | Testmate_t_jtapi | dCloud123! |
Press test connection, Ensure that you click on the blue ribbon once completed, as this will ensure that the AXL version is populated.
Configure Terminator Service
Test_mate uses this service to send and receive RTP using a CTI Routepoint. The IP address is required as this will be bound to the RTP packets. It’s possible to have Multiple Arms with different IP addresses in complex networks.
Click on Services > Add Service > Terminator Service
Select standalone for the node/arm, the IP address for Test_mate (if you are using the prebuild VM, this will be 198.18.133.6), set the last port number to 6709, and press submit
You can ignore the message about the mismatched address.
Add Testmate App
Add a new service of Testmate App
Click on Services > Add Service > Testmate App
Click on Bind to standalone Node/Arm, and select central DB-Only Authentication policy.
Add the testmate app to the Yarman Proxy service
Click on Services > Standalone Yarnman Proxy.
Click on Service Routing
Click on Add Yarnapp > Testmate App
Click on Submit to save the changes.
Configure Testmate App
Navigate to the Testmate App
Set the CTI route point used by Testmate
Scroll down and click on CUCM instances > Click on testmate_target
Select the testmate_t_RP route point we created earlier and click add.
The page will reload and show the two DN’s of the CTI route point on the Target cluster.
Note: If you cannot see the CTI Routepoint from the dropdown, make sure the Application user has been associated with the CTI route point in CUCM
Start Cisco Jabber clients
Connect to Workstations 1 and 2 and start each jabber client
First PVT Test Plan
We are now ready to create our first test plan.
The first test will use the default tests to make an incoming and outgoing onnet and PSTN call.
Navigate to the Testmate App > Test Plans > Create Testplan
Enter a name for the test, in this case, First Test; select Post Verification Testing from the dropdown and click Submit.
Click on the devices tab.
Select testmate_source
Select dCloud-DP
Click in search for devices by name.
Search for the two jabber devices and press add devices
Press Check status; in this example, we have added the wrong jabber device and will add the correct one.
Remove the offline device.
Press Save only
Click on Test Cases, scroll to external call test cases, and add the remote Endpoint we created earlier (the cti route point)
Scroll down and press Save and Run; when the screen refreshes, press Test Cases.
You can watch the progress of the tests; each test step will be marked with a green tick or a red cross. Further detailed steps can be viewed by checking for calling/called numbers and other test criteria.
Click on the results tabs once the test is finished (some tabs can only be accessed at the end of the tests)
Note: you may need to press refresh to get the latest results
Click on the report to produce a detailed test report that can be exported as a CSV or xls.
Second PVT Test Plan
We will Create another test plan with more compressive tests to check for
DTMF transmission and reception
Supplementary features such as conference, pickup and park
Media statistics to/from the CTI route point via the Terminator service
Some test cases require three devices (e.g. Device C in the test steps). Connecting another Jabber client via dCloud using Cisco-anyconnect VPN from your desktop or laptop is possible. Refer to the dCloud guides for VPN connectivity.
We will use the External Call Test Cases, allowing us to test the PSTN and simulate the 3rd endpoint. This test is helpful for both troubleshooting and commissioning a new site.
Create a new test as type Post Verification Testing
Select the following test
Make and Receive call
Call Pickup Call
Call Park Call
Select the remote endpoint Testmate_t_RP:4201 @ Testmate_target and select the following tests
Codec G711 64K
Make call
Receive Call
Transfer Internal call externally
Transfer external call internally
Forward Internal call externally
Forward external call internally
Forward external call externally
Continue Selecting
Conference call
Call pickup call
Call Park call
Scroll down to the Media terminator section and select the Terminator service we created earlier and select the following
DTMF signalling – Test DTMF Signalling Before and after hold
A and B party hold and resume – A then B party Hold/Resume
Note: Enabling Check Packet Statistics will show packets from the Terminator service. However, there will be no packet statistics from Jabber or Phones via an expressway.
Press Save Only, scroll back to the top of the page, and select devices.
Add the 2 Jabber phones from the testmate_source CUCM and press Save and Run.
Press Test Cases to monitor the progress; the test will take about 8 minutes to complete. You may hear music from the terminator service via the Remote desktop session.
As we have enabled DTMF testing before and after putting the call on hold, Test mate will randomly select a 4-digit number to transmit and will be checked by the CTI route point to validate it matches.
Call Park DN that was used when placing the call on Park
Testmate instruction jabber to create a 3-party conference with another Jabber endpoint and a PSTN endpoint
CUCM Target bulk load files
Optional use of the import/export function within CUCM to load most of the config required on the Target Cluster. Use Workstation 2, which will have the tar file named testmatetarget.tar
The Import/Export file contains the following.
Partitions
Calling Search Spaces
Route and Translation pattern
Sip Trunk
CTI route point*
Note: There is a known issue with the Importing of CTI Routepoints with DN’s in cucm 12; you will need to manually add the DN’s to the route point device and create the Application user.
Navigate to the Bulk Administration menu on the Target CUCM
Click Add New
Browse to the file tetmatetarget.tar, select import/export as the file type and select the transaction as Import Configuration
Once the file has been updated, navigate to the Import/Export menu in Bulk Administration and select Import.
Select the file that was uploaded
Press Select all to check all the configuration items and select Run Immediately before pressing Submit.
Verify the configuration items have been added to the Target CUCM, and continue by manually adding the Route point DN’s and application user
Troubleshooting
The calls are not working.
Check SIP Trunk on the source cluster is showing Full Service
Check Route Pattern added to use this trunk
Try resetting the sip trunk on both Source and Target CUCM clusters.
Unable to select External Endpoint
Make sure the CTI Route point is associated with the testmate_t_jtapi application user.
The correct permissions are applied to the application user
CTI route point selected and showing in CUCM Instances > Testmate_target
Unexpected jtapi error
Redownload the jtapi.jar via jade-Berlin
Restart the jade-Berlin service
No packet statistics on terminator service
You may need to allow the UDP port range configured on the UFW firewall on Migration Assistance.
From the AD1 server, use Putty to connect to ma.dcloud.cisco.com ( or 198.18.133.6 )
Issue the command sudo ufw allow 6700:6709/udp