Test Connection for Masking Connector JDBC URL fails with JNDI Package failure javax.naming.CommunicationException (KBA8025)

Issue

This issue can occur when pressing "Test Connection" with an Advanced connector in the Masking GUI. A JDBC connection string will need to have been provided to create the Masking connector. The error message received is:

java.sql.SQLRecoverableException: IO Error: JNDI Package failure javax.naming.CommunicationException: xxx:xxx
[Root exception is java.net.UnknownHostException: xxx]

Example screenshot:

 

 

 

 

 

 

 

 

 

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies

Major Release	All Sub Releases
6.0	6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0, 6.0.10.1
5.3	5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0, 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0
5.2	5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1
5.1	5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0
5.0	5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1, 5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4

Resolution

To resolve this issue confirm that the correct DNS domain is configured for the Masking Engine. This error (UnknownHostException) can indicate that Delphix has been unable to resolve the hostname provided in the JDBC string. The DNS configuration can be checked from the Delphix CLI as sysadmin.

For example:

Engine-6080> service
Engine-6080 service> dns
Engine-6080 service dns> ls
Properties
    type: DNSConfig
    domain: testdomain.com
    servers: 172.xx.xx.xx,172.xx.xx.xx
    source: DHCP

To update the DNS configuration please refer to the online documentation How to Change the DNS Server of the Delphix Engine

 

 

 

---