This guide has been created to help with the troubleshooting process and to ensure the most common issues/checks have been addressed.
Vibe's port is exclusively UDP 65500, similarly, with PBX QoS. Destinations are:
Please Note: The port is exclusively 65500 bidirectional.
Please Note: Always check physical media first.
Check that cables are inserted correctly.
Verify that the network cable has got an internet connection active on it. ( Test this by trying to plug a cable that is working on another phone into the phone, giving the error)
Ensure that the phone has the correct network IP address
If the phone does register after the changes have been made, the network would need to be looked into from the customer’s side.
Completing the above steps and the phone doesn’t register, the customer would need to look into their network setup and check if there is any conflict on their end.
Please Note: Make sure that SIP ALG is disabled on the WAN routers. When using a Mikrotik specifically, it’s called SIP Direct Media. With Cyberoam, the SIP ALG setting can only be disabled from the CLI. SIP ALG was designed to help VoIP, but it causes extensions to de-register. Disable IGMP Snooping.
Step 1: Navigate to the Basic Call tab.
Step 2: Uncheck the "Remove dash on alias" option
Issue: The call quality is bad when receiving but not when making a call.
Fix: Codec Negotiation Priority - Set it to the caller and not the callee.
Snom Soundpoints have another way to reset if getting the password is not an option, below are a few methods that can be tried:
Reset Method 1:
The first method to reset the phone is while it is booting up. When the countdown screen is visible whilst booting up the phone, press and hold down 6, 8, and *. Hold these three keys until the countdown ends and a password is requested. By default, this password is 456. Enter the password to reset the phone to factory defaults.
Reset Method 2:
This can also be done via the phone’s menu if the phone has already booted up. Proceed to Menu / Settings / Advanced and enter the admin password (default: 456). Choose the appropriate option and the phone will boot to default settings on the next boot.
When booting the phone to the password screen, enter the MAC address of the phone in the password field.
The MAC address can be found on the bottom of the phone.
Enter the MAC address as all lowercase letters with no colons in-between sets.
These phantom calls are also known as SIPvicious are a type of SIP denial of service attack. This happens when the phone sits on a live IP address.
A bot which is doing port scans on random public IP addresses will find an open port. The bot will then send SIP signals to this device on a general SIP port and the phone will ring. The caller ID will say "100" or "1000" and ring the phone constantly,usually at night, and when they pick it up there is no one there. These are so called ghost calls, it will disturb and confuse the phone user. No record will be found of these calls in the CDR's on your PBX as it is just a signal sent to the IP and it is not an actual call.
2. Enable SIP trust feature:
Accept Features->General Information-> SIP Trust Server Only
Zoiper:
Desktop:
Open 'Settings', then 'Preferences', then 'Advanced' (the Gear or Wheel button), then 'Network'.
The 'Port' setting Under 'SIP Options' is the Local SIP Port.
The 'Port' setting under 'RTP Options' is the starting Local RTP Port.
Disable the options to 'Open random ports'.
Apple iOS:
Click on 'Settings', then “'Advanced' to change Zoiper's Local SIP and RTP Port settings.
Disable the options to use Random Ports.
Android:
Find the Local SIP and Starting Local RTP Port settings under 'Config', then navigate to 'Connectivity', then 'Listening Ports'.
Disable the options to use Random Ports.
Aastra:
The Local SIP and RTP ports are under 'Advanced Settings' on the 'Global SIP' page.
A different Local SIP Port value should be chosen for each active account.
Bria:
Apple iOS:
From the Dialpad click 'Settings', then 'Advanced Settings'.
Under 'Media Options' the SIP Port Range and 'RTP Port Range for Audio' can be chosen.
The Start and End SIP Ports should be the same value (don't use a range of SIP ports).
Android:
From the dial pad click the Gear icon to access Bria's settings.
Tap on 'Advanced Settings' to change Bria's 'SIP Port' and 'RTP Port Audio' settings.
Bria Desktop:
Open Your sipgate account Settings and click on the 'Topology' tab to change the softphone's Local SIP ("Signaling") port and RTP ports.
Cisco/Linkys SPA:
Each 'EXT' or 'Line' under 'SIP Settings' has a 'SIP Port' setting.
The RTP ports will be found under 'Voice' --> 'SIP' --> 'RTP Parameters'.
A different Local SIP Port value should be chosen for each active Ext or Line.
CSIP Simple:
From the Menu below the Dialpad select 'Settings', then 'Network' to change CSIP local ports.
The Local SIP Port is called the 'UDP Port - port number to bind locally'.
With the Expert set up Wizard selected, each VoIP account can also be allocated a different "Port for RTP ports range start".
Each VoIP account can be assigned a different Local RTP Port.
DrayTek:
To change a DrayTek's Local SIP Port see the DrayTek Help article.
A different Local SIP Port value should be chosen for each active Index.
Gigaset:
The local ports are located under 'Telephony', then 'Advanced', then 'Listen Ports for VoIP Connections'.
Do not enable the options to use Random Ports.
Grandstream:
The 'Local SIP Port' is located in the 'Account' menus and the 'Local RTP Port' will be in the 'General' or 'Advanced Settings' menu.
Each Line or Account can be allocated a different Local SIP Port.
A different Local SIP Port value should be chosen for each active line.
Media5-fone:
The Local SIP Port and RTP ports settings are found under 'Settings', then 'Advanced', then 'Network Options'.
The start and end SIP Port value will be the same (one SIP port).
Panasonic:
Each Line can be allocated a different Local SIP Port ("SIP Source Port") under "VoIP" under "SIP Settings", then 'Line x'.
The RTP port settings will be found in the "VoIP Settings" menu.
PhonerLite:
Open 'Configuration', then Network, then Local Port.
The RTP port used by PhonerLite will be set to two ports higher than the chosen Local (SIP) Port.
Snom:
Under Advanced
SIP/RTP the Local SIP Port is called the 'Network Identity Port'
The Local RTP Ports are called the 'Dynamic RTP Port Start/End'
X-Lite:
Open sipgate account Settings and click on the 'Topology' tab to change the softphone's Local SIP ("Signaling") port and RTP ports.
This document is created to assist a user in resolving the External Client issues when the user is not the administrator. This document also indicates what is needed in the case of network or firewall restrictions.
The machine recommended specifications:
Operating system: Windows10 (x86 or x64)
Ram: 4GB
Other requirements:
The External Client also relies on .Net Framework 4.6 (Included in the EC setup)
A WebSocket is being used as a communication channel between the browser and the External Client.
The External Client uses the alias localhost.euphoria.co.za as an identifier for the WebSocket connection on the local machine.
If you are running a proxy server, External Client will require localhost.euphoria.co.za to be added to the exceptions in Windows proxy settings. Example below:
The External Client requires ICMP access upon startup in order to detect if the user has access to certain URLs. It will do this by running a ping test to Amazon S3 and Google.
The external client requires certain ports to be accessible in order to function, these summarily are:
TCP 65501 which facilitates communication between the browser and the external client.
EC uses UDP port 5060 to listen to SIP traffic.
EC will pick dynamic outbound UDP ports from the range between 10,000 - 20,000 to be used for RTP (Real-time Transport Protocol) and RTCP (Real-time Transport Control Protocol) which is used for audio streaming.
PortSIP uses random loopback ports which do not require to be opened in the system firewall, these are for internal application use.
The External Client will need to be able to access certain sites to be able to function correctly, these are:
PBX server name (including the domain name), in order to handle the real-time communication, firewall rules permitting traffic to the server may be required.
Amazon AWS used to download the certificate needed to secure the local port connection communication between EC and the user’s browser.
The External Client needs to have read and write access to the Windows Current User Certificate Store. This will enable it to download the certificate(mentioned above) to the store folder and read it from there when needed.
The User certificate store path can be found in the following location:
{system drive}:\Users\{Username}\AppData\Roaming\Microsoft\Crypto
The External Client requires administrator rights in order to auto-update, if it does not have these, it will need to be done manually through the administrator by running the External Client Updater from the system start menu or the application folder.
Since the External Client will use the system communication audio devices, any troubleshooting necessary should be done through the system troubleshooter or on the actual device itself.
The External Client should be allowed to access the device microphone and that can be done through the system privacy settings.
Speaker device: 16 bit, 48000Hz (DVD Quality)
Microphone device: 2 channel, 16 bit, 48000Hz (DVD Quality)
The External Client currently supports a single user at a time and it can only interact with a single browser page that supports it. Having more than a single page interacting with External Client will interrupt the main connection between the browser and External Client.
This can be resolved by keeping a single browser page open with the phone (The page may need to be refreshed) and then resetting the External Client (right-click the tray icon in the taskbar and reset).
Due to the External Client creating a local port connection with the browser, the connection can be interrupted by external factors like the system going to “sleep” mode or by the browser itself.
This can be resolved by resetting the External Client (right-click the tray icon in the taskbar and reset).
To detect any other issue, run the Euphoria External Client Console from the user system start menu and you should be able to see the logs and errors in detail. Please note that this can not be run at the same time as the normal client as it will conflict.
WebRTC (Web Real-Time Communication) is an API definition drafted by the World Wide Web Consortium (W3C) that supports browser-to-browser applications for voice calling, video chat, and P2P file sharing without the need of either internal or external plugins.
Your Euphoria PBX that you are currently using to make and receive calls is capable of making and receiving calls via Secure WebSockets, a module of WebRTC. You will need to familiarize your self with WebRTC and Secure WebSockets to continue.
Euphoria Allows for Secure WebSocket connections on port 443. If you normally communicate with your pbx at pbx4.euphoria.co.za on the regular SIP port of 5060, you can also establish a Secure WebSocket connection on port 443. e.g. wss://pbx4.euphoria.co.za:443. Connections using Secure WebSockets are protected via TLS.
Euphoria does not support non-secure WebSocket connections.
RTP media is transmitted over UDP ports 30000-40000. (With a non WebSocket connections, like 5060, RTP would normally use port 10000-20000). Additionally, RTP media offered by your Web Browser is normally secured with SAVPF/TLS.
The Audio codec used by most modern browsers will be OPUS. Euphoria supports opus audio codec, however you will need to contact your support or sales consultant to have this option enabled. (Browsers will also offer ulaw and alaw - these two codecs are not recommended, and also have to be enabled by contacting Euphoria.)
The Video codec used by Chrome will be VP8/9 and Mozilla will be H264. Trans-coding video is not possible and as a result, video will not be possible via this method. An alternate video conferencing solution is available if required.
A STUN server is also available at the same pbx url. e.g., if you register with pbx3.euphoria.co.za, then the stun server will be stun:pbx3.euphoria.co.za
There are two popular JavaScript libraries that enable full telephone functionality like call set-up, dtmf, call answer etc.
Option 1) SIPjs: https://sipjs.com
SIPjs is an easy to use fast to get going script library, it can handle most calling features. It is recommended to use SIPjs JavaScript library to build a browser based phone, for simple use case scenarios. (At the time of writing, hold and un-hold was not possible).
Option 2) JsSIP: http://jssip.net/
JsSIP is a more powerful script library but can be more complicated to setup. It is recommended to use JsSIP JavaScript library to build a more feature rich scenarios.
The Euphoria Agent Manager/Softphone app makes use of the tms.euphoria.co.za and api.euphoria.co.za to authenticate.
These destinations should be unblocked on your network. The TMS and API both have two destinations, the DNS works in round robin fashion. It's wise to have both destinations for both services open as it could resolve to either.
tms.euphoria.co.za operates on port 443 TCP
Resolution:
tms-a.euphoria.co.za
41.79.37.34
tms-b.euphoria.co.za
41.79.37.44
api.euphoria.co.za operates on port 443 TCP
Resolution:
api-a.euphoria.co.za
41.79.37.39
api-b.euphoria.co.za
41.79.37.46
I have an Internet Connection, but the Softphone Shows “Initialized’
A SIP account needs to be loaded onto the Softphone:
1. Click on the settings wheel next to “Enter Number”.
2. Navigate to “Select Account” and select the relevant SIP Account for your extension.
3. Once you have selected the account, the extension will register.
There is a working Internet Connection, but you cannot PING api.euphoria.co.za or tms.euphoria.co.za or the PBX.
The Agent Manager works with the TMS, if you cannot reach tms.euphoria.co.za or api.euphoria.co.za, your phone will not register.
This means that your computer could not resolve the DNS through your Internet Connection.
Usually changing the DNS settings on your Router fixes this. Alternatively, if the customer’s PC is set to DHCP, changing it to a Static IP and DNS with the same IP Address, Gateway and Subnet Mask that the computer got via DHCP will work. Make sure that it is set to “Use the following DNS server addresses” and insert the settings as seen in the image below
After changing the DNS Settings on the PC, make sure to click “OK” to save the settings and then close and re-open the Agent Manager to see if it registers with the new settings.
In order to putty into a Diginet router (Cisco) you need to open three Putty Sessions.
1st Session
1. Log into Vibe Headend - vibe6.euphoria.co.za port 22
2. Navigate to tunnels and add 8081 followed by 10.0.3.238:80 and 22 in the forwarded ports section.
2nd Session
1. Log into primary connection - 127.0.0.1 8082
2. Navigate to tunnels and add 8083 followed by Diginet router (Cisco) IP (in this case it is 192.168.0.1) port 23 in the forwarded ports section.
3rd Session
1. Log into primary connection - 127.0.0.1 8083
Telnet
The overall result should look like this:
1. If it shows the Mac address, either the Vibe CPE is not connected correctly to the network, or the Firewall is blocking the VPN from exiting the network
2. If it shows the IP address, Packets are being sent to the VIBE server but are not able to return back into the local LAN. Please check the firewall, port forwarding and mirror.
The head end might have cached information and when we remove the head end info and apply settings then re-add the info the link comes up.
We have seen a SIP helper cause occasional dropped calls when using a Mikrotik Router without ViBE.
1. Go to Firewall Settings
2. Go to Service Ports
3. Ensure sip on port 5060 and 5061 option is disabled.
4. When you mouse rolls over it, it will give you the option to enable, as it is disabled
Euphoria Telecom
http://www.informaticapressapochista.com/asterisk/asterisk-with-sonicwall/
Go to the app store and download Zoiper. After installation, open Zoiper and follow the below instructions.
1. Click on the '' I already have an account'' option.
2. Click on the ''Manual'' option.
3. Click on the ''SIP'' option.=
4. Enter the details as needed:
5. Insert the User name ( SIP username ) where it's asking for the ''Auth username.
6. Next step is to enable the G729 audio codecs, navigate to the settings wheel and click on premium features.
7. Once you have paid for the codec you will now be able to enable that codec (and only that codec) and move it to the top of the list to make it the primary codec.
The problem usually is the one-way communication router through one trunk or another related issue.To solve the issue there are the general rules:
7. Click on Voip, then Settings.
8. Check the flag “Enable Consistent NAT” e uncheck the flag “Enable SIP Transformations”.
The protocol used from Asterisk in SIP is UDP, that is connectionless, so the connection between the two ports (5060-14001) will be kept a certain time, because there is no way to know if the connection is terminated or not. For this reason the association will be maintained until a timeout: the default in Soniwall in 30s, less than the Asterisk default SIP registration refresh period of 60 seconds! We had increased this value more than the registration refresh period (90s).
Note: It is possible to change the Asterisk registration refresh period too, but I prefer this solution (change the configuration of Sonicwall).
All these changes are sufficient more often than not: for the unfortunate cases, then you need to directly forward all the ports used by the SIP flow communication directly from WAN to the PBX.
In the next we will redirect all the all the necessary ports to the PBX (5060/UDP and the range from 10000/UDP to 20000/UDP).
Firewall -> Service Objects
Create two new Custom Service Objects: PbxSipSegn & PbxSipStreamVoce.
Create one new Custom Address Objects using the LAN IP of the PBX (in my case 172.18.49.200).
After creating the necessary objects now let’s change the firewall rules: add a new rule WAN->LAN.
The last step: we have to create the NAT policy.
Externip = <External ip address>
localnet = <Network address of the LAN network/Subnet Mask>
In the trunk conf you must add the next parameter.
nat = yes
# To QoS for PBX's #
We accept UDP connections on port 5060 and TCP connections on port 5061.
You will need to have some kind of DSCP marking rule to tag voice packets for the destination of the PBX.
Pbx destinations are:
41.221.5.104/29
41.221.5.224/27
41.221.6.224/29
154.119.166.64/27
154.70.244.128/27
We accept UDP connections on port 65500. ( bidirectional )
You will need to have some kind of DSCP marking rule to tag voice packets for the destination of the tenant’s ViBE Server.
ie: {internal_lan} DSCP mark DST 41.221.5.229:65500 UDP route via alternate breakout.
Should you be using the Euphoria Agent Manager/Softphone app, it makes use of our tms.euphoria.co.za and api.euphoria.co.za to authenticate. These destinations should be unblocked on your network. The TMS and API both have two destinations, the DNS works in round-robin fashion. It's wise to have both destinations for both services open as it could resolve to either.
The TMS and API operate on port 443 TCP, subnets are as follows:
41.79.37.32/28
41.71.113.224/27
41.71.119.0/27
105.28.102.192/29
105.29.154.0/27
Auto Provisioned Zoiper for Windows/Mac or Android/iOS
I don't know if it is ideal to send this link to clients, because it contains the username and password of the extension but here it goes...
To provision windows/mac use:
To provision Android/iOS (this will generate a QR code you can copy and paste in an email safely)
Sometimes when a phone doesn’t register, it could be something simple as the SIP password that is incorrect (Recommended to copy/paste) or that the PBX server is not correct when setting up a phone.
If all the details have been Copy & Pasted, you can start to look a bit deeper into the settings of the phone. Usually, you can start with registering the phone on Account 2.
Make sure the Network Cable and Network Port in which the phone connects to is active and gives out DHCP (unless network setup is only allowing Static IP Addresses, in which case you need to get an IP Address assigned to the device and set it up statically).
Check that the cables are in working order as it could be that the network cable is Faulty.
Ensure that the network cable plugged into the phone is connected to the “Internet “port on the phone.
Are you using the correct Protocol? The Protocol should always be UDP
Try changing the local SIP Port, found in Account Settings under the advanced tab or Under the Settings tab in the SIP category. The SIP Port will always be 5060 by default. You can change the SIP Port to something else between 5060 and 65500.
Try moving the phone to a different network point where there is a working device. It could be that the network point is causing an issue.
Try and register the PBX domain directly on the IP address as there could be a DNS translation error. (Gateway router is not translating the PBX to the relative IP). This issue could be resolved by troubleshooting your network / gateway router.
If the above steps do not work, you could confirm if there are VLANs set in place on the customer’s network as well which the phones need to be on.
In rare cases, the customer’s network can have issues as well, such as DNS issues. If you change the phones DNS to the following, the phone should register:
Primary: 8.8.8.8
Secondary: 8.8.4.4
If the phone does register after the changes have been made, the network would need to be looked into from the customers side.
Completing the above steps and the phone doesn’t register, the customer would need to look into their network setup and check if there is any conflict on their end.
Disable IGMP Snooping.
On some occasions, the ViBE will not come online because the password still remains “TenantName”. This password would need to be replaced with the PBX’s Tenant Name which can be retrieved from the TMS.
One of the obvious reasons would be that the Primary connection is not set correctly.
By default, we usually set Port 2 to have a static IP 192.168.220.2 which connects to the primary internet connection (ADSL/LTE) which will be configured with a gateway of 192.168.220.1. If you have a dedicated internet connection or are going to share your internet between voice & data, you can plug that into port 3of the ViBE and either remove the route on the ViBE, or assign a reserved IP to port 3 of the ViBE and update the route.
Make sure that you have purchased the license from the supplier and that the CPE is activated with this license
Check that the details sent to Euphoria are correct such as the Mac address and password.
Check if the ViBe config file loaded on the vibe is corresponding to the server where the Euphoria agent added it to e.g. ViBE1, ViBE2, etc
You can refer to the Reseller Dropbox in order to find the steps on adding and removing routes on the ViBE Router.
This is mostly experienced when a customer is sharing internet with voice and data. In this case, you would need a dedicated Internet Connection for Voice. If you are using Fibre, it would be recommended to get a minimum of 2MB dedicated for voice (You would need to get in touch with your ISP and get them to do this on their end). QOS rules are provided on the Reseller Dropbox in the Network Configuration folder.
RSAWeb are able to implement a VLAN for Euphoria, you would need to contact them and ask them to set it up for you.
On rare occasions, the ViBE can be set in Rain Mode on the CPE, but on the headend the ViBE will be set to Failover (Vice versa). You are welcome to call/mail Euphoria Support to confirm the server set-up.
If you are experiencing call quality issues like crackling, a loud buzzing noise etc., try checking that the curly cord is plugged into the correct port.
Try calling on loudspeaker
Try changing curly cord
Try changing the hand piece.
Check firmware of device
Factory reset the phone
If the caller says that they can’t hear you, experience one-way audio, that you sound like you are underwater or disappear etc., this is most probably a Firewall issue. You need to make sure that the correct protocols, sip ports and UDP ports are allowed through the firewall, as well as from the ISP side. (Ports and IP’s are provided on the Reseller Dropbox in the Network Configuration folder.
When there are call quality issues, you would need to confirm what kind of phone it is as well. Is it a desk phone/cordless phone/cell phone app/Softphone etc.? With this being said, if it is a cordless phone, make sure you are not out of range from the base or if there is anything else near it that can cause interference.
You would need to know if this is from a certain Network or from all networks, including phones on the Euphoria Network.
If this is happening on all phones, you would need to make sure that the routing on the Euphoria’s side. Only if you get a message saying “I’m sorry, the number you have dialed cannot be found on the Euphoria Network”, it would mean that the number has been ported, but not been added to the Account yet.
If the routing Is setup on Euphoria’s network, get the latest example of a call that happened within at most a 6 hour time frame and escalate this to the relevant network provider where they will let you know what the issue is. On some occasions, the routing has not been updated on Vodacom, Cellc, MTN etc side (The relevant network provider needs to sort this out on their side). Send all call examples to Euphoria Support so that they can investigate and escalate it to the relevant network provider if needed.
Please do not contact the network provider directly, all correspondence with the network provider MUST be done through Euphoria Telecom.