Troubleshooting tips and techniques

The following tricks and techniques can be used to test or troubleshoot issues.


Spoof addresses with hosts entries

You can use entries in a local hosts file to bypass DNS, which enables you to test applications before names are available in DNS. Tools such as nslookup and dig don't return values found in a local hosts file.

  1. Open the hosts file for your platform in a text editor:
    Linux and similar/etc/hosts
  2. Enter a reference specific to an app such as:


  3. Test normally.

Can Access Gateway reach a host?

Ping can be used within the Access Gateway Management console to determine if a host is reachable.

  1. Open a connection to the Access Gateway Management console.
  2. Select 1-Network.
  3. Select 6-Ping.
  4. At the IP Address/Hostname prompt, enter a name or address.
  5. Examine the result to determine if Access Gateway can reach the host. For example: IP Address/Hostname: PING ( 56(84) bytes of data. 64 bytes from ( icmp_seq=1 ttl=114 time=22.7 ms . . . 64 bytes from ( icmp_seq=4 ttl=114 time=18.1 ms --- ping statistics --- 4 packets transmitted, 4 received, 0% packet loss, time 3006ms rtt min/avg/max/mdev = 16.900/19.520/22.757/2.234 ms

Are hosts entered into DNS

Tools such as nslookup and dig can be used to determine if a host is resolvable.

To use nslookup to determine the IP address of a host name:

  1. Open a command prompt. While nslookup is typically available on Linux and Apple OSX-based computers, it may not be available on Windows.
  2. Run nslookup. For example:


  3. Evaluate the result.

    nslookup Server: Unknown Address: Name: Addresses:

Can a host be reached across a firewall?

Tools such as telnet can be used to determine if a host can be reached across a firewall. It's assumed that the machine running the telnet command is on the opposite side of the host being accessed.

While telnet is typically available on Linux and macOS, it may not be available on Windows.

To attempt to access a host using telnet:

  1. Open a command prompt.
  2. Run the telnet command:

    telnet 443

  3. Evaluate the result:

    Trying telnet: connect to address Connection refused

Related topics

Application process flow

Application troubleshooting process

Troubleshoot applications