################################################################

注意：

1、请先通过兼容性查询工具http://support.huawei.com/onlinetoolsweb/ftca来获取服务器与OS兼容性&部件与OS兼容性，然后使用驱动配套表查询配套关系，查询环境设备驱动是否需要安装或者升级驱动。

2、如源码驱动安装涉及编译依赖和包依赖，请先搭建好源安装环境后安装依赖之后再安装驱动，如gcc、make、tcl和tk等等，
   参考文档：https://forum.huawei.com/enterprise/en/installing-the-software-compilation-environment-via-yum-yast2/thread/411263-895#pid2335931
   
3、华为自主研发的MLNX板卡升级驱动不会同步升级固件，固件需要单独升级。

4、 MLNX驱动需要满足依赖包安装之后再安装驱动，依赖包列表如下：

	1). RHEL/OEL/CentOS: yum install perl pciutils python gcc-gfortran libxml2-python tcsh libnl.i686 libnl expat glib2 tcl libstdc++ bc tk gtk2 atk cairo numactl pkgconfig ethtool lsof
	
	2). SLES12: zypper install pkg-config expat libstdc++6 libglib-2_0-0 lib- gtk-2_0-0 tcl libcairo2 tcsh python bc pciutils libatk-1_0-0 tk python-libxml2 lsof libnl3-200 ethtool lsof
	
	3). SLES15: 
		
		python ethtool libatk-1_0-0 python2-libxml2-python tcsh lib- stdc++6-devel-gcc7 libgtk-2_0-0 tcl libopenssl1_1 libnl3-200 make libcairo2 expat libmnl0 insservcompat pciutils lsof 
		lib- glib-2_0-0 pkg-config tk
	
	4). Ubuntu/Debian: 
	
		apt-get install perl dpkg autotools-dev autoconf libtool auto- make1.10 automake m4 dkms debhelper tcl tcl8.4 chrpath swig graphviz tcl-dev tcl8.4-dev tk-dev tk8.4-dev bison flex \
		dpatch zlib1g-dev curl libcurl4-gnutls-dev python-libxml2 libvirt-bin libvirt0 libnl-dev libglib2.0-dev libgfortran3 automake m4 pkg-config libnuma logrotate ethtool lsof

    5).CentOS 7.6:yum install perl pciutils python gcc-gfortran libxml2-python tcsh libnl.i686 libnl expat glib2 tcl libstdc++ bc tk gtk2 atk cairo numactl pkgconfig ethtool lsof python-devel redhat-rpm-config rpm-build gcc kernel-devel-4.14.0-115.el7a.0.1.aarch64 libtool

5、RAID、MLNX板卡驱动需要重启OS生效，板卡驱动卸载加载操作会影响板卡业务，若当前机器上有业务运行，请停止当前机器运行的业务并脱离服务器集群单独进行驱动升级。

6、请使用管理员权限用户进行驱动维护。

################################################################

1.在OS安装时手动加载iso/img驱动文件

1.1 镜像文件加载方法
	*.iso --- 使用虚拟 CD/DVD
	*.img --- 使用虚拟软盘
	
1.2 场景应用说明：
	1) RAID卡下的硬盘安装系统时需要在安装时加载RAID驱动
	2) SAN Boot启动加载OS FC卡驱动

1.3 镜像文件加载使用指导
	参考操作系统安装指南: https://forum.huawei.com/enterprise/zh/forum.php?mod=viewthread&tid=286397&extra=&page=1

RAID-B80121-openEuler20.03SP3-hiraid-1.0.1.2-aarch64.iso
---1880 B80121 driver

################################################################

2.OS安装完成后安装onboard_driver_XXX.iso里的驱动文件

2.1 使用驱动安装脚本自动安装驱动

	driver.cfg
	---自动安装驱动的配置文件
	install.sh
	---自动安装驱动的shell脚本

	自动安装驱动步骤：
 	1)使用BMC虚拟光驱挂载onboard_driver_xxx.iso:
    2)mount /dev/sr0 /mnt       // 挂载CD-ROM驱动器到目标目录
    3)mkdir /root/driver/	    // 在/root下创建目录
	4)cp -vr  /mnt/*  /root/driver/		//将所有文件复制到新建的目录下
	5)cd /root/driver  //切换到驱动目录
	6)chmod +x install.sh  //给脚本添加可执行权限
	7)./install.sh		//执行自动脚本，说明：1) 输入2查询，输入1安装；2).安装驱动后，请根据自动安装notes信息执行是否要重启OS生效新驱动 //请在OS下执行reboot命令，请不要通过iBMC强制重启OS和强制下电
	
	说明：
	1. 名称以SP、SM或者MZ命名开头的MLNX卡，升级驱动时不会自动升级驱动配套的FW
	2. 名称以“MCX”命名开头的MLNX PCIe卡，，升级驱动时会自动升级驱动配套的FW
    3. MCX4121A-ACAT_C12卡升级驱动时不会自动升级配套的FW

	result.txt
	---自动安装结果记录文件
	说明：FileName为驱动名称，为举例说明，具体打印以实际安装的驱动包替代
	1) "File":"FileName","Result":"success","ErrorInfo":"NA"
		---驱动安装成功
	2) "File":"FileName","Result":"fail","ErrorInfo":"fail_log"
		---驱动安装失败，fail_log为错误信息
	3) "File":"FileName","Result":"success","ErrorInfo":"The driver version has been updated to the target version and there is no need to upgrade the driver."
		---当前驱动版本与目标版本一致，不需要安装驱动
	4) "File":"FileName","Result":"success","ErrorInfo":"unknown file."
		---自动化不支持的驱动文件
	5) "File":"FileName","Result":"success","ErrorInfo":"can not find the installation of driver FileName."
		---自动化支持，但是FileName名称文件实际不存在	

2.2 onboard_driver_xxx.iso驱动文件列表和手动安装驱动指导:

RAID-B80121-openEuler20.03SP3-hiraid-1.0.1.2-aarch64.rpm
---1880 B80121 driver
#说明：请以归档的包名替代xxx.rpm进行实际驱动安装
#升级安装
1. rpm -Uvh xxx.rpm
2. OS下执行reboot
#降级安装
1. rpm -Uvh xxx.rpm --oldpackage
2. OS下执行reboot
