Requirements
Linux x64 (kernel 3.10 and later, glibc 2.17-78 and later)
UDMG 1.4 with the modules:
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/:
| Panel |
|---|
# sudo mkdir -p /etc/udmg/udmg-web-transfer
|
Create a configuration file for the service:
| Panel |
|---|
# sudo vi /etc/udmg/udmg-web-transfer/config.toml
|
| Panel |
|---|
[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>"
|
...
Install the binary under /usr/local/bin:
| Panel |
|---|
# sudo install -m 755 udmg-web-transfer /usr/local/bin
|
Setup the Systemd Services
UDMG Web Transfer Client
Create a new service definition:
| Panel |
|---|
# sudo vi /etc/systemd/system/udmg-web-transfer.service
|
| Panel |
|---|
[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
|
...
- Start the service and check the status:
| Panel |
|---|
# systemctl start udmg-web-transfer
# systemctl status udmg-web-transfer
|