> ## 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.

# 工单安装失败排查

## MariaDB 默认组件清理及重新安装说明

### 一、适用场景

部分 Linux 操作系统（如 CentOS、Rocky Linux、AlmaLinux、OpenEuler 等）可能预装了系统自带的 MariaDB 软件包。如果系统已存在默认安装的 MariaDB，可能会与当前安装程序产生冲突，导致安装失败或服务异常。<br />因此，在执行安装前，需要先卸载系统默认自带的 MariaDB 组件。

### 二、卸载系统默认 MariaDB

1. 卸载 MariaDB 客户端<br />执行以下命令：

```plain theme={null}
yum remove mariadb
```

根据提示输入：

```plain theme={null}
y
```

确认卸载。

2. 卸载 MariaDB 服务端<br />执行以下命令：

```plain theme={null}
yum remove mariadb-server
```

根据提示输入：

```plain theme={null}
y
```

确认卸载。

3.创建新的配置文件

```plain theme={null}
vi /etc/my.cnf.d/mariadb-server.cnf
```

输入i进入编辑模式，然后粘贴下面配置文件

```plain theme={null}
[mysqld]
sql_mode=NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
skip-name-resolve=
lower_case_table_names=1
```

输入esc退出编辑模式，然后输入:wq保存配置文件

### 三、检查是否卸载完成（可选）

执行以下命令确认系统中是否仍存在 MariaDB 软件包：

```plain theme={null}
rpm -qa | grep -i mariadb
```

如果没有任何输出，则表示系统默认 MariaDB 已清理完成。<br />如果仍存在其他 MariaDB 相关组件，可根据实际情况继续执行：

```plain theme={null}
yum remove "mariadb*"
```

或者：<br />`rpm -e --nodeps \<软件包名称>`<br />直至系统中不存在任何 MariaDB 相关软件包。

### 四、清理安装残留文件

完成系统默认 MariaDB 卸载后，执行卸载脚本清理历史安装产生的残留文件：

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

等待脚本执行完成。

### 五、重新执行安装

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

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

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

操作流程总结<br />卸载系统默认 MariaDB<br />↓<br />`yum remove mariadb`<br />↓<br />`yum remove mariadb-server`<br />↓<br />（可选）rpm -qa | grep -i mariadb 检查残留<br />↓<br />`bash uninstall.sh`<br />↓<br />`bash install.sh`<br />↓<br />完成软件安装

### 注意事项

1.卸载 MariaDB 前，请确认业务数据已备份。<br />2.如果服务器已部署生产环境数据库，请先确认当前 MariaDB 是否被业务系统使用。<br />3.建议在全新环境或停止相关业务后执行卸载及重新安装操作。