Help Center/ Image Management Service/ User Guide/ Creating a Private Image/ Fast Import of an Image File/ Overview
Updated on 2024-07-12 GMT+08:00
View PDF

Overview

If an image file is larger than 128 GB, you can import it using fast import.

Constraints

  • The image file must be in RAW or ZVHD2 format.
  • The image file size cannot exceed 1 TB.

Methods

You can import an image file in any of the following methods depending on the file format:
  • ZVHD2
    1. Optimize the image file.
    2. Upload the image file to an OBS bucket.
    3. Register the image file on the cloud platform.
  • RAW
    1. Optimize the image file.
    2. Generate a bitmap file for the image file.
    3. Upload the image file and bitmap file to an OBS bucket.
    4. Register the image file on the cloud platform.
  • Others
    • If the file format is converted to ZVHD2:
      1. Optimize the image file.
      2. Convert the image file format to ZVHD2.
      3. Upload the image file to an OBS bucket.
      4. Register the image file on the cloud platform.
    • If the file format is converted to RAW:
      1. Optimize the image file.
      2. Convert the image file format to RAW and generate a bitmap file for the image file.
      3. Upload the image file and bitmap file to an OBS bucket.
      4. Register the image file on the cloud platform.
  • Fast import is used to quickly import large files. It depends on lazy loading which defers loading of file data until the data is needed. This reduces the initial loading time. However, RAW files do not support lazy loading. When you upload a RAW file, you need to upload its bitmap together.
  • For details about how to optimize an image file, see Optimization Process (Windows) or Optimization Process (Linux) depending on the OS type specified in the image file.

Import Process

Assume that you need to convert the file format to ZVHD2 or RAW.

You can use qemu-img-hw or the open-source tool qemu-img to convert the image format. qemu-img-hw can only be used in Linux.

The tool package contains qemu-img-hw (for converting image formats) and CreateMF.jar (for generating bitmap files).

  • Linux

    You are advised to use an EulerOS ECS to convert the file format.

    Figure 1 Import process (Linux)

    For details, see Fast Import in Linux.

  • Windows

    You are advised to use a local PC running Windows to convert the file format.

    qemu-img cannot convert image files to the ZVHD2 format. You need to convert an image file to the RAW format and then use CreateMF.jar to generate a bitmap file.

    Figure 2 Import process (Windows)

    For details, see Fast Import in Windows.