Applying an Update, Restoring a System, 11-63

Chapter 11 Miscellaneous Administrative Tasks

Applying an Update

Restoring a System

Restoration from a backup file is intended to occur only on an ACE XML appliance with an initial, empty configuration. Restoration may not work on an appliance that already contains a populated policy or that may have other changes from its initial state. It should, however, contain the same software version, hotfixes, and SDK extensions as the system used to generate the backup. These items should be separately installed before running the backup restore command.

Also, the appliance should be in the same operating mode as the system used to generate the backup file. That is, if the source system was configured in standalone mode, the target system should be configured for standalone mode as well.

After ensuring these prerequisites, restore the system as follows:

Step 1 Access the appliance shell on the ACE XML appliance on which you want restore the system. Step 2 Choose Advanced Options > Run Bash.

Step 3 Use the backup script to restore the system from the backup file. The file should be either on the system or a disk location accessible from the appliance operating system.

For example:

backup -restore <filename>

Where filename is the name of the tgz file that was previously saved with the backup script. For example: backup -restore -verbose applianceBackup.tgz

The -verboseswitch enables error messages that occur during the backup or restoration process to be printed to the screen.

Note Enter backup -hto see a full list of options. To have errors in the operation printed to the screen, use the -eor -lswitch.

Once you enter the command, the system reads the file and overwrites the current system with the appliance state represented in the file. After the changes are applied, the appliance reboots. After restarting, the system contains the state restored from the backup archive.

Step 4 If the hardware system of the target appliance is different from the source appliance, you will need to configure a license for the new appliance before it is fully operable. ACE XML Gateway licenses are bound to a particular machine, and therefore need to be separately acquired and installed for each physical appliance. For more information on acquiring and installing licenses, see “Configuring the Product License” section on page 5-27.