IBM Support

Backup and restore on DataPower appliance with large number of domains

Troubleshooting


Problem

A complete backup or restore of a DataPower appliance with a large number of domains may fail without providing helpful diagnostics. For instance, in one case it was reported that the prompt to allow you to save the backup to a file never appeared. The popup to choose to download the backup file displayed, but at that point an error was recorded in the log: "File not found." Similarly, a full backup may complete, but the complete restore might not be successful. The WebGUI might hang without giving a meaningful error message.

Symptom

The complete backup or restore might fail if there are lots of domains. It is usually possible to backup or restore in smaller increments to work around the current limitations.

The following steps show just one example of an issue you might see when importing a large .zip backup file. Keep in mind, this is not the only symptom and also not the only action that can encounter related problems. Backups of devices with large, complex configurations and many domains, as well as restores, might run into limitations and hang or display errors.

Here are recreation steps that show one possible problem when attempting to restore all domains:

  1. Administration > Configuration > Import Configuration
  2. Use the default ZIP Bundle and browse for the File, backup.zip
  3. Select Next to display the list of domains
  4. Click All to select all domains and press Restore
  5. After backup completes, select Next

At this point, you see an error and login to the WebGUI might be temporarily down:

The XML page cannot be displayed                                        
Cannot view XML input using style sheet. Please correct the error and then click the Refresh button, or try again later.

[{"Product":{"code":"SS9H2Y","label":"IBM DataPower Gateway"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"General","Platform":[{"code":"PF009","label":"Firmware"}],"Version":"4.0.2;4.0.1;3.8.2;5.0.0","Edition":"Edition Independent","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
08 June 2021

UID

swg21293016