Tutorial - Creating a PeSIT Server

Owned by
Stonebranch
Jul 19, 2023
3 min read

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

Start the server by clicking on the start (play) button.

Step 8

Click to UDMG 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 PeSIT server listening on the IP and port that we configured.

Step 9

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

Step 10

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 11

Authorize the receive rule for the server

Step 12

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.