Reference8:Configuration/General/Update: Difference between revisions
(New page: 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 mech...) |
|||
(2 intermediate revisions by 2 users not shown) | |||
Line 5: | Line 5: | ||
|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 some placeholders may be used in the URL-String as described in [[ | 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 [[Reference8:Update Server#SCFG_command | the update servers scfg command description]]. | ||
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>). | ||
Line 14: | Line 14: | ||
| name || value || example | | name || value || example | ||
|- | |- | ||
| ver || human readable version information (as shown in the ''Version''' line of the [[ | | ver || human readable version information (as shown in the ''Version''' line of the [[Reference8:Configuration/General/Info | general page ]] (display, for programmatic use rather apply [[Reference8:Update Server#SCFG_command | '''#F''']] etc.) || 7.00 dvl-sr1 IP6000[07-60600.03], Bootcode[145], HW[104] 16384/131072 | ||
|- | |- | ||
| BOOT || last serial for [[ | | BOOT || last serial for [[Reference8:Update Server#Boot_command | '''boot''']] command || 336 | ||
|- | |- | ||
| PROT || last serial for [[ | | PROT || last serial for [[Reference8:Update Server#Prot_command | '''prot''']] command || 07-6060003 | ||
|- | |- | ||
| CHECK || last serial for [[ | | CHECK || last serial for [[Reference8:Update Server#Check_command | '''check''']] command || 20070511-01 | ||
|- | |- | ||
| BMC || last serial for [[ | | BMC || last serial for [[Reference8:Update Server#Bmc_command | '''bmc''']] command || | ||
|- | |- | ||
| CFG || last serial for [[ | | CFG || last serial for [[Reference8:Update Server#Cfg_command | '''cfg''']] command || | ||
|- | |- | ||
| CFG-BACKUP-NUM || last backup number for [[ | | CFG-BACKUP-NUM || last backup number for [[Reference8:Update Server#Scfg_command | '''scfg''']] command || | ||
|} | |} | ||
If access to the command file requires authentication it must be configured within the HTTP-Client of the device. See [[ | If access to the command file requires authentication it must be configured within the HTTP-Client of the device. See [[Reference8:Configuration/General/HTTP-Client|Configuration/General/HTTP-Client]]. | ||
|- | |- | ||
|valign=top nowrap=true|'''Interval''' | |valign=top nowrap=true|'''Interval''' | ||
Line 42: | Line 42: | ||
| name || command | | name || command | ||
|- | |- | ||
| BOOT || [[ | | BOOT || [[Reference8:Update Server#Boot_command | '''boot''']] || | ||
|- | |- | ||
| PROT || [[ | | PROT || [[Reference8:Update Server#Prot_command | '''prot''']] || | ||
|- | |- | ||
| CHECK || [[ | | CHECK || [[Reference8:Update Server#Check_command | '''check''']] || | ||
|- | |- | ||
| BMC || [[ | | BMC || [[Reference8:Update Server#Bmc_command | '''bmc''']] || | ||
|- | |- | ||
| CFG || [[ | | CFG || [[Reference8:Update Server#Bmc_command | '''cfg''']] || | ||
|- | |- | ||
| CFG-BACKUP-NUM || [[ | | CFG-BACKUP-NUM || [[Reference8:Update Server#Scfg_command | '''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. | |||
== Update Client Error Codes == | |||
See [[Reference8:Update_Server#Common_Problems | Update Server, Common Problems ]] |
Latest revision as of 19:07, 8 December 2009
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 Reference8: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:
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.