VMware 虚拟化编程(12) — VixDiskLib Sample 程序使用

目录

• 目录
• 前文列表
• vixDiskLibSample
  • 安装 Sample 程序
  • Sample 程序使用方法

前文列表

VMware 虚拟化编程(1) — VMDK/VDDK/VixDiskLib/VADP 概念简析

VMware 虚拟化编程(2) — 虚拟磁盘文件类型详解

VMware 虚拟化编程(3) —VMware vSphere Web Service API 解析

VMware 虚拟化编程(4) — VDDK 安装

VMware 虚拟化编程(5) — VixDiskLib 虚拟磁盘库详解之一

VMware 虚拟化编程(6) — VixDiskLib 虚拟磁盘库详解之二

VMware 虚拟化编程(7) — VixDiskLib 虚拟磁盘库详解之三

VMware 虚拟化编程(8) — 多线程中的 VixDiskLib

VMware 虚拟化编程(9) — VMware 虚拟机的快照

VMware 虚拟化编程(10) — VMware 数据块修改跟踪技术 CBT

VMware 虚拟化编程(11) — VMware 虚拟机的全量备份与增量备份方案

vixDiskLibSample

在介绍 VDDK 时也提到过，VDDK 实际上是一系列的 C/C++ lib 库及其相关的 Docs 和 Sample 的开发工具集合。本篇主要记录 VDDK 提供的 Sample 程序的使用方法，它对于刚刚接触 VDDK 的开发者而言是非常有用的。

这些 Sample 程序代码是使用 C++ 编写的，要成功编译 Sample 程序，必须确保加载了正确的动态链接库和共享对象。在 Linux 系统，VixDiskLib 与动态链接库或者共享对象是组织在一起的，这样简化了第三方以及开源组件的打包发行。如果你按照《VMware 虚拟化编程(4) — VDDK 安装》中提供的方式进行安装，那么应该可以编译成功。当然了，每个人的环境不一样，你也可能需要进行调整。

官方给出了下列保证正确加载动态链接库的建议：

• Linux 默认的安装路径为 /usr/share/doc/vmware-vix-disklib/sample
• 在 VDDK 程序中设置路径
• 将 VDDK lib 库的路径加入到环境变量

NOTE：需要注意的是，VDDK 使用相对路径来加载动态链接库文件，而非绝对路径，应该要注意避免不同版本动态链接库的冲突。

安装 Sample 程序

在安装好 VDDK 之后，直接编译 Sample 程序：

[root@mickeyfan-dev diskLib]# cd /usr/lib/vmware-vix-disklib/doc/samples/diskLib
[root@mickeyfan-dev diskLib]# ls
Makefile  vixDiskLibSample.cpp
[root@mickeyfan-dev disklib]# make
[root@mickeyfan-dev diskLib]# ls
Makefile  vix-disklib-sample  vixDiskLibSample.cpp

NOTE 1：官方建议的 Sample 安装路径为 /usr/share/doc/vmware-vix-disklib/samples/disklib

NOTE 2：某些特定的 Linux 还需要在 vixDiskLibSample.cpp 的 15 行后添加两行 include

15 #else
16 #include <stdio.h>
17 #include <string.h>

NOTE 3：如果编译失败建议进行以下尝试

• 将 /usr/lib/vmware-vix-disklib/lib64 添加到 /etc/ld.so.conf.d/vmware-vix-disklib.conf 文件中，然后使用 root 权限运行 ldconfig 指令
• 添加或编辑环境变量 LD_LIBRARY_PATH=/usr/lib/vmware-vix-disklib/lib64

Sample 程序使用方法

使用方法：vixdisklibsample command [options] diskPath

指令：

- -create：创建由 -cap 选项指定容量大小的稀疏类型虚拟磁盘「diskPath」

- -redo parentPath：为父虚拟磁盘「parentPath」创建一个子(重写日志)虚拟磁盘「diskPath」

- -info：显示指定虚拟磁盘「diskPath」的信息

- -dump：以十六进制的方式显示指定范围内的扇区内容

- -fill：使用 -val 选项指定的值来填充指定范围内的虚拟磁盘扇区

- -wmeta key value：将键值对(key, value)写入指定虚拟磁盘「diskPath」的元数据表中

- - rmeta key：显示元数据表中指定 key 对应的 value

- -meta：显示虚拟磁盘元数据表中所有的项

- -clone sourcePath：将源 VMDK 克隆到指定的远程站点

- -readbench blocksize：使用指定的 I/O blocksize (以扇区为单位)，在虚拟磁盘上读取标签。

- -writebench blocksize：使用指定的 I/O blocksize (以扇区为单位)，在虚拟磁盘上写入标签。警告：这可能会覆盖磁盘上原有的数据

选项：

- -adapter [ide|scsi]：在「-create」指令时，指定总线 bus 的类型，默认为 scsi 类型

- -start n：在「dump | fill」指令时，指定开始扇区，默认为 0

- -count n：在「dump | fill」指令时，指定扇区数量，默认为 1

- -val byte：在「fill」指令时，指定用于填充的字节，默认为 255

- -cap megabytes：在「-create」指令时，指定容量的大小(MB)，默认为 100

- -single：打开虚拟机的单个磁盘链接而非全部磁盘链接(不指定该选项默认打开全部磁盘链接)，仅支持本地磁盘，不支持远程托管磁盘。

- -multithread n：开启 n 个线程，并将指定文件拷贝到 n 个新文件中

- -host hostname：VC/vSphere 的 hostname/IP (强制项)

- -user userid：host 的 username (强制项)

- -password password：host 的 password (强制项)

- -port port：用于连接 VC/ESXi host 的端口，默认是 443

- nfchostport port：使用 NFC 连接到 ESXi host 的端口，默认 902

- -vm moref=id：虚拟机的托管对应引用

- -libdir dir：VDDK lib 库的安装路径

- -initex configfile：配置文件的路径或文件名

- -ssmoref moref：虚拟机快照的托管对象引用

- -mode mode：传递给 VixDiskLib_ConnectEx 函数的传输模式字符串，有效的模式为：nbd, nbdssl, san, hotadd

- -thumb stirng：SSL 指纹验证字符串，格式为：xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx

NOTE 1：要连接到 ESXi Host，则必须指定 -host，-user，-password 等强制选项，并提供 Datastore 中的 diskPath。EXAMPLE：

./vix-diskLib-sample -info -host esx5 -user root -password secret "[datastore1] <VM>/<VM>.vmdk"

NOTE 2：如果要连接到 vCenter Server，还需要指定 -libdir 和 -vm 选项，DiskLibPlugin 需要通过这两个选项来连接到 vCenter Server 并定位到指定 VM。EXAMPLE：

./vix-diskLib-sample -info -host vc5 -user Administrator -password secret -libdir <pluginDir> -vm vmPath=<path/to/VM> "[<partition>] <VM>/<VM>.vmdk"

# e.g.

vix-disklib-sample -info -host vc5 -user Administrator -password secret -libdir /usr/lib/vmware-vix-disklib/lib64 -vm vmPath=Datacenter/vm/RHEL5 "[datastore1] RHEL5/RHEL5.vmdk"

NOTE 3：如果希望使用高级传输进行连接，就必须指定 -mode 和 -ssmoref 选项。这两个选择的值会被传递到 VixDiskLib_ConnectEx。注意，虚拟机的快照必须存在，因为打开正在运行的虚拟机的 bask disk 是非常危险的。EXAMPLE：

./vix-disklib-sample –host <vc_ip> –user <vc_username> –password <vc_password> –libdir <pluginDir> -vm moref=<vm_mof> -mode san -ssmoref <snap_mor> "[<datastore_name>] <vm_name>/<vm_vdisk_name>.vmdk"

NOTE 4：VixDiskLib_Create 不支持直接创建远程的托管磁盘，而是首先需要在创建一个本地磁盘，然后使用 VixDiskLib_Clone 将本地磁盘克隆并转换为托管磁盘。EXAPMLE：

./vix-disklib-sample -create -cap 1024 virtdisk.vmdk
./vix-disklib-sample -clone virtdisk.vmdk –host <vc_ip> –user <vc_username> –password <vc_password> vmfsdisk.vmdk

NOTE 5：如果希望测试 vCenter/ESX(i) 的读写性能可以应用 -readbench/writebench 选项，注意需要关闭虚拟机电源后执行。

./vix-disklib-sample -readbench 40960 -host 192.168.10.103 -user root -password sysadmin -initex /usr/etc/vddk.conf -thumb 'D9:7A:E8:E3:D2:75:0B:23:EF:7C:44:91:BD:C5:6F:15:4B:7B:EA:0B' "[datastore1 (1)] eDR-CentOS7_1/eDR-CentOS7-000006.vmdk"

其中如果使用了 SSL 的连接方式，那么你必须提供 vCenter/ESX(i) 的指纹或者虚拟机的 managed object reference 信息，下列两个小脚本能够获取这些信息。

• filename: get_thumb.py

import ssl
import OpenSSL

ip = '192.168.10.241'
port = 443
addr = (ip, port)

pem = ssl.get_server_certificate(addr)
print OpenSSL.crypto.load_certificate(OpenSSL.crypto.FILETYPE_PEM, pem).digest(''
sha1')

$ python get_thumb.py
D3:85:DC:32:3D:D6:43:5D:57:90:D0:D3:A1:8A:81:44:B5:6F:9B:2A

• filename: get_vm_mor.py

from pyVmomi import vim
from pyVim.connect import SmartConnect, Disconnect
import atexit

import ssl
ssl._create_default_https_context = ssl._create_unverified_context

def get_obj(content, vimtype, name):
    obj = None
    container = content.viewManager.CreateContainerView(
        content.rootFolder, vimtype, True)
    for c in container.view:
        if c.name == name:
            obj = c
            break
    return obj

def main():

    # connect this thing
    si = SmartConnect(
        host='192.168.10.241',
        user='administrator@vsphere.local',
        pwd='Abc999@1',
        port=443)
    # disconnect this thing
    atexit.register(Disconnect, si)

    content = si.RetrieveContent()
    vm_name = 'aju-dev'
    vm = get_obj(content, [vim.VirtualMachine], vm_name)
    print(vm._moId)

# start this thing
if __name__ == "__main__":
    main()

$ python get_vm_mor.py
73

需要注意的是，如果执行上述指令出现下述异常，那么你就需要升级你的 Python 版本至 >= 2.7.9 了。

python URLError: <urlopen error [Errno 8] _ssl.c:510: EOF occurred in violation of protocol>