Common Causes for Linkus Failure - Failed to Connect to Server

  • Applicability
  • Common Causes
    • Incorrect Port Forwarding
    • Linkus Server hasn't been enabled
    • IPv6 network
  • Log Capture

 

Applicability

  • PBX version: 30.13.0.15 or higher
  • Linkus server version: 2.6.10 higher

 

Symptom

Commonly, you would get the error prompt Failed to Connect to Server (1) 

mceclip1.png 

If you meet Failed to Connect to Server (3), you refer to this article: Linkus Login Failed through LCS - Error Code 3

 

Common Causes

  1. Incorrect Port Forwarding
  2. Linkus Server hasn't been enabled
  3. Login via IPv6 network

 

Solution 

Let's what are the exact causes and the solutions:

1. Incorrect Port Forwarding

Make sure you have forwarded ports 8111(UDP and TCP), 5060 UDP, 10000-12000 UDP on your router for

the PBX (Especially port 8111). Please refer this article to configure the port mapping for Linkus:

https://help.yeastar.com/en/s-series/topic/set_up_linkus_server_without_lcs.html

You can also use this web tool to check if your port has been forwarded. https://www.canyouseeme.org/

Enter your public IP of the PBX uses, and the port you want to check.

For example, it shows 8111 is not forwarded.

mceclip0.png

If you don't want to do port forwarding, you could try our LCS service. Enable Linkus Cloud Service(LCS)

on the Linkus Server. LCS uses the tunnel to transmit data it does not needs to set port forwarding on the

router and more secure. See how to use LCS https://help.yeastar.com/en/s-series/topic/set_up_linkus_server_with_LCS.html

 

2.  Linkus Server hasn't been enabled

Make sure your Linkus server service has been enabled.

 

3. IPv6 network

Linkus client has already compatible with lots of IPv6 networks. But the IPv6 is complicated, in order to

exclude the network issue. Please try to change your Linkus client to the IPv4 network and test.

For example: 

1. Change your SIM card network to IPv4 if you data network to login Linkus.

mceclip0.png

2. Change your WiFi network to IPv4 if you use WiFi to login Linkus. You can set DNS to manual configuration. Then remove IPv6 DNS servers. 

mceclip1.png

 

Log Capture

If the problem still exists, please try to capture and post us the logs follow the below step when you replicate the issue.

1. Enable debug and sip debug on the PBX(no need to put any IP to sip debug

mceclip1.png

2. Log in the Linkus and click 'login' to make the problem happens again

3. Download the System log from the PBX

mceclip2.png

4. Get log from Linkus client, please refer to this link to get the Linkus client log

https://support.yeastar.com/hc/en-us/articles/360012270934-How-to-Get-Linkus-Debug-Logs

 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.