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 与 6100 | 6100 是主机与引擎通信端口,别只开 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 提示输入密码 | |
help | shell 内查看可用命令 | |
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 --json | JSON 输出,脚本判断用 | |
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 vdsmd | vdsm 服务状态,主机失联先看它 | |
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.sock | vdsm 未运行或无权限,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 | |
虚拟机启动报镜像不可用 | 卷链断裂或存储域未激活 | |
操作一直 pending | list 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 .../storagedomainsengine-backup --mode=backup --scope=all --file=/backup/engine-$(date +%F).bak --log=/backup/bak.log → engine-backup --mode=verify --file=/backup/engine-$(date +%F).bakengine-config -g MaxNumOfVmCpusPerArch --cver=4.5 → engine-config -s MaxNumOfVmCpusPerArch=64 --cver=4.5 → systemctl restart ovirt-engineovirt-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 startcurl .../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; donehosted-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 升级或维护前必须进维护模式,避免引擎被迁移
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 排障与用户权限维护,以及红帽系虚拟化运维与面试复习。