命令行界面
的xeCLI使您能够编写脚本并自动执行系统管理任务。通过CLI将Citrix Hypervisor集成到现有IT基础设施中。
安装xe命令行
xe命令行接口默认安装在所有Citrix Hypervisor服务器上,并包含在XenCenter中。Linux也可以使用独立的远程CLI。
在Windows上
在Windows上,xe.exe
命令与XenCenter一起安装。
要使用xe.exe
命令,打开Windows命令提示符并将目录更改为xe.exe
文件的位置(通常为C:\Program Files\Citrix\XenCenter
).如果你加上xe.exe
安装位置到您的系统路径,您可以使用该命令,而不必更改到该目录。
在Linux上
在基于RPM的发行版(如Red Hat)上,您可以从命名为client_install / xapi-xe-BUILD.x86_64.rpm
在主Citrix Hypervisor安装ISO上。
要从RPM安装,使用以下命令:
rpm -ivh xapi-xe-BUILD.x86_64。rpm < !——NeedCopy >
可以通过命令行参数定义执行xe命令时使用的Citrix Hypervisor服务器、用户名和密码。但是,您还可以选择将此信息设置为环境变量。例如:
export XE_EXTRA_ARGS="server=<主机名>,username=<用户名>,password=<密码>"
注意:
当试图通过安全连接运行命令时,Linux上的远程xe CLI可能会挂起,这些命令涉及文件传输。如果是,您可以使用
——no-ssl
参数,以不安全的方式连接到Citrix Hypervisor服务器。
获取有关xe命令的帮助
主机上的CLI命令可以通过输入以下命令获得基本帮助:
Xe帮助命令
如果输入以下命令,将显示最常用的xe命令列表:
救命啊!——NeedCopy >
如果输入以下命令,则会显示所有xe命令的列表:
帮助——所有
xe基本语法
所有Citrix Hypervisor xe CLI命令的基本语法如下:
Xe命令-name参数=value参数=value
每个特定命令都包含自己的一组参数,这些参数的形式为参数=值
.有些命令有必需的参数,大多数命令有一组可选参数。通常,在不调用某些可选参数时,命令会为它们假定默认值。
如果xe命令远程运行,则使用额外的参数进行连接和身份验证。这些参数也采用以下形式参数= argument_value
.
的服务器
参数用于指定主机名或IP地址。的用户名
和密码
参数用于指定凭据。
一个密码文件
参数,而不是直接指定密码。在这种情况下,xe命令尝试从指定的文件中读取密码,并使用该密码进行连接。(文件末尾的任何尾随cr和lf都将被删除。)此方法比直接在命令行指定密码更安全。
可选港口
参数可用于指定远程Citrix Hypervisor服务器上的代理端口(默认为443)。
例子:在本地Citrix Hypervisor服务器上:
Xe vm-list
例子:在远端Citrix Hypervisor服务器上:
Xe vm-list username=username password=password server=hostname
速记语法也可用于远程连接参数:
- u
用户名pw
密码-pwf
密码文件- p
港口- s
服务器
例子:在远端Citrix Hypervisor服务器上:
Xe vm-list -u myuser -pw mypassword -s hostname
参数也以逗号分隔的键/值对的形式从环境变量XE_EXTRA_ARGS中获取。例如,要输入在远端Citrix Hypervisor服务器上运行的命令,则先执行以下命令:
导出XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
运行此命令后,您不再需要在运行的每个xe命令中指定远程Citrix Hypervisor服务器参数。
使用XE_EXTRA_ARGS环境变量还可以在对远程Citrix Hypervisor服务器发出xe命令时启用选项卡完成,这在默认情况下是禁用的。
特殊字符和语法
对象上指定参数/值对xe
命令行,写入:参数=值
除非值包含空格,否则不要使用引号。在参数名称、等号(=)和值之间不应该有空格。任何不符合此格式的参数都将被忽略。
对于包含空格的值,写入:参数="带空格的值"
当您在Citrix Hypervisor服务器上使用CLI时,命令具有与标准Linux bash shell中的特性类似的选项卡完成特性。例如,如果您键入xe vm-l
然后按下选项卡键后,显示命令的其余部分。如果有多个命令以vm-l
,按下选项卡第二次列出可能性。在命令中指定对象uuid时,此特性非常有用。
注意:
在远程Citrix Hypervisor服务器上执行命令时,制表符补全通常不起作用。但是,如果在输入命令的机器上设置XE_EXTRA_ARGS变量,则启用选项卡补全。有关更多信息,请参见xe基本语法.
命令类型
CLI命令可以分为两部分。低级命令关注API对象的列表和参数操作。高级命令用于在更抽象的级别上与虚拟机或主机进行交互。
低级命令有:
类附些
类-param-get
类-param-set
类-param-list
类-param-add
类-param-remove
类-param-clear
在哪里类是其中之一:
债券
控制台
宿主
host-crashdump
主机cpu
网络
补丁
pbd
论坛
池
sm
老
任务
模板
vbd
vdi
vif
vlan
虚拟机
并不是每一个类有全套的吗类param -行动命令。的一些值类使用更少的命令集。
参数类型
使用xe命令寻址的对象具有一组参数,用于标识它们并定义它们的状态。
大多数参数采用单个值。例如,品牌)
参数中包含单个字符串值。在参数列表命令的输出中,例如xe vm-param-list
,括号内的值表示参数是读写(RW)还是只读(RO)。的输出xe vm-param-list
在指定的虚拟机中,可能有以下行:
user-version (RW): 1 is-control-domain (RO): false
第一个参数,user-version
,是可写的,其值为1。第二个,is-control-domain
,为只读,值为false。
另外两种类型的参数是多值的。一个集参数包含值列表。一个地图参数是一组键/值对。的示例输出如下所示xe vm-param-list
在指定虚拟机上:
platform (MRW): acpi: true;apic:真实;pae:真实;nx: false allowed-operations (SRO): pause;clean_shutdown;clean_reboot;\ hard_shutdown;hard_reboot;暂停
的平台
参数具有表示键/值对的项列表。键名后面跟着冒号(:)。每个键/值对之间用分号(;)隔开。RW前的M表示该参数为映射参数,可读可写。的允许的操作
参数具有组成一组项的列表。RO前面的S表示这是一个设置好的参数,可读但不可写。
如果需要对映射参数进行过滤或设置映射参数,请使用冒号(:)分隔映射参数名称和键值对。的值喷火
钥匙其他配置
虚拟机的参数英国机场管理局
,命令将是
xe VM -param-set uuid=虚拟机uuid other-config:foo=baa
注意:
在以前的版本中,使用连字符(-)来指定映射参数。这种语法仍然有效,但已弃用。
低级参数命令
有几个命令用于操作对象的参数:类-param-get,类-param-set,类-param-add,类-param-remove,类-param-clear,类-param-list。这些命令中的每一个都带有auuid
参数来指定特定对象。由于这些命令被认为是低级命令,因此它们必须使用UUID,而不是虚拟机名称标签。
Xe class-param-list uuid=uuid
列出所有参数及其关联值。不像类-list命令用于列出“昂贵”字段的值。
Xe class-param-get uuid=uuid param-name=parameter param-key=key
返回特定参数的值。对于映射参数,指定param-key将获得与映射中该键相关联的值。如果未指定param-key或参数为set,则该命令返回该set或映射的字符串表示形式。
Xe class-param-set uuid=uuid param=value
设置一个或多个参数的值。
Xe class-param-add uuid=uuid param-name=parameter key=value param-key=key
添加到映射或集合参数。对于map参数,使用key=value语法添加键/值对。如果该参数是一个集合,则使用param-key=key语法添加键。
Xe class-param-remove uuid=uuid param-name=parameter param-key=key
从映射中删除键/值对,或从集合中删除键。
Xe class-param-clear uuid=uuid param-name=参数
完全清除一组或一张地图。
低级列表命令
的类-list命令列出type的对象类.默认情况下,这种类型的命令列出所有对象,打印参数的子集。此行为可以通过以下方式修改:
- 它可以过滤对象,以便只输出一个子集
- 打印的参数可以修改。
要更改打印的参数,请指定实参参数个数作为所需参数的逗号分隔列表。例如:
Xe vm-list参数=name-label,other-config
或者,要列出所有参数,请使用以下语法:
Xe vm-list参数=所有
list命令不显示一些计算成本很高的参数。这些参数如下所示,例如:
allowed-VBD-devices (SRO):
要获取这些字段,请使用以下命令类-param-list或类-param-get
为了过滤列表,CLI将参数值与命令行上指定的值进行匹配,只打印匹配所有指定约束的对象。例如:
xe vm-list HVM-boot-policy="BIOS order" power-state= stopped
此命令仅列出以下虚拟机这两个这个领域电源状态
有价值吗?停止还有田野HVM-boot-policy
有价值吗?BIOS的顺序.
还可以根据映射中的键值或集合中存在的值筛选列表。基于映射中的键进行过滤的语法是映射名称:键=值
.基于集合中存在的值进行过滤的语法为集名称:包含=价值
.
编写脚本时,传递了一种有用的技术——最小
在命令行中,导致xe
只打印逗号分隔列表中的第一个字段。例如:命令Xe vm-list——minimal
在安装了三个虚拟机的主机上,给出了三个虚拟机的uuid:
\ 42c044de-df69-4b30-89d9-2c199564581d
秘密
Citrix Hypervisor提供了一种保密机制,以避免密码以明文形式存储在命令行历史记录或API对象中。XenCenter自动使用这个特性,也可以从xe CLI中使用它来执行任何需要密码的命令。
请注意
密码秘密不能用于从xe CLI的远程实例向Citrix Hypervisor主机进行身份验证。
要创建一个秘密对象,请在Citrix Hypervisor主机上运行以下命令。
Xe secret-create value=my-password
在Citrix Hypervisor主机上创建并存储一个密钥。该命令输出secret对象的UUID。例如,99945 d96 - 5890 de2a c04ef2521db——3899 - 8
.附加_secret
到密码参数的名称,以便将此UUID传递给需要密码的任何命令。
例子:在创建secret的Citrix Hypervisor主机上,可以运行以下命令:
xe SR -create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username \ device-config:cifspassword_secret=secret_uuid name-label=" cifs ISO SR" type=" ISO " content-type=" ISO " shared="true"
命令历史记录
例如,一些xe命令xe vm-migrate
或xe pool-enable-external-auth
,以密码等秘密作为参数。这些可以在shell历史记录中结束,并且在命令执行期间在进程表中可见。因此,只在可信的环境中执行这些命令非常重要。
对于bash shell,您可以使用HISTCONTROL
变量来控制哪些命令存储在shell历史记录中。
Xe命令参考
本节根据命令所针对的对象对命令进行分组。这些物品按字母顺序排列。
设备命令
用于创建和修改VM设备(也称为vApps)的命令。有关更多信息,请参见vapp.
设备参数
Appliance命令有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
电器电源 | 要求 |
name-description |
设备描述 | 可选 |
停顿了一下 |
可选 | |
力 |
强制关闭 | 可选 |
appliance-assert-can-be-recovered
uuid=appliance-uuid数据库vdi-uuid=vdi-uuid
测试是否有可用的存储来恢复此虚拟机设备/vApp。
appliance-create
create name-label=name-label [name-description=name-description]
创建一个设备/vApp。例如:
Xe appliance-create name-label=my_appliance
向一体机添加虚拟机:
xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
appliance-destroy
Xe appliance-destroy uuid=appliance-uuid
销毁一个设备/vApp。例如:
Xe appliance-destroy uuid=appliance-uuid
appliance-recover
Xe appliance-recover uuid=appliance-uuid数据库:vdi-uuid=vdi-uuid [paused=true|false]
从提供的VDI中包含的数据库恢复VM设备/vApp。
appliance-shutdown
Xe appliance-shutdown uuid=appliance-uuid [force=true|false]
关闭设备/vApp中的所有虚拟机。例如:
Xe appliance-shutdown uuid=appliance-uuid
appliance-start
Xe appliance-start uuid=appliance-uuid [paused=true|false]
启动设备/vApp。例如:
Xe appliance-start uuid=appliance-uuid
审计的命令
审计命令下载池中RBAC审计文件的所有可用记录。如果可选参数自
存在时,它只下载该特定时间点的记录。
audit-log-get
参数
audit-log-get
具有以下参数
参数名称 | 描述 | 类型 |
---|---|---|
文件名 |
将池的审计日志写入文件名称 | 要求 |
自 |
具体日期/时间点 | 可选 |
audit-log-get
Xe audit-log-get [since=timestamp] filename=filename
例如,需要获取该池从精确毫秒时间戳开始的审计记录。
执行如下命令:
xe audit-log-get since=2009-09-24 t17:56:20.53 z filename=/tmp/auditlog-pool-actions. exe< !——NeedCopy >
成键的命令
用于处理网络绑定的命令,用于物理接口故障转移的弹性。有关更多信息,请参见网络.
绑定对象是一个粘合在一起的引用对象主和成员进行通信。主PIF是绑定接口,必须将其用作总体PIF来引用绑定。成员pif是两个或多个物理接口的集合,这些物理接口被组合成高级绑定接口。
键参数
bond有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
绑定的唯一标识符/对象引用 | 只读 |
主 |
主绑定PIF的UUID | 只读 |
成员 |
用于底层绑定pif的uuid集 | 只读 |
bond-create
Xe bond-create network-uuid=network_uuid pif- uids=pif_uuid_1,pif_uuid_2,…<!——NeedCopy >
在从现有PIF对象列表中指定的网络上创建绑定的网络接口。当出现以下情况时,命令执行失败:
- 如果pif已经购买了另一只债券
- 如果任何成员设置了VLAN标签
- 如果引用的pif不在同一台Citrix Hypervisor服务器上
- 如果提供的pif少于2个
bond-destroy
Xe bond-destroy uuid=bond_uuid
从主机删除由其UUID指定的绑定接口。
bond-set-mode
Xe bond-set-mode uuid=bond_uuid mode=bond_mode
修改绑定模式。
CD命令
用于处理Citrix Hypervisor服务器上的物理CD/DVD驱动器的命令。
CD参数
cd有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
CD的唯一标识符/对象引用 | 只读 |
品牌) |
CD的名称 | 读/写 |
name-description |
CD的描述文本 | 读/写 |
允许的操作 |
可在此CD上执行的操作列表 | 只读设置参数 |
当前操作 |
此CD上当前正在进行的操作的列表 | 只读设置参数 |
sr-uuid |
该CD所属的SR的唯一标识符/对象引用 | 只读 |
sr-name-label |
这张CD所属的SR的名称 | 只读 |
vbd-uuids |
连接到该CD的虚拟机上vbd的唯一标识符列表 | 只读设置参数 |
crashdump-uuids |
没有在cd上使用。因为崩溃转储不能写入cd | 只读设置参数 |
虚拟内存 |
对vm显示的CD大小(以字节为单位) | 只读 |
physical-utilisation |
CD映像在SR上占用的物理空间数量(以字节为单位) | 只读 |
类型 |
cd设置为“User” | 只读 |
可分享的 |
CD驱动器是否可共享。默认是假 . |
只读 |
只读 |
CD是否为只读,如果假 ,设备是可写的。对于cd来说总是如此。 |
只读 |
storage-lock |
值是真正的 如果该磁盘在存储级别被锁定。 |
只读 |
父 |
引用父磁盘,如果这个CD是链的一部分。 | 只读 |
失踪 |
值是真正的 如果SR扫描操作报告磁盘上不存在此CD |
只读 |
其他配置 |
为CD指定额外配置参数的键/值对列表 | 读写映射参数 |
位置 |
挂载设备的路径 | 只读 |
管理 |
值是真正的 如果设备被管理 |
只读 |
xenstore-data |
要插入的数据xenstore 树 |
只读映射参数 |
sm-config |
存储管理器设备配置密钥的名称和描述 | 只读映射参数 |
都只能 |
值是真正的 如果此模板为CD快照 |
只读 |
snapshot_of |
该模板作为快照的CD的UUID | 只读 |
快照 |
已从该CD中获取的任何快照的uuid | 只读 |
snapshot_time |
快照操作的时间戳 | 只读 |
cd-list
cd-list [params=param1,param2,…][parameter=parameter_value]
列出Citrix Hypervisor服务器或池上的CD和iso (CD镜像文件),过滤可选参数参数个数
.
如果可选参数参数个数
时,params的值是一个字符串,其中包含要显示的此对象的参数列表。或者,您可以使用关键字所有
显示所有参数。当参数个数
,则返回的列表显示所有可用参数的默认子集。
可选参数可以是任意数量的CD参数列在本节的开头。
集群命令
使用集群池的命令。
集群池是指开启了集群特性的资源池。与GFS2 sr一起使用这些池。有关更多信息,请参见集群池
集群和集群-主机对象可以使用标准对象列表命令(xe cluster-list
和xe cluster-host-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令.使用集群池的命令。
集群参数
集群包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
集群的唯一标识符/对象引用 | 只读 |
cluster-hosts |
集群中主机的唯一标识符/对象引用列表 | 只读设置参数 |
cluster-token |
的秘钥xapi-clusterd 当它在其他主机上自言自语时 |
只读 |
群集堆栈 |
提供集群功能的技术栈。可能的值有corosync . |
只读 |
允许的操作 |
列出在此状态下允许的操作。此列表仅供参考,当客户端读取此字段时,集群状态可能已经更改。 | 只读设置参数 |
当前操作 |
列出当前正在处理的操作。此列表仅供参考,当客户端读取此字段时,集群状态可能已经更改。 | 只读设置参数 |
牌繁忙值 |
的corosync 令牌超时(秒) |
只读 |
token-timeout-coefficient |
的corosync 令牌超时系数,单位为秒 |
只读 |
pool-auto-join |
如果自动将新池成员加入集群,则为True。它被设置为真正的 . |
只读 |
cluster-config |
指定集群额外配置参数的键/值对列表。 | 只读映射参数 |
其他配置 |
指定集群额外配置参数的键/值对列表。 | 读写映射参数 |
cluster-host-create
Xe cluster-host-create cluster-uuid=cluster_uuid host-uuid=host_uuid pif-uuid=pif_uuid
在已有集群中添加主机。
cluster-host-destroy
Xe cluster-host-destroy uuid=host_uuid
销毁集群主机,有效地离开集群。
cluster-host-disable
Xe cluster-host-disable uuid=cluster_uuid
为已启用的集群主机禁用集群成员资格。
cluster-host-enable
Xe cluster-host-enable uuid=cluster_uuid
为已禁用的集群主机启用集群成员资格。
cluster-host-force-destroy
Xe cluster-host-force-destroy uuid=cluster_host
强制销毁集群主机对象,有效地离开集群。
cluster-pool-create
Xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
创建池级集群。
cluster-pool-destroy
Xe cluster-pool-destroy cluster-uuid=cluster_uuid
摧毁池级集群。池仍然存在,但不再是集群,不能再使用GFS2 sr。
cluster-pool-force-destroy
Xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
强制销毁池范围内的群集。
cluster-pool-resync
Xe cluster-pool-resync cluster-uuid=cluster_uuid
跨池重新同步集群。
控制台命令
使用控制台的命令。
控制台对象可以使用标准对象列表命令(xe console-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令.
控制台参数
控制台有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
控制台的唯一标识符/对象引用 | 只读 |
vm-uuid |
打开此控制台的虚拟机的唯一标识符/对象引用 | 只读 |
vm-name-label |
打开此控制台的虚拟机的名称 | 只读 |
协议 |
此控制台使用的协议。可能的值有vt100 : VT100端子;rfb :远程帧缓冲协议(VNC使用),或rdp :远程桌面协议 |
只读 |
位置 |
控制台服务的URI | 只读 |
其他配置 |
为控制台指定额外配置参数的键/值对列表。 | 读写映射参数 |
控制台
Xe控制台
连接到特定的控制台。
诊断命令
从Citrix Hypervisor收集诊断信息命令。
diagnostic-compact
Xe诊断-紧凑
执行一次主要的GC收集和堆压缩。
弃用:diagnostic-db-log
Xe diagnostic- dblog
开始记录数据库操作。警告:一旦开始,就无法停止。
diagnostic-db-stats
Xe diagnostic-db-stats
打印数据库统计信息。
diagnostic-gc-stats
Xe diagnostic-gc-stats
打印GC统计信息。
diagnostic-license-status
Xe diagnostic-license-status
帮助诊断池范围的许可问题。
diagnostic-net-stats
Xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2…]) < !——NeedCopy >
打印网络统计信息。
diagnostic-timing-stats
Xe diagnostic- time -stats
打印定时统计信息。
diagnostic-vdi-status
Xe diagnostic-vdi-status uuid=vdi_uuid
使用实例查询VDI的锁定和共享状态。
diagnostic-vm-status
Xe diagnostic-vm-status uuid=vm_uuid
查看虚拟机可以启动的主机,查看所有vbs的共享/锁定状态。
容灾命令
灾后恢复虚拟机命令
drtask-create
Xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
创建容灾任务。例如,连接到iSCSI SR,为灾难恢复做准备:
xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \ device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \ sr-whitelist=sr-uuid-list
注意:
命令
sr-whitelist
列出允许的SR uid。的drtask-create
命令只引入并连接到具有允许的uuid之一的SR
drtask-destroy
命令drtask-destroy uuid= drtask- uuid
破坏灾难恢复任务并忘记引入的SR。
vm-assert-can-be-recovered
vdi-uuid=vdi-uuid数据库:vdi-uuid=vdi-uuid
测试是否有可用的存储来恢复此虚拟机。
appliance-assert-can-be-recovered
uuid=appliance-uuid数据库vdi-uuid=vdi-uuid
检查存储(包含设备的/vAPP磁盘)是否可见。
appliance-recover
Xe appliance-recover uuid=appliance-uuid数据库:vdi-uuid=vdi-uuid [force=true|false]
从提供的VDI中包含的数据库中恢复设备/vAPP。
vm-recover
Xe vm-recover uuid=vm-uuid数据库:vdi-uuid=vdi-uuid [force=true|false]
从提供的VDI中包含的数据库中恢复虚拟机。
sr-enable-database-replication
Xe sr-enable-database-replication uuid=sr_uuid
启用XAPI数据库复制到指定的(共享的)SR。
sr-disable-database-replication
Xe sr-disable-database-replication uuid=sr_uuid
禁用XAPI数据库到指定SR的复制。
示例使用
容灾CLI命令示例如下:
在主站点启用数据库复制:
Xe sr-database-replication uuid=sr=uuid
灾难发生后,在备用站点上,连接到srdevice-config
命令具有与sr-probe
.
\ device-config:targetIQN=target-iqn \ device-config:SCSIid=scsi-id \ sr-whitelist=sr-uuid
在SR上查找数据库vdi:
xe vdi-list sr-uuid=sr-uuid type=Metadata
查询数据库VDI中存在的虚拟机:
Xe vm-list数据库:vdi-uuid=vdi-uuid
恢复虚拟机:
Xe vm-recover uuid=vm-uuid数据库vdi-uuid=vdi-uuid
销毁容灾任务。容灾任务引入的、虚拟机不需要的sr将被销毁。
命令drtask-destroy uuid=drtask-uuid
事件的命令
用于处理事件的命令。
事件类
事件类列在下表中:
类名 | 描述 |
---|---|
池 |
物理主机池 |
虚拟机 |
虚拟机 |
宿主 |
物理主机 |
网络 |
虚拟网络 |
vif |
虚拟网络接口 |
论坛 |
物理网络接口(单独的vlan表示为几个pif) |
老 |
存储库 |
vdi |
虚拟磁盘映像 |
vbd |
虚拟块设备 |
pbd |
主机通过物理块设备访问sr |
event-wait
Xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
阻止其他命令执行,直到存在满足命令行上给定条件的对象。这个论点x = y
表示“等待字段x取值y”和x = / = y
表示“等待字段x取y以外的任何值”。
例子:等待指定的虚拟机运行。
Xe event-wait class=vm name-label=myvm power-state=running
阻塞其他命令,直到一个虚拟机被调用myvm
在。电源状态
“运行”。
例子:等待指定虚拟机重启:
xe event-wait class=vm uuid=$ vm start-time=/=$(xe vm-list uuid=$ vm params=start-time——minimal)
阻塞其他命令,直到有UUID的虚拟机VM美元重新启动。该命令使用的值启动时间
决定虚拟机何时重启。
类名可以是事件类列在本节的开头。参数可以是CLI命令中列出的任意参数类-param-list。
GPU的命令
物理图形处理器、图形处理器组和虚拟图形处理器相关命令。
可以使用标准对象列表命令列出GPU对象:xe pgpu-list
,xe gpu-group-list
,xe vgpu-list
.可以使用标准参数命令对参数进行操作。有关更多信息,请参见低级参数命令.
GPU物理参数
物理gpu (Physical gpu)包括以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
pGPU的唯一标识符/对象引用 | 只读 |
商家名称 |
pGPU的厂商名称 | 只读 |
设备名称 |
由供应商分配给该pGPU模型的名称 | 只读 |
gpu-group-uuid |
该pGPU被Citrix Hypervisor自动分配到的GPU组的唯一标识符/对象引用。同一池中不同主机的相同pgpu被分组 | 只读 |
gpu-group-name-label |
pGPU所分配的GPU组名称 | 只读 |
host-uuid |
pGPU所连接的Citrix Hypervisor服务器的唯一标识/对象引用 | 只读 |
host-name-label |
pGPU所连接的Citrix Hypervisor服务器的名称 | 只读 |
pci-id |
一种总线标准标识符 | 只读 |
依赖关系 |
列出传递到同一虚拟机的相关PCI设备 | 读写映射参数 |
其他配置 |
指定pGPU额外配置参数的键/值对列表 | 读写映射参数 |
supported-VGPU-types |
底层硬件支持的虚拟GPU类型列表 | 只读 |
enabled-VGPU-types |
该pGPU已启用的虚拟GPU类型列表 | 读/写 |
resident-VGPUs |
该pGPU上运行的vgpu列表 | 只读 |
pgpu-disable-dom0-access
ppuu -disable-dom0-access uuid=uuid
禁止PGPU访问dom0。
pgpu-enable-dom0-access
Xe pgpu-enable-dom0-access uuid=uuid
开启PGPU对dom0的访问。
GPU组参数
GPU组包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
GPU组的唯一标识符/对象引用 | 只读 |
品牌) |
GPU组的名称 | 读/写 |
name-description |
GPU组的描述信息 | 读/写 |
VGPU-uuids |
列出GPU组中虚拟图形处理器的唯一标识符/对象引用 | 只读设置参数 |
PGPU-uuids |
列出图形处理器组中图形处理器的唯一标识符/对象引用 | 只读设置参数 |
其他配置 |
为GPU组指定额外配置参数的键/值对列表 | 读写映射参数 |
supported-VGPU-types |
底层硬件支持的所有虚拟GPU类型的联合 | 只读 |
enabled-VGPU-types |
底层GPU上已启用的所有虚拟GPU类型的并集 | 只读 |
分配算法 |
在组内的gpu上分配虚拟gpu的Depth-first/ width -first设置 | 读写enum参数 |
GPU组操作
使用GPU组的命令
gpu-group-create
Xe gpu-group-create name-label=name_for_group [name-description=description]
创建一个新的(空的)GPU Group,用于移动GPU。
gpu-group-destroy
Xe gpu-group-destroy uuid=uuid_of_group
破坏GPU组;只允许空组使用。
gpu-group-get-remaining-capacity
Xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
返回在此GPU组中可以实例化指定类型的虚拟GPU的数目。
gpu-group-param-set
Xe gpu-group-param-set uuid=uuid_of_group分配-算法=宽度优先|深度优先
修改图形处理器组分配虚拟图形处理器的算法。
gpu-group-param-get-uuid
xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
返回该GPU组支持或启用的类型。
虚拟GPU参数
虚拟gpu有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
虚拟GPU的唯一标识符/对象引用 | 只读 |
vm-uuid |
分配图形处理器的虚拟机的唯一标识符/对象引用 | 只读 |
vm-name-label |
分配图形处理器的虚拟机名称 | 只读 |
gpu-group-uuid |
虚拟图形处理器所在的图形处理器组的唯一标识/对象引用 | 只读 |
gpu-group-name-label |
虚拟图形处理器所在的图形处理器组名称 | 只读 |
currently-attached |
开启GPU直通功能的虚拟机为True,否则为false | 只读 |
其他配置 |
为虚拟GPU指定额外配置参数的键/值对列表 | 读写映射参数 |
类型uuid |
该虚拟图形处理器的虚拟图形处理器类型的唯一标识符/对象引用 | 读写映射参数 |
type-model-name |
与虚拟GPU类型相关联的模型名称 | 只读 |
虚拟GPU类型参数
注意:
GPU直通和虚拟GPU不支持热迁移、存储热迁移、虚拟机挂起,除非有GPU厂商支持的软件和显卡。没有此支持的虚拟机无法迁移以避免停机。有关NVIDIA vGPU与热迁移、存储热迁移和虚拟机挂起的兼容性的信息,请参见图形.
虚拟GPU类型的参数如下:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
虚拟GPU类型的唯一标识符/对象引用 | 只读 |
商家名称 |
虚拟GPU厂商名称 | 只读 |
模型名称 |
与虚拟GPU类型相关联的模型名称 | 只读 |
定格 |
虚拟GPU类型的帧缓冲区大小,以字节为单位 | 只读 |
max-heads |
虚拟GPU类型支持的最大显示数 | 只读 |
supported-on-PGPUs |
支持该虚拟GPU类型的GPU列表 | 只读 |
enabled-on-PGPUs |
启用该虚拟GPU类型的GPU列表 | 只读 |
VGPU-uuids |
该类型的虚拟图形处理器列表 | 只读 |
虚拟GPU操作
vgpu-create
Xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
创建虚拟GPU。该命令将虚拟机绑定到指定的图形处理器组,并可指定虚拟图形处理器的类型。如果未指定虚拟GPU类型,则假定为“直通”类型。
vgpu-destroy
Xe vgpu-destroy uuid= uid_of_vgpu
销毁指定的虚拟GPU。
使用虚拟GPU的虚拟机关闭VNC
Xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
使用假
在虚拟机通过时禁用虚拟机的VNC控制台disablevnc = 1
通过显示仿真器。默认情况下,VNC功能处于开启状态。
主机的命令
与Citrix Hypervisor服务器交互的命令。
Citrix Hypervisor服务器是指运行Citrix Hypervisor软件的物理服务器。它们在一个特殊的特权虚拟机(称为控制域或域0)的控制下运行虚拟机。
可以使用标准对象列表命令列出Citrix Hypervisor服务器对象:xe主机列表
,xe host-cpu-list
,xe host-crashdump-list
).可以使用标准参数命令对参数进行操作。有关更多信息,请参见低级参数命令.
主机选择器
这里列出的几个命令具有一种通用机制,用于选择要在其上执行操作的一个或多个Citrix Hypervisor服务器。最简单的方法是提供论证主机= uuid_or_name_label
.您还可以通过过滤字段值上的完整主机列表来指定Citrix Hypervisor。例如,指定启用= true
选择所有Citrix Hypervisor服务器启用
场等于真正的
.当有多台Citrix Hypervisor服务器匹配且可以在多台Citrix Hypervisor服务器上执行该操作时,必须指定——多个
执行操作。本节开头描述了可以匹配的参数的完整列表。可以通过该命令获取该命令列表Xe host-list参数=all
.如果不提供选择Citrix虚拟化环境服务器的参数,则在所有Citrix虚拟化环境服务器上执行该操作。
主机参数
Citrix虚拟化环境服务器包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
Citrix Hypervisor服务器的唯一标识符/对象引用 | 只读 |
品牌) |
Citrix Hypervisor服务器的名称 | 读/写 |
name-description |
Citrix Hypervisor服务器的描述字符串 | 只读 |
启用 |
值是假 如果禁用。这样可以防止在主机上启动任何新的虚拟机,并为关闭或重启主机做准备。值是真正的 如果主机已启用 |
只读 |
API-version-major |
主要版本号 | 只读 |
API-version-minor |
次要版本号 | 只读 |
API-version-vendor |
API供应商识别 | 只读 |
API-version-vendor-implementation |
供应商实现的细节 | 只读映射参数 |
日志记录 |
日志配置 | 读写映射参数 |
suspend-image-sr-uuid |
放置挂起图像的SR的唯一标识符/对象引用 | 读/写 |
crash-dump-sr-uuid |
放置崩溃转储的SR的唯一标识符/对象引用 | 读/写 |
软件版本 |
版本控制参数及其值的列表 | 只读映射参数 |
功能 |
Citrix Hypervisor服务器可以运行的Xen版本列表 | 只读设置参数 |
其他配置 |
为Citrix Hypervisor服务器指定额外配置参数的键/值对列表 | 读写映射参数 |
chipset-info |
指定有关芯片组信息的键/值对列表 | 只读映射参数 |
主机名 |
Citrix Hypervisor服务器主机名 | 只读 |
地址 |
Citrix Hypervisor服务器的IP地址 | 只读 |
许可证服务器 |
一个键/值对列表,用于指定有关许可证服务器的信息。与Citrix产品通信的默认端口为27000。有关由于冲突而更改端口号的信息,请参见更改端口号 | 只读映射参数 |
supported-bootloaders |
Citrix Hypervisor服务器支持的引导加载程序列表,例如:pygrub ,eliloader |
只读设置参数 |
memory-total |
Citrix Hypervisor服务器上的物理内存总量,以字节为单位 | 只读 |
空闲内存 |
剩余可分配给虚拟机的物理内存总量,以字节为单位 | 只读 |
host-metrics-live |
如果主机可运行,则为True | 只读 |
日志记录 |
的syslog_destination “Key”可设置为远程监听syslog服务的主机名。 |
读写映射参数 |
允许的操作 |
列出在此状态下允许的操作。此列表仅供参考,当客户端读取此字段时,服务器状态可能已经更改。 | 只读设置参数 |
当前操作 |
列出当前正在处理的操作。此列表仅供参考,当客户端读取此字段时,服务器状态可能已经更改。 | 只读设置参数 |
补丁 |
主机补丁集 | 只读设置参数 |
斑点 |
二进制数据存储 | 只读 |
memory-free-computed |
对主机上最大可用内存量的保守估计 | 只读 |
ha-statefiles |
所有HA状态文件的uuid | 只读 |
ha-network-peers |
当故障发生时,该主机上可以承载虚拟机的所有主机的uuid | 只读 |
external-auth-type |
外部认证类型,例如Active Directory。 | 只读 |
external-auth-service-name |
外部身份验证服务的名称 | 只读 |
external-auth-configuration |
外部认证服务的配置信息。 | 只读映射参数 |
Citrix Hypervisor服务器包含一些其他对象,这些对象也具有参数列表。
Citrix Hypervisor服务器的cpu参数如下:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
CPU的唯一标识符/对象引用 | 只读 |
数量 |
Citrix Hypervisor服务器的物理CPU核数 | 只读 |
供应商 |
CPU名称的供应商字符串 | 只读 |
速度 |
CPU时钟速率,单位为Hz | 只读 |
modelname |
CPU型号的供应商字符串,例如“Intel(R) Xeon(TM) CPU 3.00 GHz”。 | 只读 |
步进 |
CPU版本号 | 只读 |
旗帜 |
物理CPU的标志(特征字段的解码版本) | 只读 |
利用 |
当前CPU利用率 | 只读 |
host-uuid |
CPU所在主机的UUID | 只读 |
模型 |
物理CPU的型号 | 只读 |
家庭 |
物理CPU族号 | 只读 |
Citrix Hypervisor服务器上的崩溃转储有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
崩溃转储的唯一标识符/对象引用 | 只读 |
宿主 |
崩溃转储对应的Citrix Hypervisor服务器 | 只读 |
时间戳 |
崩溃转储发生的日期和时间的时间戳yyyymmdd-hhmmss-ABC ,在那里美国广播公司是时区指示符,例如GMT |
只读 |
大小 |
崩溃转储的大小,以字节为单位 | 只读 |
host-all-editions
Xe host-all-editions
获取所有可用版本的列表
host-apply-edition
Xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
该任务指导管理员为主机服务器分配Citrix Hypervisor的license。分配license时,Citrix Hypervisor与license Server联系,申请指定类型的license。如果有可用的许可证,则从许可证服务器签出该许可证。
对于Citrix虚拟桌面版的Citrix Hypervisor,使用“xendesktop”
.
有关初始许可配置,请参见license-server-address
和license-server-port
.
host-backup
Xe host-backup file-name=backup_filename host=host_name
将指定Citrix Hypervisor服务器控制域的备份下载到调用该命令的计算机上。将其保存为文件名为文件名称
.
重要的是:
而
xe host-backup
如果在本地主机上执行(即不指定特定的主机名),则此命令有效,请勿这样使用。这样做将用备份文件填满控制域分区。仅在有空间存放备份文件的远程非主机机器上使用该命令。
host-bugreport-upload
Xe host-bugreport-upload [host-selector=host_selector_value…][url=destination_url http-proxy=http_proxy_name]
生成一个新的bug报告(使用xen-bugtool
(包括所有可选文件)并上传到支持FTP站点或其他位置。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
可选参数有http代理
:使用指定的HTTP代理,和url
:上载到此目的URL。如果不使用可选参数,则不标识代理服务器,目的站点为默认的Support FTP站点。
host-call-plugin
Xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
使用可选参数调用给定主机上插件中的函数。
host-compute-free-memory
Xe主机-计算-空闲内存
计算主机上的空闲内存量。
host-compute-memory-overhead
Xe主机-计算机-内存-开销
计算主机的虚拟化内存开销。
host-cpu-info
Xe host-cpu-info [uuid=uuid]
列出主机的物理cpu信息。
host-crashdump-destroy
Xe host-crash - dump-destroy uuid=crashdump_uuid
删除Citrix Hypervisor服务器上UUID指定的主机崩溃转储。
host-crashdump-upload
Xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
上传崩溃转储到支持FTP站点或其他位置。如果不使用可选参数,则不标识代理服务器,目的站点为默认的Support FTP站点。可选参数有http代理
:使用指定的HTTP代理,和url
:上载到此目的URL。
host-declare-dead
host-declare-dead uuid=host_uuid
在不显式地联系宿主的情况下声明宿主已死。
警告:
这个调用是危险的,如果主机实际上没有死,可能会导致数据丢失。
host-disable
Xe host-disable [host-selector=host_selector_value…]) < !——NeedCopy >
禁用指定的Citrix Hypervisor服务器,从而阻止在该服务器上启动任何新的虚拟机。此操作准备关闭或重新启动Citrix Hypervisor服务器。
应该执行此操作的主机使用标准选择机制(参见主机选择器).可选参数可以是任意数量的主机参数列在本节的开头。
host-disable-display
显示uuid=host_uuid
禁用主机显示。
host-disable-local-storage-caching
主机-禁用本地存储-缓存
在指定主机上禁用本地存储缓存。
host-dmesg
Xe host-dmesg [host-selector=host_selector_value…]) < !——NeedCopy >
买一个Xendmesg命令
(内核环缓冲区的输出)从指定的Citrix Hypervisor服务器。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
host-emergency-ha-disable
Xe host-emergency-ha-disable[——force]
关闭本地主机的HA功能。仅用于恢复HA设置损坏的池。
host-emergency-management-reconfigure
Xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
重新配置该Citrix Hypervisor服务器的管理接口。该命令仅在Citrix Hypervisor服务器处于紧急模式时使用。紧急模式是指资源池中的主机已从网络中消失,经过多次重试后无法联系。
host-emergency-reset-server-certificate
主机-emergency-reset-server-certificate
在执行该命令的Citrix Hypervisor服务器上安装自签名证书。
host-enable
Xe host-enable [host-selector=host_selector_value…]) < !——NeedCopy >
启用指定的Citrix Hypervisor服务器,允许在这些服务器上启动新的虚拟机。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
host-enable-display
Xe host-enable-display uuid=host_uuid
为主机启用显示。
host-enable-local-storage-caching
Xe host-enable-local-storage-caching sr-uuid=sr_uuid
在指定主机上启用本地存储缓存。
host-evacuate
[host-selector=host_selector_value…]) < !——NeedCopy >
热迁移将所有运行中的虚拟机迁移到池中其他合适的主机上。命令禁用主机host-disable
命令。
如果疏散的主机是池主主机,则必须选择另一个主机作为池主主机。要更改禁用HA的池主,请使用pool-designate-new-master
命令。有关更多信息,请参见pool-designate-new-master.
启用HA后,您唯一的选择是关闭服务器,这将导致HA随机选择一个新的主服务器。有关更多信息,请参见host-shutdown.
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
host-forget
Xe主机忘记uuid=host_uuid
XAPI代理忘记了指定的Citrix Hypervisor服务器,而没有显式地联系它。
使用——力
参数,以避免系统提示确认是否执行该操作。
警告:
如果池已启用HA,则不使用此命令。首先禁用HA,然后在忘记主机后再次启用它。
如果要“忘记”的Citrix Hypervisor服务器已死亡,则此命令很有用。但是,如果Citrix Hypervisor服务器是活动的并且是池的一部分,则使用xe pool-eject
代替。
host-get-cpu-features
Xe host-get-cpu-features {features=pool_master_cpu_features} [uuid=host_uuid]
打印主机物理cpu特征的十六进制表示。
host-get-server-certificate
Xe host-get-server-certificate
获取已安装的服务器TLS证书。
host-get-sm-diagnostics
Xe host-get-sm-diagnostics uuid=uuid
显示每个主机的SM诊断信息。
host-get-system-status
Xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar. exe]bz2 |获取zip] [host-selector = host_selector_value……) < !——NeedCopy >
将系统状态信息下载到指定文件中。可选参数条目
是一个以逗号分隔的系统状态条目列表,取自host-get-system-status-capabilities
命令。有关更多信息,请参见host-get-system-status-capabilities.如果不指定,则将所有系统状态信息保存到该文件中。的参数输出
可能是tar.bz2(默认)或邮政编码.如果不指定该参数,则文件保存在tar.bz2
的形式。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。
host-get-system-status-capabilities
host-selector=host_selector_value…) < !——NeedCopy >
获取指定主机的系统状态功能。功能作为XML片段返回,类似于以下示例:
< ?XML版本="1.0" ?>< system-status-capabilities ><功能- type =“文本/普通”default-checked =“是的”关键=“xenserver-logs”\最大尺寸=“150425200”max-time =“1”min-size =“150425200”min-time =“1”\pii =“也许”/><功能- type =“文本/普通”default-checked =“是的”\关键=“xenserver-install”最大尺寸=“51200”max-time =“1”min-size =“10240”\min-time =“1”pii =“也许”/>...< / system-status-capabilities ><!——NeedCopy >
每个功能实体可以具有以下属性。
关键
功能的唯一标识符。内容类型
可以是文本/纯文本或应用程序/数据。指示UI是否可以呈现供人使用的条目。default-checked
可以是或不是。指示UI是否应该默认选择此条目。min-size
,最大尺寸
以字节为单位表示该表项大小的大致范围。-1表示大小不重要。min-time
,max-time
指示收集此条目所需时间的大致范围(以秒为单位)。-1表示时间不重要。pii
个人身份信息。指示表项是否包含可以识别系统所有者或其网络拓扑详细信息的信息。该属性可以是以下值之一:没有
:这些条目中没有PII是的
PII很可能或肯定在这些条目中也许
:您可能需要审核这些PII条目if_customized
如果文件未被修改,则它们不包含PII。但是,由于我们鼓励对这些文件进行编辑,因此PII可能是由这种自定义引入的。该值特别用于控制域中的网络脚本。
无论任何PII声明如何,密码都永远不会包含在任何错误报告中。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。
host-get-thread-diagnostics
Xe host-get-thread-diagnostics uuid=uuid
显示每个主机的线程诊断信息。
host-get-vms-which-prevent-evacuation
Xe host-get-vms-which-prevent-evacuation uuid=uuid
返回阻止指定主机进行疏散的虚拟机列表,并显示每个虚拟机的原因。
host-is-in-emergency-mode
主机处于紧急模式
返回真正的
如果与CLI对话的主机处于紧急模式,假
否则。即使没有主服务器,该CLI命令也可以直接在池成员服务器上工作。
host-license-add
Xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
对于Citrix Hypervisor(免费版),使用解析本地license文件,并将其添加到指定的Citrix Hypervisor服务器上。
host-license-remove
Xe host-license-remove [host-uuid=host_uuid]
删除应用于主机的任何许可。
host-license-view
Xe host-license-view [host-uuid=host_uuid]
显示Citrix Hypervisor服务器license的内容。
host-logs-download
Xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value…]) < !——NeedCopy >
下载指定Citrix Hypervisor服务器的日志副本。默认情况下,副本保存在一个带有时间戳的文件中hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz
.您可以使用可选参数指定不同的文件名文件名称.
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
重要的是:
而
xe host-logs-download
如果在本地主机上执行(即不指定特定的主机名),则命令有效不这样用。这样做会使控制域分区与日志副本混淆。命令应该是只有在有空间保存日志副本的远程非主机机器上使用。
host-management-disable
host-management-disable
禁用主机代理侦听外部管理网口,并断开所有连接的API客户端(如XenCenter)。该命令直接在CLI所连接的Citrix Hypervisor服务器上执行。当应用于Citrix Hypervisor成员服务器时,该命令不会转发到池主服务器。
警告:
使用off-host命令时要小心。执行此命令后,无法通过网络远程连接到控制域以重新启用主机代理。
host-management-reconfigure
Xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
重新配置Citrix Hypervisor服务器,使其使用指定的网口作为管理接口,即用于连接XenCenter的网口。该命令重写了MANAGEMENT_INTERFACE键/etc/xensource-inventory
.
如果指定了接口的设备名(接口必须有IP地址),Citrix Hypervisor服务器会立即重新绑定。该命令在正常模式和紧急模式下都有效。
如果指定了PIF对象的UUID, Citrix Hypervisor服务器将确定要重新绑定到自己的IP地址。执行此命令时,命令不能处于紧急模式。
警告:
在使用off-host命令时要小心,并确保在新接口上有网络连接。使用
xe pif-reconfigure
先建立一个。否则,后续的CLI命令将无法到达Citrix Hypervisor服务器。
host-power-on
Xe host-power-on [host=host_uuid]
打开Citrix Hypervisor服务器的电源主机上电功能启用。使用该命令前,请先启用host-set-power-on
在主机上。
host-reboot
Xe host-reboot [host-selector=host_selector_value…]) < !——NeedCopy >
重启指定的Citrix Hypervisor服务器。必须先禁用指定的主机xe host-disable
命令,否则为HOST_IN_USE
弹出错误提示。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
如果指定的Citrix Hypervisor服务器是池中的成员,则会处理关闭时的连通性丢失,当Citrix Hypervisor服务器返回时,池会恢复。其他成员和主人继续发挥作用。
如果关闭主服务器,池将停止工作,直到发生以下操作之一:
- 你让其中一个成员成为master
原始主机被重新启动并重新上线。
当主服务器重新联机时,成员重新连接并与主服务器同步。
host-restore
Xe host-restore [file-name=backup_filename] [host-selector=host_selector_value…]) < !——NeedCopy >
还原名为文件名称
Citrix Hypervisor服务器控制软件。这里使用“restore”一词并不意味着通常意义上的完全恢复,它仅仅意味着压缩的备份文件已被解压缩并解包到辅助分区上。在你做了一个xe host-restore
,您必须启动安装光盘并使用其从备份恢复选项。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
host-send-debug-keys
Xe host-send-debug-keys host-uuid=host_uuid keys=keys
将指定的虚拟机监控程序调试密钥发送到指定的主机。
host-server-certificate-install
Xe host-server-certificate-install certificate=path_to_certificate_file私钥=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
该任务指导管理员在Citrix Hypervisor服务器上安装TLS证书。
host-set-hostname-live
Xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
修改指定的Citrix Hypervisor服务器的主机名host-uuid
.此命令会永久设置控制域数据库中的主机名和Citrix Hypervisor服务器的实际Linux主机名。的价值主机名
是不的值相同name_label
字段。
host-set-power-on-mode
xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "DRAC" | "custom"} \ [power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid]
用于启用主机上电支持远程电源解决方案的Citrix Hypervisor主机。在使用host-set-power-on
命令时,必须指定主机的电源管理方案类型(即上电模式)。然后使用power-on-config参数及其关联的键值对指定配置选项。
要使用秘密功能来存储密码,请指定密钥“power_on_password_secret”
.有关更多信息,请参见秘密.
host-shutdown
Xe host-shutdown [host-selector=host_selector_value…]) < !——NeedCopy >
关闭指定的Citrix Hypervisor服务器。必须先禁用指定的Citrix Hypervisor服务器xe host-disable
命令,否则为HOST_IN_USE
弹出错误提示。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
如果指定的Citrix Hypervisor服务器是池中的成员,则会处理关闭时的连通性丢失,当Citrix Hypervisor服务器返回时,池会恢复。其他成员和主人继续发挥作用。
如果关闭主服务器,池将停止工作,直到发生以下操作之一:
- 你让其中一个成员成为master
原始主机被重新启动并重新上线。
当主服务器重新联机时,成员重新连接并与主服务器同步。
如果为池启用了HA,则其中一个成员将自动成为主节点。如果HA被禁用,则必须使用pool-designate-new-master
命令。有关更多信息,请参见pool-designate-new-master.
host-sm-dp-destroy
Xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
试图销毁和清理主机上的存储数据路径。如果allow-leak = true
则它删除数据路径的所有记录,即使它没有完全关闭。
host-sync-data
Xe host-sync-data
将存储在池主机上的数据与指定的主机同步。这不包括数据库数据)。
host-syslog-reconfigure
Xe host-syslog-reconfigure [host-selector=host_selector_value…]) < !——NeedCopy >
重新配置syslog
在指定的Citrix Hypervisor服务器上启动。该命令应用主机中定义的配置信息日志记录
参数。
应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。
host-data-source-list
Xe host-data-source-list [host-selectors=host selector value…]) < !——NeedCopy >
列出可为主机记录的数据源。
使用标准选择机制选择要执行此操作的主机主机选择器).可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数,则对所有主机执行该操作。
数据源有两个参数-标准
和启用
.该命令输出参数的值:
- 如果数据源具有
启用
设置为真正的
,这些指标当前被记录到性能数据库中。 - 如果数据源具有
标准
设置为真正的
,这些指标被记录到性能数据库中默认情况下.的价值启用
也被设置为真正的
用于此数据源。 - 如果数据源具有
标准
设置为假
,指标是不默认情况下记录到性能数据库中。的价值启用
也被设置为假
用于此数据源。
要开始将数据源指标记录到性能数据库,请运行host-data-source-record
命令。这个命令设置启用
来真正的
.停止,运行host-data-source-forget
.这个命令设置启用
来假
.
host-data-source-record
host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >
记录主机的指定数据源。
将数据源中的信息写入指定主机的持久性性能指标数据库。出于性能原因,该数据库不同于普通的代理数据库。
使用标准选择机制选择要执行此操作的主机主机选择器).可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数,则对所有主机执行该操作。
host-data-source-forget
Xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >
停止为主机记录指定数据源,并忘记所有记录的数据。
使用标准选择机制选择要执行此操作的主机主机选择器).可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数,则对所有主机执行该操作。
host-data-source-query
host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >
显示主机的指定数据源。
使用标准选择机制选择要执行此操作的主机主机选择器).可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数,则对所有主机执行该操作。
DEPRECATED:日志命令
用于处理日志的命令。
弃用:log-get
Xe log-get
返回当前存储在字符串记录器中的日志。
弃用:log-get-keys
Xe log-get-keys
列出记录器已知的键。
弃用:log-reopen
重新打开日志
重新打开所有记录器(用于旋转文件)。
弃用:log-set-output
Xe log-set-output output=output [key=key] [level=level]
将所有记录器设置为指定的输出(零
,stderr
,字符串
,文件:
文件名称,syslog:
某物).
消息命令
用于处理消息的命令。创建消息是为了通知用户重大事件,并在XenCenter中显示为警报。
可以使用标准对象列表命令(xe消息列表
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
消息参数
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
消息的唯一标识符/对象引用 | 只读 |
名字 |
消息的唯一名称 | 只读 |
优先级 |
消息优先级。数字越大表示优先级越高 | 只读 |
类 |
消息类,例如VM。 | 只读 |
obj-uuid |
受影响对象的uid。 | 只读 |
时间戳 |
消息生成的时间。 | 只读 |
身体 |
消息内容。 | 只读 |
message-create
Xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
创建消息。
message-destroy
Xe message-destroy [uuid=message_uuid]
销毁已存在的消息。您可以构建一个脚本来销毁所有消息。例如:
#取消所有警报\ IFS=",";For min $(xe message-list params=uuid——minimal);Do \ xe message-destroy uuid=$m \ done
网络命令
用于处理网络的命令。
可以使用标准对象列表命令(xe网络表
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
网络参数
网络有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
网络的唯一标识符/对象引用 | 只读 |
品牌) |
网络的名称 | 读/写 |
name-description |
网络的描述文本 | 读/写 |
VIF-uuids |
vif(虚拟网络接口)的唯一标识符列表,vif从虚拟机连接到此网络 | 只读设置参数 |
PIF-uuids |
从Citrix Hypervisor服务器附加到该网络的pif(物理网络接口)的唯一标识符列表 | 只读设置参数 |
桥 |
该网络在本地Citrix Hypervisor服务器上对应的网桥名称 | 只读 |
default-locking-mode |
与VIF对象一起用于ARP过滤的网络对象。设置为解锁 删除与VIF关联的所有过滤规则。设置为禁用 所以VIF会丢弃所有流量。 |
读/写 |
目的 |
Citrix Hypervisor服务器使用该网络的一组目的。设置为nbd 利用网络建立NBD连接。 |
读/写 |
其他配置:staticroute |
的逗号分隔列表子网/子网掩码/网关指定路由子网通过的网关地址的格式化条目。例如,设置其他配置:静态路由 对于172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4,使172.16.0.0/15的流量通过192.168.0.3,172.18.0.0/16的流量通过192.168.0.4。 |
读/写 |
其他配置:ethtoolautoneg |
设置为no表示禁用物理接口或网桥的自协商功能。默认为yes。 | 读/写 |
其他配置:ethtool-rx |
设置为on以启用接收校验和,关闭以禁用 | 读/写 |
其他配置:ethtool-tx |
设置为on以启用传输校验和,关闭以禁用 | 读/写 |
其他配置:ethtool-sg |
设置为on以启用分散收集,关闭以禁用 | 读/写 |
其他配置:ethtool-tso |
设置为on为启用TCP分段卸载,off为禁用 | 读/写 |
其他配置:ethtool-ufo |
设置为on以启用UDP片段卸载,off为禁用 | 读/写 |
其他配置:ethtool-gso |
设置为on为启用通用分段卸载,off为禁用 | 读/写 |
斑点 |
二进制数据存储 | 只读 |
network-create
Xe network-create name-label=name_for_network [name-description=descriptive_text]
创建网络。
network-destroy
Xe network-destroy uuid=network_uuid
破坏现有网络。
SR-IOV命令
使用SR-IOV的命令。
的network-sriov
可以使用标准对象列表命令(xe network-sriov-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
SR-IOV参数
SR-IOV具有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
physical-PIF |
PIF使能SR-IOV。 | 只读 |
logical-PIF |
一个SR-IOV逻辑PIF。用户可以使用该参数创建SR-IOV VLAN网络。 | 只读 |
requires-reboot |
如果设置为True,用于重启主机使SR-IOV启用生效。 | 只读 |
显示 |
剩余可用VFs数。 | 只读 |
network-sriov-create
Xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
为给定的物理PIF创建SR-IOV网络对象,并在物理PIF上启用SR-IOV。
network-sriov-destroy
Xe network- sriov_destroy uuid=network_sriov_uuid
移除网络SR-IOV对象并在其物理PIF上禁用SR-IOV。
分配一个SR-IOV VF
Xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
将SR-IOV网络中的VF分配给虚拟机。
SDN控制器命令
与SDN控制器相关的命令。
sdn-controller-forget
Xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
介绍SDN控制器。
sdn-controller-introduce
sdn-controller-forget uuid=uuid
拔出SDN控制器。
隧道命令
用于处理隧道的命令。
tunnel-create
创建pif-uuid=pif_uuid network-uuid=network_uuid
在主机上新建隧道。
tunnel-destroy
Xe tunnel-destroy uuid=uuid
摧毁隧道。
补丁命令
用于处理补丁的命令。
patch-apply
Xe patch-apply uuid=patch_uuid host-uuid=host_uuid
将之前上传的补丁应用到指定主机。
patch-clean
Xe patch-clean uuid=uuid
删除之前上传的补丁文件。
patch-destroy
命令patch-destroy uuid=uuid
从服务器上删除未应用的补丁记录和文件。
patch-pool-apply
命令patch-pool-apply uuid=uuid
将之前上传的补丁应用于池中的所有主机。
patch-pool-clean
命令patch-pool-clean uuid=uuid
删除池中所有主机上已上传的补丁文件。
patch-precheck
Xe patch-precheck uuid=uuid host-uuid=host_uuid
运行先前上传到指定主机的补丁中包含的预检。
patch-upload
Xe patch-upload file-name=file_name
上传补丁文件到服务器。
PBD命令
用于处理pbd(物理块设备)的命令。pbd是Citrix Hypervisor服务器访问存储库的软件对象。
可以使用标准对象列表命令(xe pbd-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
PBD参数
pbd有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
PBD的唯一标识符/对象引用。 | 只读 |
sr-uuid |
PBD指向的存储库 | 只读 |
device-config |
提供给主机sr -后端驱动程序的额外配置信息 | 只读映射参数 |
currently-attached |
如果SR附加在此主机上,则为True,否则为False | 只读 |
host-uuid |
可用PBD的物理机UUID | 只读 |
宿主 |
不支持使用host字段。请使用host_uuid。 | 只读 |
其他配置 |
额外的配置信息。 | 读写映射参数 |
pbd-create
Xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
在Citrix Hypervisor服务器上创建PBD。只读device-config
参数只能在创建时设置。
要添加从' path '到' /tmp '的映射,命令行应该包含该参数device-config:路径= / tmp
有关每种SR类型上支持的设备配置键/值对的完整列表,请参见存储.
pbd-destroy
uuid= uid_of_pbd
销毁指定的PBD。
pbd-plug
Xe pbd-plug uuid=uuid_of_pbd
尝试将PBD插入到Citrix Hypervisor服务器。如果该命令成功,那么所引用的SR(以及其中包含的vdi)应该对Citrix Hypervisor服务器可见。
pbd-unplug
uuid= uid_of_pbd
尝试从Citrix Hypervisor服务器上拔掉PBD。
论坛的命令
用于处理pif(表示物理网络接口的对象)的命令。
PIF对象可以使用标准对象列表命令(xe pif-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
论坛参数
pif有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
PIF的唯一标识符/对象引用 | 只读 |
设备机器可读 |
接口名称(例如eth0) | 只读 |
MAC |
PIF的MAC地址 | 只读 |
其他配置 |
额外的PIF配置名称:值 对。 |
读写映射参数 |
物理 |
如果为true,则PIF指向实际的物理网络接口 | 只读 |
currently-attached |
PIF当前是否连接在此主机上?真正的 或假 |
只读 |
MTU |
PIF的最大传输单位,以字节为单位。 | 只读 |
VLAN |
通过该接口的所有流量的VLAN标签。-1表示不分配VLAN tag | 只读 |
bond-master-of |
该PIF是主键的UUID(如果有的话) | 只读 |
bond-slave-of |
该PIF所属的键的UUID(如果有的话) | 只读 |
管理 |
这个PIF被指定为控制域的管理接口吗 | 只读 |
network-uuid |
PIF所连接的虚拟网络的唯一标识符/对象引用 | 只读 |
network-name-label |
该PIF所连接的虚拟网络的名称 | 只读 |
host-uuid |
此PIF所连接的Citrix Hypervisor服务器的唯一标识符/对象引用 | 只读 |
host-name-label |
该PIF所连接的Citrix Hypervisor服务器的名称 | 只读 |
IP-configuration-mode |
使用的网络地址配置类型;DHCP或静态 | 只读 |
知识产权 |
PIF的IP地址。当ip配置模式为static时定义;DHCP时未定义 | 只读 |
子网掩码 |
PIF的网络掩码。当ip配置模式为static时定义;当由DHCP提供时未定义 | 只读 |
网关 |
PIF的网关地址。当ip配置模式为static时定义;当由DHCP提供时未定义 | 只读 |
DNS |
PIF的DNS地址。当ip配置模式为static时定义;当由DHCP提供时未定义 | 只读 |
io_read_kbs |
设备的平均读速率(kB/s) | 只读 |
io_write_kbs |
设备的平均写速率,单位为kB/s | 只读 |
航空公司 |
此设备的链路状态 | 只读 |
卖主身份证 |
分配给NIC供应商的ID | 只读 |
商家名称 |
网卡供应商的名称 | 只读 |
设备id |
由供应商分配给该网卡型号的ID | 只读 |
设备名称 |
厂商为该网卡型号指定的名称 | 只读 |
速度 |
网卡数据传输速率 | 只读 |
双工 |
网卡的双工模式;满的还是半的 | 只读 |
pci-bus-path |
PCI总线路径地址 | 只读 |
其他配置:ethtoolspeed |
以Mbps为单位设置连接速度 | 读/写 |
其他配置:ethtoolautoneg |
设置为no表示禁用物理接口或网桥的自协商功能。默认为yes。 | 读/写 |
其他配置:ethtoolduplex |
设置PIF的双工能力,全或半。 | 读/写 |
其他配置:ethtool-rx |
设置为on以启用接收校验和,关闭以禁用 | 读/写 |
其他配置:ethtool-tx |
设置为on以启用传输校验和,关闭以禁用 | 读/写 |
其他配置:ethtool-sg |
设置为on以启用分散收集,关闭以禁用 | 读/写 |
其他配置:ethtool-tso |
设置为on为启用TCP分段卸载,off为禁用 | 读/写 |
其他配置:ethtool-ufo |
设置为on以启用UDP片段卸载,off为禁用 | 读/写 |
其他配置:ethtool-gso |
设置为on为启用通用分段卸载,off为禁用 | 读/写 |
其他配置:域 |
逗号分隔的列表,用于设置DNS搜索路径 | 读/写 |
其他配置:bondmiimon |
链路活动检查间隔时间,单位为毫秒 | 读/写 |
其他配置:bonddowndelay |
链路丢失后等待的毫秒数,然后才真正认为链路已经消失。该参数允许瞬态链路丢失 | 读/写 |
其他配置:bondupdelay |
链路启动后真正考虑启动之前等待的毫秒数。允许链接振荡。默认是31日的年代 允许交换机有时间开始转发流量。 |
读/写 |
disallow-unplug |
如果此PIF是专用存储网卡,则为True,否则为false | 读/写 |
注意:
的更改
其他配置
字段的设置只有在重启后才会生效。或者,使用xe pif-unplug
和xe pif-plug
命令重写PIF配置。
pif-forget
pif忘记uuid= uid_of_pif
销毁特定主机上指定的PIF对象。
pif-introduce
Xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
在指定的Citrix Hypervisor服务器上创建表示物理接口的PIF对象。
pif-plug
pif-plug uuid= uid_of_pif
尝试启动指定的物理接口。
pif-reconfigure-ip
xe pif- reconfiguration - IP uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
修改PIF的IP地址。对于静态IP配置,请设置模式
参数静态
,与网关
,知识产权
,子网掩码
参数设置为适当的值。如果需要使用DHCP,请设置模式
参数DHCP
保持静态参数未定义。
注意:
对于使用生成树协议的交换机,在关闭(或不支持)STP快速链路的情况下,在与端口相连的物理网络接口上使用静态IP地址,会导致一段时间内没有流量。
pif-reconfigure-ipv6
xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
重新配置PIF的IPv6地址。
pif-scan
pif-scan host-uuid=host_uuid
扫描Citrix Hypervisor服务器上的新物理接口。
pif-set-primary-address-type
pif-set-primary-address-type uuid=uuid primary_address_type=address_type
修改PIF使用的主地址类型。
pif-unplug
uuid= uid_of_pif
试图关闭指定的物理接口。处理步骤
池的命令
用于处理池的命令。一个池是一个或多个Citrix Hypervisor服务器的集合。一个存储池可以使用一个或多个共享存储库,以便将存储池中主机上运行的虚拟机近乎实时地迁移到存储池中的另一个主机上。此迁移在VM仍在运行时进行,不需要关闭VM并重新启动它。默认情况下,每个Citrix Hypervisor服务器实际上是一个由单个成员组成的池。当您的Citrix Hypervisor服务器加入到一个池中时,它被指定为一个成员,并且它所加入的池成为该池的主池。
单例池对象可以使用标准对象列表命令(xe池列表
).它的参数可以用标准参数命令来操作。有关更多信息,请参见低级参数命令
池参数
池包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
池的唯一标识符/对象引用 | 只读 |
品牌) |
池的名称 | 读/写 |
name-description |
池的描述字符串 | 读/写 |
主 |
指定为池主的Citrix Hypervisor服务器的唯一标识符/对象引用 | 只读 |
default-SR |
池的默认SR的唯一标识符/对象引用 | 读/写 |
crash-dump-SR |
存储池成员的崩溃转储的SR的唯一标识符/对象引用 | 读/写 |
metadata-vdis |
池的所有已知元数据vdi | 只读 |
suspend-image-SR |
存储池成员上挂起虚拟机所在SR的唯一标识符/对象引用 | 读/写 |
其他配置 |
为池指定额外配置参数的键/值对列表 | 读写映射参数 |
supported-sr-types |
此池可以使用的SR类型 | 只读 |
ha-enabled |
如果池启用了HA,则为True,否则为false | 只读 |
ha配置 |
保留以备将来使用。 | 只读 |
ha-statefiles |
列出HA用于确定存储运行状况的vdi的uuid | 只读 |
ha-host-failures-to-tolerate |
在发送系统警报之前可以容忍的主机故障数量 | 读/写 |
ha-plan-exists-for |
根据HA算法的计算,实际可以处理的主机故障数量 | 只读 |
ha-allow-overcommit |
如果允许池被过度提交,则为True,否则为False | 读/写 |
ha-overcommitted |
如果池超量使用,则为True | 只读 |
斑点 |
二进制数据存储 | 只读 |
live-patching-disabled |
设置为False以启用实时补丁。设置为True禁用实时补丁。 | 读/写 |
igmp-snooping-enabled |
设置为True,开启IGMP snooping功能。设置为False表示关闭IGMP snooping功能。 | 读/写 |
pool-apply-edition
Xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
跨池应用一个版本。
pool-certificate-install
Xe pool-certificate-install filename=file_name
在池范围内安装TLS证书。
pool-certificate-list
Xe pool-certificate-list
列出池中所有已安装的TLS证书。
pool-certificate-sync
Xe pool-certificate-sync
将TLS证书和证书撤销列表从池主同步到其他池成员。
pool-certificate-uninstall
Xe pool-certificate-uninstall name=name
卸载TLS证书。
pool-crl-install
Xe pool-crl-install filename=file_name
安装全池范围的TLS证书撤销列表。
pool-crl-list
池-crl-list
列出所有已安装的TLS证书撤销列表。
pool-crl-uninstall
Xe pool-crl-uninstall name=name
卸载TLS证书吊销列表。
pool-deconfigure-wlb
Xe pool- config -wlb
永久删除工作负载平衡的配置。
pool-designate-new-master
Xe pool- designated -new-master host-uuid=uuid_of_new_master
指示指定的Citrix Hypervisor服务器成员成为现有池的主服务器。该命令用于将资源池中的主主机角色有序切换到另一台主机。该命令仅在当前主机在线时有效。它不能替代下面列出的紧急模式命令。
pool-disable-external-auth
Xe pool-disable-external-auth [uuid=uuid] [config=config]
在池中的所有主机中禁用外部身份验证。
pool-disable-local-storage-caching
Xe pool-disable-local-storage-caching uuid=uuid
跨池禁用本地存储缓存。
pool-disable-redo-log
Xe pool-disable-redo-log
除非启用了HA,否则在使用时禁用重做日志。
pool-dump-database
Xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
下载整个池数据库的副本,并将其转储到客户机上的一个文件中。
pool-enable-external-auth
Xe pool-enable-external-auth auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
对池中的所有主机启用外部认证。的一些值auth-type
将需要特定的配置值。
pool-enable-local-storage-caching
Xe pool-enable-local-storage-caching uuid=uuid
跨池启用本地存储缓存。
pool-enable-redo-log
Xe pool- enable -redo-log sr-uuid=sr_uuid
在使用的SR上启用重做日志,除非启用了HA。
pool-eject
Xe pool-eject host-uuid=uuid_of_host_to_eject
指示指定的Citrix Hypervisor服务器离开现有池。
pool-emergency-reset-master
Xe pool-emergency-reset-master master-address=address_of_pool_master
指示池成员服务器将其主服务器地址重置为新值,并尝试连接到它。不要在主服务器上运行此命令。
pool-emergency-transition-to-master
pool-emergency-transition-to-master
指示Citrix Hypervisor服务器成员成为池主服务器。只有在主机切换到紧急模式后,Citrix Hypervisor服务器才会接受此命令。紧急模式是指主机已从网络中消失,经过多次重试后无法联系的池中的成员。
如果主机加入存储池后修改过主机密码,该命令会导致主机密码重置。有关更多信息,请参阅(用户命令).
pool-ha-enable
Xe pool-ha-enable heartbeat-sr-uuid =uuid_of_heartbeat_sr
在资源池上启用高可用性,使用指定的SR UUID作为中央存储心跳库。
pool-ha-disable
Xe pool-ha-disable
禁用资源池的高可用性特性。
pool-ha-compute-hypothetical-max-host-failures-to-tolerate
计算在当前池配置下可容忍的最大主机故障数。
pool-ha-compute-max-host-failures-to-tolerate
Xe pool-ha-compute- hypohypotical -max-host-failures-to- tolerance [vm-uuid=vm_uuid] [restart-priority=restart_priority]
计算提供的建议保护的虚拟机所能容忍的最大主机故障数。
pool-initialize-wlb
Xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
使用目标workload balancing服务器初始化当前池的工作负载平衡。
pool-join
Xe pool-join master-address=address master-username=username master-password=password
指示Citrix Hypervisor服务器加入现有池。
pool-management-reconfigure
Xe pool-management-reconfigure [network-uuid=network-uuid]
重新配置池中所有主机的管理接口,使其使用指定的网口,即用于连接XenCenter的网口。该命令重写了MANAGEMENT_INTERFACE键/etc/xensource-inventory
给泳池里所有的主人。
如果指定了接口的设备名(接口必须有IP地址),则Citrix Hypervisor的主主机立即重新绑定。该命令在正常模式和紧急模式下都有效。
从指定的网络UUID中,识别PIF对象的UUID并将其映射到Citrix Hypervisor服务器,该服务器确定要将哪个IP地址重新绑定到自己。执行此命令时,命令不能处于紧急模式。
警告:
在使用off-host命令时要小心,并确保在新接口上有网络连接。使用
xe pif-reconfigure
先建立一个。否则,后续的CLI命令将无法到达Citrix Hypervisor服务器。
pool-recover-slaves
Xe pool- recovery -slaves
指示池主服务器尝试重置当前以紧急模式运行的所有成员的主服务器地址。该命令通常在执行命令后使用pool-emergency-transition-to-master
已经被用来设置一个成员作为新的主人。
pool-restore-database
Xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
上传数据库备份(使用pool-dump-database
)到游泳池。在接收到上传后,主机使用新数据库重新启动自己。
还有一个排练选项,该选项允许您检查是否可以在不实际执行操作的情况下恢复池数据库。默认情况下,管制
设置为false。
pool-retrieve-wlb-configuration
pool-retrieve-wlb-configuration
从Workload Balancing服务器检索池优化标准。
pool-retrieve-wlb-diagnostics
Xe pool-retrieve-wlb-diagnostics [filename=file_name]
从工作负载平衡服务器检索诊断。
pool-retrieve-wlb-recommendations
pool-retrieve-wlb-recommendations
从Workload Balancing服务器检索池的虚拟机迁移建议。
pool-retrieve-wlb-report
Xe pool-retrieve-wlb-report report=report [filename=file_name]
从工作负载平衡服务器检索报告。
pool-rotate-secret
Xe pool-rotate-secret
旋转池秘密。
池秘密是池中的服务器之间共享的秘密,它使服务器能够证明它是池的成员。具有Pool Admin角色的用户可以在通过SSH连接到服务器时查看此秘密。如果其中一个用户离开了您的组织或失去了他们的pool Admin角色,则轮换池密钥。
pool-send-test-post
设置pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
使用HTTPS将给定的主体发送到给定的主机和端口,并打印响应。用于调试TLS层。
pool-send-wlb-configuration
Xe pool-send-wlb-configuration [config:=config]
设置负载均衡服务器的池优化标准。
pool-sync-database
Xe pool-sync-database
强制在资源池中的所有主机上同步池数据库。正常情况下不需要执行此命令,因为数据库会定期自动复制。但是,该命令对于确保在执行大量CLI操作后快速复制更改非常有用。
集水池igmp-snooping
Xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
开启或关闭Citrix Hypervisor池的IGMP snooping功能。
PVS加速器命令
使用PVS加速器的命令。
pvs-cache-storage-create
Xe pv -cache-storage-create sr-uuid=sr_uuid pv -site-uuid=pvs_site_uuid size=size
在给定的SR上为给定的主机配置PVS缓存。
pvs-cache-storage-destroy
Xe pvs-cache-storage-destroy uuid=uuid
删除PVS缓存。
pvs-proxy-create
Xe pv -proxy-create pv -site-uuid=pvs_site_uuid vif-uuid=vif_uuid
配置虚拟机/VIF使用PVS代理
pvs-proxy-destroy
命令pvs-proxy-destroy uuid=uuid
为这个VIF/VM删除(或关闭)一个PVS代理。
pvs-server-forget
Xe pv -server-forget uuid=uuid
忘记PVS服务器吧。
pvs-server-introduce
Xe pv -server-introduce addresses= address first-port=first_port last-port=last_port pv -site-uuid=pvs_site_uuid
介绍新的PVS服务器。
pvs-site-forget
Xe pv -site-forget uuid=uuid
忘记PVS网站吧。
pvs-site-introduce
Xe pv -site- introduction name-label=name_label [name-description=name_description] [pv -uuid=pvs_uuid]
介绍新的pv站点。
存储管理器命令
控制Storage Manager插件的命令。
存储管理器对象可以使用标准对象列表命令(xe sm-list
).可以使用标准参数命令对参数进行操作。有关更多信息,请参见低级参数命令
SM参数
短信有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
SM插件的唯一标识符/对象引用 | 只读 |
品牌) |
SM插件的名称 | 只读 |
name-description |
SM插件的描述字符串 | 只读 |
类型 |
此插件连接到的SR类型 | 只读 |
供应商 |
创建此插件的供应商的名称 | 只读 |
版权 |
此SM插件的版权声明 | 只读 |
required-api-version |
Citrix Hypervisor服务器要求的SM API最低版本 | 只读 |
配置 |
设备配置键的名称和描述 | 只读 |
功能 |
SM插件的功能 | 只读 |
driver-filename |
SR驱动的文件名。 | 只读 |
快照命令
用于处理快照的命令。
snapshot-clone
Xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
在可用的情况下,使用存储级快速磁盘克隆操作,通过克隆现有快照创建新模板。
快照复制
Xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
通过复制现有虚拟机创建新模板,但不使用存储级快速磁盘克隆操作(即使有这种操作)。复制的虚拟机的磁盘映像保证是“完整映像”,即不是CoW链的一部分。
snapshot-destroy
Xe snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid]
销毁快照。这将保留与快照关联的存储。要删除存储,请使用snapshot-uninstall。
snapshot-disk-list
Xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
列出所选虚拟机中的磁盘。
snapshot-export-to-template
Xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false]
将快照导出到文件名称.
snapshot-reset-powerstate
Xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid][——force]
仅在管理工具栈数据库中强制虚拟机上电状态为“stopped”。此命令用于恢复被标记为“挂起”的快照。这是一个潜在的危险操作:您必须确保不再需要内存映像。您将无法再恢复快照。
snapshot-revert
Xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
将现有虚拟机恢复到以前的检查点或快照状态。
snapshot-uninstall
Xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid][——force]
卸载快照。此操作将销毁那些标记为RW且仅连接到此快照的vdi。如果需要直接销毁虚拟机记录,使用snapshot-destroy命令。
老的命令
用于控制SRs(存储库)的命令。
可以使用标准对象列表命令(xe sr-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
SR参数
SRs有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
SR的唯一标识符/对象引用 | 只读 |
品牌) |
SR的名称 | 读/写 |
name-description |
SR的描述字符串 | 读/写 |
允许的操作 |
此状态下SR允许的操作列表 | 只读设置参数 |
当前操作 |
此SR上当前正在进行的操作的列表 | 只读设置参数 |
vdi |
该SR中虚拟磁盘的唯一标识符/对象引用 | 只读设置参数 |
pbd |
附在此SR上的pbd的唯一标识符/对象引用 | 只读设置参数 |
physical-utilisation |
当前在该SR上使用的物理空间,以字节为单位。对于精简配置的磁盘格式,物理利用率可能低于虚拟分配 | 只读 |
物理尺寸 |
SR的总物理大小,以字节为单位 | 只读 |
类型 |
SR的类型,用于指定要使用的SR后端驱动程序 | 只读 |
通过 |
的drtask (如有的话)引入了SR |
只读 |
内容类型 |
SR内容的类型。用于区分ISO库和其他sr。对于存储iso库的存储库,必须将内容类型设置为iso。在其他情况下,我们建议将此参数设置为空,或者将字符串user设置为空。 | 只读 |
共享 |
如果此SR可以在多个Citrix Hypervisor服务器之间共享,则为True;假的,否则 | 读/写 |
其他配置 |
为SR指定额外配置参数的键/值对列表 | 读写映射参数 |
宿主 |
存储库主机名 | 只读 |
virtual-allocation |
此存储库中所有vdi的虚拟大小值的总和(以字节为单位) | 只读 |
sm-config |
SM相关数据 | 只读映射参数 |
斑点 |
二进制数据存储 | 只读 |
sr-create
Xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
在磁盘上创建一个SR,将其引入数据库,并创建一个PBD,将SR连接到Citrix Hypervisor服务器。如果共享
设为真正的
则为池中的每个Citrix Hypervisor服务器创建一个PBD。如果共享
未指定或设置为假
,则仅为指定的Citrix Hypervisor服务器创建PBDhost-uuid
.
确切的device-config
不同设备的参数不同类型
.有关不同存储后端之间这些参数的详细信息,请参见存储.
sr-data-source-forget
Xe sr-data-source-forget data-source=data_source
停止为SR记录指定的数据源,并忘记所有记录的数据。
sr-data-source-list
Xe sr-数据源-list
列出可为SR记录的数据源。
sr-data-source-query
sql -data-source-query data-source=data_source
查询从SR数据源读取的最后一个值。
sr-data-source-record
Xe sr-data-source-record data-source=data_source
记录SR的指定数据源。
sr-destroy
命令sr-destroy uuid=sr_uuid
销毁Citrix Hypervisor服务器上指定的SR。
sr-enable-database-replication
Xe sr-enable-database-replication uuid=sr_uuid
启用XAPI数据库复制到指定的(共享的)SR。
sr-disable-database-replication
Xe sr-disable-database-replication uuid=sr_uuid
禁用XAPI数据库到指定SR的复制。
sr-forget
Xe sr-forget uuid=sr_uuid
XAPI代理忘记了Citrix Hypervisor服务器上指定的SR。当XAPI代理忘记SR时,SR将被分离,您无法访问SR上的vdi,但SR在源媒体上保持完整(数据不会丢失)。
sr-introduce
Xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
只是将SR记录放入数据库。使用device-config
以在表单中指定其他参数device-config: parameter_key = parameter_value
,例如:
Xe sr-introduce device-config:device=/dev/sdb1——NeedCopy >
注意:
正常情况下不使用该命令。当创建SR后必须将其重新配置为共享时,或者帮助从各种故障场景中恢复时,此高级操作可能很有用。
sr-probe
Xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
方法对后端执行扫描device-config
钥匙。如果device-config
对于SR后端,此命令返回设备上存在的SR的列表(如果有的话)。如果device-config
参数只是部分的,执行特定于后端的扫描,返回指导您改进其余部分的结果device-config
参数。扫描结果以特定于后端的XML格式返回,并在CLI中打印。
确切的device-config
不同设备的参数不同类型
.有关不同存储后端之间这些参数的详细信息,请参见存储.
sr-probe-ext
Xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
执行存储探测。设备配置参数可以通过如下命令指定,例如device-config:devs=/dev/sdb1。与SR -probe不同,对于每种SR类型,该命令以相同的人类可读格式返回结果。
sr-scan
Xe sr-scan uuid=sr_uuid
强制进行SR扫描,将XAPI数据库与存在于底层存储基板中的vdi同步。
sr-update
Xe sr-update uuid=uuid
刷新数据库中SR对象的字段。
lvhd-enable-thin-provisioning
Xe lvhd-enable-thin-provisioning sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
在LVHD SR上启用精简配置功能。
主题的命令
用于处理主题的命令。
session-subject-identifier-list
Xe session-subject-identifier-list
返回所有外部认证的现有会话的所有用户主题id的列表。
session-subject-identifier-logout
Xe session-subject-identifier-logout subject-identifier=subject_identifier
注销与用户主题id关联的所有外部身份验证会话。
session-subject-identifier-logout-all
session-subject-identifier-logout-all
注销所有外部认证会话。
subject-add
Xe subject-add subject-name=subject_name
向可以访问池的主题列表中添加一个主题。
subject-remove
Xe subject-remove subject-uuid=subject_uuid
从可以访问池的主题列表中删除一个主题。
subject-role-add
Xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
向主题添加角色。
subject-role-remove
Xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
从主题中删除角色。
secret-create
Xe secret-create value=value
创造一个秘密。
secret-destroy
命令secret-destroy uuid=uuid
摧毁一个秘密。
任务命令
处理长时间运行的异步任务的命令。这些命令是启动、停止和挂起虚拟机等任务。任务通常由一组其他原子子任务组成,这些子任务共同完成所请求的操作。
可以使用标准对象列表命令(xe任务列表
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
任务参数
任务有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
任务的唯一标识符/对象引用 | 只读 |
品牌) |
任务的名称 | 只读 |
name-description |
任务的描述字符串 | 只读 |
居民在 |
运行任务所在主机的唯一标识符/对象引用 | 只读 |
状态 |
任务状态 | 只读 |
进步 |
如果任务仍处于挂起状态,则此字段包含估计的完成百分比,从0到1。如果任务已经完成,成功或不成功,该值为1。 | 只读 |
类型 |
如果Task已成功完成,则此参数包含编码结果的类型。类型是其引用位于结果字段中的类的名称。否则,该参数的值为未定义 | 只读 |
结果 |
如果Task已成功完成,则该字段包含结果值,可以是Void或对象引用;否则,该参数的值为未定义 | 只读 |
error_info |
如果任务失败,此参数包含一组相关的错误字符串。否则,该参数的值为未定义 | 只读 |
allowed_operations |
此状态下允许的操作列表 | 只读 |
创建 |
任务创建完成的时间 | 只读 |
完成了 |
任务完成的时间(即成功或失败)。如果task-status为pending,则该字段的值没有任何意义 | 只读 |
subtask_of |
包含此任务是其子任务的任务的UUID | 只读 |
子任务 |
包含此任务的所有子任务的uuid | 只读 |
task-cancel
Xe task-cancel [uuid=task_uuid]
指示指定的Task取消并返回。
模板的命令
使用虚拟机模板的命令。
模板本质上是虚拟机是一个模板
参数设置为真正的
.模板是一个“金映像”,其中包含用于实例化特定VM的所有各种配置设置。Citrix Hypervisor附带了一组基本模板,这些模板是通用的“原始”虚拟机,可以引导操作系统供应商的安装CD(例如:RHEL、CentOS、SLES、Windows)。您可以创建VM,根据您的特定需求以标准形式配置它们,并将它们的副本保存为模板,以便将来在VM部署中使用。
可以使用标准对象列表命令(xe模板列表中
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
注意:
不能通过设置模板直接转为虚拟机
是一个模板
参数假
.设置是一个模板
参数假
不支持,会导致虚拟机无法启动。
虚拟机模板参数说明
模板包含以下参数:
uuid
(只读)模板的唯一标识符/对象引用品牌)
(读/写)模板的名称name-description
(读/写)模板的描述字符串user-version
(读/写)字符串,供虚拟机和模板的创建者放置版本信息是一个模板
(读/写)当此虚拟机为模板时为true。模板虚拟机不能启动,只能用于克隆其他虚拟机。在该值被设置为true之后,它不能被重置为false。该参数不支持模板虚拟机转为虚拟机。is-control-domain
(只读)如果这是控制域(域0或驱动域),则为true电源状态
(只读)当前电源状态。对于模板,该值始终处于暂停状态memory-dynamic-max
(只读)以字节为单位的动态最大内存。当前未使用,但如果更改,必须遵守以下约束:memory_static_max
>=
memory_dynamic_max
>=
memory_dynamic_min
>=
memory_static_min
.memory-dynamic-min
(读/写)以字节为单位的动态最小内存。当前未使用,但如果更改了相同的约束memory-dynamic-max
必须服从。memory-static-max
(读/写)以字节为单位静态设置(绝对)最大内存。该字段是用于确定分配给虚拟机的内存量的主要值。memory-static-min
(读/写)以字节为单位静态设置(绝对)最小内存。该字段表示绝对最小内存,和memory-static-min
必须小于memory-static-max
.此值在正常操作中是不使用的,但必须遵守前面的约束。suspend-VDI-uuid
(只读)存储挂起映像的VDI(对模板没有意义)VCPUs-params
(读写映射参数)所选vCPU策略的配置参数。你可以调优一个vCPU的钉住:
vcpu -params:mask=1,2,3
使用该模板创建的虚拟机只能运行在物理cpu 1、2、3上。
您还可以使用上限和权重参数调优vCPU优先级(xen调度)。例如:
xe template-param-set uuid=
vcpu -params:weight=512 xe template-param-set uuid= vcpu -params:cap=100 基于此模板的虚拟机,如果权值为512,在同一台竞争主机上获得的CPU是权值为256的域的2倍。合法权重的取值范围是1 ~ 65535,默认值是256。
即使Citrix Hypervisor服务器有空闲的CPU周期,该上限也可以选择固定基于此模板的虚拟机可以消耗的最大CPU量。上限表示一个物理CPU的百分比:100表示1个物理CPU, 50表示半个CPU, 400表示4个CPU,以此类推。默认值为0,表示没有上限。
VCPUs-max
(读/写)最大vcpu数VCPUs-at-startup
(读/写)vcpu的启动数actions-after-crash
基于该模板的虚拟机崩溃时采取的(读/写)操作console-uuids
(只读设置参数)虚拟控制台设备平台
(读/写映射参数)平台特定配置禁用HVM客户机(例如,Windows客户机)的并行端口模拟:
Xe vm-param-set uuid=
平台:parallel=none 为HVM客户机禁用串行端口仿真。
Xe vm-param-set uuid=
platform:hvm_serial=none 为HVM客户机禁用USB控制器和USB平板设备的仿真:
Xe vm-param-set uuid=
平台:usb=false Xe vm-param-set uuid= 平台:usb_tablet=false 允许的操作
(只读设置参数)该状态下允许的操作列表当前操作
(只读设置参数)当前在此模板上正在进行的操作列表allowed-VBD-devices
(只读设置参数)可用的VBD标识符列表,用0-15范围的整数表示。此列表仅供参考,可能会使用其他设备(但可能不起作用)。allowed-VIF-devices
(只读设置参数)可用的VIF标识符列表,由0-15范围的整数表示。此列表仅供参考,可能会使用其他设备(但可能不起作用)。HVM-boot-policy
(读/写)HVM客户机的启动策略。BIOS Order或空字符串。HVM-boot-params
(读/写映射参数)order键控制HVM客户机引导顺序,用字符串表示,其中每个字符是一种引导方式:d表示CD/DVD, c表示根磁盘,n表示网络PXE引导。默认为dc。PV-kernel
(读/写)路径到内核PV-ramdisk
的(读/写)路径initrd
PV-args
(读/写)内核命令行参数字符串PV-legacy-args
(读/写)参数字符串,使基于此模板的旧虚拟机启动PV-bootloader
(读/写)引导加载程序的名称或路径PV-bootloader-args
(读/写)引导加载程序的杂项参数字符串last-boot-CPU-flags
(只读)描述基于此模板的虚拟机上次启动时使用的CPU标志;没有为模板填充居民在
(只读)基于该模板的虚拟机所在的Citrix Hypervisor服务器。显示为不在数据库中
对于模板亲和力
(读/写)基于此模板的虚拟机优先运行的Citrix Hypervisor服务器。由xe vm-start
命令,以决定在何处运行虚拟机其他配置
(读/写映射参数)键/值对列表,为模板指定额外的配置参数启动时间
(只读)时间戳,读取基于此模板的VM的度量标准的日期和时间,格式为yyyymmddThh: mm: ss z
,其中z是单个字母的军用时区指示符,例如,z代表UTC(GMT)。设置为1970年1月1日
(Unix/POSIX纪元的开始)用于模板安装时
(只读)时间戳,读取基于此模板的VM的度量标准的日期和时间,格式为yyyymmddThh: mm: ss z
,其中z是单个字母的军用时区指示符,例如,z代表UTC (GMT)。设置为1970年1月1日
(Unix/POSIX纪元的开始)用于模板memory-actual
(只读)基于该模板的虚拟机实际使用的内存;模板为0VCPUs-number
(只读)根据该模板分配给虚拟机的虚拟cpu数量;模板为0VCPUs-Utilization
(只读映射参数)虚拟cpu列表及其权重只读映射参数操作系统版本
使用该模板创建虚拟机的操作系统版本。显示为不在数据库中
对于模板PV-drivers-version
(只读映射参数)基于该模板的虚拟机的半虚拟化驱动版本。显示为不在数据库中
对于模板PV-drivers-detected
(只读)标志,表示基于该模板的虚拟机的半虚拟化驱动程序的最新版本。显示为不在数据库中
对于模板内存
(只读映射参数)代理根据该模板上报的虚拟机内存指标。显示为不在数据库中
对于模板磁盘
(只读映射参数)代理根据该模板上报的虚拟机磁盘指标。显示为不在数据库中
对于模板网络
(只读映射参数)代理根据该模板上报的虚拟机网络指标。显示为不在数据库中
对于模板其他
(只读映射参数)代理根据此模板在虚拟机上报告的其他指标。显示为不在数据库中
对于模板guest-metrics-last-updated
(只读)guest代理执行最后一次写入这些字段的时间戳。在表格中yyyymmddThh: mm: ss z
,其中z是单个字母的军用时区指示符,例如,z代表UTC (GMT)。actions-after-shutdown
虚拟机关机后需要执行的(读/写)操作actions-after-reboot
虚拟机重启后需要执行的读/写操作possible-hosts
(只读)可能承载该虚拟机的主机列表HVM-shadow-multiplier
(读/写)倍增器应用于可提供给来宾的阴影量dom-id
(只读)域ID(如果可用,则为-1)建议
(只读)该虚拟机属性推荐值和范围的XML规范xenstore-data
(读/写映射参数)要插入的数据xenstore
树(/地方/域/ * domid * / vmdata
)。都只能
(只读)当此模板为虚拟机快照时为Truesnapshot_of
(只读)该模板被快照的虚拟机UUID快照
(只读)该模板的所有快照的uuidsnapshot_time
(只读)虚拟机最近一次快照的时间戳memory-target
(只读)此模板设置的目标内存量blocked-operations
(读写映射参数)列出了该模板不能执行的操作last-boot-record
(只读)这个模板的最后一个引导参数的记录,XML格式ha-always-run
(读/写)如果这个模板的实例总是在另一个主机上重启,如果它所在的主机发生故障,True。该参数现在已弃用。使用ha-restartpriority
参数。ha-restart-priority
(只读)重启或尽最大努力读/写blobs二进制数据存储生活
(只读)仅与运行中的虚拟机相关。
模板导出
Xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
将指定模板的副本导出到具有指定新文件名的文件。
template-uninstall
Xe template-uninstall template-uuid=template_uuid[——force]
卸载自定义模板。该操作将销毁那些被该模板标记为“拥有”的vdi。
更新命令
以下章节包含Citrix Hypervisor服务器更新命令。
可以使用标准对象列表命令(xe update-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
更新参数
Citrix Hypervisor服务器更新包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
更新的唯一标识符/对象引用 | 只读 |
宿主 |
应用此更新的主机列表 | 只读 |
host-uuid |
要查询的Citrix Hypervisor服务器的唯一标识 | 只读 |
品牌) |
更新的名称 | 只读 |
name-description |
更新的描述字符串 | 只读 |
应用 |
是否已应用更新;真或假 | 只读 |
安装尺寸 |
以字节为单位的更新大小 | 只读 |
after-apply-guidance |
XAPI工具栈或主机是否需要重启 | 只读 |
版本 |
更新的版本 | 只读 |
update-upload
Xe update-upload file-name=update_filename
将指定的更新文件上传到Citrix Hypervisor服务器。此命令准备要应用的更新。如果成功,将打印上传更新的UUID。如果更新之前已经上传,UPDATE_ALREADY_EXISTS
返回错误,补丁不能再次上传。
update-precheck
Xe update-precheck uuid=update_uuid host-uuid=host_uuid
在指定的Citrix Hypervisor服务器上运行指定更新中包含的预检。
update-destroy
update-destroy uuid=update_file_uuid——NeedCopy >
删除尚未从池中应用的更新文件。用于删除不能应用于主机的更新文件。
update-apply
Xe update-apply host-uuid=host_uuid uuid=update_file_uuid
应用指定的更新文件。
update-pool-apply
更新池-应用uuid=update_uuid
将指定的更新应用于池中的所有Citrix Hypervisor服务器。
update-introduce
Xe update-introduce vdi_uuid =vdi_uuid
引入更新VDI。
update-pool-clean
Xe update-pool-clean uuid=uuid
从池中的所有主机中删除更新文件。
用户命令
user-password-change
Xe user-password-change old=old_password new=new_password
修改当前登录用户的密码。没有检查旧密码字段,因为您需要管理员权限才能使用此命令。
VBD命令
使用vbd(虚拟块设备)的命令。
VBD是连接虚拟机和VDI的软件对象,VDI代表虚拟磁盘的内容。VBD具有将VDI绑定到VM的属性(它是否可引导,它的读/写指标,等等)。VDI包含有关虚拟磁盘物理属性的信息(SR类型、磁盘是否可共享、介质是读写还是只读,等等)。
VBD对象可以使用标准对象列表命令(xe vbd-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
VBD参数
vbd有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
VBD的唯一标识符/对象引用 | 只读 |
vm-uuid |
VBD所附加的虚拟机的唯一标识符/对象引用 | 只读 |
vm-name-label |
VBD所挂载的虚拟机名称 | 只读 |
vdi-uuid |
VBD映射到的VDI的唯一标识符/对象引用 | 只读 |
vdi-name-label |
该VBD映射到的VDI的名称 | 只读 |
空 |
如果真正的 ,此VBD表示空驱动器 |
只读 |
设备 |
例如,客人看到的设备hda |
只读 |
userdevice |
期间由设备参数指定的设备号vbd-create ,例如,0hda , 1为hdb 等等 |
读/写 |
可启动的 |
如果这个VBD是可引导的,则为True | 读/写 |
模式 |
VBD应该安装的模式 | 读/写 |
类型 |
VBD在虚拟机中如何显示,例如磁盘或CD | 读/写 |
currently-attached |
如果VBD连接到此主机,则为True,否则为false | 只读 |
storage-lock |
如果获取了存储级锁,则为True | 只读 |
状态码 |
与上次附加操作相关联的错误/成功代码 | 只读 |
status-detail |
与上次附加操作状态相关联的错误/成功信息 | 只读 |
qos_algorithm_type |
使用的QoS算法 | 读/写 |
qos_algorithm_params |
所选QoS算法参数 | 读写映射参数 |
qos_supported_algorithms |
VBD支持的QoS算法 | 只读设置参数 |
io_read_kbs |
该VBD的平均读取速率(单位为kB /秒) | 只读 |
io_write_kbs |
该VBD的平均写速率(单位为kB /秒) | 只读 |
允许的操作 |
此状态下允许的操作列表。此列表仅供参考,当客户端读取此字段时,服务器状态可能已经更改。 | 只读设置参数 |
当前操作 |
使用此对象(通过引用)将每个正在运行的任务链接到current_operation enum,该enum描述任务的性质。 | 只读设置参数 |
不可 |
如果此VBD支持热拔插,则为True | 读/写 |
可连接的 |
如果设备可以连接,则为True | 只读 |
其他配置 |
额外的配置 | 读写映射参数 |
vbd-create
vdi-uuid= uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
在虚拟机上创建VBD。
的允许值设备
字段为整数,取值范围为0 ~ 15,且每个虚拟机的序号不能重复。中可以看到当前的允许值allowed-VBD-devices
参数。这被看作是userdevice
在vbd
参数。
如果类型
是磁盘
,vdi-uuid
是必需的。模式可以是罗依
或RW
用于磁盘。
如果类型
是CD
,vdi-uuid
是可选的。如果不指定VDI,则为CD创建一个空VDI罗依
买一张CD。
vbd-destroy
vbd-destroy uuid= uid_of_vbd
销毁指定的VBD。
如果VBD有它的其他配置:老板
参数设置为真正的
,关联的VDI也会被销毁。
vbd-eject
Xe vbd-eject uuid= uid_of_vbd
从VBD表示的驱动器中删除媒体。此命令仅在介质为可移动类型(物理CD或ISO)时有效。否则,显示错误信息VBD_NOT_REMOVABLE_MEDIA
返回。
vbd-insert
Xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
将新媒体插入由VBD表示的驱动器中。此命令仅在介质为可移动类型(物理CD或ISO)时有效。否则,显示错误信息VBD_NOT_REMOVABLE_MEDIA
返回。
vbd-plug
vbd-plug uuid= uid_of_vbd
在虚拟机处于运行状态时尝试挂载VBD。
vbd-unplug
vbd-unplug uuid= uid_of_vbd
当VBD处于运行状态时,尝试将其从虚拟机中分离出来。
VDI的命令
使用vdi(虚拟磁盘映像)的命令。
VDI是一个软件对象,表示虚拟机所看到的虚拟磁盘的内容。这与VBD不同,VBD是将VM绑定到VDI的对象。VDI包含有关虚拟磁盘物理属性的信息(SR类型、磁盘是否可共享、介质是读写还是只读,等等)。VBD具有将VDI绑定到VM的属性(它是否可引导,它的读/写度量,等等)。
VDI对象可以使用标准对象列表命令(xe vdi-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
VDI参数
vdi有以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
uuid |
VDI的唯一标识符/对象引用 | 只读 |
品牌) |
VDI的名称 | 读/写 |
name-description |
VDI的描述字符串 | 读/写 |
允许的操作 |
在此状态下允许的操作列表 | 只读设置参数 |
当前操作 |
该VDI上当前正在进行的操作的列表 | 只读设置参数 |
sr-uuid |
VDI所在的SR | 只读 |
vbd-uuids |
引用此VDI的vbd列表 | 只读设置参数 |
crashdump-uuids |
引用此VDI的崩溃转储列表 | 只读设置参数 |
虚拟内存 |
呈现给虚拟机的磁盘大小,以字节为单位。根据存储后端类型的不同,可能不会完全遵守大小 | 只读 |
physical-utilisation |
VDI在SR上占用的物理空间的数量,以字节为单位 | 只读 |
类型 |
VDI类型,例如“System”或“User” | 只读 |
可分享的 |
如果这个VDI可以共享,则为True | 只读 |
只读 |
如果该VDI只能以只读方式挂载,则为True | 只读 |
storage-lock |
如果该VDI在存储级别被锁定,则为True | 只读 |
父 |
当父VDI是链的一部分时,引用父VDI | 只读 |
失踪 |
如果SR扫描操作报告该VDI不存在,则为True | 只读 |
其他配置 |
此VDI的额外配置信息 | 读写映射参数 |
sr-name-label |
包含存储库的名称 | 只读 |
位置 |
位置信息 | 只读 |
管理 |
如果VDI被管理,则为True | 只读 |
xenstore-data |
要插入的数据xenstore 树(/local/domain/0/backend/ vbd/)domid/设备id/smdata)。SM后端通常将此字段设置为开启状态vdi_attach . |
只读映射参数 |
sm-config |
SM相关数据 | 只读映射参数 |
都只能 |
如果该VDI是虚拟机存储快照,则为True | 只读 |
snapshot_of |
此VDI作为快照的存储的UUID | 只读 |
快照 |
该VDI的所有快照的uuid | 只读 |
snapshot_time |
创建该VDI的快照操作的时间戳 | 只读 |
metadata-of-pool |
创建此元数据VDI的池的uid | 只读 |
metadata-latest |
指示VDI是否包含此池的最新已知元数据的标志 | 只读 |
cbt-enabled |
标识是否为VDI启用了更改块跟踪 | 读/写 |
vdi-clone
Xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
创建可直接使用的指定VDI的新的可写副本。它是…的变体vdi-copy
这是可以暴露高速图像克隆设施存在的地方。
使用可选的driver-params
map参数将额外的特定于供应商的配置信息传递到VDI所基于的后端存储驱动程序。有关详细信息,请参阅存储供应商驱动程序文档。
vdi-copy
Xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
将VDI复制到指定的SR。
vdi-create
Xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-\*=storage_specific_configuration_data
创建VDI。
的虚拟内存
参数可以以字节为单位或使用IEC标准后缀KiB、MiB、GiB和TiB来指定。
注意:
支持磁盘精简配置的SR类型(如Local VHD和NFS)不强制磁盘虚拟分配。在SR上过度分配虚拟磁盘空间时要非常小心。如果过度分配的SR已满,则必须在SR目标基板上或通过删除SR中未使用的vdi来提供磁盘空间。
一些SR类型可能会把
虚拟内存
值,使其可被配置的块大小整除。
vdi-data-destroy
vdi-data-destroy uuid= uid_of_vdi
销毁与指定VDI相关的数据,但保留已更改的块跟踪元数据。
注意:
如果您使用更改块跟踪对VDI进行增量备份,请确保使用
vdi-data-destroy
命令,删除快照,但保留元数据。不要使用vdi-destroy
已启用块跟踪的vdi的快照。
vdi-destroy
Xe vdi-destroy uuid= uid_of_vdi
销毁指定的VDI。
注意:
如果您使用更改块跟踪对VDI进行增量备份,请确保使用
vdi-data-destroy
命令,删除快照,但保留元数据。不要使用vdi-destroy
已启用块跟踪的vdi的快照。对于Local VHD和NFS SR类型,磁盘空间不会立即释放
vdi-destroy
,但在存储库扫描操作期间定期。如果必须强制已删除的磁盘空间可用,请调用sr-scan
手动。
vdi-disable-cbt
Xe vdi-disable-cbt uuid= uid_of_vdi
禁用VDI的更改块跟踪。
vdi-enable-cbt
Xe vdi-enable-cbt uuid= uid_of_vdi
启用VDI的更改块跟踪。
注意:
您只能在Citrix Hypervisor高级版的许可实例上启用更改块跟踪。
vdi-export
Xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi][——progress]
导出VDI到指定的文件名。导出VDI的格式有以下几种:
生
vhd
VHD格式可以稀疏的.如果VDI中有未分配的块,则可以从VHD文件中省略这些块,从而使VHD文件更小。支持从所有支持的VHD存储类型(EXT3/EXT4、NFS)导出为VHD格式。
如果您指定基地
参数时,该命令只导出在导出的VDI和基本VDI之间发生了变化的块。
vdi-forget
vdi-forget uuid= uid_of_vdi
无条件地从数据库中删除一条VDI记录,而不触及存储后端。在正常操作中,您应该使用vdi-destroy
代替。
vdi-import
Xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format][——progress]
导入VDI。您可以从以下格式之一导入VDI:
生
vhd
vdi-introduce
Xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [shared =yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [ms -config=storage_specific_configuration_data]
创建代表现有存储设备的VDI对象,而无需实际修改或创建任何存储。该命令主要用于内部自动引入热插拔存储设备。
vdi-list-changed-blocks
vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
比较两个vdi并以base64编码字符串的形式返回两个vdi之间发生变化的块列表。该命令仅对已使能块跟踪的vdi有效。
有关更多信息,请参见更改块跟踪.
vdi-pool-migrate
xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
将VDI迁移到指定的SR,同时将VDI附加到正在运行的客户机。(存储热迁移)
有关更多信息,请参见迁移虚拟机.
vdi-resize
Xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
修改UUID指定的VDI的大小。
vdi-snapshot
Xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
生成一个VDI的可读写版本,该版本可以用作备份或模板创建的参考,也可以同时用作两者的参考。使用快照执行备份,而不是在虚拟机内部安装和运行备份软件。当外部备份软件将快照内容流式传输到备份介质时,虚拟机将继续运行。类似地,快照可以用作模板的“金映像”。可以使用任何vdi制作模板。
使用可选的driver-params
map参数将额外的特定于供应商的配置信息传递到VDI所基于的后端存储驱动程序。有关详细信息,请参阅存储供应商驱动程序文档。
快照的克隆应该总是产生一个可写的VDI。
vdi-unlock
Xe vdi-unlock uuid= uid_of_vdi_to_unlock [force=true]
尝试解锁指定的vdi。如果力= true
传递给命令时,它强制执行解锁操作。
vdi-update
Xe vdi-update uuid=uuid
刷新数据库中VDI对象的字段。
VIF的命令
使用vif(虚拟网络接口)的命令。
VIF对象可以使用标准对象列表命令(xe vif-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
VIF参数
vif有以下参数:
uuid
(只读)VIF的唯一标识符/对象引用vm-uuid
(只读)这个VIF所在的虚拟机的唯一标识符/对象引用vm-name-label
(只读)该VIF所在的虚拟机的名称允许的操作
(只读设置参数)在此状态下允许的操作列表当前操作
(只读设置参数)当前在这个VIF上正在进行的操作的列表设备
(只读)该VIF的整数标签,指示创建VIF后端的顺序MAC
(只读)VIF的MAC地址,暴露给虚拟机MTU
(read only) VIF的最大传输单位,以字节为单位。该参数为只读,但可以使用
mtu
键使用其他配置
映射参数。例如,将虚拟网卡上的MTU重置为使用jumbo帧:Xe vif-param-set \ uuid=
\ other-config:mtu=9000 currently-attached
(只读)如果设备已连接,则为trueqos_algorithm_type
(读/写)使用的QoS算法qos_algorithm_params
(读写映射参数)所选QoS算法的参数qos_supported_algorithms
(只读设置参数)此VIF支持的QoS算法MAC-autogenerated
(只读)如果VIF的MAC地址是自动生成的,为True其他配置
(读/写映射参数)额外配置键:值
双其他配置:ethtoolrx
(读/写)设置为on为启用接收校验和,off为禁用其他配置:ethtooltx
(读/写)设置为on为启用传输校验和,off为禁用其他配置:ethtoolsg
(读/写)设置为on使分散聚集,关闭禁用其他配置:ethtooltso
(读/写)设置为on为启用TCP分段卸载,off为禁用其他配置:ethtoolufo
(读/写)设置为on开启UDP分片卸载,off关闭其他配置:ethtoolgso
(读/写)设置为on为启用通用分段卸载,off为禁用其他配置:滥交
(读/写)一个VIF在桥上是混杂的,这样它就能看到桥上的所有交通。用于在虚拟机中运行入侵检测系统(IDS)或类似系统。network-uuid
(只读)该VIF所连接的虚拟网络的唯一标识符/对象引用network-name-label
(只读)该VIF所连接的虚拟网络的描述性名称io_read_kbs
(只读)该VIF的平均读取速率,单位为kB/sio_write_kbs
(只读)该VIF的平均写速率,单位为kB/slocking_mode
(读/写)影响VIFs对MAC和IP地址列表的流量过滤能力。需要额外的参数。locking_mode:默认
(读/写)根据VIF网络默认的锁模式不同。如果将默认锁定模式设置为
禁用
Citrix Hypervisor设置了一个过滤规则,使VIF无法接收或发送流量。如果default-lockingmode设置为解锁
, Citrix Hypervisor删除与VIF相关的所有过滤规则。有关更多信息,请参见网络命令.locking_mode:锁定
(读/写)在VIF上只允许从指定的MAC地址和IP地址发送或发送流量。如果不指定IP地址,表示不允许任何流量通过。locking_mode:解锁
(读/写)没有过滤器应用到任何流量去或从VIF。locking_mode:禁用
(读/写)Citrix Hypervisor应用过滤规则,使VIF丢弃所有流量。
vif-create
Xe vif-create vm-uuid=uuid_of_the_vm device=如下所示network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
在虚拟机上创建VIF
的适当值。设备
字段列在参数中allowed-VIF-devices
在指定虚拟机上安装。在存在任何vif之前,允许的值是0-15之间的整数。
的mac
参数为格式中的标准MAC地址aa: bb: cc: dd: ee: ff
.如果不指定,则会创建一个适当的随机MAC地址。也可以通过指定显式设置随机MAC地址mac =随机
.
vif-destroy
vif-destroy uuid= uid_of_vif
销毁一个VIF。
vif-move
Xe vif-move uuid=uuid network-uuid=network_uuid
将VIF移动到另一个网络。
vif-plug
Xe vif-plug uuid=uuid_of_vif
尝试在虚拟机处于运行状态时附加VIF。
vif-unplug
uuid= uid_of_vif
尝试在虚拟机运行时将VIF与虚拟机分离。
vif-configure-ipv4
配置该虚接口的IPv4配置。设置IPv4设置如下:
xe vif- configuration -ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
例如:
VIF。configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
清除IPv4设置如下:
Xe vif- configuration -ipv4 uuid=uuid_of_vif mode=none
vif-configure-ipv6
配置虚拟接口的IPv6配置。设置IPv6设置如下:
xe vif-config -ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
例如:
VIF。configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
清除IPv6设置如下:
Xe vif- configuration -ipv6 uuid=uuid_of_vif mode=none
VLAN的命令
vlan(虚拟网络)相关命令。要列出和编辑虚拟接口,请参考PIF命令,这些命令有一个VLAN参数,表示它们具有关联的虚拟网络。有关更多信息,请参见论坛的命令.例如,要列出vlan,请使用xe pif-list
.
vlan-create
vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
在Citrix Hypervisor服务器上创建VLAN。
pool-vlan-create
Xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
在池中的所有主机上创建VLAN,通过确定哪个接口(例如,eth0
)指定的网络(在每个主机上),并相应地在每个主机上创建和插入一个新的PIF对象。
vlan-destroy
Xe vlan-destroy uuid= uid_of_pif_mapped_to_vlan
销毁VLAN。需要表示VLAN的PIF的UUID。
虚拟机的命令
虚拟机及其属性控制命令。
虚拟机选择器
这里列出的几个命令都有一个通用机制,用于选择要在其上执行操作的一个或多个vm。最简单的方法是提供论证vm = name_or_uuid
.获取实际VM的uid的一种简单方法是执行Xe vm-list power-state=running
.(获取可以通过使用该命令匹配的字段的完整列表Xe vm-list params=all
)。例如,指定电源状态=停止
选择以下虚拟机电源状态
参数等于停止
.当有多个虚拟机匹配时,指定选项——多个
执行操作。本节开头描述了可以匹配的参数的完整列表。
可以使用标准对象列表命令(xe vm-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
虚拟机参数
虚拟机包含以下参数:
注意:
所有可写虚拟机的参数值都可以在虚拟机运行时修改,但新参数不能修改不动态应用,在重启虚拟机之前不能应用。
设备
(读/写)虚拟机所属的appliance/vAppuuid
(只读)虚拟机的唯一标识符/对象引用品牌)
(读/写)虚拟机的名称name-description
(读/写)虚拟机的描述字符串订单启动订单
(读/写)用于vApp启动/关闭和HA故障切换后的启动版本
(只读)该虚拟机恢复的次数。如果要用旧版本覆盖新VM,请调用vm-recover
user-version
(读/写)字符串,供虚拟机和模板的创建者放置版本信息是一个模板
(读/写)False,除非该虚拟机是模板。模板虚拟机永远不会启动,仅用于克隆其他虚拟机。设置为“true”后,不能重置为“false”。该参数不支持模板虚拟机转为虚拟机。is-control-domain
(只读)如果这是控制域(域0或驱动域),则为True。电源状态
(只读)当前电源状态起动延迟
(读/写)在启动VM的调用返回之前等待的延迟shutdown-delay
(读/写)在关闭虚拟机的调用返回之前等待的延迟memory-dynamic-max
(读/写)动态最大字节数memory-dynamic-min
(读/写)以字节为单位的动态最小值memory-static-max
(读/写)静态设置(绝对)最大字节。如果要修改该值,必须先关闭虚拟机。memory-static-min
(读/写)静态设置(绝对)最小字节。如果要修改该值,必须先关闭虚拟机。suspend-VDI-uuid
(只读)存储挂起映像的VDIVCPUs-params
(读写映射参数)所选vCPU策略的配置参数。可以调优vCPU的固定
vcpu -params:mask=1,2,3
选择的虚拟机只能运行在物理cpu 1、2、3上。您还可以使用上限和权重参数调优vCPU优先级(xen调度)。例如:
xe vm-param-set uuid=
vcpu -params:weight=512 xe vm-param-set uuid= vcpu -params:cap=100 在竞争的Citrix Hypervisor服务器上,一个权重为512的虚拟机获得的CPU是一个权重为256的域的两倍。合法权重的取值范围是1 ~ 65535,默认值是256。即使Citrix Hypervisor服务器有空闲的CPU周期,上限也可以选择固定虚拟机能够消耗的最大CPU量。上限表示一个物理CPU的百分比:100表示1个物理CPU, 50表示半个CPU, 400表示4个CPU,以此类推。默认值为0,表示没有上限。
VCPUs-max
(读/写)最大虚拟cpu数。VCPUs-at-startup
(读/写)虚拟cpu的启动数actions-after-crash
虚拟机崩溃时需要执行的(读/写)操作。对于PV客户机,有效参数为:保存
(只供分析)coredump_and_restart
(录制coredump并重启虚拟机)coredump_and_destroy
(记录一个coredump并让VM停止)重新启动
(无coredump,重启虚拟机)摧毁
(没有coredump, VM暂停)
console-uuids
(只读设置参数)虚拟控制台设备平台
(读/写映射参数)平台特定的配置要禁用VDA以将Windows 10切换到Tablet模式:
Xe vm-param-set uuid=
platform:acpi_laptop_slate=0 启用VDA将Windows 10切换到Tablet模式:
Xe vm-param-set uuid=
platform:acpi_laptop_slate=1 查看当前状态。
Xe vm-param-get uuid=
param-name=platform param-key=acpi_laptop_slate 允许的操作
(只读设置参数)该状态下允许的操作列表当前操作
(只读设置参数)虚拟机当前正在进行的操作列表allowed-VBD-devices
(只读设置参数)可用的VBD标识符列表,用0-15范围的整数表示。此列表仅供参考,可能会使用其他设备(但可能无法工作)。allowed-VIF-devices
(只读设置参数)可用的VIF标识符列表,由0-15范围的整数表示。此列表仅供参考,可能会使用其他设备(但可能无法工作)。HVM-boot-policy
(读/写)HVM客户机的启动策略。BIOS Order或空字符串。HVM-boot-params
(读/写映射参数)order键控制HVM客户机引导顺序,用字符串表示,其中每个字符是一种引导方式:d表示CD/DVD, c表示根磁盘,n表示网络PXE引导。默认为dc。HVM-shadow-multiplier
(读/写)浮点值,用于控制授予虚拟机的影子内存开销。默认值为1.0(最小值),只有高级用户才应该更改此值。PV-kernel
(读/写)路径到内核PV-ramdisk
的(读/写)路径initrd
PV-args
(读/写)内核命令行参数字符串PV-legacy-args
(读/写)一串参数,使旧的虚拟机启动PV-bootloader
(读/写)引导加载程序的名称或路径PV-bootloader-args
(读/写)引导加载程序的杂项参数字符串last-boot-CPU-flags
(只读)描述虚拟机上次启动时的CPU标志位居民在
(只读)虚拟机所在的Citrix Hypervisor服务器亲和力
(读/写)虚拟机优先选择在其上运行的Citrix Hypervisor服务器。由xe vm-start
命令,以决定在何处运行虚拟机其他配置
(读/写映射参数)键/值对列表,为虚拟机指定额外的配置参数。例如,主机启动后虚拟机自动启动其他配置
参数包括键值对auto_poweron:真
启动时间
(只读)读取VM指标的日期和时间戳。这个时间戳的形式是yyyymmddThh: mm: ss z
,其中z是单个字母的军事时区指示符,例如,z代表UTC (GMT)。安装时
(只读)读取VM指标的日期和时间戳。这个时间戳的形式是yyyymmddThh: mm: ss z
,其中z是单个字母的军事时区指示符,例如,z代表UTC (GMT)。memory-actual
(只读)虚拟机实际使用的内存VCPUs-number
(只读)Linux虚拟机分配的虚拟cpu数量。这个数字可以不同于VCPUS-max
可以在不重启虚拟机的情况下使用vm-vcpu-hotplug
命令。有关更多信息,请参见vm-vcpu-hotplug
.Windows虚拟机总是在vcpu数量设置为的情况下运行VCPUsmax
并且必须重新启动才能更改此值。当你设置时,性能急剧下降VCPUs-number
设置为大于Citrix Hypervisor服务器物理cpu个数的值。VCPUs-Utilization
(只读映射参数)虚拟cpu及其权重的列表操作系统版本
(只读映射参数)虚拟机操作系统版本PV-drivers-version
(只读映射参数)虚拟机的半虚拟化驱动版本PV-drivers-detected
虚拟机最新版本的半虚拟化驱动程序(只读)标志内存
(只读映射参数)代理在虚拟机上报告的内存指标磁盘
(只读映射参数)代理在虚拟机上上报的磁盘指标网络
(只读映射参数)虚拟机上代理上报的网络指标其他
(只读映射参数)代理在虚拟机上报告的其他指标guest-metrics-lastupdated
(只读)guest代理执行最后一次写入这些字段的时间戳。时间戳的形式如下yyyymmddThh: mm: ss z
,其中z是单个字母的军事时区指示符,例如,z代表UTC (GMT)。actions-after-shutdown
虚拟机关机后需要执行的(读/写)操作actions-after-reboot
虚拟机重启后需要执行的读/写操作possible-hosts
该虚拟机的潜在主机只读dom-id
(只读)域ID(如果可用,则为-1)建议
(只读)该虚拟机属性推荐值和范围的XML规范xenstore-data
(读/写映射参数)要插入的数据xenstore
树(/地方/域/ * domid * /虚拟机数据
)都只能
(只读)该虚拟机为快照时为Truesnapshot_of
(只读)该快照所在虚拟机的UUID快照
(只读)该虚拟机所有快照的uuidsnapshot_time
(只读)创建该虚拟机快照的快照操作的时间戳memory-target
(只读)为该虚拟机设置的目标内存量blocked-operations
(读写映射参数)列出了该虚拟机不能执行的操作last-boot-record
(只读)这个模板的最后一个引导参数的记录,XML格式ha-always-run
(读/写)如果该虚拟机在其所在主机故障时总是在另一台主机上重启,则为True。该参数现在已弃用。使用ha-restart-priority
参数。ha-restart-priority
(读/写)重启或best-effort斑点
(只读)二进制数据存储生活
(只读)虚拟机处于运行状态时为True。如果HA怀疑虚拟机未运行,则为False。
vm-assert-can-be-recovered
Xe vm-assert-can-be-recover uuid [database] vdi-uuid
测试是否有可用的存储来恢复此虚拟机。
vm-call-plugin
Xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
使用可选参数(args:key=value)在给定VM上调用插件中的函数。要传递包含特殊字符的"value"字符串(例如new line),可以使用另一种语法args:key:file=local_file,其中将检索local_file的内容并将其作为一个整体分配给"key"。
vm-cd-add
Xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value…]) < !——NeedCopy >
向所选虚拟机添加新的虚拟CD。的设备
参数的值中选择allowed-VBD-devices
参数。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-cd-eject
Xe vm-cd-eject [vm-selector=vm_selector_value…]) < !——NeedCopy >
从虚拟光驱中弹出光盘。该命令仅在虚拟机挂载了一张CD的情况下有效。当有两个或更多的cd时,使用该命令xe vbd-eject
并指定VBD的UUID。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-cd-insert
Xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value…]) < !——NeedCopy >
将CD插入虚拟光驱。该命令仅在虚拟机中只有一个空CD设备时有效。当有两个或多个空CD设备时,使用xe vbd-insert
命令,并指定要插入的VBD和VDI的uuid。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-cd-list
Xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value…]) < !——NeedCopy >
列出指定虚拟机挂载的cd列表。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
您还可以选择列出哪些VBD和VDI参数。
vm-cd-remove
Xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value…]) < !——NeedCopy >
从指定的虚拟机中移除虚拟光盘。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-checkpoint
Xe vm-checkpoint new-name-label=name_label [new-name-description=description]
检查点现有的虚拟机,在可用的情况下使用存储级快速磁盘快照操作。
vm-clone
Xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value…]) < !——NeedCopy >
克隆现有的虚拟机,在可用的情况下使用存储级快速磁盘克隆操作。指定克隆结果虚拟机的名称和可选描述new-name-label
和new-name-description
参数。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-compute-maximum-memory
xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vcpu ?]真|假][vm_selector = vm_selector_value……) < !——NeedCopy >
以物理内存总量为上限,计算可分配给现有虚拟机的最大静态内存量。可选参数近似
在计算时预留足够的额外内存,以便后续为虚拟机增加额外的vcpu。
例如:
Xe vm-compute-maximum-memory vm=testvm total= ' Xe host-list params=memory-free——minimal '
该命令使用空闲内存
的返回参数。xe主机列表
命令,设置虚拟机的最大内存testvm
.
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-compute-memory-overhead
Xe vm-compute-memory-overhead
计算虚拟机的虚拟化内存开销。
vm-copy
Xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value…]) < !——NeedCopy >
复制现有的虚拟机,但不使用存储级快速磁盘克隆操作(即使有此选项)。拷贝后的虚拟机磁盘映像必须为完整的图片也就是说,它不是写时复制(CoW)链的一部分。
指定结果复制的虚拟机的名称和可选描述new-name-label
和new-name-description
参数。
为最终复制的虚拟机指定目标SRsr-uuid
.如果不指定此参数,则表示目的地与原虚拟机所在的SR相同。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-copy-bios-strings
Xe vm-copy-bios-strings host-uuid=host_uuid
将指定主机的BIOS字符串拷贝到虚拟机中。
注意:
虚拟机首次启动后,不支持修改BIOS字符串。第一次启动虚拟机时,请确保BIOS的字符串设置正确。
vm-crashdump-list
Xe vm-crashdump-list [vm-selector=vm选择器value…]) < !——NeedCopy >
列出与指定虚拟机关联的崩溃转储。
当你使用可选参数时参数个数
, params的值是一个字符串,其中包含要显示的该对象的参数列表。或者,您可以使用关键字所有
显示所有参数。如果参数个数
,则返回的列表显示所有可用参数的默认子集。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-data-source-list
Xe vm-data-source-list [vm-selector=vm选择器值…]) < !——NeedCopy >
列出虚拟机可记录的数据源。
通过标准选择机制,选择需要执行该操作的虚拟机。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数,则对所有虚拟机执行该操作。
数据源有两个参数-标准
和启用
-您可以在该命令的输出中看到。如果数据源具有启用
设置为真正的
,这些指标当前被记录到性能数据库中。如果数据源具有标准
设置为真正的
默认情况下,度量被记录到性能数据库中启用
也被设置为真正的
对于此数据源)。如果数据源具有标准
设置为假
,指标是不默认情况下记录到性能数据库(和启用
也被设置为假
对于此数据源)。
要开始将数据源指标记录到性能数据库,请运行vm-data-source-record
命令。这个命令设置启用
来真正的
.停止,运行vm-data-source-forget
.这个命令设置启用
来假
.
vm-data-source-record
Xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm选择器value…]) < !——NeedCopy >
记录虚拟机指定的数据源。
通过该操作,可以将数据源中的信息写入指定虚拟机的持久性能指标数据库。出于性能原因,该数据库不同于普通的代理数据库。
通过标准选择机制,选择需要执行该操作的虚拟机。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数,则对所有虚拟机执行该操作。
vm-data-source-forget
Xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value…]) < !——NeedCopy >
停止对虚拟机指定数据源的记录,并忘记记录的所有数据。
通过标准选择机制,选择需要执行该操作的虚拟机。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数,则对所有虚拟机执行该操作。
vm-data-source-query
vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value…]) < !——NeedCopy >
显示虚拟机的指定数据源。
通过标准选择机制,选择需要执行该操作的虚拟机。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数,则对所有虚拟机执行该操作。
vm-destroy
Xe vm-destroy uuid=uuid_of_vm
销毁指定虚拟机。这将保留与虚拟机关联的存储。也可以删除存储,使用xe vm-uninstall
.
vm-disk-add
Xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value…]) < !——NeedCopy >
为指定虚拟机添加磁盘。选择设备
参数的值allowed-VBD-devices
参数。
的磁盘容量
参数可以以字节为单位或使用IEC标准后缀KiB、MiB、GiB和TiB来指定。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-disk-list
Xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value…]) < !——NeedCopy >
列出指定虚拟机绑定的磁盘列表。的vbd-params
和vdi-params
参数控制要输出的各个对象的字段。以逗号分隔的列表或特殊键的形式给出参数所有
查看完整的列表。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-disk-remove
Xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value…]) < !——NeedCopy >
将磁盘从指定虚拟机中移除并销毁。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-export
Xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value…]) < !——NeedCopy >
将指定的虚拟机(包括磁盘镜像)导出为本地文件。指定导出虚拟机的文件名文件名
参数。按照惯例,文件名应该有.xva
扩展。
如果元数据
参数是真正的
,则不导出磁盘。输出文件中只写入虚拟机元数据。当底层存储通过其他方式传输时,允许重新创建虚拟机信息。有关更多信息,请参见vm-import
.
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-import
Xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
通过之前导出的文件导入虚拟机。如果保存
设为真正的
,则保留原虚拟机的MAC地址。的sr-uuid
确定导入虚拟机的目的SR。如果不指定,则使用缺省SR。
如果元数据
是真正的
,您可以导入之前导出的一组元数据,而不需要它们关联的磁盘块。如果找不到任何vdi(由SR和VDI.location
),除非——力
选项,在这种情况下,导入将继续进行。如果磁盘可以镜像或带外移动,则元数据导入/导出是在不连接的池之间快速移动虚拟机的一种方式。例如,作为灾难恢复计划的一部分。
注意:
多个虚拟机的导入以串行方式执行比并行方式更快。
vm-install
Xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-string -from=host_uuid]
使用模板安装或克隆虚拟机。指定模板名称template-uuid
或模板
论点。指定一个SRsr-uuid
或sr-name-label
论点。指定安装bios锁定介质copy-bios-strings-from
论点。
注意:
当从具有现有磁盘的模板安装时,默认情况下,将在与这些现有磁盘相同的SR中创建新磁盘。在SR支持的地方,这些磁盘是快速复制。如果在命令行上指定了不同的SR,则会在那里创建新磁盘。在这种情况下,快速复制是不可能的,磁盘是完整的副本。
当从没有现有磁盘的模板安装时,任何新磁盘都将在指定的SR中创建,或者在未指定SR时在池默认SR中创建。
vm-is-bios-customized
Xe vm-is-bios-customized
显示虚拟机BIOS字符串是否定制过。
vm-memory-balloon
Xe vm-memory-balloon target=target
当虚拟机处于运行状态时,设置内存目标。该值必须在虚拟机的memory_dynamic_min和memory_dynamic_max设置的范围内。
vm-memory-dynamic-range-set
Xe vm-memory-dynamic-range-set min=min max=max
设置虚拟机动态内存范围动态内存范围定义了虚拟机内存的软上下限。可以在虚拟机运行或停止时更改这些字段。动态范围必须与静态范围相匹配。
vm-memory-limits-set
Xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
设置虚拟机内存限制
vm-memory-set
Xe vm-memory-set memory=memory
配置虚拟机内存分配
vm-memory-shadow-multiplier-set
Xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value…][multiplier=float_memory_multiplier]
设置虚拟机的影子内存乘数。
这是一个高级选项,可以修改的数量影子内存分配给硬件辅助的虚拟机。
在一些特殊的应用程序工作负载中,例如Citrix Virtual Apps,需要额外的影子内存来实现完整的性能。
这种内存被认为是一种开销。它与正常的内存计算分离,用于计算虚拟机的内存。当调用此命令时,空闲主机内存量会根据乘数和HVM_shadow_multiplier
字段更新为Xen分配给虚拟机的值。如果没有足够的Citrix Hypervisor服务器可用内存,则返回错误。
通过标准选择机制选择需要执行该操作的虚拟机。有关更多信息,请参见虚拟机选择器.
vm-memory-static-range-set
vm-memory-static-range-set min=min max=max
设置虚拟机静态内存范围静态内存范围定义了虚拟机内存的硬性上下限。只有当虚拟机停止时才可以更改这些字段。静态范围必须包含动态范围。
vm-memory-target-set
Xe vm-memory-target-set target=target
该任务指导管理员对已停止或运行中的虚拟机设置内存目标。该值必须在虚拟机的“memory_static_min”和“memory_static_max”的取值范围内。
vm-memory-target-wait
Xe vm-memory-target-wait
等待运行中的虚拟机到达当前内存目标。
vm-migrate
Xe vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value…][remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid][vif:=vif_uuid] [vdi=vdi_uuid]
在物理主机之间迁移指定的虚拟机。的宿主
参数为Citrix Hypervisor服务器的名称或UUID。例如,将虚拟机迁移到存储池中的其他主机,且虚拟机磁盘所在的存储为两个主机共享的存储。
Xe vm-migrate uuid=vm_uuid host-uuid=host_uuid
在同一池中不共享存储的主机间移动虚拟机(存储热迁移):
Xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 \ remote-username=username remote-password=password \ host-uuid=desination_host_uuid vdi=vdi_uuid
您可以选择每个VDI存储的SR:
Xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \ vdi1:vdi_1_uuid=destination_sr_uuid \ vdi2:vdi_2_uuid=destination_sr2_uuid \ vdi3:vdi_3_uuid=destination_sr3_uuid
此外,您还可以选择迁移后绑定虚拟机的网络:
Xe vm-migrate uuid=vm_uuid \ vdi1:vdi_1_uuid=destination_sr_uuid \ vdi2:vdi_2_uuid=destination_sr2_uuid \ vdi3:vdi_3_uuid=destination_sr3_uuid \ vif:vif_uuid=network_uuid
跨池迁移:
Xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 remote-username=username remote-password=password \ host-uuid=desination_host_uuid vdi=vdi_uuid
有关存储热迁移、热迁移和VDI热迁移的详细信息,请参见迁移虚拟机.
默认情况下,虚拟机挂起、迁移、恢复到另一台主机。的生活
参数选择热迁移。实时迁移在执行迁移时保持虚拟机运行,从而将虚拟机停机时间降至1秒以内。在某些情况下,例如虚拟机的内存负载非常大的情况下,热迁移会恢复到默认模式,在完成内存迁移之前会暂停虚拟机一小段时间。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-pause
Xe vm-pause
暂停运行中的虚拟机。注意,此操作不会释放关联的内存(参见vm-suspend
).
vm-query-services
Xe vm-query-services
查询指定虚拟机提供的系统服务。
vm-reboot
Xe vm-reboot [vm-selector=vm_selector_value…][force=true]
重启指定虚拟机。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
使用力
参数导致不正常的重新启动。其中关闭类似于拔掉物理服务器上的插头。
vm-recover
Xe vm-recover vm-uuid [database] [vdi-uuid] [force]
从提供的VDI中包含的数据库中恢复虚拟机。
vm-reset-powerstate
Xe vm-reset-powerstate [vm-selector=vm_selector_value…]{force=true}
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
这是一个先进的该命令仅在池中的成员主机故障时使用。该命令用于强制pool master重置待启动的虚拟机的上电状态停止
.从本质上讲,该命令强制锁定虚拟机及其磁盘,以便在另一个池主机上启动它。这叫需要要指定的强制标志,如果不在命令行上则失败。
vm-resume
Xe vm-resume [vm-selector=vm_selector_value…][force=true|false] [on=host_uuid]
恢复指定虚拟机。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
如果虚拟机位于主机池中的共享SR,则使用在
参数指定在哪个池成员上启动它。默认情况下,系统确定一个适当的主机,它可以是池中的任何成员。
vm-retrieve-wlb-recommendations
vm-retrieve-wlb-recommendations
检索所选VM的工作负载平衡建议。
vm-shutdown
Xe vm-shutdown [vm-selector=vm_selector_value…][force=true|false]
关闭指定虚拟机。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
使用力
参数导致不正常的关闭,类似于拔掉物理服务器上的插头。
vm-snapshot
Xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
快照已存在的虚拟机,使用存储级快速磁盘快照操作。
vm-start
Xe vm-start [vm-selector=vm_selector_value…][force=true|false] [on=host_uuid][——multiple]
启动指定虚拟机。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
如果虚拟机位于主机池中的共享SR,则使用在
参数指定要在哪个池成员上启动虚拟机。默认情况下,系统确定一个适当的主机,它可以是池中的任何成员。
vm-suspend
Xe vm-suspend [vm-selector=vm_selector_value…]) < !——NeedCopy >
暂停指定虚拟机。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-uninstall
Xe vm-uninstall [vm-selector=vm_selector_value…][force=true|false]
卸载虚拟机时,除了元数据记录外,还会销毁该虚拟机的磁盘(即标记为RW且仅与该虚拟机连接的vdi)。若要仅销毁VM元数据,请使用xe vm-destroy
.
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
vm-unpause
Xe vm-unpause
取消暂停虚拟机。
vm-vcpu-hotplug
Xe vm-vcpu-hotplug new-vcpus=new_vcpu_count [vm-selector=vm_selector_value…]) < !——NeedCopy >
该任务指导软件调测工程师动态调整Linux虚拟机的vcpu数量。vcpu的个数受参数限制VCPUs-max
.Windows虚拟机总是在vcpu数量设置为的情况下运行VCPUs-max
并且必须重新启动才能更改此值。
执行该操作的Linux虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.可选参数可以是任意数量的虚拟机参数列在本节的开头。
注意:
对于未安装Citrix VM Tools的Linux虚拟机,请在虚拟机as
根
确保新热插拔的vcpu被使用;# for I /sys/devices/system/cpu/cpu[1-9]*/online;执行if ["$(cat $i)"= 0];然后echo 1 > $i;fi;完成
vm-vif-list
Xe vm-vif-list [vm-selector=vm_selector_value…]) < !——NeedCopy >
列出指定虚拟机中的vif。
执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息,请参见虚拟机选择器.选择器在过滤时对VM记录进行操作,以及不在VIF值上。可选参数可以是任意数量的虚拟机参数列在本节的开头。
将快照
虚拟机定时快照及其属性控制命令。
的虚拟机
可以使用标准对象列表命令(xe vmss-list
),以及使用标准参数命令操作的参数。有关更多信息,请参见低级参数命令
vmss-create
xe vmss-create enabled=True/False name-label=name type=type frequency=frequency reserved -snapshots=value name-description=description schedule:schedule
在资源池中创建快照时刻表。
例如:
Xe vmss-create retain -snapshots=9 enabled=true frequency=daily \ name-description=sample name-label=samplepolicy type=snapshot \ schedule:hour=10 schedule:min=30
快照时刻表包含以下参数:
参数名称 | 描述 | 类型 |
---|---|---|
品牌) |
快照时刻表的名称。 | 读/写 |
name-description |
快照时刻表的描述信息。 | 读/写 |
类型 |
磁盘快照或内存快照。 | 读/写 |
频率 |
每小时;每日的;每周 | 读/写 |
retained-snapshots |
需要保留的快照。范围:1 - 10。 | 读/写 |
时间表 |
时间表:天 (星期一至星期日);时间表:小时 (0 ~ 23);时间表:分钟 (0,15,30,45) |
读/写 |
vmss-destroy
vmss-destroy uuid=uuid
销毁池中的快照时刻表。
USB透传
USB直通启用/禁用
Xe pusb-param-set uuid=pusb_uuid passthroughenabled =true/false
启用/禁用USB直通。
pusb-scan
Xe pus_scan主机uuid=host_uuid
扫描PUSB并更新。
vusb-create
Xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
在资源池中创建虚拟USB。启动虚拟机,通过USB连接到虚拟机。
vusb-unplug
vusb_uuid
拔掉虚拟机的USB插头。
vusb-destroy
vusb_uuid
从虚拟机中移除虚拟USB列表。