快速导入镜像文件（基于Linux环境）

操作场景

本节指导您基于Linux操作系统环境完成镜像文件快速导入，推荐使用云平台的EulerOS云服务器作为转换镜像格式和生成位表文件的环境。

Linux操作系统环境下，建议使用qemu-img-hw工具进行镜像格式转换。

前提条件

• 已完成镜像文件优化，详细操作请参考优化过程（Windows）或优化过程（Linux）；同时需要确保镜像文件符合表2或表2中的限制条件。
  

  根据镜像文件的操作系统类型来选择所参考内容。

• 已在管理控制台创建EulerOS操作系统的弹性云服务器，并确保云服务器已绑定弹性公网IP。
• 已在管理控制台创建OBS桶。

操作步骤

1. 上传镜像文件至云服务器。
   • 本地主机为Linux系统：

     通过scp命令将镜像文件上传至云服务器。以将“image01.qcow2”文件上传至云服务器的“/usr/”目录下为例。

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

     其中，xxx.xxx.xx.xxx为云服务器的弹性公网IP。

   • 本地主机为Windows系统：

     使用文件传输工具（例如WinSCP）将镜像文件上传至云服务器。

2. 获取快速导入工具并上传至云服务器，然后解压工具包。

   请联系管理员获取快速导入工具。

3. 使用qemu-img-hw工具转换镜像格式。
   1. 进入qemu-img-hw存放目录，以存放在“/usr/quick-import-tools/qemu-img-hw”为例：

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

   2. 执行以下命令修改权限：

      chmod +x qemu-img-hw

   3. 执行qemu-img-hw命令将镜像文件转为zvhd2或raw格式（推荐转为zvhd2格式）。

      qemu-img-hw命令格式：

      ./qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件}

      以将“image01.qcow2”格式文件转换成“image01.zvhd2”格式为例：

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

      • 若转换后为zvhd2格式文件，请执行5。
      • 若转换后为raw格式文件，请使用CreateMF.jar工具，生成raw格式镜像文件的位表文件。请执行4。

4. 使用CreateMF.jar工具生成位表文件。
   1. 请确保当前云服务器已安装jdk。

      执行以下命令查看是否已安装jdk：

      source /etc/profile

      java -version

      如果回显信息中显示java版本信息，证明当前云服务器已安装jdk。

   2. 执行以下命令进入CreateMF.jar程序所在的目录。

      cd /usr/quick-import-tools/createMF

   3. 执行以下命令生成位表文件。

      java -jar CreateMF.jar /原raw文件路径 /生成的mf文件路径

      例如：

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

      

      • 生成的.mf位表文件和raw格式镜像文件必须是相同名称。例如镜像文件名称为：image01.raw，那么生成的位表文件名称为：image01.mf。

5. 使用s3cmd工具上传文件至OBS桶。
   1. 安装s3cmd工具。

      若云服务器已安装该工具可跳过此步骤，直接进行第二步配置s3cmd：

      1. 执行以下命令，安装setuptools。

         yum install python-setuptools

      2. 执行以下命令，安装wget。

         yum install wget

      3. 执行以下命令，获取s3cmd软件包。

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

         mv master.zip s3cmd-master.zip

      4. 执行以下命令，安装s3cmd。

         unzip s3cmd-master.zip

         cd s3cmd-master

         python setup.py install

   2. 配置s3cmd工具。

      执行以下命令配置s3cmd工具。

      s3cmd --configure
      Access Key: 输入AK
      Secret Key: 输入SK
      Default Region: 输入所在Region
      S3 Endpoint: 可参考OBS的Endpoint
      DNS-style bucket+hostname:port template for accessing a bucket: 输入带桶名的Server地址，例如mybucket.obs.myclouds.com
      Encryption password: 不填，直接按回车
      Path to GPG program: 不填，直接按回车
      Use HTTPS protocol: 是否使用HTTPS，Yes/No
      HTTP Proxy server name: 代理地址，连接云平台需要连外网（如不需要直接回车）
      HTTP Proxy server port: 代理端口，连接云平台需要连外网（如不需要直接回车）
      Test access with supplied credentials? y
      （如果显示：Success. Your access key and secret key worked fine :-) 则表示连接成功）
      Save settings? y（是否保存配置）

      

      配置完成后，信息会保存在用户目录下“/root/.s3cfg”，如果还想修改，可以重新执行s3cmd --configure命令，或者直接编辑.s3cfg文件（执行vi .s3cfg命令进行编辑）。

   3. 使用s3cmd命令上传zvhd2格式镜像文件到OBS桶，或者上传raw格式镜像文件及其位表文件到OBS桶。

      s3cmd put image01.zvhd2 s3://mybucket/

      

      .mf位表文件必须和其对应的raw格式镜像文件在同一个OBS桶中。

6. 注册私有镜像。

   您可以通过控制台方式、API接口方式，将转换后的zvhd2或raw文件注册为私有镜像。

   方法一：通过控制台创建私有镜像

   1. 登录IMS控制台。
      1. 登录管理控制台。
      2. 选择“计算 > 镜像服务”。

         进入镜像服务页面。

   2. 单击右上角的“创建私有镜像”。
   3. 在“镜像类型和来源”区域，选择镜像的创建方式为“系统盘镜像”或“数据盘镜像”。
   4. 镜像源选择“镜像文件”，从列表中选择转换为zvhd2或raw文件的桶，再选择转换后的镜像文件。如果是raw格式镜像文件，需要确保同名位表文件已上传。
   5. 勾选快速通道栏的“开启快速通道”，并确认已优化镜像文件，然后勾选“镜像文件准备”栏的内容。
   6. 根据界面提示填写配置信息。

      具体的配置参数说明，请参见注册镜像（Linux）。

      

      • 操作系统必须要和镜像文件所含的操作系统一致。
      • 系统盘大小必须大于镜像文件的大小。

        通过qemu-img-hw工具可查询镜像文件大小：

        qemu-img-hw info test.zvhd2

   方法二：通过API方式创建私有镜像

   您可以通过接口POST /v2/cloudimages/quickimport/action，实现镜像文件快速导入功能。

   该接口的具体调用方法，请参见《镜像服务接口参考》的“镜像文件快速导入”章节。

附1：qemu-img-hw常用命令

• 镜像文件格式转换：qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件}

  上述命令中各参数对应的说明如下：

  -p：标识转换的进度条

  -O：（必须是大写）后面的参数为转换出来的镜像格式 + 源镜像文件名称 + 目标镜像文件名称

  示例：将qcow2格式转为zvhd2格式

  qemu-img-hw convert -p -O zvhd2 test.qcow2 test.zvhd2

• 查询镜像文件信息：qemu-img-hw info {镜像文件}

  示例：qemu-img-hw info test.zvhd2

• 查看帮助：qemu-img-hw -help

附2：执行qemu-img-hw常见报错

• 问题描述：
  执行qemu-img-hw命令时回显信息如下：

  ./qemu-img-hw: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by ./qemu-img-hw)

  解决方法：

  执行strings /lib64/libc.so.6 | grep GLIBC查看GLIBC版本，若由于版本过低造成，可安装高版本即可。依次执行下述命令：

  wget http://ftp.gnu.org/gnu/glibc/glibc-2.15.tar.gz

  wget http://ftp.gnu.org/gnu/glibc/glibc-ports-2.15.tar.gz

  tar -xvf glibc-2.15.tar.gz

  tar -xvf glibc-ports-2.15.tar.gz

  mv glibc-ports-2.15 glibc-2.15/ports

  mkdir glibc-build-2.15

  cd glibc-build-2.15

  ../glibc-2.15/configure --prefix=/usr --disable-profile --enable-add-ons --with-headers=/usr/include --with-binutils=/usr/bin

  

  此命令若报错“configure: error: no acceptable C compiler found in $PATH”，请先执行：yum -y install gcc

  make

  make install

• 问题描述：

  执行qemu-img-hw命令时回显信息如下：

  ./qemu-img-hw: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory

  解决方法：请先执行命令yum install libaio