Huawei IN300 FC HBA User Guide 16
Installing the Driver
Prerequisites
- The driver package of the IN300 has been downloaded.
For the package name and download method, see Obtaining Software Packages.
- You have uploaded the driver package to the server OS.
- The IN300 driver has not been installed on the server.
Impacts
The driver installation takes about 30 seconds. The installation process cannot be interrupted. Do not restart the OS during the installation. Otherwise, the OS exceptions such as startup failures may occur.
Installing the Driver in Linux
- Log in to server OS.
For details, see Logging In to the Remote Control Interface of the Server.
- Go to the directory where the new driver package is stored.
- Install the driver package.
- For an RPM package, run the rpm -ivh <driver package name> command to install the driver.Using RHEL as an example:
localhost:~ # rpm -ivh hifc-kmp-default-3.7.0.1_k5.3.18_22-sles.x86_64.rpm Preparing... ################################# [100%] Updating / installing... 1:hifc-kmp-default-3.7.0.1_k5.3.18_################################# [100%]
If the RPM package has no signature, before installing the driver package, perform the following operations:- Run the vim /etc/modprobe.d/10-unsupported-modules.conf command and change the value of allow_unsupported_modules to 1.
vim /etc/modprobe.d/10-unsupported-modules.conf
- Run the rpm -checksig hifc-kmp-default-<version>-<distribution>.<arch>.rpm command to make the certificated driver package take effect.Example:
rpm -checksig hifc-kmp-default-1.4.3.0_k4.4.73_5-100R.4.1.x86_64.rpm hifc-kmp-default-1.4.3.0_k4.4.73_5-100R.4.1.x86_64.rpm: rsa sha1 (md5) pgp md5 OK
- Run the vim /etc/modprobe.d/10-unsupported-modules.conf command and change the value of allow_unsupported_modules to 1.
- For a DEB package, run the dpkg -i <driver package name> command to install the driver.For example, run the following command in the Ubuntu OS:
root@ubuntu1804:~# dpkg -i hifc-1.8.2.3-4.15.0_20_generic.ubuntu.amd64.deb (Reading database ... 65984 files and directories currently installed.) Preparing to unpack hifc-1.8.2.3-4.15.0_20_generic.ubuntu.amd64.deb ... Unpacking hifc (1.8.2.3) ... Setting up hifc (1.8.2.3) ... Installing... Please wait for a moment. Install hifc driver package successfully.
- For an RPM package, run the rpm -ivh <driver package name> command to install the driver.
- Make the driver take effect.
You can use either of the following methods to make the driver take effect. Select one as required.
- Method 1:
Run the reboot command on the OS.
- Method 2:
Run the following commands in the OS:
modprobe hifc
- Method 1:
Installing the Driver in VMware ESXi (VIB)
- Log in to server OS.
For details, see Logging In to the Remote Control Interface of the Server.
- Go to the directory where the new driver package is stored, for example, /tmp.
- Install the driver package.
Run the esxcli software vib install -v hifc-<version>-<kernel_version>.<arch>.vib command.
Enter a complete file path after -v.
Example:
esxcli software vib install -v /tmp/hifc-1.5.0.0-1OEM.650.0.0.4598673.x86_64.vib Installation Result Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective. Reboot Required: true VIBs Installed: Huawei_bootbank_hifc_1.8.2.0-1OEM.600.0.0.2768847 VIBs Removed: VIBs Skipped:
- Run the reboot command to restart VMware ESXi for the driver to take effect.
Installing the Driver in VMware ESXi (ZIP)
- Log in to server OS.
For details, see Logging In to the Remote Control Interface of the Server.
- Go to the directory where the new driver package is stored, for example, /tmp.
- Install the driver package.
Run the esxcli software vib install -d /tmp/*.zip command to install the driver package.
Enter a complete file path after -d.
Example:
[root@localhost:/tmp] esxcli software vib install -d /tmp/VMW-ESX-6.5.0-hifc-3.2.0.17-offline_bundle-17294290.zip Installation Result Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective. Reboot Required: true VIBs Installed: Huawei_bootbank_hifc_3.2.0.17-1OEM.650.0.0.4598673 VIBs Removed: VIBs Skipped:
- Run the reboot command on VMware ESXi to make the driver take effect.
Follow-up Operations
- Run the lsmod | grep hifc command on Linux or vmkload_mod -l | grep hifc command on VMware ESXi to check whether the driver has taken effect.
- If no command output is displayed, the driver has not taken effect, and you need to perform the operation again.
- If the command output about the IN300 driver is displayed, the driver has taken effect.
- Run the hifcadm version -i <devicename> command using the hifcadm tool to query the version of the driver that takes effect. <devicename> indicates the IN300 device name on the OS, for example, hifc0.