Fast Import of an Image File in Windows

Scenarios

Prerequisites

• The image file has been initially configured as instructed in Table 2 based on the OS in the image file.
• An OBS bucket has been created on the management console, and OBS Browser+ has been ready.

Procedure

1. Install the open-source image conversion tool qemu-img.
2. Run the cmd command to go to the qemu-img installation directory and run the qemu-img command to convert the image file to the RAW format.

   For example, run the following command to convert an image.qcow2 file to an image.raw file:

   qemu-img convert -p -O raw image.qcow2 image.raw

3. Use CreateMF.jar to generate a bitmap file.
   1. Obtain the CreateMF.jar package and decompress it.

      Table 1 CreateMF.jar package

      Tool Package	How to Obtain
      createMF.zip	https://ecs-instance-driver.obs.ru-moscow-1.hc.sbercloud.ru/createMF.zip

   2. Ensure that JDK has been installed in the current environment.

      You can verify the installation by running cmd.exe and then java -version. If Java version information is displayed, JDK has been installed.

   3. Go to the directory where CreateMF.jar is stored.

      For example, if you have downloaded CreateMF.jar to D:/test, run the following commands to access the directory:

      D:

      cd test

   4. Run the following command to generate a bitmap file for the RAW image file:

      java -jar CreateMF.jar D:/image01.raw D:/image01.mf

      Caution

      • The generated .mf bitmap file must have the same prefix as the RAW image file. For example, if the image file name is image01.raw, the generated bitmap file name is image01.mf.

4. Use OBS Browser+ to upload the converted image file and its bitmap file to an OBS bucket.

   You must upload the RAW image file and its bitmap file to the same OBS bucket.

5. Register a private image.

   You can register a private image using the converted ZVHD2 or RAW file on the console or using an API.

   Method 1: Register a private image on the console.

   1. Log in to the management console.
   2. Choose Computing > Image Management Service.

      The IMS console is displayed.

   3. In the upper right corner, click Create Image.
   4. In the Image Type and Source area, select Import Image for Type and then select System disk image or Data disk image for Image Type.
   5. Select the bucket storing the ZVHD2 or RAW image file and then select the image file. For the RAW format, you also need to upload a bitmap file with the same name as the image file.
   6. Select Enable Fast Create, and select the sentence following Image File Preparation.
   7. Set parameters as prompted.

      For details about the parameters, see Registering an Image File as a Private Image.

      Caution

      • The OS must be the same as that in the image file.
      • The system disk capacity must be greater than that specified in the image file.

        Run the following command to check the system disk capacity in the image file:

        qemu-img-hw info test.zvhd2

   Method 2: Register a private image using an API.

   The API is POST /v2/cloudimages/quickimport/action.

   For details about how to call this API, see "Importing an Image File Quickly" in Image Management Service API Reference.