Configure Gateway backup in Gateway 1.8+

[EcoStruxureIT]

Gateway is automatically backed up on a weekly schedule. See Backup schedule

Gateway backup configuration and one time backup is now performed via the command line. Local or remote terminal access is required to create and maintain Gateway backups.

Backup files are stored to the local file system. Backup files can be stored on a remote system of your choice, independent of the Gateway application, through the OS as a one time or recurring task.

IMPORTANT: You can restore a backup from the same version of Gateway only. 

Create a onetime backup

Note: This example is on a Windows based system. The Linux commands are identical; the install directory is slightly different. Sudo can be used to run with administrator level privileges.

1. Open a command prompt as administrator on the computer where the Gateway is installed.

2. Navigate to the bin subdirectory in Gateway install directory on the files system, for example, C:\Program Files\EcoStruxure IT Gateway\<version number>\bin.

3. Type the command ./backup

4. If prompted, enter a password used to encrypt and decrypt the configuration data. Be sure to save this password for later to use during restoration. This is new to Gateway 1.8 to improve Gateway backup security. After confirming the password, the backup archive will be created. When not prompted, the gateway administrator password will be used. 

5. Upon creation, output is displayed with the Gateway backup id, name, date, and other version information.

GW18_backup_1_360007070377.png

Backup files are stored locally on the Gateway server file system, under the backups subdirectory in the Gateway install directory, for example, C:\Program Files\EcoStruxure IT Gateway\backups. From here, the file can be copied or configured for export to a remote file share through the operating system.

GW18_backup_2_360007070377.png

 

Backup config options

The instructions above use the default Gateway backup settings. Some aspects of the backup are configurable by adding the config parameter to the backup command.

View the backup configuration

./backup config

View the backup configuration settings.

GW18_backup_3_360007070377.png

 

Configure the backup password

You will be prompted for a new password to use for encrypting backups.

./backup config --archive-password

GW18_backup_4_360007070377.png

 

Configure the backup destination

Set the directory used to store backup file contents.

./backup config --destination <file path>

GW18_backup_5_360007070377.png

 

Configure the maximum number of backups to keep

Set the maximum number of backup entries to store before rotating older entries.

./backup config --rotation <maximum number of backups to store>

GW18_backup_6_360007070377.png

 

Backup schedule

Set the schedule of backups. The default settings are to backup on Sunday at midnight each week.

--repeat accepts one of the following values: monthly, weekly, daily, or hourly.

--on accepts one of the following values when repeat is weekly: monday, tuesday, wednesday, thursday, friday, saturday, or sunday. When repeat is monthly it accepts the day of the month instead (see examples below).

--at accepts time in twelve or twenty four hour format with hours separated by a colon. Valid examples: 8:00am, 14:00, 2:00pm, or 03:00pm. 

GW18_backup_7_360007070377.png

 

Weekly backup example

Backup will run every Tuesday at 14:00 (2pm).

./backup schedule --repeat weekly --on tuesday --at 14:00

 

Monthly backup example

Backup will run on the 15th of each month at 08:00 (8am).

./backup schedule --repeat monthly --on 15 --at 8:00am

 

Daily backup example

Backup will run every day at 14:00 (2pm)

./backup schedule --repeat daily --at 2:00pm

 

Hourly backup example

Backup will run every hour

./backup schedule --repeat hourly

 

Disabling scheduled backup

Scheduled backup will be disabled

./backup schedule false

 

Re-enabling scheduled backup

Scheduled backup will be enabled with the default backup schedule.

./backup schedule true --repeat weekly