Skip to main content

Testing the Masking Connector using the CLI (KBA8885)




KBA# 8885

At a Glance

Description: This page describes how to test and troubleshoot a failed Masking Connector using the CLI (and other commands).

The tests below are to verify that the host is reachable and that the port accepts connections. For detailed tests, it is recommended to use a SQL Editor Tool or FTP/SFTP client.
CLI: To test a connection using the CLI - (see below for example):
CLI> connectivity shh
Success: Successfully connect to host and service (shh login fails with the error):
Server closed connection during identification exchange
Failure - port: Successfully connect to host. Error, the port is not listening:
Connection refused (Connection refused)
Failure - host: Error: Cannot reach the host.
Connection timed out (Connection timed out)
Other commands: Other tools/commands that can be used to test the connection are: 

SQL Editor | FTP | SFTP Client
  • Many too are available on all platforms (Windows, Mac, Linux, etc). Outside the scope of this KBA.

Command Line: ping
ping [IP_Addr|Hostname]

Command Line: telnet
telnet [IP_Addr|Hostname] [port]

Command Line: nc
nc -zv [IP_Addr|Hostname] [port]
Verify host port: The commands below can be used to verify that the port is listening on the host:

netstat -an | grep [port]

netstat -an | find "[port]"

Troubleshooting: For details on how to review errors in logs and other topics, see the Related Topics section.


If a Masking Connector is failing with a timeout or other connectivity error - one way to isolate the issue can be to verify that the host can be reached and the port accepts connections.

Since the 'Command-Line' is not accessible, this KBA describes an alternative method that uses a tool available in the Delphix Engine CLI (Command Line Interface). 

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies
Major Release All Sub Releases





Connection Test

CLI Command

The following CLI command can be accessed using the Continuous Data Engine (formerly Virtualization Engine) admin user. In order to test this, you need a Continuous Data Engine admin user and password (on the Continuous Compliance Engine (formerly Masking Engine)).

  1. ssh (or use PuTTY) to the engine.
  2. Login using a engine admin user.
  3. Go to 'connectivity' and then 'ssh'.
  4. Specify host address and port.
  5. Specify dummy for user and password (we are using dummy as we are only testing the host and the port).
  6. Type commit to start the test.
$ ssh VE_admin@Your_DCCE
Your_DCCE> connectivity
Your_DCCE connectivity> ssh
Your_DCCE connectivity ssh *> set address=[IP_Addr|Hostname]
Your_DCCE connectivity ssh *> set port=[Port]
Your_DCCE connectivity ssh *> set username=dummy
Your_DCCE connectivity ssh *> set credentials.type=PasswordCredential
Your_DCCE connectivity ssh *> set credentials.password=dummy
Your_DCCE connectivity ssh *> commit




DCCE above stands for Delphix Continuous Compliance Engine (formerly Delphix Masking Engine).


Use this to exit when done:

Your_DCCE connectivity ssh *> discard
Your_DCCE connectivity> exit 


All test connections will fail (as we are using SSH and dummy user). This is acceptable. We are going to use the response code to determine if the host can be reached and the port accepts connections.


The first two lines (Error and Actions) should be ignored. Example below: 

Your_DCCE connectivity ssh *> commit
   Error: An error occurred when attempting to connect to remote host "[IP_Addr|Hostname]".
  Action: Check connectivity to the host and try again. Verify the host address is correct for the environment.


This message indicates the host can be reached and the port accepts connections. The output is an error message when the connection failed to log in to the (ssh) service.

  Output: ...: Server closed connection during identification exchange

Failure - port not listening

If the test fails to connect to the port the following message is shown:

Output: ...: Connection refused (Connection refused)

Failure - host cannot be reached

If the host cannot be reached, then the connection fails with a timeout (the connection test will try x minutes and then timeout the connection):

Output: ...: Connection timed out (Connection timed out)


Related Articles

The following articles may provide more information or related information to this article: