Backing up and restoring a gateway configuration

The Back up options write out, to a single file, the deployment details for all the channels, filters, UDDI references and Web services that are currently deployed to the gateway. 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 channels, filters, UDDI references and Web services.

There are two situations in which you might want to back up a gateway configuration:

When you apply an upgrade or fix pack, the configured gateway is replaced with an upgraded but empty gateway. You use the Save Gateway Configuration -> Private option to preserve your configuration.

When you want to create or update a gateway cluster, you use the Save Gateway Configuration -> Shared option to save a "shareable" version of your gateway configuration. This saved configuration does not include machine-specific values, and therefore does not over-write these values on the target gateways in your cluster when you restore the configuration to them.

The restore option automatically detects whether the configuration file that it is restoring contains a Private or a Shared gateway configuration.

Note: For the Save Gateway Configuration -> Private option, the steps below include

  • Manual un-publishing of Web services from UDDI before backing up the gateway configuration.

  • Manual re-publishing of these Web services to UDDI after restoring the gateway configuration.
The reasons for this are explained in Backing up and restoring UDDI publication links.

To back up and restore a gateway configuration, complete the following steps:

 

  1. Display the Web services gateway administrative user interface.

  2. (Optional)  

    If you are backing up before you apply an upgrade or fix pack, and any of your deployed Web services are also published by the gateway to UDDI registries, use the List and managing gateway-deployed Web services option to un-publish them from UDDI. Make a note of the UDDI deployment details so that you can re-publish them to UDDI after you restore the gateway configuration.

  3. To back up the gateway configuration, complete the following steps:

      1. In the gateway user interface navigation pane, click the following link:

        Gateway

        • Back Up

        The Save Gateway Configuration screen is displayed.

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

        Note:

        • The path to your configuration file must point to a local drive on the machine on which the gateway is currently running.

        • The file name for the configuration file can be any valid Java filename.

      3. If you are backing up before you apply an upgrade or fix pack, select Private. If you are backing up to create a gateway cluster, select Shared.

      4. Click OK

      Your gateway configuration is saved to the location you specified.

    1. To restore a gateway configuration, complete the following steps:

      1. Check that the target gateway is empty. If there are any channels, filters, UDDI references or Web services deployed to the gateway, then remove them.

        Note: If you have just installed a WebSphere Application Server fix pack or upgrade program, then the upgraded gateway is empty.

      2. In the gateway user interface navigation pane, click the following link:

        Gateway

        • Restore

        The Restore Gateway Configuration screen is displayed.

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

        Note:

        • 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 will succeed but you will have to use the gateway user interface to correct any resultant errors in the deployment details.

      4. Click OK

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

    2. (Optional)  

      If you have just restored a configuration after applying an upgrade or fix pack, and any of the deployed Web services were previously published to UDDI registries, use the List and managing gateway-deployed Web services option (and the notes you made in step 2 above) to re-publish these Web services to UDDI.

    Backing up and restoring UDDI publication links
    Web services gateway: Enabling Web services

     

    WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

     

    IBM is a trademark of the IBM Corporation in the United States, other countries, or both.