8. Firmware Update
UMX-HDMI-140 series– User's Manual
138
Applied firmware package: v1.3.0b5 | 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.7 --backupFile C:\mybackup.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.7 --backupFile C:\mybackup.lw3 --keepOriginalIp
[2021-04-28 07:51:23.206] [ INFO] [ main] - Executing configuration restore...
[2021-04-28 07:51:23.219] [ INFO] [ main] - Device IPs: [192.168.1.7]
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:\UMX-HDMI-140_v1.3.0b5.lfp2
c:\Program Files (x86)\Lightware\Lightware Device Updater V2>lib\jre\bin\java.exe -jar lib\ldu2.jar packageOptions
--package C:\UMX-HDMI-140_v1.3.0b5.lfp2
Backup and restore options:
--factoryDefault: if set to true device will reset to factory default settings after the upgrade process is
finished, default: false
--restoreFromBackup: if true, no device configuration is restored from the backup created at the
begininning of upgrade process (default: true)
--skipPresetsAtRestore: If true. Device presets will be skipped at restore. (default: false)
--backupFolder: folder to create configuration backup into
Advanced backup and restore options:
--forceNoBackup: if true, no backup file will be created (default: false)
--uploadDefaultMiniWeb: If true, the default built-in miniweb will be uploaded to the device. (default:
false)
Login options:
--clearTextLoginPw: The login password used when updating devices. (It's cleartext password!)
INFO:
There is a known bug in UMX-HDMI-140_v1.3.0b5.lfp2 package file: the double dashes of the
options are not displayed in the description, however, above example shows correctly. The double dash is
a must when applying a special parameter during update.
Package option example can be seen in the following section.
