Scanning a Microsoft Windows Machine


When scanning a Microsoft Windows machine, you must acquire Windows licenses in order to handle Windows OS in UForge and confirm usage conditions of cloud provider and virtualization software which you scan and migrate to.


It is not possible to scan a Windows “Core” system for all versions: 2008R2, 2012, 2012R2 and 2016.


Windows Evaluation Editions are not supported for scanning.


If the target filesystem is NTFS, the scan is optimized by extracting only “used space” from target disks on the source system. Some applications might hold their data on “free space,” which is not used by the operating system. If the source system of the scan has such applications installed, these applications may not work correctly on a machine image generated from the scan. With the other filesystems, such as FAT, ReFS and so on, all the space including “free space” on target disks will be copied by the scan.


For Windows Server 2008R2, you will need to run a command in PowerShell on the source machine before scanning winrm set winrm/config/service '@{AllowUnencrypted="true"}'. This command will disable WinRM encryption over HTTP which is not supported by AMP. More information can be found on the Cloudsoft AMP documentation, in section WinRM Connectivity Diagnostics.


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, please refer to official Fujitsu K5 IaaS Documentation.

To carry out a scan, go to the Re-platform tab on the Migrations page:

  1. Click on scan in the top right.

  2. Enter a name for the scan of the target system you want to migrate.

  3. Select Windows from the drop-down menu and click next.

  4. Select if you want to use the graphical user interface or the command line. Follow the instructions on the pop-up to download the scan binary.


    When you run the uforge-scan.exe command the -n option to indicate the scan name is mandatory. If a scan with this name already exists, the scan will be grouped under this name.

    By default the scan data will be saved in /tmp. You can modify the directory where the data will be saved using the -t option in order to ensure that there is enough space to save the scan data.

    Use the -e option if you want to exclude certain files or directories from the scan. Use -E option if you want to exclude a harddisk.

  5. You can then launch the scan. The following image illustrates a Windows scan with all of the possible options checked. They are described in the following steps.

  6. Optionally you can use API keys. In this case, check Use API keys authentication and enter the public and secret key information.

  7. If you want to set up a proxy, check Proxy authentication required and enter the proxy information.

  8. Fill in the Scanned Instance Name.


    Scan name can be mix of alphanumeric characters, spaces and the following special characters ._-. All other characters are not supported at this time.

  9. Optionally you can select Use local storage. This means that the scan will be not be done in streaming but in 2 phases. First the data will be stored on a temporary storage drive during the scan process. This temporary storage can be a local directory or a virtual space on the network. It can also be on the same partition that is being scanned (provided there is enough space available). It must be at least half the size of the machine you want to scan.


    If you are using local storage, UForge AppCenter will generate a script for you named upload_raw_partition_images.bat that you will have to launch at the end, to upload the archive to UForge AppCenter once the scan is complete.

  10. If you want to exclude certain partitions from the scan then check the boxes accordingly in the section Disks or Partitions to exclude.

  11. Click Scan to launch the scan. A report is sent to UForge AppCenter which can be used for migration. To view the progress, go back to the Scans page.

  12. To view the details of a scan, click on the scan and refer to Viewing and Using a Scan.


    The log files of uforge-scan.exe on the source Microsoft Windows machine are stored under the following directory: %SystemRoot%\System32\LogFiles\UForge.

  13. To complete your migration, you will need to generate a machine image and publish it. Refer to Generate a Machine Image from Scan.