Backing up and restoring the IAG configuration
Applies To: Intelligent Application Gateway (IAG)
Whale Communications Intelligent Application Gateway (IAG) 2007 provides backup and restore utilities. During backup, the IAG backup utility uses the Windows makecab.exe utility to archive the necessary files and registry values in a .cab file. It uses the Windows extract.exe utility to restore them. You can then use the restore utility to restore configuration settings to a compatible IAG server.
Backing up IAG configuration settings
It is recommended that you create IAG backups as follows:
Run the backup utility directly after the initial IAG configuration.
Following the initial backup, run the backup utility each time you modify the configuration settings, in order to ensure that the backup is updated at all times.
Copy the backup file to a separate location whenever you make major changes to the configuration.
By default, the backup is created under the following IAG installation path:
\whale-Com\e-Gap\Backup
If a backup file is not available at this location, then verify whether the default location has been modified. The name of the backup file is whlbackup.<host_name>.cab, where host_name is the name of the IAG server. Each time you run the backup utility, a log is created in the following folder:
\Whale-Com\e-Gap\Logs\whlbackup.log
You can backup the configuration by using one of the following methods:
From within the IAG Configuration interface.
By running a console application from the command line. If you back up the configuration from the command line, you can only restore it by using the command line.
Backing up the configuration in the Configuration console
You can select to back up the configuration settings each time you activate the configuration in the Configuration program.
To back up the configuration in the Configuration program
In the Configuration program, click the Activate Configuration icon to activate.
Select the option Back up configuration after activation, and then click Activate.
The IAG configuration is activated and backed up.
Running the backup utility as a console application
You can run the backup utility from the command line as follows.
To run the Backup utility as a Console application
On the IAG server, open a command line, and then type the following:
whlbackup.exe -bThe IAG configuration is backed up.
Restoring IAG configuration settings
After backing up the IAG configuration by using the backup utility, you can use the restore utility to restore the configuration settings to an IAG server. You can restore the configuration using one of the following methods:
From within the Configuration console
From a command line
Before you restore a backup, ensure that the backed-up IAG server and the IAG server to which you are restoring the configuration settings are compatible, as follows:
Both IAG servers use the same passphrase.
The same application shuttles are installed on both servers.
Restoring the configuration in the Configuration program
The following describes how to restore the configuration from the Configuration program.
To restore the configuration in the Configuration program
In the IAG Configuration console, on the Admin menu, click Restore from Backup.
Click the Activate Configuration icon to activate the configuration.
The IAG configuration settings are restored from the backup file, as defined in the file
whlbackup.ini.
Running the restore utility as a console application
Run the restore utility from the command line as follows.
To run the Restore utility as a Console application
On the IAG server, open a command line, and then type the following:
whlbackup.exe -rOn the IAG server, activate the configuration by clicking the Activate Configuration icon.
The IAG configuration settings are restored from the backup file, as defined in the file
whlbackup.ini.