/
UDMG Web Transfer Client for Windows Installation

UDMG Web Transfer Client for Windows Installation

Jun 10, 2023

Requirements

Installing UDMG Web Transfer Client

  • Create a directory C:\MFT\Web_Transfer_Client:

  • Create a configuration file for the service:

# C:\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 = "C:\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 C:\MFT\Web_Transfer_Client

mft_web_upload.ex


Setup the Windows Service with WinSW


UDMG Web Transfer Client


Download WinSW and copy winsw.exe under C:\MFT\Web_Transfer_Client with the following name: mft_web_upload-service.exe


Create a new Service definition for our Service:


id: MFT Web Transfer Client
name: MFT Web Transfer Clientt
description: MFT Web Transfer Client
executable: C:\MFT\Web_Transfer_Client\mft_web_upload.exe
priority: Normal
workingdirectory: C:\MFT\Web_Transfer_Client
env:
- name: MFT_WEB_UPLOAD
value: 'C:\MFT\Web_Transfer_Client\config.toml'

Open a command prompt under C:\MFT\Web_Transfer_Client and run the command

C:\MFT\Web_Transfer_Client>mft_web_upload-service.exe install
2022-07-11 11:23:24,653 INFO - Installing service 'MFT Web Transfer Client (MFT Web Transfer Client)'...
2022-07-11 11:23:24,680 INFO - Service 'MFT Web Transfer Client (MFT Web Transfer Client)' was installed successfully.

Start the service

C:\MFT\Web_Transfer_Client>mft_web_upload-service.exe install
2022-07-11 11:23:24,653 INFO - Starting service 'MFT Web Transfer Client (MFT Web Transfer Client)'...
2022-07-11 11:23:24,680 INFO - Service 'MFT Web Transfer Client (MFT Web Transfer Client)' started successfully.