# Client Connection: HDFSS

Fields with the asterisk **\*** are mandatory.

<table><thead><tr><th width="230">Properties</th><th>Description</th></tr></thead><tbody><tr><td><strong>STATUS</strong></td><td><p>Enable or disable the client connection. Possible values:</p><ul><li>Enabled (default)</li><li>Disabled</li></ul></td></tr><tr><td><strong>NAME *</strong></td><td>Name of the HDFSS connection you are creating. The maximum number of characters is 128. Blanks and the ' " | special characters are not supported.</td></tr><tr><td><strong>DESCRIPTION</strong></td><td>Description of the HDFSS connection you are creating. The maximum number of characters is 2048.</td></tr><tr><td><strong>HOST *</strong></td><td>Remote host IP Address or hostname.</td></tr><tr><td><strong>PORT *</strong></td><td>Port to connect to the remote host (1 to 65535).</td></tr><tr><td><strong>USERNAME</strong></td><td>Username to be used for the connection. The maximum number of characters is 320.</td></tr><tr><td><strong>PASSWORD</strong></td><td>User password.</td></tr><tr><td><strong>CONNECTION TIMEOUT *</strong></td><td>Number of seconds without network activity to wait before closing a session due to inactivity.<br>Default value: 60.</td></tr><tr><td><strong>CLIENT KEY LABEL</strong></td><td>Key identifier to create the SSL connection</td></tr><tr><td><strong>SSL AUTHENTICATION PROTOCOL</strong></td><td><p>Select the SSL authentication protocol:</p><ul><li>ALL</li><li><p>ONLY SPECIFIC VALUES:</p><ul><li>SSLv3</li><li>TLSv1</li><li>TLSv1_1</li><li>TLSv1_2</li><li>TLSv1_3</li></ul></li></ul></td></tr><tr><td><strong>ACCEPTED CIPHER SUITES</strong></td><td><p>Select the cipher suites. Possible values:</p><ul><li>ALL</li><li>ONLY SPECIFIC VALUES. See <a href="/pages/bXblCQPvaPonLHqKDwk2#accepted-cipher-suites">ACCEPTED CIPHER SUITES</a> for details.</li></ul></td></tr><tr><td><strong>MATCH SERVER HOSTNAME</strong></td><td><p>Specify whether the client should verify that the server’s certificate matches the hostname (the <strong>HOST</strong> value) it is connecting to.</p><ul><li><strong>Enabled:</strong> the client checks that the server’s certificate Distinguished Name (DN) includes the IP address or hostname that was contacted.</li><li><strong>Disabled (default):</strong> no hostname verification is performed.</li></ul></td></tr><tr><td><strong>KNOX ENDPOINT *</strong></td><td>Path or instance of Knox. This information must be provided by the System Administrator.</td></tr><tr><td><strong>KNOX CLUSTER *</strong></td><td>In this field, select the Knox topology, i.e. the configuration to access Apache Knox and Hadoop. This information must be provided by the System Administrator.<br>Apache Knox can support one Hadoop Cluster. The configuration of the Hadoop Cluster is defined in a topology deployment descriptor file.</td></tr><tr><td><strong>HDFS AUTHENTICATION *</strong></td><td><p>Select the network authentication protocol. Possible values:</p><ul><li>KERBEROS</li><li>BASIC</li></ul></td></tr><tr><td><strong>HDFS KEYTAB</strong></td><td>Absolute path of the .keytab file saved on the STENG.<br>E.g.: /etc/kerberos_guest.keytab.</td></tr><tr><td><strong>USE WEB PROTOCOL WITH HDFS</strong></td><td><p>Possible values:</p><ul><li>Enabled</li><li>Disabled (default)</li></ul><p>Enable this option if HDFS must use a proprietary or HTTP Protocol.<br>If you enable only this option, connection to Hadoop can occur either with a proprietary protocol or with HTTP.</p></td></tr><tr><td><strong>USE KNOX WITH HDFS</strong></td><td><p>If enabled, HDFSS will use Knox. Possible values:</p><ul><li>Enabled</li><li>Disabled (default)</li></ul></td></tr><tr><td><strong>MAX RETRIES *</strong></td><td>Maximum number of retries. If this field is empty or set to 0, no retries will be executed and the job will be set to Failed if the first attempt is not successful. A high value corresponds to a high number of retrying attempts.</td></tr><tr><td><strong>RETRY INTERVAL</strong></td><td>This field will appear only if you have set the maximum numbers of retries to 1 or greater.<br>Time (in seconds) waited before retrying executing a job. The lower the value, the more frequent the retrying attempts. If this field is empty or set to 0, no retries will be executed and the job will be set to Failed if the first attempt is not successful.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-mover-1.21/transfer-protocols-and-connectors/client-connections/client-connection-hdfss.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.