Scanning a Linux Machine¶
When scanning a Linux machine, you have to check whether the licenses of OS and software which the source machine contains allow you to use them on the destination server which you are migrating to. For more detail, refer to Notes on Licensing.
To carry out a scan, go to
Re-platform tab on the
scanin the top right.
Enter a name for the scan of the target system you want to migrate.
Linuxfrom the drop-down menu.
Include overlayselected if you want to run a scan with overlay. This will return all the packages, files and configuration information of the source machine.
If you do not include the overlay, all files needed to rebuild packages are still transferred to UForge, including the package configuration files. However, all “extra_files” are excluded from the scan.
If you want to exclude certain directories or files from the scan then click
addand enter the directory path or full pathname of the file.
Next. Follow the instructions on the UForge AppCenter GUI.
Download binary locally by clicking
Copy the binary on the target environment you want to migrate.
Open a terminal window and login to the target environment.
Run the scan command on the running target environment to start a scan of the system you want to migrate. Note the
-ooption in the scan command indicates that you will launch a scan with overlay. The binary identifies the packages, files and custom files on the system.
By default the scan data will be saved in
/tmp. You can modify the directory where the data will be saved using the
-toption in order to ensure that there is enough space to save the scan data.
-eoption if you want to exclude certain files or directories from the scan.
You can also use API keys to run the command. In this case, in the command you copied, remove the password and enter the API keys using
-aoption for the public key and
-soption for the secret key. For example:./uforge-scan.[bin/exe] -u <username> -a <public-key> -s <secret-key> -U http://ip:port/ufws -n 'Test_scan'
-noption to indicate the scan name is mandatory. If a scan with this name already exists, the scan will be grouped under this name.
The uforge scan tool self extracts in
/tmpdirectory before execution. If the machine is configured with
Permission deniederror will occur. In that case, you can specify the environment variable
TMPDIRto use a different directory. For example:TMPDIR=/root/ ./uforge-scan.bin -u <username> -a <public-key> -s <secret-key> \ -U https://<uforge-ip>/api -n 'Test_scan'
A report is sent to UForge AppCenter which can be used for migration. To view the progress, go back to the
The duration of the scan depends on:
- the power of the machine in the target environment,
- the complexity of the target environment OS (number of packages installed),
- the network bandwidth between the target environment and UForge.
Scans of typical simple target environments can last about 5 to 15 minutes. In the case of larger and more complex target environments, together with poorer bandwidth, one can experience durations of up to one hour.
Image generation will fail when migrating if the source server has the same LVM volume group name as the UForge server’s one. It will fail also if the volume group name set in the Partitioning Table is the same as the name of LVM volume group in UForge server.