Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Requirements

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

  • UDMG 1.4 with the modules:

    • UDMG Admin UI

    • UDMG Authentication Proxy

    • UDMG Server

Installing UDMG Web Transfer Client

  • Create a directory under /etc/udmg/:

# mkdir -p /etc/udmg/udmg-web-transfer

  • Create a configuration file for the service:

# vi /etc/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 = "/home/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 Rate limit
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 udmg-web-transfer /usr/local/bin

Setup the Systemd Services

UDMG Web Transfer Client

Create a new service definition:

# vi /etc/systemd/system/udmg-web-transfer.service

[Unit]
Description=UDMG Web Transfer

[Service]
Type=simple
User=udmg
Group=udmg
WorkingDirectory=/home/udmg
Environment=UDMG_WEB_TRANSFER=/etc/udmg/udmg-web-transfer/config.toml
ExecStart=/bin/sh -c 'exec /usr/local/bin/udmg-web-transfer'
Restart=on-failure

[Install]
WantedBy=multi-user.target

  • Enable the new service:

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

  • Start the service and check the status:

# systemctl start udmg-web-transfer
# systemctl status udmg-web-transfer

  • No labels