UDMG Web Transfer Client for Linux Installation

Owned by
Stonebranch
Last updated: Feb 21, 2023
1 min read

Requirements

  • Linux x64 (kernel 3.10 and later, glibc 2.17-78 and later)

  • UDMG 1.2 with the modules:

    • UDMG Admin UI

    • UDMG Authentication Proxy

    • UDMG Server (Waarp Gateway)

Installing UDMG Web Transfer Client

  • Create a directory under /etc/mft/:

# mkdir -p /etc/mft/web_transfer_client

  • Create a configuration file for the service:

# vi /etc/mft/web_transfer_client/config.toml


[settings]
####################################
# Web Transfer Client
####################################
## Network interface, default "0.0.0.0"
inet = "0.0.0.0"
## Port, default "5050"
port = "5050"
## Working directory
workdir = "/home/mft"
## SSL certificate, uncomment to enable HTTPS
#ssl_cert = "path_to_file.crt"
#ssl_cert_key = "path_to_file.key"
#############################################
# Fine tuning parameters
#############################################
## Enable recover on panic, default true, should be true for production environment
recover = true

## Enable Cross-Origin Resource Sharing (CORS), should be true for production environment
cors = true
## Enable Request Track ID, default true
tracker = true
## Enable Request Logguer, default true
logger = true
## Enable Prometheus Metric /metrics
metrics = true
## Enable Ratelimit
limit = 50
## Update Interval, number of seconds before to send a upload to the local auth service
update_interval = 60


#############################################
# Web Transfer Client Authentication Server
# This is defined in the UDMG Server
#############################################
[secrets]
## URL of the Web Client Authentication server API
endpoint = "http://<LOCAL-AUTH-ADRESS>:<LOCAL-AUTH-PORT>"
## API Key to authenticate to the Web Client Authentication server
apikey = "<API_KEY>"

The placeholders LOCAL-AUTH-ADRESS, LOCAL-AUTH-PORT and API _KEY must be set to the values from the local authentication server that is configured on the UDMG Admin UI, see Tutorial - Create Authentication Server for UDMG Web Transfer Client.

  • Install the binary under /usr/local/bin:

# install -m 755 mft_web_upload /usr/local/bin

Setup the Systemd Services

UDMG Web Transfer Client

Create a new service definition:

# vi /etc/systemd/system/mft_web_transfer_client.service

[Unit]
Description=MFT Web Transfer Client

[Service]
Type=simple
User=mft
Group=mft
WorkingDirectory=/home/mft
Environment=MFT_WEB_UPLOAD=/etc/mft/web_transfer_client/config.toml
ExecStart=/bin/sh -c 'exec /usr/local/bin/mft_web_upload'
Restart=on-failure

[Install]
WantedBy=multi-user.target

  • Enable the new service:

# systemctl enable mft_web_transfer_client.service
Created symlink /etc/systemd/system/multi-user.target.wants/mft_web_transfer_client.service → /etc/systemd/system/mft_web_transfer_client.service.

  • Start the service and check the status:

# systemctl start mft_web_transfer_client
# systemctl status mft_web_transfer_client