Access Tier Troubleshooting

Common issues and best practices to troubleshoot your Access Tier deployments

  • Updated on Apr 19, 2023

This article describes features that are only available in the Banyan Enterprise edition and Banyan Unlimited edition.

User -> Access Tier -> Backend Connectivity

The diagram below depicts the traffic flow through an Access Tier. Most troubleshooting involves tracking the traffic through the different hops from source to destination.

The troubleshooting steps below assume you have defined a service with domain name on port 443 of the Access Tier. For your troubleshooting provide your specific service name. For infrastructure services, you should replace port 443 with 8443.

1. Ensure that your service domain name resolves to the IP address of the Access Tier

You can use the host command on Mac and Linux, or the equivalent nslookup command on Windows

enduser-device $> host
enduser-device $> nslookup

2. Check that you can establish a TCP connection to the Access Tier

enduser-device $> nc -v 443

3. Check that the service has been defined with the appropriate TLS certificate settings

enduser-device $> openssl s_client -connect -servername

4. Ensure that the backend application is reachable from the Access Tier

The Access Tier must be able to send network packets to the backend application or service instances. You can verify this my SSH-ing into an Access Tier VM and connecting to the backend.

accesstier-host $>nc -v <backend-ip-or-name> <backend-port>

If you have been successful in running through steps 1-4 above and still have issues connecting to your service, please peruse the list of common issues below.

List of Common Issues and Debugging Tips


  1. YAML syntax errors in config.yaml. Make sure there is a space character after the colon : character, and quote string values to avoid type ambiguity.

  2. Unsupported fields in config.yaml. For a given Netagent version, all of the supported configuration parameters are listed in config.yaml.tpl.

  3. Unsupported Linux distribution

  4. Host firewall conflicts with iptables rules. Disable host firewall ufw on CentOS.

  5. Kernel module failed to install. Output of sudo modinfo /opt/banyan/netting.ko should show vermagic value that matches the currently booted kernel uname -r

  6. Kernel module download failed. You can manually download with curl -O$(uname -r)/netting.gpg

Operation – Banyan Cloud Command Center console

  1. Service not recognized. Check in service tab on access tier detail page. Info about rejected services is not displayed in the console but may be present in the API response visible through the web inspector.

  2. Not seeing Access events. All Netagents report authorized and unauthorized connections and requests under Monitor > Events > Filter By > Event Type > Access. Access events are rate limited by default from Netagents. To disable rate limiting, change the netagent parameters access_event_credits_limiting and access_event_key_limiting to false.

Operation – Network tools

  1. Service name resolution failing. Ensure that host service-domain-name or nslookup service-domain-name resolves to the IP address of the Access Tier.

  2. TCP connection failing. Check TCP connectivity with netcat: nc -v service-domain-name [8]443.

  3. TLS error. Check TLS server cert: openssl s_client -connect service-domain-name:[8]443 -servername service-domain-name

Operation – On-host debugging

  1. Traffic is not intercepted. Check the entries in sudo ipset list for the expected destination IP addresses and port numbers.

  2. Unexpected iptables rules: run sudo iptables-save to obtain the full list of rules.

  3. Other error. Debug logs are in /var/log/banyan directory. The most commonly used files are netagent.log and ctrl-netagent.log, and their rotations.

Can’t find what you’re looking for?

We’re happy to help. Contact our team.