Documentshow-to-troubleshoot-network-connectivity

How to troubleshoot network connectivity

Check the welcome screen first, then the IP address, server name, firewall and logs.

Normally the player connects to the server over the Internet once it is plugged into Ethernet or its Wi-Fi is configured. If the network is not DHCP enabled, enter the static IP parameters given by your network or ISP administrator. See How to change player settings for network and server.

After boot up, the welcome screen shows the network connectivity status.

What to verify

  1. The player has a proper IP address. 169.254.177.128 is the USB tethering address and is not a proper one.
  2. The server name or address is correct. For a local server, port 3000 must be included.
  3. Your firewall or proxy allows HTTP on port 80 and WebSocket (also on port 80) to and from the player. See Connectivity needs for the player (firewall).
  4. The server connectivity status shows "connected" and not "waiting".
  5. The network status shows Ethernet: UP, DNS: OK and DHCP with a proper IP address.

Troubleshooting

  1. Connect to the player's terminal as described in Issue shell commands or connect to pi terminal.
  2. Run these to confirm the addresses are present.
    ifconfig
    iwconfig
    
  3. Check that the network configuration files have the right settings. A Linux networking guide can help.
    /etc/network/interfaces
    /etc/wpa_supplicant/wpa_supplicant.conf
    
  4. Look at the log and note any errors.
    tail -200 /home/pi/forever_out.log
    
    A healthy connection looks like this.
    2 Mar 15:03:02 - info: starting socketio to pisignage.com
    2 Mar 15:03:02 - info: socket.io: connected to server 3y2pPLWkRsnDaVtHNEGH
    
  5. If you still need help, write to support@pisignage.com with the logs. See Support.