IBM Support

Migration of a virtual DataPower SOA appliance to a virtual DataPower Gateway

Question & Answer


Question

How to migrate a virtual XG or XI to virtual IDG?

Answer

To upgrade a virtual XG45 or XI52 to virtual IDG, you must first run a migration tool from Fix Central to convert the virtual XG45 or XI52 to a virtual DataPower Gateway. You can convert these virtual products to a virtual DataPower Gateway at any time.

You can obtain the migration tools from IBM Fix Central. Search with the text string Migration.

  • Use xg-virtual_migration to convert a virtual XG45 to a virtual DataPower Gateway.
  • Use xi-virtual_migration to convert a virtual XI52 to a virtual DataPower Gateway.

You can obtain the appropriate modules to activate from IBM Passport Advantage. If you previously purchased a module for your virtual XG45 or XI52, you are entitled to the activator tool for the DataPower Gateway. Beyond this entitlement and based on product, The following entitlements apply.
  • If you purchased the Data Integration Module for XG45, you are entitled to the Integration Module.
  • If you purchased XI52, you are entitled to the Integration Module.

Attention: Before you start the process, create a full system backup not a secure-backup package. If the system reboots between the processing of the migration tool and the processing of your final activation tool, you might lose part of your persisted configuration. If a reboot happens, you can use this backup to restore your last persisted configuration.

The end-to-end migration process is as follows.
  1. Download the migration tool from IBM Fix Central.
  2. Run the migration tool.
  3. Download appropriate modules from IBM Passport Advantage for feature parity.
  4. Run the activators from the CLI with the following command.
    # boot image -f accept-license activator
  5. Download a current supported firmware image from IBM Fix Central.
  6. Upgrade the firmware to from the CLI with the following command.
    # boot image -f accept-license firmware

After the conversion, the reported product changes as follows.
  • XG45 (5275-J90) is a DataPower Gateway (5275-T09)
  • XI52 (5275-J91) is a DataPower Gateway (5275-T09)

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSHPDZ","label":"IBM DataPower Gateway Virtual Edition"},"ARM Category":[{"code":"a8m50000000CdqTAAS","label":"DataPower->MGMT (MM)->Migration"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
16 September 2021

UID

swg22004117