tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Virtual Machine
    Documentation
    Download PDF

    Overview

    Last updated: 2024-01-08 09:37:00
    Download PDF
      In addition to creating a custom image, Tencent Cloud allows you to import images. You can import an image file of the system disk on a local or a different server into CVM custom images. You can use the imported image to create a CVM or reinstall the operating system for an existing CVM.

      Import Preparation

      Prepare an image file that meets the import requirements.
      Linux images
      Windows images
      Image Attribute
      Requirements
      OS
      CentOS、CentOS Stream、Ubuntu、Debian、OpenSUSE、CoreOS、FreeBSD、AlmaLinux、Rocky Linux、Fedora、Kylin、UnionTech、TencentOS
      Both 32-bit and 64-bit OSs are supported
      Image format
      RAW, VHD, QCOW2, and VMDK
      Run qemu-img info imageName | grep 'file format' to check the image format.
      File system type
      GPT partition is not supported
      Image size
      The actual image size cannot exceed 50 GB. Run qemu-img info imageName | grep 'disk size' to check the image size.
      The image vsize cannot exceed 500 GB. Run qemu-img info imageName | grep 'virtual size' to check the image vsize.
      Note:
      size of an image in QCOW2 format is used upon check during import.
      Network
      By default, Tencent Cloud provides the eth0 network interface for the instance.
      You can use the metadata service to query the network configuration of the instance. For more information, see Instance Metadata.
      Driver
      Virtio driver of the virtualization module KVM must be installed for an image. For more information, see Checking Virtio Drivers in Linux.
      We recommend installing cloud-init for the image. For more information, see Installing Cloud-Init on Linux.
      If cloud-init cannot be installed, configure the instance by referring to Forcibly Import Image.
      File System
      To ensure the Linux system can accurately recognize the disk when enabling the file system, please check and accurately configure the GRUB file disk identification method. For more information, refer to the Setting the GRUB File Disk Identification Method to UUID.
      To ensure the Linux system can accurately recognize the disk when mounting the file system, please check and accurately configure the fstab file disk identification method. For more information, refer to Setting the Fstab Disk Identification Method to UUID.
      Kernel
      Native kernel is preferred for an image. Any modifications on the kernel may cause the import to fail.
      Region
      Importing images from COS in another region is unavailable for the Shanghai Finance and Shenzhen Finance.
      
      Image Attribute
      Requirements
      OS
      Windows Server 2008, Windows Server 2012, Windows Server 2016 related versions, Windows Server 2019 related versions, and Windows Server 2022 related versions
      Both 32-bit and 64-bit OSs are supported.
      Image format
      RAW, VHD, QCOW2, and VMDK
      Run qemu-img info imageName | grep 'file format' to check the image format.
      File system type
      Only NTFS with MBR partition is supported.
      GPT partition is not supported.
      Logical Volume Manager (LVM) is not supported.
      Image size
      The actual image size cannot exceed 50 GB. Run qemu-img info imageName | grep 'disk size' to check the image size.
      The image vsize cannot exceed 500 GB. Run qemu-img info imageName | grep 'virtual size' to check the image vsize.
      Note:
      size of an image in QCOW2 format is used upon check during import.
      Network
      By default, Tencent Cloud provides local area connection network interface for the instance.
      You can use the metadata service to query the network configuration of the instance. For more information, see Instance Metadata.
      Driver
      Virtio driver of the virtualization module KVM must be installed for an image. The Windows system does not come with a Virtio driver by default, so first install the Windows Virtio driver before exporting a local image. Choose the download address based on the network environment:
      Public network download address:http://mirrors.tencent.com/install/windows/virtio_64_1.0.9.exe
      Private network download address:http://mirrors.tencentyun.com/install/windows/virtio_64_1.0.9.exe
      Region
      Importing images from COS in another region is unavailable for the Shanghai Finance and Shenzhen Finance.
      Others
      Imported Windows images do not support Windows system activation.
      

      Directions

      1. Log in to the CVM console and click Images on the left sidebar.
      2. Select Custom image and click Importing an image.
      3. As prompted in the operation interface, first enable COS, and then create a bucket. Uploading an Object the image file to the bucket and get the image file URL.
      4. Click Next.
      5. Complete the configurations and click Import.
      Note:
      Ensure the entered COS file URL is correct.
      You will be notified about the result of import via Message Center.

      Failed Imports

      If the import failed, troubleshoot as follows:

      Notes

      Make sure you have subscribed to product service notifications via Message Subscription. This ensures you can receive notifications from Message Center, SMS messages, and emails about the cause of failure.
      Note:
      If you do not subscribe to product service notifications, you will not receive the notification from Message Center about whether an import is successful.

      Troubleshooting

      You can refer to the following information for troubleshooting on errors. See error code for detailed error prompt and error description.

      Error Code

      Error Code
      Reason
      Recommended Solution
      InvalidUrl
      Invalid COS link.
      Check whether the COS URL is the same as the imported image URL.
      InvalidFormatSize
      Format or size does not meet requirements.
      Images must meet the image format and image size requirements in Preparations.
      VirtioNotInstall
      Virtio driver not installed.
      Install the Virtio driver in the image by referring to the Driver section in Preparations.
      PartitionNotPresent
      Partition information not found.
      Image is corrupted possibly due to incorrect image creation method.
      CloudInitNotInstalled
      Cloud-init software not installed.
      Install cloud-init in the Linux image by referring to the Driver section in Preparations.
      RootPartitionNotFound
      Root partition not found.
      Image is corrupted possibly due to incorrect image creation method.
      InternalError
      Other errors.
      Contact our customer service.
      
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy