Note1: Troubleshooting articles are only available in English.
Note2: The Rainbow WebRTC Gateway is available for General Availability for OmniPXC Enterprise and since Monday, October 15 for OXO Connect and OXO Connect Evolution.
This General Availability applies only for OXO Connect & OXO Connect Evolution as "stand-alone" PBX. Do not install the WebRTC gateway on an OXO Connect or OXO Connect Evolution that is networked with another PBX. More details on the topologies will be published soon.
- Article moved from FAQ/Early Adopter Space to FAQ/Rainbow WebRTC gateway.
- Information about "how to report an issue" has been updated.
Due to a future control on the server side that requires an identifier introduced in this WebRTC gateway version 1.67, existing WebRTC gateways whose version < 1.67 must be upgraded to this new version before October 28.
Once the WebRTC Gateway, PBX Sip trunk and Virtual ressource (REX on OmniPCX Enterprise, AnyDevice on OXO Connect and OXO Connect Evolution) are configured and your deskphone is well associated to your Rainbow account you should have in your Rainbow Web/Desktop client following new menu:
Menu to choose your device to make phone calls (the devices list depends of what you have defined into your profile):
1. Configuration check
from version 1.66 the SSH access is deactivated. If you need to activate/deactivate it you have to run following commands (from version 1.67): mpssh ON|OFF
1.1 Config files:
Once you have executed both scripts mpnetwork and mpconfig you can check the configuration in following file /etc/rainbow-mp.cfg.
This can also be checked with the command mpshow
The scripts configure the right values into following configuration files:
1.2 Log files:
Two logs files are generated, one for otlitemediapillargateway and one for janus-gateway-mediapillar:
Please provide the config and the logs files when you open a support request.
2. Check WebRTC gateway status and connectivity
2.1 The WebRTC Gateway runs 3 different services for the connection to Rainbow and to the PBX.
2.1.1 - Check their status
you can run following command
sudo service otlitemediapillargateway status
sudo service janus-gateway-mediapillar status
sudo service kamailio status
The "disabled" status from the answer of the status of otlitemediapillargateway is an indication for the autostart of this service and not the status of the service itself
Loaded: loaded (/lib/systemd/system/janus-gateway-mediapillar.service; disabled; vendor preset: enabled)
2.1.2 - Restart the services
sudo service otlitemediapillargateway restart
sudo service janus-gateway-mediapillar restart
sudo service kamailio restart
2.1.3 - Restart the server
2.2 Check WebRTC gateway connectivity to Rainbow cloud.
The command mpcheck will execute some connection tests to Rainbow cloud. The Network configuration and the access to NTP, DNS, Proxy, PBX, TURN server are checked.
The command mpcollect will save in addition to the mpcheck results some information about the WebRTC gateway (HW, CPU/RAM usage, installed linux packages, running services, etc...). The resulting output file is located by default in $HOME/mpcollect.tgz
2.3 Check that the Rainbow phone numbers of the user are registered into the WebRTC gateway
a) you can run following command:
sudo /usr/sbin/kamctl ul show
b) In case you don't see your device restart the Rainbow agent:
- OmniPCX Enterprise with following command:
dhs3_init –R RAINBOWAGENT
- OXO Connect & OXO Connect Evolution
Rainbow activated button in OMC Rainbow menu
c) and last step is then to restart the Kamailio service from WebRTC Gateway
sudo service kamailio restart
Note: OmniPCX Enterprise and OXO Connect & OXO Connect Evolution troubleshooting information can be found in the TC linked to WebRTC Gateway Installation guide.
3. How to report an issue
The proper working of the VoIP Calling functionality depends on 3 elements:
- PBX configuration:
- for the user, configuration of a virtual resource (REX for OmniPCX Enterprise or AnyDevice for OXO Connect & OXO Connect Evolution).
- SIP trunk configuration.
- WebRTC gateway activation for PBX.
- granting a Business or Enterprise license to the user.
- linking the Rainbow Account with the PBX phone extension.
If you have an issue to configure your PBX (network issue to connect to the Rainbow cloud, SIP trunk issue or user configuration) please open a ticket at firstname.lastname@example.org
If your problem concerns VoIP calling, WebRTC gateway or Rainbow configuration, please contact your support team. Please see the article How Can I Get Support in Rainbow? to find out who you should contact.
When you open a ticket please provide following information:
- WebRTC gateway config and the logs files as described at §1.1 and §1.2.
- Provide the result of the command mpcollect described in §2.2.
- Provide the Rainbow client logs.
- Indicate if the issue is systematic, random or occurred only once and if it can be reproduced.
- Indicate if the issue is for all users or only for one or a few.
- Indicate if a restart of the PBX rainbow agent, WebRTC gateway or Rainbow client solved the issue.
- Indicate the name and email of the user having the issue and the exact date and time the issue occurred.