Requirements
Linux x64 (kernel 3.10 and later, glibc 2.17-78 and later)
UDMG 2.0 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 time as the UDMG Server component.
Upgrading with Linux Software Packages
Step 1 | Contact your Stonebranch representative or 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.
|
Step 4 | Upgrade the UDMG package (RPM or DEB), for example:
|
Step 5 | Review the component configuration file. |
Step 6 | Start the components service.
|
Upgrading a Manual Installation
Step 1 | Contact your Stonebranch representative or 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.
|
Step 4 | Replace the component binary.
|
Step 5 | Review the component configuration file.
|
Step 6 | Start the components service.
|
Installing UDMG Web Transfer Client
Installing with Linux Software Packages
Step 1 | Contact your Stonebranch representative or Customer Support to receive the software package for the intended operating system. |
---|---|
Step 2 | Install the UDMG packages (RPM or DEB), for example:
|
Step 3 | Review the component configuration file. |
Step 4 | Start the components service.
|
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]
####################################
# The settings section configures the
# Web Transfer Client UI
####################################
## 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,
# beware that this can affect the security or the performance
#############################################
## 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, default false, recommended to 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 endpoint /metrics, default false
metrics = false
## Enable Rate limit, no default, value of 0 disables the rate limit
limit = 50
## Update Interval, frequency of synchronization with the local auth service, default is 30 (seconds)
update_interval = 30
[secrets]
#############################################
# The secrets section configures the connection towards udmg-server
# and the Web Transfer Client Authentication Server (local-auth)
# There are no default, the local-auth server must be defined and started in the UDMG Server
#############################################
## URL of the Web Client Authentication server API, local-auth server
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.tomlExecStart=/bin/sh -c 'exec /usr/local/bin/udmg-web-transfer'
Restart=on-failure
[Install]
WantedBy=multi-user.target
- Enable the new service:
#
systemctl enable sudo
udmg-web-transfer
.serviceCreated 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 sudo
udmg-web-transfer
#
systemctl status sudo
udmg-web-transfer