This is an old revision of the document!


Backup/restore Settings

You can save your Internet Gate configuration to a file on your PC for later reload. It is very convenient to do if you have to perform a reset to factory defaults, or want to copy one unit's settings to another one. All your settings are saved to one PC file that can be reloaded at a later time.

You are recommended to backup your settings after you have configured your Internet Gate.

:!: Do a backup of your settings now. Yes now. You never know when you need them later.

Backup

  1. Open Administration page from the Configuration section of the main menu.
  2. If the backup file should be loadable on other Internet Gate units too (recommended) then enter a password. (If no password entered file is only loadable into same unit.)
  3. Click “Backup to file”.
  4. Select a location to store the backup file and click Save .

The backup file is typically named (if no other name is chosen) settings.txt .

Restore

  1. Open Administration page from the Configuration section of the main menu.
  2. if backup file was created using a password enter the same password.
  3. Click Browse, select the previously saved backup file and click Open.
  4. Click Go.

The unit performs a reset to factory defaults, loads the backup file settings, and saves them permanently. During this process Internet Gate reboots twice. Do not turn power off or abort the process in any way.

:!: Backup files created with release 5.31 or older will load only partially: most settings load OK, but passwords and other encrypted settings do not load and remain unchanged or empty.

:!: Backup files created without password on other units will also load only partially: most settings load OK, but passwords and other encrypted settings do not load and remain unchanged or empty.

Advanced

:!: This information is only for advanced users.
You can render your unit uncontactable by loading an incorrect backup file.

You can open the settings.txt backup file in any editor capable of editing files with LF as linefeeds (unix-style). By deleting unwanted files and settings you can create backup files that only affect selected parts of the unit's configuration. Files and settings not included into the backup file will be left unchanged.

To load such a partial backup file into a unit do not perform factory reset before loading (skip step 2 above).

The structure of the settings.txt backup file is as follows:

##@#
# 5.30 Exported VMI settings file.
# This file is in UNIX format (lines end with single LF char) and must be so at import.
##@#<filename1>
<parameter1 assignment>
<parameter2 assignment>
     ....
##@#<filename2>
<parameter1 assignment>
<parameter2 assignment>
     ....
##@#<filename3>
<parameter1 assignment>
<parameter2 assignment>
     ....
##@#EndOfFile

The ”##@#” string is a filemark. It preceeds the name of the file, and marks that the following lines will list parameters (possibly modified) belonging to that file, up to the next filemark. A parameter assignment will overwrite the existing value of the named parameter, or be added to the file if missing. The first line must be a single filemark (filename is empty), and is followed by some lines that are treated as comments, up to next filemark. A filemark can be followed by the REPLACE keyword, meaning that the following parameters will constitute the new file, while deleting the old contents of the file (instead of parameter-per-parameter overwriting).

settings_and_administration/backup_files.1305813248.txt.gz · Last modified: 2011/05/19 15:54 by tibor
CC Attribution-Noncommercial-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0