• Image Management Service

  1. Help Center
  2. Image Management Service
  3. User Guide
  4. Creating a Private Image
  5. Creating a Linux System Disk Image Using an External Image File
  6. Registering an Image File as a Private Image

Registering an Image File as a Private Image


You can register an external image file as a private image on the cloud platform.

  • Register an uninitialized image file as an uninitialized private image.
  • Register an initialized image file as a normal private image.


You have uploaded the image file to the OBS bucket.


  1. Log in to the management console.
  2. Under Computing, click Image Management Service.
  3. On the Image Management Service page, click Create Image.
  4. In the Image Type and Source area, select System disk image for Type.
  5. Select Image File for Source. Select the bucket storing the image file from the list and then select the image file.
    Figure 1 Registering the image file as a private image
  6. To register the image file using the fast image creation function, select Enable Fast Create.
    • Currently, this function supports only image files in ZVHD2 or RAW format.
    • For how to convert image file formats and generate bitmap files, see Quickly Importing an Image File.
    After you decide to use this function, you need to confirm whether image file is ready.
    • Verify its format has been converted to ZVHD2 or RAW and that the images file has been optimized as required.
    • For RAW image files, the bitmap file has been uploaded together with the image file.

    If the image file is ready, select Image File Preparation.

  7. Select Enable automatic configuration. The system will perform the following operations on the image file:
    • Check whether drivers related to the PV driver exist. If yes, delete them.
    • Modify the grub and syslinux configuration files to add the OS kernel boot parameters and change the disk partition name to UUID=UUID of the disk partition.
    • Change the names of the disk partitions in the /etc/fstab file to UUID=UUID of the disk partition.
    • Check whether the initrd file has the Xen and IDE drivers. If no, load the Xen and IDE drivers.
    • Modify X Window configuration file /etc/X11/xorg.conf to prevent display failures.
    • Delete services of VMware tools.
    • Linux OSs automatically copy the built-in VirtIO driver to initrd or initramfs. For details, see External Image Files and Supported OSs.
    If the image file has the preceding configuration, you can choose not to select Enable automatic configuration. Otherwise, select Enable automatic configuration.

    For image files in the following scenarios, this function does not take effect after Enable automatic configuration is selected:

    • Image files whose /usr directory is an independent partition
    • Image files that use Fedora 29 64bit and the XFS file system
    • Image files that use SUSE 12 SP4 64bit and the ext4 file system
  8. In the Image Information area, specify the image function. By default, ECS system disk image is selected.

    ECS system disk image: This type of images can be used to create ECSs.

    BMS system disk image: This type of images can be used to create BMSs and cannot be encrypted.

    Figure 2 Specifying image information
  9. (Optional) Select the OS required by the image.

    To ensure that images can be created and used, select the OS consistent with that of the image file. If no OS is selected, the system will automatically identify the OS of the image file.

  10. Specify the system disk capacity.
  11. Enter the image name.
  12. (Optional) Encrypt the image.

    If the image needs to be encrypted, select KMS encryption and select the key to be used from the list of keys. After you select KMS encryption, the system will create a default master private key ims/default for you. You can also select a private key from the private key list. For how to encrypt an image, see Creating Encrypted Images.

  13. Enter the description of the image file as required.
  14. Click Create Now.
  15. Confirm the parameters and click Submit.

The time required for image registration is determined by the image file size. You may need to wait a long period of time for the image file to be successfully registered as a private image that is not initialized.