资源高级设置

概览

管理员可使用高级设置进行资源粒度的特性设置，一经设置，相应资源粒度范围内生效。如不设置则默认使用全局设置的值。更新高级设置无需重启管理节点。

清单

资源高级设置清单（ResourceConfig inventory）

名字	描述	可选的	起始支持版本
name	请参见资源属性		3.4.0
description	请参见资源属性	是	3.4.0
category	类型		3.4.0
value	值	是	3.4.0
createDate	请参见资源属性		3.4.0
groupBy			3.4.0
lastOpDate	请参见资源属性		3.4.0
resourceType	资源类型		3.4.0
resourceUuid			3.4.0
uuid	请参见资源属性		3.4.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.4.0

操作（Operations）

获取资源的资源高级设置(GetResourceConfig)

用户可以使用GetResourceConfig获取资源的资源高级设置。例如：

GetResourceConfig category=host name=test resourceUuid=46597de31eac41539c4e6eda52885769

参数（Parameters）

名字	描述	可选的	起始支持版本
category	设置类型		3.4.0
name	设置名称		3.4.0
resourceUuid	资源UUID		3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.4.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.4.0
timeout		是

获取可配置的资源高级设置(GetResourceBindableConfig)

用户可以使用GetResourceBindableConfig获取可配置的资源高级设置。例如：

GetResourceBindableConfig

参数（Parameters）

名字	描述	可选的	起始支持版本
category	设置类型	是	3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.4.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.4.0
timeout		是

删除资源的资源高级设置(DeleteResourceConfig)

用户可以使用DeleteResourceConfig删除资源的资源高级设置。例如：

DeleteResourceConfig category=host name=test resourceUuid=46597de31eac41539c4e6eda52885769

参数（Parameters）

名字	描述	可选的	起始支持版本
category	设置类型		3.4.0
name	设置名称		3.4.0
resourceUuid	资源UUID		3.4.0
deleteMode		是	3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.4.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.4.0
timeout		是

查询资源高级设置(QueryResourceConfig)

管理员可以使用QueryResourceConfig查询资源高级设置。例如：

QueryResourceConfig

原生域查询（Primitive Fields of Query）

请参见资源高级设置清单（ResourceConfig inventory）。

更新资源高级设置(UpdateResourceConfig)

用户可以使用UpdateResourceConfig更新资源高级设置。例如：

UpdateResourceConfig category=host name=test resourceUuid=435a7c71c82b4b0b971f4674ab346822 value=10

参数（Parameters）

名字	描述	可选的	起始支持版本
category	设置类型		3.4.0
name	设置名称		3.4.0
resourceUuid	资源UUID		3.4.0
value	设置的值		3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.4.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.4.0
timeout		是

标签（Tags）

用户可以使用CreateUserTag resourceType=ResourceConfigVO在用户上创建用户标签。例如：

CreateUserTag resourceType=ResourceConfigVO tag=Test1 \
resourceUuid=3fd25b9e5b87423bba5612a45c1f5ecc

资源高级设置条目

cluster

名字	描述	默认值	可选的参数值
zstack.experimental.repo	用于设置是否对集群启用ZStack Cloud实验源。	false	true false
enable.zeroCopy	用于设置是否开启集群Zero Copy开关。开启后将减少数据在内核态和用户态之间的拷贝次数，降低CPU占用时间，提升虚拟网卡性能。	false	true false

drs

名字	描述	默认值	可选的参数值
drs.enable	用于设置动态资源调度功能是否启用。	false	true false

Host

名字	描述	默认值	可选的参数值
cpu.overProvisioning.ratio	用于控制分配给云主机的虚拟CPU数量。计算公式：物理CPU总线程 X CPU超分率 = 可分配的虚拟CPU数量。	10	1-1000

KVM

名字	描述	默认值	可选的参数值
reservedMemory	所有KVM物理机上保留的内存容量。	1G	>= 0
vm.cpuMode	集群 CPU 架构为 x86_64：用于设置当前集群内云主机的 CPU 类型是否与物理机的 CPU 类型一致。可选模式为：None（默认）、某一特定 CPU 型号、host-model、host-passthrough。选择 None（默认），云主机 CPU 型号将由全局设置"云主机 CPU 模式"决定。选择某一特定 CPU 型号，云主机将统一配置为该 CPU 型号。选择 host-model，云主机 CPU 型号与物理机 CPU 型号一致。选择 host-passthrough，云主机 CPU 型号及特性与物理机 CPU 型号及特性严格一致。 Note: 选择 host-model 模式，可能导致缺失诸多 CPU 扩展功能，例如：扩展页表，大页内存以及虚拟化等。 host-passthrough 模式支持云主机的嵌套虚拟化，但该模式可能导致云主机在不同型号 CPU 的物理机之间迁移失败，还可能导致从云主机内部和从云主机所在物理机查看云主机 CPU 使用率数值不一致。若云主机已单独设置 CPU 模式（非默认 none），此集群设置将不对该云主机生效。若集群已”指定云主机 CPU 型号“（非默认 None），全局设置”云主机 CPU 模式“将不对该集群生效。修改 CPU 模式后，必须重启云主机生效。集群 CPU 架构为 aarch64：仅可选择 host-passthrough，当前集群内云主机 CPU 型号及特性与物理机 CPU 型号及特性严格一致。集群 CPU 架构为 mips64el：仅可选择某一特定 CPU 型号，当前集群内云主机将统一配置为该 CPU 型号。	集群 CPU 架构为 x86_64：None 集群 CPU 架构为 aarch64：host-passthrough 集群 CPU 架构为 mips64el：某一特定 CPU 型号	None 某一特定 CPU 型号 host-model host-passthrough
vm.cpu.hardwareVirtualization	用于控制是否在Windows云主机的CPUID中暴露硬件虚拟化特性，以规避部分Windows场景下暴露vmx/svm导致的兼容性问题。 true：保持默认CPU特性行为。 false：在支持的x86_64 KVM物理机上为Windows云主机屏蔽vmx/svm特性。 Note: 该配置仅影响Windows云主机启动时生成的CPU特性XML，运行中修改需要重启或下次启动后生效；当vm.cpuMode为none时，该配置不会额外修改CPU特性。	false	true false

名字

描述

默认值

可选的参数值

reservedMemory

所有KVM物理机上保留的内存容量。

>= 0

vm.cpuMode

集群 CPU 架构为 x86_64：用于设置当前集群内云主机的 CPU 类型是否与物理机的 CPU 类型一致。可选模式为：None（默认）、某一特定 CPU 型号、host-model、host-passthrough。

选择 None（默认），云主机 CPU 型号将由全局设置"云主机 CPU 模式"决定。
选择某一特定 CPU 型号，云主机将统一配置为该 CPU 型号。
选择 host-model，云主机 CPU 型号与物理机 CPU 型号一致。
选择 host-passthrough，云主机 CPU 型号及特性与物理机 CPU 型号及特性严格一致。

Note:

选择 host-model 模式，可能导致缺失诸多 CPU 扩展功能，例如：扩展页表，大页内存以及虚拟化等。
host-passthrough 模式支持云主机的嵌套虚拟化，但该模式可能导致云主机在不同型号 CPU 的物理机之间迁移失败，还可能导致从云主机内部和从云主机所在物理机查看云主机 CPU 使用率数值不一致。
若云主机已单独设置 CPU 模式（非默认 none），此集群设置将不对该云主机生效。
若集群已”指定云主机 CPU 型号“（非默认 None），全局设置”云主机 CPU 模式“将不对该集群生效。
修改 CPU 模式后，必须重启云主机生效。

集群 CPU 架构为 aarch64：仅可选择 host-passthrough，当前集群内云主机 CPU 型号及特性与物理机 CPU 型号及特性严格一致。

集群 CPU 架构为 mips64el：仅可选择某一特定 CPU 型号，当前集群内云主机将统一配置为该 CPU 型号。

集群 CPU 架构为 x86_64：None
集群 CPU 架构为 aarch64：host-passthrough
集群 CPU 架构为 mips64el：某一特定 CPU 型号

None
某一特定 CPU 型号
host-model
host-passthrough

vm.cpu.hardwareVirtualization

用于控制是否在Windows云主机的CPUID中暴露硬件虚拟化特性，以规避部分Windows场景下暴露vmx/svm导致的兼容性问题。
true：保持默认CPU特性行为。
false：在支持的x86_64 KVM物理机上为Windows云主机屏蔽vmx/svm特性。

Note: 该配置仅影响Windows云主机启动时生成的CPU特性XML，运行中修改需要重启或下次启动后生效；当vm.cpuMode为none时，该配置不会额外修改CPU特性。

false

true
false

localstorage

名字	描述	默认值	可选的参数值
qcow2.allocation	用于设置本地存储中云盘的预分配策略，可选策略为none、metadata、falloc、full，默认为none。	none	none metadata falloc full

nfsPrimaryStorage

名字	描述	默认值	可选的参数值
qcow2.allocation	用于设置NFS存储中云盘的预分配策略，可选策略为none、metadata、falloc、full，默认为none。	none	none metadata falloc full

premiumCluster（Cluster）

名字	描述	默认值	可选的参数值
hugepage.enable	用于设置集群大页功能是否启用。若为true，集群中所有物理机将启用大页（每页为2MB），且将大页空间分配给云主机。 Note: 集群启用大页，前提需确保集群内所有物理机进入维护模式。若打开该开关，需重启物理机生效。若打开该开关后修改了集群内某一物理机内存，需重新打开该开关且重启物理机，使该开关生效。集群启用大页后，若集群内物理机保留内存低于4GB，将自动调整为4GB，并将物理机剩余内存全部分配为大页内存。大页内存只能被云主机使用，请合理设置物理机保留内存，若保留内存过小，会导致物理机系统服务异常，例如在超融合场景下，建议物理机保留内存设置为16GB以上。	false	true false
hugepage.size	集群启用大页后，用于设置集群中所有物理机的每页大小，默认为2MB。	2	>0
network.ovsdpdk	默认为false，用于设置是否对集群启用网络加速支持。	false	true false

sharedblock

名字	描述	默认值	可选的参数值
qcow2.allocation	用于设置SharedBlock存储中云盘的预分配策略，可选策略为none、metadata、falloc、full，默认为none。	none	none metadata
device.allocate.strategy	用于设置云盘和快照在 SharedBlock 主存储 LUN上的落盘策略。可选策略为：none（默认选项）、minLvCounts、maxFreeSize。选择none，在 SharedBlock 主存储上创建云盘或快照时，根据系统调度算法在一个可用容量充足的LUN上落盘。选择minLvCounts，在 SharedBlock 主存储上创建云盘或快照时，在云盘和快照数量总和最少且可用容量充足的 LUN 上落盘。选择maxFreeSize，在 SharedBlock 主存储上创建云盘或快照时，在可用容量最多的 LUN 上落盘。若单独为该 SharedBlock 主存储设置 LUN 分配策略，全局设置将不对该主存储生效。	none	none minLvCounts maxFreeSize

sharedMountPointPrimaryStorage

名字	描述	默认值	可选的参数值
qcow2.allocation	用于设置SharedMountPoint存储中云盘的预分配策略，可选策略为none、metadata、falloc、full，默认为none。	none	none metadata falloc full

System（Mevoco）

名字	描述	默认值	可选的参数值
overProvisioning.memory	用于控制分配给云主机的虚拟内存容量。计算公式：物理内存容量 X 内存超分率 = 可分配的虚拟内存容量。	1.0	>0
overProvisioning.primarystorage	用于控制分配给云主机的虚拟主存储可用空间。计算公式：物理主存储可用空间 X 主存储超分率 = 可分配的虚拟主存储可用空间。	1.0	>0

VmInstance（vm）

名字	描述	默认值	可选的参数值
numa	打开计算规格在线修改选项可支持在线修改云主机的CPU和内存。不建议在生产环境中对Windows云主机在线修改CPU和内存。	false	true false
emulateHyperV	云主机Hyper-V模拟的开启或关闭。	false	true false
kvmHiddenState	云主机KVM虚拟化标记的开启或关闭。若为true，则会在新启动云主机定义XML中对<kvm>插入<hidden state='on'>，若为false则不会。注意：NVIDIA显卡集群需启用该开关。	false	true false
nicMultiQueueNum	用于设置Virtio类型的网卡流量分配给多个CPU时的队列数目，取值范围[1,256]之间的整数。	1	1-256
vm.hyperv.clock.feature	默认为true，用于设置是否开启云主机hypervclock特性。如设置为false，将禁用云主机hypervclock特性。云主机如已开启kvm hidden，需关闭hypervclock特性，避免guest在热迁移后hang住。如关闭hypervclock特性，需重启云主机后生效。	true	true false