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
-
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>
- 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
- Select the exported Edge Gateway file
and copy the exported file to the destination instance.
- Import the Edge Gateways using the
following command:
sudo manageAppHost import -i <export.json>
- Check the imported Edge Gateway using
the following command:
sudo manageAppHost showconfig
You can also check the status on the dashboard.
- 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