Reference11r1:Services/Update

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 Reference10:Concept_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 info 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 Services/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