Reference9:Services/Update

From innovaphone wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
There are also other versions of this article available: Reference | Reference7 | Reference8 | Reference9 (this version) | Reference11r1 | Reference13r1

On this page the device can be configured to poll an update server (a normal web server). A file pointed to by an URL is read from the update server and executed. This is an efficient mechanism to keep a large number of devices up to date. See Reference9:Update Server for a detailed description of the available commands.

URL An URL, for example http://192.168.0.1/update/script-ip800.txt, pointing to a file whose commands are executed.

If the URL ends with a slash '/', for example http://192.168.0.1/update/, the device is adding the file name update-ipxxx.htm automatically, deduced from the device short name (for example update-ip800.htm). Furthermore some placeholders may be used in the URL-String as described in the update servers scfg command description.

These placeholders may be used e.g. to address a device-specific directory (http://192.168.1.2/update/#h/script.txt) or to generate HTTP-GET parameters (http://192.168.0.1/update/script.php?mac=#m).

Some standard parameters are always appended to the query part of the URL:

name value example
ver human readable version information (as shown in the Version' line of the general page (display, for programmatic use rather apply #F etc.) 7.00 dvl-sr1 IP6000[07-60600.03], Bootcode[145], HW[104] 16384/131072
BOOT last serial for boot command 336
PROT last serial for prot command 07-6060003
CHECK last serial for check command 20070511-01
BMC last serial for bmc command
CFG last serial for cfg command
CFG-BACKUP-NUM last backup number for scfg command

If access to the command file requires authentication it must be configured within the HTTP-Client of the device. See Configuration/General/HTTP-Client.

Interval An interval (in minutes) at which the file is re-read and executed. To restrict the update to certain hours (e.g. only during the night), there are mechanisms within the available commands to restrict the execution of the commands. The polling of the command file cannot be restrcited.

Current Update Serials

The Current Update Serials section shows the values of the variables set after last successful execution of the associated command. These values are provided as standard parameters in the query part of the URL.

name command
BOOT boot
PROT prot
CHECK check
BMC bmc
CFG cfg
CFG-BACKUP-NUM scfg

The Update Serials can be cleared using:

mod cmd UP1 reinit

This can be useful if a device should be handled as virgin, without performing a factory reset (please note that mod cmd UP1 cmds except for poll only work from within update scripts, not from the command line),

Update Client Error Codes

See Update Server, Common Problems