Reference13r1:Services/Update

From innovaphone-wiki

Jump to: navigation, search
There are other versions of this article: Reference | Reference7 | Reference8 | Reference9 | Reference11r1 | Reference13r1 (this version)

Since V13 the UpdateURL will be used for the oldstyle Update or the new provisioning process.
You have to decide for which scenario you want to use the UpdateURL configuration.

Contents

V13 provisioning and configuration/firmware with the Devices app

There was a default value in the Firmware which will be used to reach config.innovaphone.com for Provisioning. If you dont want to use the vendor provisioning servers, you can change the URL to use your own offline Provisioning.

Operations like device configurations and firmwareupgrades should be done in the Devices App.

If the Phone boots up the first time and a UpdateURL via local DHCP will be delivered, this process doesn't work. If the Phone connects the first time to the vendor Provisioning System the UpdateURL will be changed with a "/no-dhcp" flag. A UpdateURL which is delivered via DHCP will be ignored.

UpdateURL and your own Scripts or Update Server

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 Reference13r1: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 Error_Messages

Personal tools