Requirements
Windows Server 2012 R2 (or Windows 8.1) and later
UDMG 1.4 with the modules:
UDMG Admin UI
UDMG Authentication Proxy
UDMG Server
WinSW (https://github.com/winsw/winsw/releases/tag/v2.11.0) for service management, optional.
Upgrading UDMG Web Transfer Client
Note
UDMG Web Transfer Client must be upgraded at the same at the same time as the UDMG Server component.
Installing UDMG Web Transfer Client
Create a directory
C:\UDMG\Web_Transfer_Client
:
Create a configuration file for the service:
# C:\
\UDMG
udmg-web-transfer
\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:\UDMG"
## 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 Cross-Site Request Forgery (CSRF) token, should be true for production environment
csrf = true
## Enable Request Track ID, default true
tracker = true
## Enable Request Logger, 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:\
\UDMG
udmg-web-transfer
udmg-web-transfer
.exe
Setup the Windows Service with WinSW
UDMG Web Transfer Client
Download WinSW and copy winsw.exe
under C:\UDMG\
with the following name: udmg-web-transfer
udmg-web-transfer
-service.exe
Create a new Service definition for our Service:
id: UDMG Web Transfer
name: UDMG Web Transfer
description: UDMG Web Transfer
executable: C:\UDMG\
udmg-web-transfer
\udmg-web-transfer
.exepriority: Normal
workingdirectory: C:\UDMG\
udmg-web-transfer
env:
- name: UDMG_WEB_TRANSFER
value: 'C:\UDMG\
udmg-web-transfer
\config.toml'
Open a command prompt under C:\UDMG\
and run the commandudmg-web-transfer
C:\
\Web_Transfer_Client>UDMG
udmg-web-transfer
-service.exe install2022-07-11 11:23:24,653 INFO - Installing service 'UDMG Web Transfer (UDMG Web Transfer)'...
2022-07-11 11:23:24,680 INFO - Service 'UDMG Web Transfer (UDMG Web Transfer)' was installed successfully.
Start the service
C:\
\Web_Transfer_Client>UDMG
udmg-web-transfer
-service.exe start2022-07-11 11:23:24,653 INFO - Starting service '
UDMG
Web Transfer (UDMG
Web Transfer)'...2022-07-11 11:23:24,680 INFO - Service '
UDMG
Web Transfer (UDMG
Web Transfer)' started successfully.