You can migrate App Hosts
(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
App Host management tool, as
follows:
sudo manageAppHost --version
All App Hosts are upgraded to the
management tool’s version during migration. It is recommended to upgrade App Hosts before migrating, as described in
Upgrading the App Host.
About this task
You can export, import, suspend, and resume App Hosts between different appliances.
Migration is supported on App Host V1.15.0
and later versions.
Complete the following steps to migrate your App Hosts. You must be logged in as the
root user to run the commands.
Procedure
-
Enter the following command to export the App Host as a file. The tool prompts you to select the
App Host 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 App Host. This step temporarily stops the App Host, apps, and connectors to maintain data
integrity, and can be resumed at any time.
sudo manageAppHost suspend
- Select the exported App Host file
and copy the exported file to the destination instance.
- Import the App Hosts using
the following command:
sudo manageAppHost import -i <export.json>
- Check the imported App Host using
the following command:
sudo manageAppHost showconfig
You can also check the status on the dashboard.
- If the imported App Host is ready
on the exported cluster, you can delete the migrated App Host or uninstall the entire cluster from the
instance, as follows:
sudo kubectl delete namespace <App_Host_ID>
If the
App Host import failed,
or if you want to abort the migration, enter the following command on the original instance to
resume the
App Host that you suspended in a
previous step:
sudo manageAppHost resume