Reference:Configuration/General/Update: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
m (Links adjusted)
No edit summary
Line 1: Line 1:
The '''update''' server is used for efficient administration of various VoIP devices. The update server reads a file at intervals from a configurable URL (Uniform Resource Locator).
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.


* '''Command File URL:'''
{|
<blockquote>
|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).
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:
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).
* #h - will be replaced by the device short name (for example IP800).
* #m - will be replaced by the device mac-adress (for example 00-90-33-01-02-03).
* #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>).
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]].
If the directory of the file is password-protected, the access credentials must be specified in the chapter "[[Reference:Configuration/General/HTTP-Client|Configuration/General/HTTP Client]]".
|-
</blockquote>
|valign=top nowrap=true|'''Interval'''
* '''Interval [min]:''' An interval (in minutes) at which the file is re-read and executed.
|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.
 
|}
Detailed information on the update server and the update script is contained in "[[Howto:Update Server|Configuration of the update server]]".

Revision as of 14:27, 7 April 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 the placeholder #h and #m can be used in the URL-String:

  • #h - will be replaced by the device short name (for example IP800).
  • #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 (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). 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.

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.