Migrating Edge Gateway between systems

You can migrate Edge Gateway (virtual appliance and stand-alone versions) from Red Hat Enterprise Linux 7 systems to Red Hat Enterprise Linux 8 systems using export and import commands.

Before you begin

Before you start the migration, verify the version of your Edge Gateway management tool, as follows:
sudo manageAppHost --version

All Edge Gateways are upgraded to the management tool’s version during migration. It is recommended to upgrade the Edge Gateways before migrating, as described in Upgrading the Edge Gateway.

About this task

You can export, import, suspend, and resume Edge Gateways between different systems. Migration is supported on Edge Gateway V1.15.0 and later versions.

Complete the following steps to migrate your Edge Gateways. You must be logged in as the root user to run the commands.

Procedure

  1. Enter the following command to export the Edge Gateway as a file. The tool prompts you to select the Edge Gateway to export. The exported file, named export.json in the following example, is in .JSON format and you might need to review.
    sudo manageAppHost export -o <export_file>
  2. If the exported file in the previous step is correct, suspend the exported Edge Gateway. This step temporarily stops the Edge Gateway, apps, and connectors to maintain data integrity, and can be resumed at any time.
    sudo manageAppHost suspend
  3. Select the exported Edge Gateway file and copy the exported file to the destination instance.
  4. Import the Edge Gateways using the following command:
    sudo manageAppHost import -i <export.json>
  5. Check the imported Edge Gateway using the following command:
    sudo manageAppHost showconfig

    You can also check the status on the dashboard.

  6. If the imported Edge Gateway is ready on the exported cluster, you can delete the migrated Edge Gateway or uninstall the entire cluster from the instance, as follows:
    sudo kubectl delete namespace <App_Host_ID>
    If the Edge Gateway import failed, or if you want to abort the migration, enter the following command on the original instance to resume the Edge Gateway that you suspended in a previous step:
    sudo manageAppHost resume