概览
管理员可使用高级设置进行资源粒度的特性设置,一经设置,相应资源粒度范围内生效。如不设置则默认使用全局设置的值。更新高级设置无需重启管理节点。
清单
资源高级设置清单(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 |
获取资源的资源高级设置(GetResourceConfig)
用户可以使用GetResourceConfig获取资源的资源高级设置。 例如:
GetResourceConfig category=host name=test resourceUuid=46597de31eac41539c4e6eda52885769
参数(Parameters)
获取可配置的资源高级设置(GetResourceBindableConfig)
用户可以使用GetResourceBindableConfig获取可配置的资源高级设置。 例如:
GetResourceBindableConfig
参数(Parameters)
删除资源的资源高级设置(DeleteResourceConfig)
用户可以使用DeleteResourceConfig删除资源的资源高级设置。 例如:
DeleteResourceConfig category=host name=test resourceUuid=46597de31eac41539c4e6eda52885769
参数(Parameters)
更新资源高级设置(UpdateResourceConfig)
用户可以使用UpdateResourceConfig更新资源高级设置。 例如:
UpdateResourceConfig category=host name=test resourceUuid=435a7c71c82b4b0b971f4674ab346822 value=10
参数(Parameters)
标签(Tags)
用户可以使用CreateUserTag resourceType=ResourceConfigVO在用户上创建用户标签。 例如:
CreateUserTag resourceType=ResourceConfigVO tag=Test1 \
resourceUuid=3fd25b9e5b87423bba5612a45c1f5ecc
cluster
| 名字 |
描述 |
默认值 |
可选的参数值 |
| zstack.experimental.repo |
用于设置是否对集群启用ZStack Cloud实验源。 |
false |
|
| enable.zeroCopy |
用于设置是否开启集群Zero Copy开关。开启后将减少数据在内核态和用户态之间的拷贝次数,降低CPU占用时间,提升虚拟网卡性能。 |
false |
|
drs
| 名字 |
描述 |
默认值 |
可选的参数值 |
| drs.enable |
用于设置动态资源调度功能是否启用。 |
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 型号及特性严格一致。
- 选择 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特性。
该配置仅影响Windows云主机启动时生成的CPU特性XML,运行中修改需要重启或下次启动后生效;当vm.cpuMode为none时,该配置不会额外修改CPU特性。
|
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),且将大页空间分配给云主机。
- 集群启用大页,前提需确保集群内所有物理机进入维护模式。
- 若打开该开关,需重启物理机生效。
- 若打开该开关后修改了集群内某一物理机内存,需重新打开该开关且重启物理机,使该开关生效。
- 集群启用大页后,若集群内物理机保留内存低于4GB,将自动调整为4GB,并将物理机剩余内存全部分配为大页内存。
- 大页内存只能被云主机使用,请合理设置物理机保留内存,若保留内存过小,会导致物理机系统服务异常,例如在超融合场景下,建议物理机保留内存设置为16GB以上。
|
false |
|
| hugepage.size |
集群启用大页后,用于设置集群中所有物理机的每页大小,默认为2MB。 |
2 |
0
|
| network.ovsdpdk |
默认为false,用于设置是否对集群启用网络加速支持。 |
false |
|
sharedblock
| 名字 |
描述 |
默认值 |
可选的参数值 |
| qcow2.allocation |
用于设置SharedBlock存储中云盘的预分配策略,可选策略为none、metadata、falloc、full,默认为none。 |
none |
|
| 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 |
|
| emulateHyperV |
云主机Hyper-V模拟的开启或关闭。 |
false |
|
| kvmHiddenState |
云主机KVM虚拟化标记的开启或关闭。若为true,则会在新启动云主机定义XML中对<kvm>插入<hidden state=‘on’>,若为false则不会。注意:NVIDIA显卡集群需启用该开关。 |
false |
|
| nicMultiQueueNum |
用于设置Virtio类型的网卡流量分配给多个CPU时的队列数目,取值范围[1,256]之间的整数。 |
1 |
1-256 |
| vm.hyperv.clock.feature |
默认为true,用于设置是否开启云主机hypervclock特性。如设置为false,将禁用云主机hypervclock特性。云主机如已开启kvm hidden,需关闭hypervclock特性,避免guest在热迁移后hang住。如关闭hypervclock特性,需重启云主机后生效。 |
true |
|