Whitebox Migration Process¶
The goal of white box migration is to change the contents found during the scan of the live system prior to migration. To carry out a white box migration, the user must import the scan report as an appliance template. The import process basically transforms the meta-data of the scan report to an appliance template.
White box migration is not supported for Windows.
As part of this transformation process, the scan information is mapped to one or more of the appliance template layers as follows:
- Native packages that have been analyzed by the scan process and correctly found in one of UForge AppCenter package repositories are added to the
- Native packages that have been analyzed by the scan process and NOT found in any of UForge AppCenter’s package repositories are added to a
- All other files (including configuration files) that are not part of a native package are added to a
- Partitioning table information is added to the
- Root and user passwords are added to the
- Timezone is added to the
- Keyboard is added to the
- Kernel parameters are added to the
- Users and groups are added to the
- SELinux settings are added to the
Install Profilefor CentOS, Red Hat and Scientific Linux only. Note the following:
- if SELinux is not activated on the scanned machine, it will still not be activated on a VM generated from this scan.
- if SELinux is activated, it will be activated with the same rules, and the file system will be relabeled on the first boot because of “/.autorelabel” file (and this file is deleted by SELinux once the relabel is done). Parameters from the
/etc/selinux/configfile other than the SELinux mode are lost during the appliance import. If you want to modify some of these parameters you will need to add a MySoftware overlay with a
/etc/selinux/configfile after the scan. Refer to Adding Software from Your Software Library.
All other information found in the scan is not used (reset) and the
Install Profile default information is used. This includes:
- Networking information (IP address). Furthermore, appliance templates do not support multiple NICs, therefore only the first NIC is taken into consideration.
- SSH keys. You will need to manually add the ssh keys to the install profile.
Currently, UForge is not able to migrate the Yum repository GPG keys. 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.
Once the scan report has been imported as an appliance template, you can update the content prior to generating a machine image.
The generation process is slightly different between black box and white box migration. UForge is not generating a machine image from a scan report, rather from an appliance template. You can add and remove packages at will from the OS Profile layer. Consequently package dependencies are calculated using the list of packages in the OS Profile. Any missing packages from the OS Profile are added prior to generating the machine image.