Tutorial - Creating and Manually Starting an FTPES Server

Owned by
Stonebranch
Jul 19, 2023
3 min read

In this tutorial, you will:

  • Create a FTPES 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-ftpes-01
  • In the Protocol field, select FTPES
  • In the IP Address field, enter 0.0.0.0
  • In the Port field, enter 4000
  • In the Root Directory field, enter data
  • In the Receive Directory field, enter ftpes-01/in
  • In the Send Directory field, enter ftpes-01/out
  • In the Temp Directory field, enter ftpes-01/tmp
  • In the Member of Business Service, select one of the available Business Services. More business Services can be added after the rule is created. 

Step 3

Click Save and Confirm.

Step 4

Prepare the certificate and privake key in PEM format.

To generate a sample self-signed certificate with openssl > 1.1.1:

$ openssl req -new -subj "/C=AR/ST=AR/L=AR/O=AR/OU=AR/CN=localhost" -newkey rsa:2048 -x509 -sha256 -days 365 -nodes -out ftpes-01.crt -keyout ftpes-01.key -addext 'subjectAltName = IP:0.0.0.0,DNS:localhost'
Step 5

Select the stonebranch-ftpes-01 server from the Server list panel and click the Certificates tab.

Step 6

Click the Add Certificate button

Step 7

The Certificate Details displays.

  • In the Name field, enter stonebranch-ftpes-cert-01.
  • In the Private Key field, paste the key in PEM format
  • In the Certificate field, paste the certificate in PEM format

Step 8

Click Save and Confirm.

Step 9

The certificate record appears in the list:

Step 10

To see more details about a specific server certificate, click the View button (the eye icon).

Click the Private Key to show the key details:

  • algorithm
  • bits: size of the key, only for RSA
  • key type
  • the MD5 fingerprint
  • the SHA256 fingerprint
  • a clean authorized keyline, without any comment or host specification

Click the Certificate option to show the certificate details:

  • signatureAlgorithm
  • algorithm
  • bits
  • version
  • serial number
  • subject
  • issuer
  • validity date notBefore
  • validity date notAfter
  • key usage code
  • isCA flag
  • The MD5 fingerprint
  • The SHA1 fingerprint
  • The SHA256 fingerprint
  • The list of SAN addresses

If the record was just created or updated, click the Refresh button to reload the details.

Step 11

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

Step 12

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

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

Step 13

The server status can be controlled with the following action buttons:

  • Enable: local server is set to start automatically when UDMG Server starts
  • Disable: local server is not starting automatically when UDMG Server starts
  • Start: initiate the start of the local server
  • Stop: request to stop the local server
  • Restart: request to stop and start the server
Step 14

Additional details can be attached to a local server. 

  • Description
  • Primary Contact Name
  • Primary Contact Phone
  • Primary Contact Email
  • Secondary Contact Name
  • Secondary Contact Phone
  • Secondary Contact Email
  • Customized fields

Go to the Details tab on the local server pane.

Fill in the needed details.

New fields can be added with the 'plus' button at the bottom of the form. A custom field is comprised of a key and value pair.

Press the Save button inside the tab to store the details.