8. Firmware Update
UMX-TPS-TX100 series – User's Manual
155
Applied firmware packages: (UMX-TPS): v1.5.0b4 | (WP-UMX-TPS): v1.4.0b8 | (FP-UMX-TPS): v1.4.0b8 | LDC software: v2.5.6b2
8.6.6.
Restore
Restores device configuration from a backup file.
TIPS AND TRICKS:
This command can be used for uploading a configuration to numerous devices (aka
Configuration cloning by CLI).
Command
LightwareDeviceUpdaterV2_CLI.cmd restore [options]
Options
Option
Description
Required?
-i
or
--ip
List of IP addresses of devices to be updated
one of them is
mandatory
-n
or
--hostName
List of host names of devices to be updated
-b
or
--backupFile
The path of the configuration backup file
yes
-k
or
--keepOriginalIp
Do not override the network settings of the device with the ones
in the backup file. It comes in handy when multiple devices'
configuration is being restored from a single backup file.
Default: false
optional
ATTENTION!
The configuration is restored automatically if the factory default option is not applied in the
update
command.In that case, there is no need to run the
restore
command after the update.
Example
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd restore --ip
192.168.1.14 --backupFile c:\My_backup\backup_UMX_TPS_TX140K_SN00006363.lw3 --keepOriginalIp
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar restore --ip
192.168.1.14 --backupFile c:\My_backup\backup_UMX_TPS_TX140K_SN00006363.lw3 --keepOriginalIp
[2021-05-14 14:11:04.631] [ INFO] [ main] - Executing configuration restore...
[2021-05-14 14:11:04.645] [ INFO] [ main] - Device IPs: [192.168.1.14]
INFO:
The firmware package checks the backup data before the restore procedure and if it is necessary,
a conversion is applied to avoid incompatibility problems between the firmware versions.
In that case,
two backup files are created: the original and a new one with "_converted" suffix. Using the last one for
restoring is recommended.
8.6.7.
Package Options
Shows package-specific update options.
Command
LightwareDeviceUpdaterV2_CLI.cmd packageOptions [options]
Options
Option
Description
Required?
-p
or
--package
The path of the firmware package file
yes
Example
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>LightwareDeviceUpdaterV2_CLI.cmd packageOptions
--package c:\Firmwares\umx-tps-tx100_v1.5.0b4.lfp2
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar packageOptions
--package c:\Firmwares\umx-tps-tx100_v1.5.0b4.lfp2
Backup and restore options:
--skipPresetsAtRestore : if true, device presets will not be restored. (Default: false)
--uploadDefaultMiniWeb : if true and no custom miniweb is present on the device, the default built-in
miniweb will be uploaded to the device. (Default: false)
Login options:
--clearTextLoginPw : The cleartext login password used when updating devices. (Default: empty string)
Test options:
--test : if true, no update will be performed, communication with the device will be tested. (Default:
false)
C:\Program Files (x86)\Lightware\Lightware Device Updater V2>
Package option example can be seen in the following section.