GeekIt

oVirt命令速查

引擎服务与配置、engine-backup、ovirt-shell、REST API、Hosted Engine、vdsm-client 与认证管理等 153 条命令

共 153 条命令 · 11 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
systemctl status ovirt-engine查看引擎服务状态,排障第一步
systemctl restart ovirt-engine重启引擎,改配置后常用,中断几分钟
engine-setup交互式安装或重新配置引擎
engine-setup --accept-defaults接受默认值快速跑完,适合实验环境
dnf update ovirt-engine-setup升级引擎与依赖包
rpm -q ovirt-engine查看引擎版本,升级前后都要核对
journalctl -u ovirt-engine -n 200看引擎启动日志中的异常
tail -f /var/log/ovirt-engine/engine.log业务操作的主日志,报错会带请求 ID
tail -f /var/log/ovirt-engine/server.log服务端启动与线程异常
ls /var/log/ovirt-engine/日志目录一览,含 aaa、notifier、dwh
systemctl status ovirt-engine-dwhd数据仓库服务状态,报表异常时看它
ls /etc/ovirt-engine/引擎配置目录,改文件前先备份
ovirt-engine --version部分版本支持,更稳的是 rpm -q
防火墙需放行 443 与 61006100 是主机与引擎通信端口,别只开 443
命令 / 片段说明复制
engine-config -l列出全部可配置键
engine-config -g SomeKey查询单个配置项当前值
engine-config -s SomeKey=value修改配置项,部分需要重启才生效
engine-config -s SomeKey=value --cver=4.5指定集群兼容版本,键值按版本区分
engine-config -g SomeKey --cver=4.5先确认该版本的值再改,避免改错版本
engine-config -l | grep -i timeout按关键字找配置项
改完执行 systemctl restart ovirt-engine绝大多数键需要重启引擎才生效
engine-config 修改前先 -g 记录原值回滚时不必凭记忆
常见项:MaxNumOfVmCpusPerArch限制单虚拟机最大 vCPU
常见项:MaxNumOfHostThreads限制主机线程数
常见项:UserSessionTimeOutInterval登录会话超时时间(分钟)
配置项属引擎级,不随集群单独生效要么全局改,要么用调度策略间接控制
命令 / 片段说明复制
engine-backup --mode=backup --scope=all --file=/backup/engine.bak --log=/backup/engine.log全量备份:引擎数据库、配置与数据仓库
engine-backup --mode=backup --scope=db --file=/backup/db.bak --log=/backup/db.log只备份数据库,速度快
engine-backup --mode=verify --file=/backup/engine.bak校验备份可读,避免备份无效
engine-backup --mode=restore --file=/backup/engine.bak --log=/backup/restore.log --provision-db --restore-permissions恢复引擎,需先停引擎服务
systemctl stop ovirt-engine恢复前必须停服务,否则数据库占用
engine-setup --restore-from-file=/backup/engine.bak安装时直接恢复,适合重建引擎
engine-backup --mode=backup --scope=dwhdb --file=/backup/dwh.bak单独备份数据仓库
engine-backup --help查看全部 scope 与选项
备份文件建议异地保存引擎数据库丢失意味着整个虚拟化平台配置丢失
恢复后验证主机与存储域状态数据库旧会与真实状态不一致,需要手动对齐
备份前记录引擎版本跨版本恢复限制多,版本必须匹配
命令 / 片段说明复制
dnf install ovirt-engine-cli安装 ovirt-shell 客户端
ovirt-shell -c交互式连接引擎,需输入 URL 与凭据
ovirt-shell -l "https://engine.example.com/ovirt-engine/api" -u admin@internal -A直接连接,-A 提示输入密码
helpshell 内查看可用命令
help list查看某条命令的用法
list列出可操作的资源类型
exit退出 shell
ovirt-shell 用 --format json 输出便于配合 jq 做脚本处理
非交互执行单条命令echo "list vms" | ovirt-shell -l https://... -u ... -A
用户名必须带域admin@internal 是本地域,LDAP 用户写 user@domain
证书不受信时加 --insecure生产建议导入 CA 而不是跳过校验
命令 / 片段说明复制
list vms列出虚拟机与状态
list hosts列出主机与状态
list clusters列出集群
list datacenters列出数据中心
list storagedomains列出存储域与可用状态
list disks列出磁盘
list networks列出逻辑网络
list vnicprofiles列出虚拟网卡配置集
list templates列出模板
show vm web01查看虚拟机详情
add vm --name web01 --cluster-name Default --template-name Blank --memory 2GiB创建虚拟机,内存单位别写错
update vm web01 --memory 4GiB修改配置
remove vm web01删除虚拟机
action vm web01 start启动虚拟机
action vm web01 shutdown优雅关机
action vm web01 stop强制停止
action vm web01 suspend挂起
add disk --name data1 --size 50GiB --format cow --storage-domain-name data创建磁盘,cow 即精简置备
add nic --vm-name web01 --network-name ovirtmgmt给虚拟机加网卡
add vnicprofile --name v100 --network-name net100创建网卡配置集,配合 VLAN 使用
list events查看引擎事件,定位操作失败原因
list job查看异步任务进度
命令 / 片段说明复制
curl -k -u admin@internal:pass https://engine.example.com/ovirt-engine/api访问 API 根,确认连通与认证
curl -k -u admin@internal:pass https://engine.example.com/ovirt-engine/api/vms列出虚拟机(默认 XML)
curl -k -u admin@internal:pass -H "Accept: application/json" https://engine.example.com/ovirt-engine/api/vms要求 JSON 输出,配合 jq 解析
curl -k -u admin@internal:pass -H "Accept: application/json" "https://engine.example.com/ovirt-engine/api/vms?search=name%3Dweb01"按名称搜索,注意 URL 编码
curl -k -u admin@internal:pass -X POST -H "Content-Type: application/json" -d @vm.json https://engine.example.com/ovirt-engine/api/vms创建虚拟机
curl -k -u admin@internal:pass -X POST https://engine.example.com/ovirt-engine/api/vms/<id>/start启动虚拟机,动作类接口用 POST
curl -k -u admin@internal:pass -X POST https://engine.example.com/ovirt-engine/api/vms/<id>/shutdown优雅关机
curl -k -u admin@internal:pass -X POST https://engine.example.com/ovirt-engine/api/vms/<id>/stop强制停止
curl -k -u admin@internal:pass -X DELETE https://engine.example.com/ovirt-engine/api/vms/<id>删除虚拟机
curl -k -u admin@internal:pass https://engine.example.com/ovirt-engine/api/hosts列出主机
curl -k -u admin@internal:pass https://engine.example.com/ovirt-engine/api/storagedomains列出存储域
curl -k -u admin@internal:pass ... | jq ".vm[].name"JSON 配合 jq 提取字段,做自动化
API 返回 202 表示异步任务需要轮询任务或事件确认结果
生产环境应导入 CA 而非用 -k-k 跳过证书校验只适合临时排查
命令 / 片段说明复制
hosted-engine --deploy部署自托管引擎,交互式引导
hosted-engine --deploy --restore-from-file=/backup/engine.bak基于备份重建自托管引擎
hosted-engine --vm-status查看引擎虚拟机状态与所在主机
hosted-engine --vm-status --jsonJSON 输出,脚本判断用
hosted-engine --check-liveliness检查 HA 代理存活状态
hosted-engine --set-maintenance --mode=global全局维护模式,所有主机暂停 HA 迁移
hosted-engine --set-maintenance --mode=local仅本机维护,引擎可能被迁到别处
hosted-engine --set-maintenance --mode=none退出维护模式
hosted-engine --add-console-password设置引擎虚拟机控制台密码
hosted-engine --vm-start手动启动引擎虚拟机
hosted-engine --vm-shutdown手动关闭引擎虚拟机
hosted-engine --upgrade-backup升级前备份,自托管场景专用
维护顺序:global 维护 → 操作 → none跳过维护模式容易触发意外迁移
自托管引擎故障先看 ha-agent 日志/var/log/ovirt-hosted-engine-ha/ 下
命令 / 片段说明复制
vdsm-client Host getStats查看主机 CPU、内存与负载统计
vdsm-client Host getCapabilities查看主机能力:网络、存储、CPU 特性
vdsm-client Host getAllVmStats查看该主机上全部虚拟机状态
vdsm-client VM list列出虚拟机 ID 与状态
vdsm-client VM getStats --vmID=<id>查看单台虚拟机详细统计
vdsm-client StoragePool getInfo查看存储池信息
vdsm-client Image list列出镜像与卷
vdsm-client Volume getInfo查看卷容量与分配
vdsm-client Host getStorageDomainsList查看主机已连接的存储域
vdsm-client Host setupNetworks通过 vdsm 配置主机网络(参数较多,建议由引擎下发)
vdsm-tool configure --force重新配置 vdsm,升级后异常时使用
vdsm-tool is-configured检查 vdsm 是否已配置
systemctl status vdsmdvdsm 服务状态,主机失联先看它
systemctl status supervdsmd特权守护进程,权限类问题看它
tail -f /var/log/vdsm/vdsm.log主机侧主日志,引擎与主机不一致时对账
vdsm-client 需 root 执行通过 /var/run/vdsm/vdsmd.sock 通信
命令 / 片段说明复制
ovirt-aaa-jdbc-tool user add admin2 --attribute=firstName=Ops本地域新增用户
ovirt-aaa-jdbc-tool user password-reset admin2 --password-change重置密码并要求下次登录修改
ovirt-aaa-jdbc-tool user unlock admin2解锁被锁定的账户
ovirt-aaa-jdbc-tool user show admin2查看用户属性与状态
ovirt-aaa-jdbc-tool user list列出本地域全部用户
ovirt-aaa-jdbc-tool user delete admin2删除用户
ovirt-aaa-jdbc-tool group add ops新增用户组
ovirt-aaa-jdbc-tool group add-members ops --users=admin2把用户加入组,权限按组分配更省事
ovirt-aaa-jdbc-tool group list列出组
ovirt-engine-extension-aaa-ldap-setup配置 LDAP/AD 认证的交互式向导
engine-config -s 相关 AAA 键调整会话、密码策略等认证行为
用户名必须带域后缀admin@internal 与 user@corp.example.com 是不同域
命令 / 片段说明复制
systemctl status ovirt-engine && engine-config -g Key改配置前的健康检查
engine-backup --mode=backup --scope=all --file=/backup/engine-$(date +%F).bak --log=/backup/bak.log变更前标准化备份
engine-config -s Key=value && systemctl restart ovirt-engine改配置并生效的标准两步
curl -k -u admin@internal:pass -H "Accept: application/json" .../vms?search=status%3Dup | jq ".vm[] | {name, id}"批量导出运行中的虚拟机清单
curl -k -u admin@internal:pass -X POST .../vms/<id>/shutdown按清单批量关机,注意加延时与判断
hosted-engine --set-maintenance --mode=global && dnf update && hosted-engine --set-maintenance --mode=none自托管引擎升级流程骨架
ocp/ansible: ovirt_vm 模块大规模编排建议用 Ansible 而不是裸 curl
vdsm-client Host getStats | jq .主机侧快速确认资源与负载
变更窗口前演练一次恢复engine-backup 恢复没验证过就等于没有备份
记录引擎版本与主机版本版本漂移是 oVirt 环境最常见的隐患
命令 / 片段说明复制
401 Unauthorized用户名或域写错,本地域是 admin@internal
Engine service not running引擎未启动,systemctl start ovirt-engine
PKIX path building failed证书不受信,导入 CA 或临时加 -k
host is not up / host is non-operational主机与引擎通信异常,看 vdsm.log 与 6100 端口
Storage domain is not active存储域不可用,检查主机连接与存储侧
Connection refused to /var/run/vdsm/vdsmd.sockvdsm 未运行或无权限,root 执行
user is locked多次密码错误被锁,ovirt-aaa-jdbc-tool user unlock
engine-config 改完不生效大多数键需要重启引擎
engine-backup 报缺少 pg_dump装 postgresql 客户端或在本机执行
hosted-engine 部署卡在存储检查NFS/FC 连通性、权限与路径都要确认
SPM 冲突导致操作失败等待 SPM 选举稳定,或检查存储锁
迁移失败提示 CPU 不兼容统一集群 CPU 类型或改用 manual migration policy
虚拟机启动报镜像不可用卷链断裂或存储域未激活
操作一直 pendinglist job 与 list events 看阻塞原因
API 返回 202 但资源没变化异步任务可能失败,需查 events
LDAP 用户登录失败检查 aaa 日志与域后缀大小写
引擎重启后主机全部 non-operational多为证书或时间不同步,先校时再重连

运维常用组合

引擎巡检systemctl status ovirt-engine → curl -k -u admin@internal:pass .../vms?search=status%3Dup → curl .../hosts → curl .../storagedomains
变更前备份engine-backup --mode=backup --scope=all --file=/backup/engine-$(date +%F).bak --log=/backup/bak.log → engine-backup --mode=verify --file=/backup/engine-$(date +%F).bak
调大单机 vCPU 上限engine-config -g MaxNumOfVmCpusPerArch --cver=4.5 → engine-config -s MaxNumOfVmCpusPerArch=64 --cver=4.5 → systemctl restart ovirt-engine
命令行建机ovirt-shell -l https://engine/ovirt-engine/api -u admin@internal -A → add vm --name web01 --cluster-name Default --template-name Blank --memory 2GiB → action vm web01 start
API 批量关机curl .../vms?search=status%3Dup | jq -r ".vm[].id" | while read id; do curl -k -u admin@internal:pass -X POST .../vms/$id/shutdown; sleep 5; done
自托管升级hosted-engine --vm-status → hosted-engine --set-maintenance --mode=global → dnf update → engine-setup → hosted-engine --set-maintenance --mode=none

实战要点

1. 用户名一定带域

admin@internal 是本地域,写错域就会 401,这是最常见的坑

2. 改配置记得重启

engine-config 只改数据库,多数键要重启引擎才生效

3. 备份要定期验证

engine-backup --mode=verify 很快,没验证过的备份不算备份

4. 主机侧先看 vdsm

主机 non-operational 时,/var/log/vdsm/vdsm.log 比引擎日志更直接

5. API 异步要查事件

POST 返回 202 只是受理,真正结果要看 events 或 job

6. 自托管先开维护

Hosted Engine 升级或维护前必须进维护模式,避免引擎被迁移

共 153 条 oVirt 命令 · 示例中的域名、集群与路径请替换为实际环境

关于oVirt命令速查

在线 oVirt 命令速查手册,按引擎服务与环境、engine-config 配置、备份与恢复、ovirt-shell 基础、ovirt-shell 资源操作、REST API 与 curl、Hosted Engine 高可用、vdsm-client 与主机侧、认证与用户管理、实战组合、常见报错与排查等 11 类场景整理 150 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 systemctl status ovirt-engine 与 engine-setup 与 engine-setup --accept-defaults 与 dnf update ovirt-engine-setup 与 /var/log/ovirt-engine 日志、engine-config -l/-g/-s 与 --cver 与改完重启引擎生效、engine-backup --mode=backup/restore/verify 的 --scope=all --file --log --provision-db --restore-permissions 与 engine-setup --restore-from-file 与 dwh 数据仓库备份、ovirt-shell -c/-l 与 --url --user --password 与 list vms/hosts/clusters/datacenters/storagedomains/disks/networks/templates 与 show vm 与 add vm --name --memory --cluster --template 与 update vm 与 remove vm 与 action vm start/stop/shutdown/suspend 与 add disk --size --format --storage-domain 与 add nic --network --vm 与 add vnicprofile、REST API 的 curl -k -u admin@internal 访问 /ovirt-engine/api/vms 与 -H "Accept: application/json" 与 ?search=name%3Dweb01 与 -X POST 创建与 /vms/{id}/start 与 shutdown 动作、hosted-engine --deploy 与 --vm-status 与 --set-maintenance --mode=global/local 与 --check-liveliness 与 --add-console-password 与 --upgrade-backup、vdsm-client Host getStats/getCapabilities/getAllVmStats 与 VM list 与 StoragePool getInfo 与 Image list 与 Volume getInfo 与 Host setupNetworks 与 vdsm-tool configure --force 与 supervdsmd/vdsmd 服务、ovirt-aaa-jdbc-tool user add/password-reset/unlock/show 与 group add/add-members 与 ovirt-engine-extension-aaa-ldap-setup,以及 401 Unauthorized、Engine service not running、PKIX path building failed、host is not up、Storage domain is not active、Connection refused to /var/run/vdsm/vdsmd.sock、user is locked、engine-config 修改不生效、hosted-engine 部署失败、SPM 冲突、engine-backup 缺少 pg_dump 等报错排查。适用于 oVirt 引擎部署与日常巡检、配置项批量调整、引擎数据库备份恢复与迁移、命令行与 API 自动化管理虚拟机、Hosted Engine 高可用运维、主机侧 vdsm 排障与用户权限维护,以及红帽系虚拟化运维与面试复习。

核心能力

  • 涵盖 systemctl status ovirt-engine 与 engine-setup 与 engine-setup --accept-defaults 与 dnf update ovirt-engine-setup 与 /var/log/ovirt-engine 日志、engine-config -l/-g/-s 与 --cver 与改完重启引擎生效、engine-backup --mode=backup/restore/verify 的 --scope=all --file --log --provision-db --restore-permissions 与 engine-setup --restore-from-file 与 dwh 数据仓库备份、ovirt-shell -c/-l 与 --url --user --password 与 list vms/hosts/clusters/datacenters/storagedomains/disks/networks/templates 与 show vm 与 add vm --name --memory --cluster --template 与 update vm 与 remove vm 与 action vm start/stop/shutdown/suspend 与 add disk --size --format --storage-domain 与 add nic --network --vm 与 add vnicprofile、REST API 的 curl -k -u admin@internal 访问 /ovirt-engine/api/vms 与 -H "Accept: application/json" 与 ?search=name%3Dweb01 与 -X POST 创建与 /vms/{id}/start 与 shutdown 动作、hosted-engine --deploy 与 --vm-status 与 --set-maintenance --mode=global/local 与 --check-liveliness 与 --add-console-password 与 --upgrade-backup、vdsm-client Host getStats/getCapabilities/getAllVmStats 与 VM list 与 StoragePool getInfo 与 Image list 与 Volume getInfo 与 Host setupNetworks 与 vdsm-tool configure --force 与 supervdsmd/vdsmd 服务、ovirt-aaa-jdbc-tool user add/password-reset/unlock/show 与 group add/add-members 与 ovirt-engine-extension-aaa-ldap-setup,以及 401 Unauthorized、Engine service not running、PKIX path building failed、host is not up、Storage domain is not active、Connection refused to /var/run/vdsm/vdsmd.sock、user is locked、engine-config 修改不生效、hosted-engine 部署失败、SPM 冲突、engine-backup 缺少 pg_dump 等报错排查

适用场景

适用于 oVirt 引擎部署与日常巡检、配置项批量调整、引擎数据库备份恢复与迁移、命令行与 API 自动化管理虚拟机、Hosted Engine 高可用运维、主机侧 vdsm 排障与用户权限维护,以及红帽系虚拟化运维与面试复习。oVirt命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

oVirt命令速查是免费的吗?需要注册或安装吗?
oVirt命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
oVirt命令速查支持哪些功能?
涵盖 systemctl status ovirt-engine 与 engine-setup 与 engine-setup --accept-defaults 与 dnf update ovirt-engine-setup 与 /var/log/ovirt-engine 日志、engine-config -l/-g/-s 与 --cver 与改完重启引擎生效、engine-backup --mode=backup/restore/verify 的 --scope=all --file --log --provision-db --restore-permissions 与 engine-setup --restore-from-file 与 dwh 数据仓库备份、ovirt-shell -c/-l 与 --url --user --password 与 list vms/hosts/clusters/datacenters/storagedomains/disks/networks/templates 与 show vm 与 add vm --name --memory --cluster --template 与 update vm 与 remove vm 与 action vm start/stop/shutdown/suspend 与 add disk --size --format --storage-domain 与 add nic --network --vm 与 add vnicprofile、REST API 的 curl -k -u admin@internal 访问 /ovirt-engine/api/vms 与 -H "Accept: application/json" 与 ?search=name%3Dweb01 与 -X POST 创建与 /vms/{id}/start 与 shutdown 动作、hosted-engine --deploy 与 --vm-status 与 --set-maintenance --mode=global/local 与 --check-liveliness 与 --add-console-password 与 --upgrade-backup、vdsm-client Host getStats/getCapabilities/getAllVmStats 与 VM list 与 StoragePool getInfo 与 Image list 与 Volume getInfo 与 Host setupNetworks 与 vdsm-tool configure --force 与 supervdsmd/vdsmd 服务、ovirt-aaa-jdbc-tool user add/password-reset/unlock/show 与 group add/add-members 与 ovirt-engine-extension-aaa-ldap-setup,以及 401 Unauthorized、Engine service not running、PKIX path building failed、host is not up、Storage domain is not active、Connection refused to /var/run/vdsm/vdsmd.sock、user is locked、engine-config 修改不生效、hosted-engine 部署失败、SPM 冲突、engine-backup 缺少 pg_dump 等报错排查。
oVirt命令速查适合哪些场景使用?
适用于 oVirt 引擎部署与日常巡检、配置项批量调整、引擎数据库备份恢复与迁移、命令行与 API 自动化管理虚拟机、Hosted Engine 高可用运维、主机侧 vdsm 排障与用户权限维护,以及红帽系虚拟化运维与面试复习。