Appendix A: Troubleshooting DNS

This appendix provides some steps to perform to ensure that you have the correct PCoIP Management Console 2 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 2’s host name to its IP address for forward lookups, and a DNS PTR record that maps the PCoIP Management Console 2’s IP address to its host name for reverse lookups. In addition, it checks that a DNS SRV record for _bootstrap-pcoip exists, and that the DNS TXT record containing the PCoIP Management Console 2’s certificate fingerprint exists and is located in the right place.

Also note that:

To verify DNS PCoIP Management Console 2 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 2 to perform a forward lookup to verify that a DNS A record that maps the PCoIP Management Console 2 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 2’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 2 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 2. 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 2 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

© 2018 Teradici Corporation. All rights reserved. TER1401005/A