Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Children Display

Table of Contents

Info

This Page is under Development

Introduction

Briefly describe in general terms the system/application and the purpose for which it is intended, written in non-technical terminology. Consider including a high-level architecture diagram for the system. The description should include, but is not limited to, the following:

...

...

Backup and Restore is a Troubleshooting feature developed for the WebUI considering RPi as the reference platform.

...

  • Backup allows user to save all the existing User Settings in a form of tar file containing encrypted file database files and download to their local PC.
  • Restore allows the user to retrieve the user settings from the backup created earlier. The backed up file from local PC can be uploaded to the server and the settings from the decrypted file database files will be loaded to the WebUI.

...

Environment Setup

  • Set-up Considerations

<Briefly describe and graphically depict as appropriate the equipment, communications, and network configuration of the system in a way that a non-technical user can understand>

Backup and Restore functionalities are supported by a set of script files. Following are the mentioned script files:

...

   →   backup_user_settings.php

   →   backup_enc_key.php

   →   ajax_at_saving_backup_key.php

These script files which are already present in the RDK build, will execute when the Backup and Restore buttons are clicked.

  • User Access Considerations

<Briefly describe and graphically depict as appropriate the equipment, communications, and network configuration of the system in a way that a non-technical user can understand>

  • Accessing the System

<Provide detailed information and describe the procedures necessary to access the system. If applicable, include how to get a user ID and log on to the system, as well as the actions a user must take to change and/or reset a password.>

The User needs to login to the WebUI using <username> admin and <password> password (These are default username and password). Once logged in, the following procedure has to be followed:

Backup: Under the main menu Troubleshooting, Backup User Settings sub menu is selected and Backup button is clicked. The user is asked to enter a Secure key to encrypt the files.  Once key is entered, a pop up to download the Current User settings in the form of an encrypted a tar file in Local PC.

            Troubleshooting → Backup User Settings → Backup (button) → Enter Secure key Select SaveClick Save → Pop up to Save → Select Save  .

Please check the following figure for reference:

Image AddedBackup feature steps

Restore: Under the main menu Troubleshooting, Reset / Restore Gateway is selected and Restore User Settings button is clicked. The file which needs to be uploaded has to be selected from local PC and Restored , the secure key previously used to encrypt the files should be entered to decrypt the files and Restore is clicked to apply the settings.

           Troubleshooting → Reset / Restore Gateway → Restore User Settings (button) → Browse (To select the file from Local PC) → Enter Secure key to decrypt files → Restore (button).

Please check the following figure for reference:

Restore feature step1 - BrowseImage RemovedRestore feature step2 - Select file and RestoreImage RemovedImage AddedImage Added


  • System Work Flow

<Describe how system flow is happening mentioning checkpoints which can be verified during flow to ensure system is working as expected>

Once Backup is performed, the following path can be checked to ensure that backup has executed as expected.

...

Please check the following figure for reference:

var contents after restore

  • Exiting the System

...

Care should be taken that before Backup is performed, backup.tar file already existing in Download folder of Local PC has to be deleted or renamed to avoid creation of duplicate file.

Please check the following figure for reference:

Duplicate files created in local PC

Executing System

Describe the specific system function or feature in detail and depict graphically by including screen prints and descriptive narrative as appropriate. Ensure each screen print is captioned and has an associated tag providing appropriate alternative text

...

The Backup feature creates a tar file in the /tmp/ folder. This tar file contains all the necessary files like, bbhm_bak_cfg.xml, syscfg.db and bbhm_cur_cfg.xml required for backing up all the user settings. The same tar file is downloaded to local PC.

The Restore feature copies the uploaded file temporarily to /var/tmp/ folder and restores all the settings from the tar file to the WebUI. The restore changes can be observed in WebUI and the files in /nvram/ folder.

untar contents of tmp backup.tar fileImage RemovedImage RemovedImage AddedImage Added

Backup Example:

...

These settings will be saved in the encrypted backup filefiles.

Restore Example:

In the current setting, Managed Sites is disabled.

...

Troubleshooting

  • Error Messages

<Identify the error messages that a user may receive and the likely cause(s) and/or possible corrective actions for the error>

If restore is success, the following message will be displayed before automatic device reboot.

Image RemovedImage Added

In case of Error, one among the following will be displayed.

       * Error, get restore status failure

       * Error, restore configuration failure!

       * Restore configuration Failure! Please try later.

  • Special Considerations

...

backup file not selected:

Image Added

       * Empty secure key entered

Image Added

       * Invalid secure key entered

Image Added

  • Special Considerations

The backed up and restored files are by default named as backup.tar (if changed, will cause misbehavior in feature execution).

...

Contact

Organization

Phone

Email

Role

Rajkumar Narayanan

L&T Technology Service Ltd.

Nil

rajkumar.narayanan@ltts.com

<Contact Name>

<Organization>

<Phone>

<Email>

<Role>Program manager