[Version 5.0.2 and later]Restoring a gateway configuration

Before you begin

This topic assumes that you have already completed the following tasks:
  1. Back up your gateway configuration.
  2. Complete the installation of an upgraded gateway.

If you exported a gateway that is running on a version of IBM WebSphere Application Server that is earlier than Version 5.1.0.4., and the exported gateway includes JMS channels among its deployed resources, then you need to modify the exported configuration file before you can import the saved configuration into a later version of the gateway. For more information, see Troubleshooting the Web services gateway.

Why and when to perform this task

The Restore option uses the information contained in a previously-saved file to populate an empty installation of the gateway with the same deployment details for those Web services and associated resources.

The Restore option automatically detects whether the configuration file that it is restoring contains a Private or a Shared gateway configuration (for an explanation of these terms, see Backing up a gateway configuration).

To restore a gateway configuration, complete the following steps:

Steps for this task

  1. Check that the target gateway is empty. Remove any Web services and associated resources that are deployed to the gateway.
    If you have just completed the installation of an upgraded gateway, then the installed gateway is empty.
  2. In the gateway administrative user interface navigation pane, click the following link:

    Gateway

    • Restore

    The Restore Gateway Configuration window opens.

  3. In the Location field, type the path to your configuration file.

    The path to your configuration file must point to a local drive on the machine on which the gateway is currently running. The saved file is not specific to a given version of the gateway.

    If you are restoring a file that was backed up using the Save Gateway Configuration > Private option, then the backup contains deployment details (for example URIs) that are specific to a given gateway instance. If you restore this type of backup file to a different instance (for example a gateway on a host with a different network identity), then the restore succeeds but you have to use the gateway administrative user interface to correct any errors in the deployment details.

  4. Click OK.

Results

Your gateway configuration is restored to the gateway that you are currently administering.

What to do next

If you have just restored a configuration after installing an upgraded gateway, and any of the deployed Web services were previously published to UDDI registries, use the Listing and managing gateway-deployed Web services option (and the notes you made when you backed up the configuration) to re-publish these Web services to UDDI. The reasons why this manual step is necessary are explained in Backing up and restoring UDDI publication links.

Related tasks
Backing up and restoring a gateway configuration



Searchable topic ID:   twsg_restore
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/twsg_restore.html

Library | Support | Terms of Use | Feedback