Migration Pre-requisites

You must have root access on the target system in order to complete a migration, as you will need to copy and run a binary file on the target system.

Warning

UForge AppCenter migration does not support multi-kernels. When scanning a machine with more than one kernel, only the kernel running will be scanned and imported.

In order to migrate a system, it must meet the following conditions:

Note

Your scan will take longer if not all minor versions of a distribution are install in your UForge AppCenter. For example, if you scan a CentOS 6.8 machine, but your AppCenter has only been populated with packages up to CentOS 6.7, then the AppCenter will use the machine’s yum repo to download the missing packages. As a result, the scan will take longer to complete.

  • The image formats must be in supported formats (refer to Supported Machine Image Types)
  • Any pre-install or post-install scripts on the system you are about to scan should only use ascii characters. Otherwise UForge AppCenter will return a scan error: DB Error invalid characters.
  • Custom packages on the live system to be scanned should not contain references to package dependencies as relative path. They should be expressed as absolute paths.
  • If custom packages are installed using --nodeps flag, the scan process will not detect these packages. When running Re-platform, UForge AppCenter will check for these dependencies. If they are custom packages that are not on the live system, the generation will fail. Therefore, it is recommended to provide a custom repository with all the necessary custom packages. Otherwise, they can be added after the scan to the appliance template in My software.
  • For Windows, the partition format must be NTFS
  • For Windows, GPT is not supported. Scanned Windows machine has to have MBR.

Warning

Currently, UForge is not able to migrate the Yum repository GPG keys except the ones located in the /etc/pki/rpm-gpg/ directory. This means that the user will have to accept the repository GPG key when the user installs or updates a package. The user will have to do this only once per repository.

Migrating Windows to K5

If you plan to migrate a Windows instance onto K5 Fujitsu Public Cloud, you must uninstall CloudBase-Init (if installed) before scanning.

For more detailed information, refer to official Fujitsu K5 IaaS Documentation.

Migrating Windows

If you plan to migrate a Windows machine to any cloud, you need to ensure that you have the following RDP update: KB4103723.

Migrating Linux to VCenter

If you plan to migrate a Linux instance from a platform using cloud-init (such as OpenStack) to VCenter you must following one of the next proposals:
  • Uninstall cloud-init (if installed) before scanning
  • Use Re-platform. Once the appliance is imported, remove cloud-init package before generating.

Migrating Linux to Microsoft Azure

Currently, to publish to Microsoft Azure platform https://azure.microsoft.com/en-us/ you must do the following before scanning:

  1. Unless you are migrating from CentOS7+ or Red Hat Enterprise Linux 7+, uninstall NetworkManager (if installed).
  2. Uninstall the Microsoft Azure agent, i.e. WALinuxAgent and waagent packages (if installed).

Migrating Windows to Microsoft Azure

You must install the Azure Virtual Machine Agent on the source machine before scanning if you plan to migrate using Lift & Shift or using Re-platform and the appliance is configured as to not run sysprep automatically on its first boot.