> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lwops.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# CMDB安装失败排查

## 安装前 AVX 指令集检查及处理说明

### 一、检查 AVX 指令集

在安装软件前，需要确认当前操作系统是否支持 AVX 指令集。 执行以下命令：

```text theme={null}
lscpu | grep avx
```

正常输出示例

```text theme={null}
Flags: ... sse4_2 avx avx2 ...
```

如果输出内容中包含 avx 或 avx2，表示当前系统已支持 AVX 指令集，可以继续执行安装步骤。

### 二、缺少 AVX 指令集的处理方法

如果执行命令后无任何输出：

```text theme={null}
lscpu | grep avx
```

则表示当前虚拟机未识别到 AVX 指令集。 需要在虚拟化平台上将虚拟机 CPU 配置为 CPU 直通模式（Host Passthrough/Host Model）。 不同虚拟化平台的配置方式如下：

* VMware ESXi：启用 CPU 硬件虚拟化透传，确保虚拟机使用宿主机 CPU 特性。
* KVM/libvirt：CPU 模式设置为 host-passthrough。
* Proxmox VE：CPU Type 设置为 host。
* OpenStack：配置 CPU Passthrough 或 Host Model。

### 三、重启虚拟机

修改 CPU 模式后，需要执行彻底关机操作： 1.关闭虚拟机（Power Off）。 2.重新启动虚拟机（Power On）。 注意：仅执行操作系统重启（reboot）可能无法重新加载 CPU 特性，必须执行彻底关机后再开机。

### 四、重新验证 AVX 指令集

虚拟机启动完成后，再次执行检查命令：

```text theme={null}
lscpu | grep avx
```

确认输出中已经包含：

```text theme={null}
avx
```

或：

```text theme={null}
avx avx2
```

确认 AVX 指令集正常识别后，再继续后续安装操作。

### 五、清理残留文件

执行卸载脚本，清理之前安装失败产生的残留文件：

```text theme={null}
bash uninstall.sh
```

等待脚本执行完成。

### 六、重新执行安装

残留文件清理完成后，执行安装脚本：

```text theme={null}
bash install.sh
```

按照安装程序提示继续完成软件安装。

操作流程总结 检查 AVX ↓ lscpu | grep avx ↓ 是否存在 avx？ ├── 是 → 执行 bash uninstall.sh → 执行 bash install.sh └── 否 → 配置 CPU 直通模式 ↓ 虚拟机彻底关机并重新启动 ↓ 再次执行 lscpu | grep avx ↓ 确认存在 avx 后继续安装