Importing Custom Windows Images

The Compute service enables you to import Windows images that were created outside of Oracle Cloud Infrastructure. For example, you can import images running on your on-premises physical or virtual machines (VMs), or VMs running in Oracle Cloud Infrastructure Classic. You can then launch your imported images on compute virtual machines.

For information about the licensing requirements for Windows images, see Microsoft Licensing on Oracle Cloud Infrastructure.

Supported Operating Systems

These Windows versions support custom image import:

  • Windows Server 2012 Standard, Datacenter
  • Windows Server 2012 R2 Standard, Datacenter
  • Windows Server 2016 Standard, Datacenter
  • Windows Server 2019 Standard, Datacenter
  • Windows Server 2022 Standard, Datacenter
Note

  • Oracle Cloud Infrastructure has tested the operating systems listed previously and will support customers in ensuring that instances launched from these images and built according to the guidelines in this topic are accessible using RDP.
  • For OS editions not listed previously, Oracle Cloud Infrastructure will provide commercially reasonable support to customers in an effort to get instances that are launched from these images accessible via RDP.
  • Support from Oracle Cloud Infrastructure in launching an instance from a custom OS does not ensure that the operating system vendor also supports the instance.
  • Oracle Cloud Infrastructure licenses and charges the Windows licensing fee for all instances launched using an imported Windows OS image. This applies whether or not those instances are registered with Oracle Cloud Infrastructure's Microsoft Key Management service.

Windows Source Image Requirements

Custom images must meet the following requirements:

  • The maximum image size is 400 GB.

  • The image must be set up for BIOS boot. You can leave the boot type as BIOS or change it to UEFI after you import the image.

  • Only one disk is supported, and it must be the boot drive with a valid master boot record (MBR) and boot loader. You can migrate additional data volumes after you import the image's boot volume.

  • The minimum boot volume size is 256 GB. For more information, see Custom Boot Volume Sizes.
  • The boot process must not require additional data volumes to be present for a successful boot.

  • The disk image cannot be encrypted.

  • The disk image must be a VMDK or QCOW2 file.

    • Create the image file by cloning the source volume, not by creating a snapshot.
    • VMDK files must be either the "single growable" (monolithicSparse) type or the "stream optimized" (streamOptimized) type, both of which consist of a single VMDK file. All other VMDK formats, such as those that use multiple files, split volumes, or contain snapshots, are not supported.
  • The network interface must use DHCP to discover the network settings. When you import a custom image, existing network interfaces are not recreated. Any existing network interfaces are replaced with a single NIC after the import process is complete. You can attach additional VNICs after you launch the imported instance.

  • The network configuration must not hardcode the MAC address for the network interface.

Preparing Windows VMs for Import

Before you can import a custom Windows image, you must prepare the image to ensure that instances launched from the image can boot correctly and that network connections will work.

You can perform the tasks described in this section on the running source system. If you have concerns about modifying the live source system, you can export the image as-is, import it into Oracle Cloud Infrastructure, and then launch an instance based on the custom image. You can then connect to the instance using the VNC console and perform the preparation steps.

Important

The system drive where Windows is installed will be imported to Oracle Cloud Infrastructure. All partitions on the drive will follow through the imported image. Any other drives will not be imported and you must re-create them on the instance after import. You will then need to manually move the data on the non-system drives.

To prepare a Windows VM for import:

  1. Follow your organization's security guidelines to ensure that the Windows system is secured. This can include, but is not limited to the following tasks:

    • Install the latest security updates for the operating system and installed applications.

    • Enable the firewall, and configure it so that you only enable the rules which are needed.

    • Disable unnecessary privileged accounts.

    • Use strong passwords for all accounts.

  2. Configure Remote Desktop Protocol (RDP) access to the image:

    1. Enable Remote Desktop connections to the image.
    2. Modify the Windows Firewall inbound port rule to allow RDP access for both Private and Public network location types. When you import the image, the Windows Network Location Awareness service will identify the network connection as a Public network type.
  3. Determine whether the current Windows license type is a volume license by running the following command in PowerShell:

    Get-CimInstance -ClassName SoftwareLicensingProduct | where {$_.PartialProductKey} | select ProductKeyChannel

    If the license is not a volume license, after you import the image, you will update the license type.

  4. If you plan to launch the imported image on more than one VM instance, create a generalized image of the boot disk. A generalized image is cleaned of computer-specific information, such as unique identifiers. When you create instances from a generalized image, the unique identifiers are regenerated. This prevents two instances that are created from the same image from colliding on the same identifiers.

  5. Create a backup of the root volume.

  6. If the VM has remotely attached storage, such as NFS or block volumes, configure any services that rely on this storage to start manually. Remotely attached storage is not available the first time that an imported instance boots on Oracle Cloud Infrastructure.

  7. Ensure that all network interfaces use DHCP, and that the MAC address and IP addresses are not hard-coded. See your system documentation for steps to perform network configuration for your system.

  8. Download the Oracle VirtIO Drivers for Microsoft Windows.
  9. Install the drivers and then restart the instance.

  10. Stop the VM.

  11. Clone the stopped VM as a VMDK or QCOW2 file, and then export the image from your virtualization environment. See the tools documentation for your virtualization environment for steps.

Importing a Windows-Based VM

After you prepare a Windows image for import, follow these steps to import the image:

  1. Upload the image file to an Object Storage bucket. You can upload the file using the Console or using the command line interface (CLI). If you use the CLI, use the following command:

    oci os object put -bn <destination_bucket_name> --file <path_to_the_VMDK_or_QCOW2_file>
  2. Open the navigation menu and click Compute. Under Compute, click Custom Images.
  3. Click Import image.

  4. In the Create in compartment list, select the compartment that you want to import the image to.

  5. Enter a Name for the image. Avoid entering confidential information.

  6. For the Operating system, select Windows.

  7. In the Operating system version list, select the version of Windows.

  8. Confirm that you chose the operating system version that complies with your Microsoft licensing agreement, and then select the compliance check box.

    Important

    Failure to provide the correct version and SKU information could be a violation of your Microsoft Licensing Agreement.
  9. Select the Import from an Object Storage bucket option.

  10. Select the Bucket that you uploaded the image to.
  11. In the Object name list, select the image file that you uploaded.
  12. For the Image type, select the file type of the image, either VMDK or QCOW2.

  13. In the Launch mode area, select Paravirtualized mode.

  14. Show tagging options: If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
  15. Click Import image.

    The imported image appears in the Custom images list for the compartment, with a state of Importing. When the import completes successfully, the state changes to Available.

    If the state doesn't change, or no entry appears in the Custom images list, the import failed. Ensure that you have read access to the Object Storage object, and that the object contains a supported image.

  16. Complete the post-import tasks.

Post-Import Tasks for Windows Images

After you import a custom Windows-based image, do the following:

  1. If you want to use the image on AMD or X6-based shapes, add the shapes to the image's list of compatible shapes.
  2. Create an instance based on the custom image. For the image source, select Custom Images, and then select the image that you imported.
  3. Enable Remote Desktop Protocol (RDP) access to the compute instance.
  4. Connect to the instance using RDP.
  5. If the instance requires any remotely attached storage, such as block volumes or file storage, create and attach it.
  6. Create and attach any required secondary VNICs.
  7. Test that all applications are working as expected.
  8. Reset any services that were set to start manually.
  9. Configure your instance to use the Network Time Protocol (NTP). You can use the Oracle Cloud Infrastructure NTP service, or you can use the Windows Time service (W32Time).
    Tip

    If you encounter a no time data was available error message when setting up NTP on Windows Server, review the information in the Microsoft known issue article.
  10. Register the instance with the Oracle-provided Key Management Service (KMS) server:
    Important

    To register the instance with the KMS server, the time on your instance must match your time zone.
    1. On the instance, open PowerShell as Administrator.
    2. To set the KMS endpoint, run the following command:

      slmgr /skms 169.254.169.253:1688
    3. If the Windows license type that you noted while preparing the image isn't a volume license, then you must update the license type. Run the following command:

      slmgr /ipk <setup key>

      <setup key> is the KMS client setup key that corresponds to the version of Windows that you imported:

      Important

      Go to Microsoft's Key Management Services (KMS) client activation and product keys page and get the <setup key> for your operating system version. Entries looks similar to:

      Windows Server 2022 Standard: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

      To determine the Windows version of the VM, run the following command:

      DISM.exe /Online /get-currentedition
    4. To activate Windows, run the following command:

      slmgr /ato
    5. To verify the license status, run the following command:

      Get-CimInstance -ClassName SoftwareLicensingProduct | where {$_.PartialProductKey} | select Description, LicenseStatus

      If the LicenseStatus is 1, the instance is properly licensed. It might take up to 48 hours for the license status to update.