====== 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:support: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:keros_custo: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, Wirnet iStation, Wirnet iFemtoCell-evolution, please follow this procedure:|
  - Unpower the gateway by pushing ON/OFF button more than 5 seconds.
  - Make sure [[wiki:systeme_mana: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:systeme_mana: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:systeme_mana:peripherals#leds|here]]). It takes approximately 2 minutes.
++++

++++
To manually trigger a stock restore on Wirnet iZeptoCell, please follow this procedure:|
  - Press the button once to trigger a software reset
  - Push the button again when the status led is blinking red 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:systeme_mana: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:keros_custo:upgrade#configuration_management_sysupgrade|sysupgrade]] management.