Many Teradici products require Domain Name System (DNS) for the product to correctly function. DNS can provide the details for a PCoIP Zero Client to find the Teradici Management Console, for the Connection Manager to find PCoIP Agents or Clients to find hosts. These Teradici components query DNS for certain records to allow them to function. To find out the results of the queries you can use the tool nslookup to directly query a DNS server.

By default nslookup will use the operating systems settings to determine which DNS server. To check that DNS is configured correctly the default DNS servers maybe enough but, if you are troubleshooting a device/system you should use the same DNS server as the device. By examining the network settings of the device/system you should be able to determine what DNS servers are in use.

Launching nslookup

Windows

1. Open the command prompt:

   • Go to Start > Programs > Accessories > Command Prompt. 
     OR
   • Press Windows key+R on your keyboard to initiate the Run command. Type cmd, and then press Enter.

2. Run nslookup .

Linux

1. Open a terminal
2. Type nslookup.

Setting the DNS Server in use

The nslookup utility can be configured to use any DNS server. Typically the default server obtained from the operating system is sufficient. In a Windows Active Directory Domain, this will be one of the domain controllers. There may be times when you need to use the DNS server the client is using or an internet DNS server such as Google (8.8.8.8 or 8.8.4.4) to check the same address from outside your network.

Windows

When start nslookup the default server will be displayed, 

If this is not the DNS server you would like to query, the server can be changed by the command. Where 10.10.10.11 is the IP address of the DNS server

 Default Server: ns2.cloudaccesslabs.com 
Address: 10.10.10.11 

Linux

Use the command server to determine the current servers.

 > server
Default server: 10.10.10.10
Address: 10.10.10.10#53 

If this is not the DNS server you would like to query, the server can be changed by the command. Where 10.10.10.11 is the IP address of the DNS server.

 Default server: 10.10.10.11 
Address: 10.10.10.11#53 

Checking A records

An Address (A) record is used to find the IP address of a host from it's name. For example, if there is a host called broker in the domain cloudaccesslabs.com and an A record is created on the DNS server. When nslookup queries the DNS server for the A record broker, the DNS server will return the IP address. 

To check an A record do the following in nslookup

The first command sets the query type to A record. Once the query type is set, it is used for subsequent queries until it is changed. The second command request the A record broker.cloudaccesslabs.com

The results will appear like below. Verify the returned IP address is the address that is expected. 

Windows

 > set query=a
> broker.cloudaccesslabs.com
Server: dns2.cloudaccesslabs.com
Address: 10.10.10.11 

Name: broker.cloudaccesslabs.com
Address: 10.10.10.5 

Linux

> set query=a
> broker.cloudaccesslabs.com
Server: 10.10.10.11
Address: 10.10.10.11#53 

Name: broker.cloudaccesslabs.com
Address: 10.10.10.5 

Checking SRV records

The Teradici Zero Clients will query Service Location (SRV) records to locate services including the PCoIP Management Console. To query for SRV records use the following commands in nslookup.

The results will appear similar to below. Verify this is what is expected.

Windows

 > set query=srv
> _pcoip-bootstrap._tcp.cloudaccesslabs.com
Server: dns2.cloudaccesslabs.com
Address: 10.10.10.11 

Non-authoritative answer:
_pcoip-bootstrap._tcp.cloudaccesslabs.com SRV service location:
 priority = 0
 weight = 0
 port = 5172
 svr hostname = pcoipmc.cloudaccesslabs.com 

Linux

 > set query=srv
> _pcoip-bootstrap._tcp.terase.local
Server: 10.10.10.11
Address: 10.10.10.11#53 

_pcoip-bootstrap._tcp.cloudaccesslabs.com service = 0 0 5172 pcoipmc.cloudaccesslabs.com. 

Checking TXT records

The Teradici Zero Clients will query TXT records when connecting to the PCoIP Management Console. To query for TXT records use the following commands in nslookup.

The results will appear similar to below. Verify this is what is expected.

Windows

 > set query=txt
> pcoipmc.cloudaccesslabs.com
Server: dns2.cloudaccesslabs.com
Address: 10.10.10.11 

Non-authoritative answer:
pcoipmc.cloudaccesslabs.com text = 

"pcoip-bootstrap-cert=AA:F4:6F:80:CF:CF:CC:5B:C1:C1:E3:F9:FC:9F:E5:FF:4C:48:3B:9B:4A:53:11:E4:76:75:35:3C:08:CA:03:6D" 

Linux

> set query=txt
> pcoipmc.cloudaccesslabs.com 

Server: 10.10.10.11
Address: 10.10.10.11#53 

pcoipmc.cloudaccesslabs.com text = "pcoip-bootstrap-cert=AA:F4:6F:80:CF:CF:CC:5B:C1:C1:E3:F9:FC:9F:E5:FF:4C:48:3B:9B:4A:53:11:E4:76:75:35:3C:08:CA:03:6D"