# Client Connection: PESIT

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 Pesit 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 PESIT 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>PESIT REMOTE NODE IDENTIFIER</strong></td><td>Remote identifier of PESIT. Logical identifier that is submitted to Data One. If an ID different from the ID contained in this field is submitted, the connection fails. The maximum number of characters is 24. Blanks are not supported. Special characters allowed: - _ .</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>PESIT LOCAL NODE IDENTIFIER</strong></td><td>Local Identifier of PESIT. Logical identifier that Data One submits to connect. If an ID different from the ID contained in this field is submitted, the connection fails.<br>The maximum number of characters is 24. Blanks are not supported. Special characters allowed: - _ .</td></tr><tr><td><strong>INTERVAL BETWEEN SYNC POINTS</strong></td><td>Number of synchronization points in Kb used to restart a transfer after an incident. Default number: 1024. The value of this field must always be greater or equal to 4.</td></tr><tr><td><strong>ACKNOWLEDGEMENT WINDOW SIZE</strong></td><td>Acknowledgement window size. This is the number of synchronization points without answer that can be sent before the transfer is stopped. Default number: 3.</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>

### PESIT Protocol Configuration

To set up a PeSIT configuration, define the following entities:

* a VFS
* a Remote Actor with a User
* a remote connection to a Remote PeSIT node
* a Server template with PeSIT protocol

In the Actors section, click the **New** button and create Partner PXFB01.\
Click the **New User** button and create User USR99:

<figure><img src="/files/g1hqhlJnayTzRLTTeraj" alt=""><figcaption></figcaption></figure>

Go to the **VFS** tab and click the **NEW** button to define a **VFS** for Partner PXFB01:

Go to **Setup → STENG, Clusters & Servers** and define a new PeSIT remote Server to connect to/be connected from.\
Click the **NEW SERVER** button and define connection parameters to the remote PeSIT Node XFB01:

| Parameters            | Value                                |
| --------------------- | ------------------------------------ |
| **PROTOCOL TYPE**     | PeSIT                                |
| **SERVER NAME**       | PXFB01\_PROTOCOL                     |
| **DESCRIPTION**       | Remote Access Config Pesit x XFB01   |
| **ENABLED**           | Yes                                  |
| **DMZ PROXY ENABLED** | No                                   |
| **REMOTE HOST**       | IP of the remote Host                |
| **REMOTE PORT**       | Port of remote Host                  |
| **USERNAME**          | Username to establish the connection |
| **REMOTE ID**         | XFB-01                               |
| **LOCAL ID**          | SPENTC12                             |

{% hint style="warning" %}
Do not set a password to connect to the XFB-01 remote PeSIT node. The parameters not mentioned can be omitted.
{% endhint %}

Now define the PeSIT **Server Template**, with the following parameters:

Server configuration:

| Parameters                 | Value              |
| -------------------------- | ------------------ |
| **PROTOCOL TYPE**          | PeSIT              |
| **TEMPLATE NAME**          | PESIT01            |
| **DESCRIPTION**            | PeSIT local server |
| **ENABLED**                | Yes                |
| **DEFAULT LISTENING PORT** | 51600              |
| **DIAGNOSTIC PORT 1**      | 51601              |
| **DIAGNOSTIC PORT 2**      | 51602              |
| **MAXIMUM PDU SIZE**       | 30000              |

The PESIT server is now installed in the STENG folder. Note that if the path of this folder is **longer than 52 characters**, the PESIT server **cannot be run**, and an error appears in the\
messages.log.\
To solve this issue, you must **create a Symbolic Link** (SymLink) and **edit the server.env** file as shown in the example here below:\
`Steng folder = /home/user1/installation/ghibli-home/wlp/usr/servers/steng`

Information available in the server.env installation file:\
`KEYMXMS=PRIMPESI-AA7BB8O483`\
`OSIVERS=3.6B.01`\
`OSIROOT=/home/user1/installation/ghibli-home/wlp/usr/servers/steng/pesit/SPRun/pesit`

Create the SymLink:\
Go to`ln -s /home/user1/installation/ghibli-home/wlp/usr/servers/steng /home/user1/PesitDeploy`

and modify the server.env file:\
`KEYMXMS=PRIMPESI-AA7BB8O483`\
`OSIVERS=3.6B.01`\
`PESIT_DEPLOY_DIR==/home/user1/PesitDeploy`\
`OSIROOT=/home/user1/PesitDeploy/pesit/SPRun/pesit`

Incoming call:

| Parameters           | Value                  |
| -------------------- | ---------------------- |
| **NAME**             | Ic\_pesit01            |
| **DESCRIPTION**      | Incoming call x XFB-01 |
| **INCOMING ADDRESS** | 0.0.0.0                |
| **ACTOR**            | PXFB01                 |

Allocate the Server Template to a cluster.

{% hint style="warning" %}
Use 0.0.0.0 as IP for local PeSIT to expose the right listening server port
{% endhint %}

The configuration is now completed.


---

# 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-pesit.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.