Image Import/Export (2024)

Verify Your Windows Operating System

When importing custom Windows images, ensure that the version you select matches the Windows image that you imported. Failure to provide the correct version and SKU information could be a violation of your Microsoft Licensing Agreement.

Windows System Time Issue on Custom Windows Instances

If you change the time zone from the default setting on Windows VM instances, when the instance reboots or syncs with the hardware clock, the system time will revert back to the time for the default time zone. However, the time zone setting will stay set to the new time zone, so the system clock will be incorrect. You can fix this by setting the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation registry key to 1.

Windows platform images already have the RealTimeIsUniversal registry key set by default, but you must set this for any custom Windows images that you import.

To fix this issue for custom Windows images:

1. Open the Windows Registry Editor and navigate to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation registry key.
2. Create a new DWORD key named RealTimeIsUniversal and set the value to 1.
3. Reboot the instance.
4. Reset the time and time zone manually.

Best practices for replicating an image across regions

You can replicate an image from one region to another region using the Console or API. At a high level:

1. Export the image to an Object Storage bucket in the same region as the image.
2. Copy the image to an Object Storage bucket in the destination region.
3. Obtain the URL path to the image object.
4. In the destination region, import the image. Use the URL path as the Object Storage URL.

Best practices for sharing an image across tenancies

You can replicate an image from one tenancy to another tenancy using the Console or API. At a high level:

1. Export the image to an Object Storage bucket in the same region as the image.

2. Working with Pre-Authenticated Requests with read-only access for the image in the destination region.

3. In the destination tenancy, import the image. Use the pre-authenticated request URL as the Object Storage URL.

Pre-Authenticated Requests

When using import/export across tenancies, you need to use an Object Storage pre-authenticated request. See Working with Pre-Authenticated Requests for steps to create a pre-authenticated request. When you go through these steps, after you click Create Pre-Authenticated Request, the Pre-Authenticated Request Details dialog box opens. You must make a copy of the pre-authenticated request URL displayed here, because this is the only time this URLis displayed. This is the Object Storage URL that you specify for import/export.

/o/MyCustomImage.qcow2

To export an image using the Console

1. Open the navigation menu and click Compute. Under Compute, click Custom Images.
2. Click the custom image that you're interested in.
3. Click Export.

4. Specify the Object Storage location to export the image to:

   • Export to an Object Storage bucket: Select a bucket. Then, enter a name for the exported image. Avoid entering confidential information.
   • Export to an Object Storage URL: Enter the Object Storage URL.

5. In the Image format list, select the format that you want to export the image to. The following formats are available:

   • Oracle Cloud Infrastructure file with a QCOW2 image and OCI metadata (.oci). Use this format to export a custom image that you want to import into other tenancies or regions.
   • QEMU Copy On Write (.qcow2)
   • Virtual Disk Image (.vdi) for Oracle VM VirtualBox
   • Virtual Hard Disk (.vhd) for Hyper-V
   • Virtual Machine Disk (.vmdk)
6. Click Export image.

After you click Export image, the image state changes to Exporting. Images are a copy of the VM or BM instance boot volume and metadata when the image is created, capturing the current state of the instance. Exporting a custom image copies the data to the Object Storage location that you specified. You can still launch instances while the image is exporting, but you can't delete the image until the export has finished. To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

When the export is complete, the image state changes to Available. If the image state changes to Available, but you don't see the exported image in the Object Storage location you specified, the export failed, and you need to go through the steps again to export the image.

To import an image using the Console

1. Open the navigation menu and click Compute. Under Compute, click Custom Images.
2. Click Import image.
3. In the Create in compartment list, select the compartment that you want to import the image to.
4. Enter a Name for the image. Avoid entering confidential information.

5. Select the Operating system:

   • For Linux images, select Linux.
   • For Windows images, select Windows. Select the Operating system version, and then certify that the selected operating system complies with Microsoft licensing agreements.

6. Specify the Object Storage location to import the image from:

   • Import from an Object Storage bucket: Select the Bucket that contains the image. In the Object name list, select the image file.
   • Import from an Object Storage URL: Enter the Object Storage URL of the image. When importing across tenancies, you must specify a pre-authenticated request URL.

7. In the Image type section, select the format of the image. The following formats are available:

   • VMDK: Virtual Machine Disk (.vmdk)
   • QCOW2: QEMU Copy On Write (.qcow2)
   • OCI: Oracle Cloud Infrastructure file with a QCOW2 image and OCI metadata (.oci). Use this format when importing a custom image that was exported from another tenancy or region.

8. Select the Launch mode:

   • For custom images where the image type is .oci, the launch mode is disabled. Oracle Cloud Infrastructure selects the appropriate launch mode based on the launch mode for the source image.

   • For custom images exported from Oracle Cloud Infrastructure where the image type is QCOW2, select Native mode.

   • To import other custom images, select Paravirtualized mode or Emulated mode. For more information, see Bring Your Own Image.

9. 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.
10. Click Import image.

After you click Import image, you'll see the imported image in the Custom images list for the compartment, with a state of Importing. To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

When the import completes successfully, the state changes to Available. If the state does not change, or no entry appears in the Custom images list, the import failed. If the import failed, ensure you have read access to the Object Storage object, and that the object contains a supported image.