Troubleshooting Connect issues involving local.connectme.us and local ports

Description

Connect 3.6.5 and newer uses the domain name local.connectme.us that points to a machine's local 127.0.0.1 IP address. There is an SSL certificate for the domain that allows Connect to make requests to the local machine through HTTPS.

If Connect cannot make a connection to local.connectme.us (as of now, on Chrome, Firefox and Edge browsers), the Connect plug-in will not be able to launch.

Troubleshooting

1. Test that local.connectme.us can be resolved by the DNS server.

On Linux/Mac OS X, run the following command:

# host local.connectme.us

The expected, correct response is the following:

local.connectme.us has address 127.0.0.1

If the DNS server cannot be reached, you will see something like the following:

Host local.connectme.us not found: 3(NXDOMAIN)

This usually occurs when the system is on a closed network, or accesses the internet through a restrictive proxy. See this KB article for more details on how to solve this: DNS cannot resolve local.connectme.us for Connect

2. Test the connection to the default local Connect port

Connect listens in the local port range 43003-43013. Typically it ends up listening on the first available, 43003.

On Linux/Mac OS X, run the following command:

# telnet local.connectme.us 43003

The expected, correct response is a successful connection which would look like this:

Trying 127.0.0.1...
Connected to localhost. 
Escape character is '^]'.
^] (Control+])
telnet> quit
Connection closed.

If there are issues, you will get a response like this:

Trying 127.0.0.1...
telnet: connect to address 127.0.0.1: Connection refused
telnet: Unable to connect to remote host

This could indicate that:

  • Connect is not running
  • Connect is not current (3.6.5+)
  • The port is blocked locally, either by virus protection software or a local firewall

3. Test for issues with an antivirus program (specifically, Symantec)

While an antivirus like Symantec can block access to ports from the browser, it cannot block access from the terminal.

With Connect running, run the following command:

curl https://local.connectme.us:43003/v5/connect/info/ping

The expected, correct response is an empty curly brace pair { }.

In Chrome, Firefox, or Edge, enter the following URL into the address bar:

https://local.connectme.us:43003/v5/connect/info/ping

If there is no error and no port blockage you will again see { }.

If there is an error you will see a message such as Page Unreachable or Security Error. This indicates that Symantec is likely blocking Connect's local ports.

In this case the customer should have their IT team open ports 43003-43012 on localhost.

4. Consult other articles that involve local.connectme.us:

0 Comments

Please sign in to leave a comment.
Powered by Zendesk