This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:features [2019/09/25 10:11] ghi |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Recovery mode & backup features ====== | ||
- | ===== Recovery ===== | ||
- | ==== Instability detection ==== | ||
- | |||
- | An instability counter is used to detect system instability. | ||
- | * If 16 consecutive reboots are detected due to a watchdog, a “backup restore” operation is triggered. | ||
- | * If 32 consecutive reboots are detected due to a watchdog, a “stock restore” operation is triggered. | ||
- | |||
- | The counter is reset if the system is up during at least 10 minutes. | ||
- | This feature cannot be disabled as it avoids bricking the gateway in case of software failure. | ||
- | |||
- | The counter ''bootfail'' is displayed at boot time only if the reboot is due to a watchdog. Bootcause information are available [[wiki:troubleshoot#bootcause|here]]. | ||
- | |||
- | ++++ | ||
- | Bootcause - Example | | ||
- | <code> | ||
- | U-Boot 2015.04 (Aug 21 2018 - 18:53:11) | ||
- | |||
- | CPU: Freescale i.MX6SX rev1.2 at 792 MHz | ||
- | CPU: Temperature 48 C | ||
- | Reset cause: WDOG | ||
- | Watchdog enabled | ||
- | I2C: ready | ||
- | DRAM: 240 MiB | ||
- | MMC: FSL_SDHC: 0 | ||
- | Using default environment | ||
- | |||
- | In: serial | ||
- | Out: serial | ||
- | Err: serial | ||
- | bootcause = SW | ||
- | bootcount = 32 | ||
- | bootfail = 0 | ||
- | bootmode = nominal | ||
- | boardconfig = 0x0 | ||
- | Net: FEC0 | ||
- | Normal Boot | ||
- | </code> | ||
- | ++++ | ||
- | |||
- | \\ \\ | ||
- | ===== Backup ===== | ||
- | ==== Backup restore ==== | ||
- | Packages installed during an update could make the system unstable, therefore, they are not immediately included in the backup. \\ | ||
- | There will be included the next time an update is triggered. Before each update, a ''snapshot'' of the firmware is done. It contains all the previously installed packages. \\ | ||
- | This ''snapshot'' is used if a “backup restore” is triggered. \\ | ||
- | If a ''backup recovery'' is triggered, only the stored packages are restored. Other packages are discarded. | ||
- | |||
- | |||
- | Modifications in rootfs will be lost except [[wiki:upgrade#configuration_management_sysupgrade|system upgrade]] files. | ||
- | |||
- | This mecanism is divided in 2 elements: | ||
- | |||
- | * ''/etc/sysupgrade.conf'': Contains the system (KerOS) elements to backup/restore. | ||
- | * ''/etc/sysupgrade.d/'': a directory with .conf files where additional elements to backup/restore can be added (i.e. by additional packages). | ||
- | |||
- | By default, some system configuration files are backed up like the network configuration. | ||
- | |||
- | |||
- | To trigger a backup restore execute the following commands: | ||
- | <code bash> | ||
- | kerosd -b | ||
- | reboot | ||
- | </code> | ||
- | |||
- | \\ | ||
- | ==== Stock restore ==== | ||
- | The stock firmware is backuped at production time (or when updated with a KerOS liveburner.ipk file). \\ | ||
- | A “stock restore” will factory reset the station. All data will be lost. | ||
- | To trigger a stock restore execute the following commands: | ||
- | <code bash> | ||
- | kerosd -s | ||
- | reboot | ||
- | </code> | ||
- | |||
- | \\ | ||
- | ==== Manual Stock restore ==== | ||
- | Since firmware >= 4.1, a "stock restore" can also be triggered manually without console access. \\ | ||
- | To manually trigger a stock restore on Wirnet **iBTS** or **iStation**, please follow this procedure: | ||
- | - Unpower the gateway by pushing ON/OFF button more than 5 seconds | ||
- | - Make sure [[wiki:peripherals#leds|Power led]] is off and release button | ||
- | - Push On/OFF button to power-up the gateway and maintain until power and status leds blink alternatively. At this step, the gateway is ready to execute a stock restore operation. It will wait for a confirmation during 10 seconds | ||
- | - Release button and push it again to confirm the operation (leds will then stop blinking alternatively) | ||
- | - Wait for the end of this operation (Leds behavior described [[wiki:peripherals#leds|here]]). It takes approximately 2 minutes | ||
- | |||
- | To manually trigger a stock restore on Wirnet **iFemtocell**, please follow this procedure: | ||
- | - Push WPS button and maintain it | ||
- | - Push Reset button one second | ||
- | - At this step, the gateway is ready to execute a stock restore operation. It will wait for a confirmation during 10 seconds | ||
- | - Release WPS button and push it again to confirm the operation (leds will then stop blinking alternatively) | ||
- | - Wait for the end of this operation (Leds behavior described [[wiki:peripherals#leds|here]]). It takes approximately 2 minutes | ||
- | |||
- | \\ \\ | ||
- | ===== Store & Restore configuration ===== | ||
- | |||
- | This functionality from firmware < 4.0 must not be used to store configuration files. In order to save configuration use the [[wiki:upgrade#configuration_management_sysupgrade|sysupgrade]] management. |