Quickly Importing an Image File (Linux)

Scenarios

This section describes how to convert the format of an image file on a Linux server and then quickly import it to the cloud platform. You are advised to use an EulerOS ECS for converting image file formats and generating bitmap files.

In Linux, you are advised to use qemu-img-hw to convert image formats.

Prerequisites

Procedure

  1. Upload an image file.

    • If the image file is uploaded from a Linux PC, run the scp command.

      For example, to upload image01.qcow2 to the /usr/ directory of the ECS, run the following command:

      scp /var/image01.qcow2 root@xxx.xxx.xx.xxx:/usr/

      xxx.xxx.xx.xxx indicates the EIP bound to the ECS.

    • If the image file is uploaded from a Windows PC, use a file transfer tool, such as WinSCP, to upload the image file.

  2. Obtain the fast import tool package, upload it to the ECS, and then decompress the package.

    Obtain the fast import tool package from the following link in the table.
    Table 1 Fast import tool package

    Tool Package

    How to Obtain

    quick-import-tools

    https://obs-20181128.ims.obs.eu-de.otc.t-systems.com/DT-image-convert-tools.zip

  3. Use qemu-img-hw to convert the image format.

    1. Go to the directory where qemu-img-hw is stored, for example, /usr/quick-import-tools/qemu-img-hw.

      cd /usr/quick-import-tools/qemu-img-hw

    2. Run the following command to make qemu-img-hw executable:

      chmod +x qemu-img-hw

    3. Execute qemu-img-hw to convert the image file format to ZVHD2 (recommended) or RAW.

      Command format:

      ./qemu-img-hw convert -p -O Target_image_format Source_image_file Target_image_file

      For example, run the following command to convert an image01.qcow2 file to an image01.zvhd2 file:

      ./qemu-img-hw convert -p -O zvhd2 image01.qcow2 image01.zvhd2

      • If the image file is converted to the ZVHD2 format, go to 5.
      • If the image file is converted to the RAW format, go to 4.

  4. Use CreateMF.jar to generate a bitmap file.

    1. Ensure that JDK has been installed on the ECS.

      Run the following commands to check whether JDK is installed:

      source /etc/profile

      java -version

      If a Java version is displayed, JDK has been installed.

    2. Run the following command to enter the directory where CreateMF.jar is stored:

      cd /usr/quick-import-tools/createMF

    3. Run the following command to generate a bitmap file:

      java -jar CreateMF.jar /Original RAW file path/Generated .mf file path

      Example:

      java -jar CreateMF.jar image01.raw image01.mf

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

  5. Use s3cmd to upload the file(s) to an OBS bucket.

    1. Install s3cmd on the ECS.

      If s3cmd has been installed, skip this step.

      1. Run the following command to install setuptools:

        yum install python-setuptools

      2. Run the following command to install wget:

        yum install wget

      3. Run the following commands to obtain the s75pxd software package:

        wget https://github.com/s3tools/s3cmd/archive/master.zip

        mv master.zip s3cmd-master.zip

      4. Run the following commands to install s3cmd:

        unzip s3cmd-master.zip

        cd s3cmd-master

        python setup.py install

    2. Configure s3cmd.

      Run the following command to configure s3cmd:

      s3cmd --configure
Access Key: Enter an AK.
Secret Key: Enter an SK.
Default Region: Enter the region where the bucket is located.
S3 Endpoint: Refer to the OBS endpoint.
DNS-style bucket+hostname:port template for accessing a bucket: Enter a server address with a bucket name, for example, mybucket.obs.myclouds.com.
Encryption password: Press Enter.
Path to GPG program: Press Enter.
Use HTTPS protocol: Specifies whether to use HTTPS. The value can be Yes or No.
HTTP Proxy server name: Specifies the proxy address used to connect the cloud from an external network. (If you do not need it, press Enter.)
HTTP Proxy server port: Specifies the proxy port used to connect to the cloud from an external network (If you do not need it, press Enter.)
Test access with supplied credentials? y
(If "Success. Your access key and secret key worked fine :-)" is displayed, the connection is successful.)
Save settings? y (Specifies whether to save the configurations. If you enter y, the configuration will be saved.)

      The configurations will be stored in /root/.s3cfg. If you want to modify these configurations, run the s3cmd --configure command to configure the parameters or run the vi .s3cfg command to edit the .s3cfg file.

    3. Run the following command to upload the ZVHD2 image file (or the RAW image file and its bitmap file) to an OBS bucket.

      s3cmd put image01.zvhd2 s3://mybucket/

      The .mf bitmap file must be in the same OBS bucket as the RAW image file.

  6. 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. Access the IMS console.
      1. Log in to the management console.
      2. Under Compute, click Image Management Service.

        The IMS console is displayed.

    2. In the upper right corner, click Create Image.
    3. In the Image Type and Source area, select System disk image or Data disk image for Type.
    4. Select Image File for Source. Select the bucket storing the ZVHD2 or RAW image file and then select the image file. If the image file is in the RAW format, you also need to select its bitmap file.
    5. Select Enable Fast Create, and select the sentence following Image File Preparation.
      Figure 1 Quickly importing an image file
    6. Set parameters as prompted.

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

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

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

        qemu-img-hw info test.zvhd2

    Method 2: Register a private image using an API.

    You can use the POST /v2/cloudimages/quickimport/action API to quickly import an image file.

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

Appendix 1: Common qemu-img-hw Commands

Appendix 2: Common Errors During qemu-img-hw Running

Parent topic: Quickly Importing an Image File