Tutorial - Creating a PeSIT Server

Owned by Stonebranch (Deactivated)
Last updated: May 03, 2023 by Olivier Michaut

In this tutorial, you will:

  • Create a PeSIT server.

  • Manually launch the server.

  • View server details.

Step 1

From the UDMG navigation pane, select Management > Servers. The Servers list displays.

Step 2

Click New. The Server Details displays.

  • In the Server Name field, enter stonebranch-pesit-01

  • In the Protocol field, select PeSIT

  • In the IP Address field, enter 0.0.0.0

  • In the Port field, enter 2021

  • In the Root Directory field, enter pesit-01-server

  • In the Receive Directory field, enter in

  • In the Send Directory field, enter out

  • In the Temp Directory field, enter tmp

Step 3

Click the Configuration tab on the Partner detail panel

  • In the Pre Connect Username field, enter pre_user

  • In the Pre Connect Password field, enter pre_pass

  • In the Caller ID (PI3) field, enter PesitCaller

  • In the Partner ID (PI3) field, enter PesitServer

  • In the Access Type (PI32) field, select RW

  • In the Data Element Max Size (PI25) field, enter 2048

  • In the Access Control (PI5) field, enter control

  • In the Checkpoint interval (PI7) field, enter 1024

  • In the Checkpoint window (PI7) field, enter 3

  • In the Compression (PI21) field, select No

  • In the Compression Type (PI21) field, select None

  • In the Article Format (PI31) field, select Fixed

  • In the Article Length (PI32) field, enter 4096

Step 4

Click Save and Confirm.

Step 5

Click the Accounts tab on the Partner detail panel. Add an account.

It is required to define an account for the Caller ID. The user name must be the Caller Id that is sent by the PeSIT client and that is defined on the server configuration tab.

  • In the Name field, enter PesitCaller.

  • Leave the Password field empty

Step 6

Click Save

Step 7

Restart the MFT Waarp Gateway service.

For example on Linux:

systemctl restart mft_waarp_gateway


Step 8

Login again to the UDMG User Interface.

Step 9

Click to MFT Server Status button to show the list of running services.

The new server stonebranch-pesit-01 is listed and should appear with a green status which means there is now a SFTP server listening on the IP and port that we configured.

Step 10

From the UDMG navigation pane, select Management > Rules. The Rules list displays.

Step 11

Click New. The Rule Details displays.

  • In the Rule Name field, enter pesit-01_receive.

  • In the Direction field, select Receive.

  • In the Description field, enter any value, for example "Receive PeSIT files under 'pesit_dir' folder".

  • In the Path Directory field, enter pesit_dir

  • In the Local Directory field, enter pesit_dir.

  • In the Remote Directory field, enter pesit_dir

  • In the Temp Directory field, leave it empty

Step 12

Authorize the receive rule for the server

Step 13

The server is ready to accepts files.

See the Tutorial - Creating a PeSIT Partner for an example of transfer with the integrated UDMG PeSIT client


Note

According to the protocol specification, the following constraints are checked when setting the configuration parameters:

  • Pre Connect Username is mandatory and must be less than 9 characters

  • Pre Connect Password is mandatory and must be less than 9 characters

  • Caller ID (PI3) field is mandatory and must be less than 25 characters

  • Partner ID (PI3) field is mandatory and must be less than 25 characters

  • Data Element Max Size (PI25)  is mandatory and must > 0

  • Access Control (PI5) is optional and must be less than 17 characters

  • Article Length (PI32) is mandatory and must > 0

An error "the protocol configuration is invalid" is raised if one of these values is not correct.