Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

Table of Contents

Requirements

...

Note
titleNote

UDMG Web Transfer Client must be upgraded at the same time as the UDMG Server component.


Note
titleNote

If you are upgrading an installation of UDMG from any release prior to 2.0.0.0, the start parameters for component the module have changed.

Please review them carefully, especially for a manual installation or in case the Systemd service files have been edited. 
For a standard upgrade with the provided Linux packages, the service configuration is updated automatically.

The module now requires a 'start' command  to begin in server mode. 

udmg-web-transfer start -f configuration_file

Without it, it will only display the command line usage information.

In addition, a 'test' command allows to verify the the syntax of the configuration file without starting the server.

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.

sudo systemctl stop udmg-web-transfer

Step 4

Upgrade the UDMG package (RPM or DEB), for example:

sudo rpm -Uvh udmg-web-transfer-2.0.0.0.build.11.x86_64.rpm

Step 5

Review the component configuration file.
/opt/udmg/etc/udmg/web-transfer/config.toml
Note that the new configuration file templates (with the extension .rpmnew or .dpk-new) that contain all the allowed parameters are added during the software package upgrade.

Step 6

Review the component service configuration file.

The  service file (/etc/systemd/system/udmg-web-transfer.service) was installed with these parameter in version 1.5

Code Block
titleudmg-auth-proxy.service (Version 1.5)
[Unit]
Description=Stonebranch UDMG Web Transfer

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

[Install]
WantedBy=multi-user.target

Note the addition of the start command on the ExecStart directive on the version 2.0:

Code Block
titleudmg-auth-proxy.service (Version 2.0)
[Unit]
Description=Stonebranch UDMG Web Transfer

[Service]
Type=simple
User=udmg
Group=udmg
WorkingDirectory=/home/udmg
Environment="UDMG_WEB_TRANSFER=/opt/udmg/etc/udmg/web-transfer/config.toml"
ExecStart=/bin/sh -c 'exec /opt/udmg/bin/udmg-web-transfer start'
Restart=on-failure
SyslogIdentifier=udmg-web-transfer
SyslogFacility=local0

[Install]
WantedBy=multi-user.target


Step 7

Start the components service.

sudo systemctl start udmg-web-transfer


...

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.

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

Review the component service configuration file.

The  service file (/etc/systemd/system/udmg-web-transfer.service) was installed with these parameter in version 1.5

Code Block
titleudmg-auth-proxy.service (Version 1.5)
[Unit]
Description=Stonebranch UDMG Web Transfer

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

[Install]
WantedBy=multi-user.target

Note the addition of the start command on the ExecStart directive on the version 2.0:

Code Block
titleudmg-auth-proxy.service (Version 2.0)
[Unit]
Description=Stonebranch UDMG Web Transfer

[Service]
Type=simple
User=udmg
Group=udmg
WorkingDirectory=/home/udmg
Environment="UDMG_WEB_TRANSFER=/opt/udmg/etc/udmg/web-transfer/config.toml"
ExecStart=/bin/sh -c 'exec /opt/udmg/bin/udmg-web-transfer start'
Restart=on-failure
SyslogIdentifier=udmg-web-transfer
SyslogFacility=local0

[Install]
WantedBy=multi-user.target


Step 7

Start the components service.

sudo systemctl start udmg-web-transfer

...