This section provides some frequently asked question on WRTC Gateway application, database, and the cluster configuration through EMS.
How to view WRTC Gateway Application Code?
You can view the code of sample applications to know how certain Sonus WebRTC features are implemented as a reference when developing your custom application. When the WRTC Gateway application is open in WRTC supported browsers like Chrome or Firefox, you can right click on the page and select View page source option. This will open the application source code:
How to View Browser Console Logs?
The browser console logs helps application developers to view the diagnostic information in the console like request, response, errors, warnings, and also logs from application code. Every web browser has a different approach for accessing the console logs, you will have to check your browser specific approach to view the console logs. A few examples on how to view the logs in WRTC supported browsers like Chrome or Firefox are listed as follows:
You can press F12 button on your keyboard and select Console tab. This will open the browser console:
I have installed WRTC server but not able to ping this server?
Ensure the WRTC instance IP address is configured in DNS server. The DNS server IP must be given in
/etc/resolv.conf against the name server. Also the FQDN/IP of WRTC instance should be updated in Firewall in order to access it. Contact your IT help desk.
I have installed WRTC server but, notices some error related to the GCM service?
The following error messages appears when GCM is enabled and services are started. You can ignore the error messages.
What if the WRTC application does not come up in a VMware instance?
When the WRTC application does not come up in a VMware instance, the following exception is observed:
This exception has been observed in VMware instances due to a known issue in VMware that causes the entire file-system of the VM to become read only which prevents file writes. During WRTC application startup, a folder gets created in
/tmp directory and the contents of the WRTC fat jar are copied into this folder. When the file-system becomes read only, this cannot happen preventing the WRTC application from starting. This issue can be resolved by rebooting the VM instance.
I have mentioned the WRTC server IP on the login page but, not able to login the WRTC application
After installing WRTC, If you observe the following error while log in to the WRTC application:
You must execute the following commands to resolve the preceding error:
WRTC application does not come up due to invalid SIP Listener IP
The application will not start up if the "SIPListeningIP" and "SIPFloatingIP" attributes in
startup.json are not valid IP addresses corresponding to the WRTC node's IP. There will be an exception during the initialization of the SIP stack.
To resolve this issue, the values for these attributes need to be correctly updated in the
startup.json and WRTC application has to be restarted.
I have installed WRTC but I am not able to launch the instance?
After installing WRTC, if you have problems launching the instance and are getting the following error:
You must reset and activate the instance by executing the following command:
How can I know that Cassandra Database is running?
In case the following error occurs when restarting Cassandra you must kill the existing Cassandra process and restart it again:
I installed and started the WRTC application, but observed DB Exception error?
The startup.json file includes the wsxnodeip address which has to be the local IP on which the server is running. Cassandra IP address must be the loop back IP as the cass services will be running on the local db."CassandraNode":"127.0.0.1".
Where can I refer the logs?
The WRTC logs are located at the
How should I configure my OAUTH server?
The OAuth credentials must be picked up from the console.developers URL to login to the profile id. For more information, see OAuth Developer Account Creation.
How to View WRTC Internals in Firefox browser?
To view the WRTC internals in Firefox browser enter the following in the browser URL field:
WRTC Internals appears:
To view the internals in Chrome web browser enter the following command in browsers:
To view the WRTC internals in Opera web browser execute the following command:
Why EMS REST interface not responding when port 443 is open?
Several interfaces will share port 443, this port being open does not mean EMS REST interface has been initialized successfully. You must check the management IP address in the wrtcCloudInputs file and assign the management IP if it is not assigned and restart the LCA.
How to know that WRTC node is register successfully with EMS?
After invoking the script
./wrtcnodeinit start we can observe the state of the node as registered in the EMS. Refer to the Viewing WRTC Registered Node for more information.
Alternately, we can invoke the script
./emsRegistration.py –a register to get the following notification that the node has been registered with EMS:
You would view the following notification if the registration with EMS is not successful:
How would I know that the cluster configured through EMS is successfully pushed to WRTC?
When the cluster configuration that is pushed to WRTC node would be available as a processed file with a specific timestamp.
If the configuration has not pushed to WRTC node successfully then the processed file with the failed message, and specific timestamp would be displayed as follows:
How to configure SBC with WRTC, through EMS?
Add SBC SIP Signaling IP in SIP Peer under "Globals" in WRTC data model, along with transport type and port. For more information on cluster configuration, refer to the WRTC Cluster Configuration. After configuring SBC for the first time, if WebRTC calls are failing, ensure SRTP licence is present.
Why my Web to SIP call does not reach SBC?
Check if a route for the called number is present in the routing table. Also in "Data rows for routing", ensure that the routing label is pointing to the correct SBC. For more information on cluster configuration, refer to the WRTC Cluster Configuration.
What step shall I take if I observer 503 service unavailable from SBC?
Ensure that the WRTC IP is added to the WRTC-SBC trunk group as ingress IP prefix.
What must be added in the DTLS profile of SBC when using Firefox to make Web to SIP calls?
When Firefox is used, the following cipher needs to be added in the DTLS profile in SBC - tls_ecdhe_rsa_with_aes_128_cbc_sha.
How to check the status for ICE and DTLS profile?
To see the status of ICE and DTLS, in config mode check for the following:
This must be successful for all media streams.
What if there is any delay in call setup?
If there is any delay in call setup, check if the STUN and TURN servers are reachable and the services are enabled.
Why is WebRTC server is not issuing registration for WebRTC logins with SIP Registration info?
This is due to one of the following reasons:
- SIP registration of a SIP signalling profile for an enterprise must be enabled.
- Using same email ID for third party login. Try to use a different email ID or append a digit to login with the same email ID.
No routes for the numbers getting allocated. I
n the WRTC Data Model, select Globals > Route. Configure the route as:
How do I check for a specific user in the userprofile schema for an allocated number in the Cassandra DB?
Execute the following command to search for a particular user profile in the Cassandra DB:
How to check all the userprofile data in Cassandra DB?
Execute the following command to check for all the user profiles from the Cassandra DB:
How can I configure routes for SIP registration and SIP calls?
To configure routes for SIP registration and SIP calls, in the WRTC Data Model, select Globals > Route.
For SIP Calls:
Following route fields must be configured as:
Prefix: prefix of the dialed number.
Domain: called domain.
Enterprise: Name of the calling enterprise.
For SIP Registrations:
Following route fields must be configured as:
Prefix: prefix of the allocated number.
Enterprise: enterprise name from which the user has logged in.
How can I update the EMS patch on Unity Explorer?
First download the required file (for example,
UE.V02.00.02A001.tar.gz) from SalesForce.
To update EMS patch on Unity Explorer:
Enter the following command to stop the EMS server.
- Copied the patch to
/tmplocation on the EMS server.
Enter the following command to navigate to
Enter the following command to unzip the patch file and deploy it:
Enter the following command to clean-up after running deploying the patch:
Enter the following commands to navigate to the following location and start the EMS server: