# Client Connection: SMB v3 or later versions

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

<table><thead><tr><th width="229.9998779296875">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 SMB 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 SMB 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>NETBIOS FALLBACK</strong></td><td>When creating a new SMB3 client connection, this button is enabled by default, but you can change it as needed. When enabled, NetBIOS port 139 is used in case of connection errors.</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>DOMAIN *</strong></td><td>User domain.</td></tr><tr><td><strong>SHARE NAME *</strong></td><td>Name of the share to be mounted.</td></tr><tr><td><strong>BUFFER SIZE *</strong></td><td>Size of the buffer to be used when reading/writing data.<br>Default value: 1 MB</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><tr><td><strong>CONFIGURATION TEST</strong></td><td>Use this section to test that the <strong>Cluster</strong> and the <strong>STENG</strong> are connected correctly. Select a <strong>Cluster</strong> and a <strong>STENG</strong> you want to test and click the <strong>TEST</strong> button. Data One <strong>automatically</strong> selects a <strong>Cluster</strong> and a <strong>STENG</strong> to test the connection. Note that a Cluster will be selected only if it is the only one available.<br>A message with a green check will confirm a successful connection. A message with a red exclamation mark will warn about an unsuccessful connection. The message also details the reason why the connection fails.<br>The connection might not be successful for different reasons, each of them depending on the transport type and the configuration.<br>The first time you try to test the connection, if trusting certificates are missing, an error message detailing the unsuccessful connection will appear. In this case, go to the <strong>Setup</strong> → <strong>Untrusted Cache</strong> → <strong>Certificates</strong> tab and trust the relevant certificates.<br>Note that trusting certificates in the Untrusted Cache page may not be sufficient to establish a successful connection. Refer to the <a href="/pages/riYYXT6YPDLkxQCEKrVk">Untrusted Cache</a> section of this documentation for all the details.</td></tr></tbody></table>

Unlike other protocols, SMB does not allow files to be edited, deleted, or downloaded when the "Show hidden files" option is activated in the destination folder until the transfer is complete. This is the default behavior.

Unlike other protocols, SMB client connections will not create folders that do not already exist on the remote SMB server. In this case, file transfer operations will fail, and a clear error message will specify that the folder does not exist. This error message also appears in the Central Log. This behavior occurs regardless of whether the user has the necessary permissions to create the folder on the remote server.\
To apply the same behavior as other protocols, i.e., to create folders if they do not exist on the remote SMB server, configure the client.connections.createMissingDir.permitted advanced setting with the names of the client connections separated by commas:

* **Module**: ghibli-speng-centralnode
* **Section**: smb3
* **Property Name**: client.connections.createMissingDir.permitted
* **Value**: names of client connections separated by commas


---

# 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-smb-v3-or-later-versions.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.