Reference:Configuration/General/Update: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
m (link adjusted)
No edit summary
Line 4: Line 4:
|valign=top nowrap=true|'''URL'''
|valign=top nowrap=true|'''URL'''
|An URL, for example <nowiki>http://192.168.0.1/update/script-ip800.txt</nowiki>, pointing to a file whose commands are executed.
|An URL, for example <nowiki>http://192.168.0.1/update/script-ip800.txt</nowiki>, pointing to a file whose commands are executed.
If the URL ends with a slash '/', for example <nowiki>http://192.168.0.1/update/</nowiki>, the device is adding the file name update-ipxxx.htm automatically, deduced from the device short name (for example update-ip800.htm). Furthermore the placeholder #h and #m can be used in the URL-String:
 
* #h - will be replaced by the device short name (for example IP800).
If the URL ends with a slash '/', for example <nowiki>http://192.168.0.1/update/</nowiki>, 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 [[Reference:Update Server#SCFG_command | the update servers scfg command description]].
* #m - will be replaced by the device mac-adress (for example 00-90-33-01-02-03).
 
These placeholders may be used e.g. to address a device-specific directory (<nowiki>http://192.168.1.2/update/#h/script.txt</nowiki>) or to generate HTTP-GET parameters (<nowiki>http://192.168.0.1/update/script.php?mac=#m</nowiki>). If access to the command file requires authentication it must be configured within the HTTP-Client of the device. See [[Reference:Configuration/General/HTTP-Client|Configuration/General/HTTP-Client]].
These placeholders may be used e.g. to address a device-specific directory (<nowiki>http://192.168.1.2/update/#h/script.txt</nowiki>) or to generate HTTP-GET parameters (<nowiki>http://192.168.0.1/update/script.php?mac=#m</nowiki>).  
 
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 [[Reference:Configuration/General/General | general page ]] (display, for programmatic use rather apply [[Reference:Update Server#SCFG_command | '''#F''']] etc.) || 6.00 dvl-sr1 IP6000[07-60600.03], Bootcode[145], HW[104] 16384/131072
|-
| BOOT || last tag for [[Reference:Update Server#Boot_command | '''boot''']] command || 336
|-
| CHECK || last tag for [[Reference:Update Server#Check_command | '''check''']] command || 20070511-01
|-
| PROT || last tag for [[Reference:Update Server#Prot_command | '''prot''']] command || 07-6060003
|-
| BMC || last tag for [[Reference:Update Server#Bmc_command | '''bmc''']] command ||
|}
 
 
 
If access to the command file requires authentication it must be configured within the HTTP-Client of the device. See [[Reference:Configuration/General/HTTP-Client|Configuration/General/HTTP-Client]].
|-
|-
|valign=top nowrap=true|'''Interval'''
|valign=top nowrap=true|'''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.
|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.
|}
|}

Revision as of 16:05, 30 May 2007

On this page the device can be configured to poll an update server (a normal web server). The file configure with the 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 Howto: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.) 6.00 dvl-sr1 IP6000[07-60600.03], Bootcode[145], HW[104] 16384/131072
BOOT last tag for boot command 336
CHECK last tag for check command 20070511-01
PROT last tag for prot command 07-6060003
BMC last tag for bmc 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.