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

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.

Upgrading with Linux software packages

Step 1	Contact your Stonebranch representative or the Customer Support to receive the software package for the intended operating system.
Step 2	Perform the recommended backup of configuration files.
Step 3	Stop the components service. `sudo systemctl stop udmg-web-transfer`
Step 4	Upgrade the UDMG package (RPM or DEB), for example: `sudo rpm -Uvh udmg-web-transfer-1.4.0.0+build.4.x86_64.rpm`
Step 5	Review the component configuration file. `/opt/udmg/etc/udmg/web-transfer/config.toml` Note that new configuration file templates (with the extension .rpmnew or .dpk-new) that contains all the allowed parameters are added during the software package upgrade.
Step 6	Start the components service. `sudo systemctl start udmg-web-transfer`

Upgrading a manual installation

Step 1	Contact your Stonebranch representative or the Customer Support to receive the software package for the intended operating system.
Step 2	Perform the recommended backup of configuration files.
Step 3	Stop the components service. `sudo systemctl stop udmg-web-transfer`
Step 4	Replace the component binary `sudo cp udmg-web-transfer.bin /opt/udmg/bin/udmg-web-transfer`
Step 5	Review the component configuration file. `/opt/udmg/etc/udmg/web-transfer/config.toml`
Step 6	Start the components service. `sudo systemctl start udmg-web-transfer`

Installing UDMG Web Transfer Client

Installing with Linux software packages

Step 1	Contact your Stonebranch representative or the Customer Support to receive the software package for the intended operating system.
Step 2	Install the UDMG packages (RPM or DEB), for example: `sudo rpm -ivh udmg-web-transfer-1.4.0.0+build.4.x86_64.rpm`
Step 3	Review the component configuration file. Refer to each component installation section below for the list of parameters. `/opt/udmg/etc/udmg/web-transfer/config.toml`
Step 4	Start the components service. `sudo systemctl start udmg-web-transfer`

Performing a manual installation

Create a directory under /etc/udmg/:

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

Create a configuration file for the service:

# sudo 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:

# sudo install -m 755 udmg-web-transfer /usr/local/bin

Setup the Systemd Services

UDMG Web Transfer Client

Create a new service definition:

# sudo 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:

# sudo 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:

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

UDMG Web Transfer Client for Linux Installation