Skip to content

Troubleshooting DNS

This troubleshooting reference provides some steps to perform to ensure that you have the correct PCoIP Management Console information configured in your DNS server.

Note: Instructions are for Windows only

These instructions apply to the Windows platform.

The procedure shown next checks that you have a DNS A record that maps the PCoIP Management Console’s host name to its IP address for forward lookups, and a DNS PTR record that maps the PCoIP Management Console’s IP address to its host name for reverse lookups. In addition, it checks that a DNS SRV record for _pcoip-bootstrap exists, and that the DNS TXT record containing the PCoIP Management Console’s certificate fingerprint exists and is located in the right place.

Also note that:

  • DNS records have a time-to-live value that dictates how long the records are cached. If your nslookup results show old information, please try clearing the PC’s DNS cache using the ipconfig /flushdns command before running the nslookup commands in this example again.
    For example,
    C:\Users\username> ipconfig /flushdns 

    Windows IP Configuration
Successfully flushed the DNS Resolver Cache

  • PCoIP Zero Client endpoints will cache DNS results for the entire time-to-live period. You can clear this cache by power cycling the endpoint.

  • The following SHA-256 fingerprint shown is the default PCoIP Management Console certificate fingerprint. If you have created your own certificates, this value will be different.

  • The following example uses sample IP addresses and host names for the primary DNS server and PCoIP Management Console. Please substitute your own server and PCoIP Management Console 2 information for these names and addresses.

  • The information returned by the nslookup commands is shown in gray text after each command.

To verify DNS PCoIP Management Console information:

  1. Log in to your Windows server.

  2. Launch a command prompt window by clicking the Start button and typing cmd in the Search box.

  3. Launch nslookup from the command line prompt:
    C:\Users\username> nslookup
    Default Server: mydnsserver.mydomain.local
    Address: 172.15.25.10

  4. Instruct nslookup to connect to the DNS server under which you created the records. This address should match the primary DNS server address configured in the endpoint’s network settings.
    > server 172.15.25.10

    Default Server: mydnsserver.mydomain.local
    Address: 172.15.25.10

  5. Enter the FQDN of your PCoIP Management Console to perform a forward lookup to verify that a DNS A record that maps the PCoIP Management Console host name to its IP address is present:
    > pcoip-mc.mydomain.local

    Server: mydnsserver.mydomain.local
    Address: 172.15.25.10

    Name: pcoip-mc.mydomain.local
    Address: 172.25.15.20

  6. Enter the PCoIP Management Console’s IP address (found in the previous step) to perform a reverse lookup to verify that a DNS PTR record that maps the PCoIP Management Console IP address to its host name is present:
    > 172.25.15.20

    Server: mydnsserver.mydomain.local
    Address: 172.15.25.10

    Name: pcoip-mc.mydomain.local
    Address: 172.25.15.20

  7. Set the record type to SRV and check that a DNS SRV record exists to tell endpoints the FQDN of the PCoIP Management Console. In the second command, the domain name is the domain under which your endpoints are configured:

    > set type=srv
    > _pcoip-bootstrap._tcp.myendpointdomain.local

    Server: mydnsserver.mydomain.local
    Address: 172.15.25.10:

    > _pcoip-bootstrap._tcp.myendpointdomain.local SRV service location:
            priority =0
            weight =0
            port =5172
            svr hostname =pcoip-mc.mydomain.local
    pcoip-mc.mydomain.local internet address = 172.25.15.20

  8. Set the record type to TXT and check that a DNS TXT record exists containing the PCoIP Management Console SHA-256 fingerprint. In the second command, the domain name is the domain under which your endpoints are configured.

    > set type=txt
    > pcoip-mc.myendpointdomain.local

    Server: mydnsserver.mydomain.local
    Address: 172.15.25.10

    pcoip-mc.mydomain.local text = "pcoip-bootstrap-cert= B7:62:71:01:85:27:46:BB:E3:E9:5C:E2:34:2C:B5:76:7D:7A:F1:7F:6A:4D:5C:DB:AA:2B:99:BD:D5:A9:28:91"

  9. Exit nslookup:
    > exit