HighPoint SSD7180 User manual

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
1
HighPoint NVMe G5 Data RAID
Installation Guide (Linux)
V1.14– May 30th 2023
Copyright 2023 HighPoint Technologies, Inc.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
2
All rights reserved
Contents
Overview ............................................................................................................................... 3
Prerequisites for a Data-RAID Configuration .................................................................. 5
UEFI BIOS Settings ............................................................................................................. 6
Driver Installation................................................................................................................ 7
Installing the Open-Source Driver......................................................................................... 7
Updating the Driver ..............................................................................................................10
Uninstalling the Driver .........................................................................................................12
HighPoint RAID Management (WebGUI) Installation ..................................................13
Uninstalling the HighPoint RAID Management Software (WEBGUI & CLI) ............ 14
Troubleshooting ..................................................................................................................15
WebGUI ............................................................................................................................... 15
Controller and Drive Detection Issues ................................................................................. 21
Appendix ............................................................................................................................. 22
How to collect Log information in WEBGUI......................................................................22
How to collect Log information CLI ....................................................................................23

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
3
Overview
This guide includes important hardware/software requirements, installation & upgrade procedures, and
troubleshooting tips for using NVMe products with a Linux operating system.
The following is a list of supported NVMe products.
Supported Controller
SSD7540
SSD7505
SSD7502
SSD7140A
SSD7204
SSD7202
SSD7104
SSD7104F
SSD7101A-1
SSD7105
SSD7749M
SSD7749E
SSD7580B
SSD7580A
SSD7184
SSD7180
SSD7120
Supported Enclosure
SSD6540
SSD6540M
SSD6444
SSD6780A
Prerequisites
This section describes the base hardware and software requirements for the NVMe products.
UEFI BIOS settings
This section describes how to configure your motherboard UEFI settings for use with NVMe products.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
4
Driver Installation
This section covers driver installation, driver upgrade and driver uninstallation procedures for NVMe
products. in a Linux environment.
Management Software Installation
This section explains how to download and install the HighPoint RAID Management Software Suite for Linux
distributions. The download includes both the Web RAID Management Interface (WebGUI), and the CLI
(Command Line Interface).
Troubleshooting
Please consult this section if you encounter any difficulties installing or using NVMe products. It includes
solutions and description for commonly reported technical issues.
Appendix
This section describes how to collect troubleshooting information for support cases you have submitted via
our Online Support Portal.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
5
Prerequisites for a Data-RAID Configuration
In order to configure a non-bootable NVMe RAID array, you will need the following:
1. An NVMe SSD must be installed. At least one NVMe SSD must be installed into or connected to the
NVMe products.
2. A PCIe 5.0 or PCIe 4.0 slot or PCIe3.0 with x8 or x16 lanes. The NVMe products must be installed
into a PCIe 5.0 or PCIe 4.0 slot or PCIe3.0 with x8 or x16 lanes.
3. Your motherboard must have a UEFI BIOS with option ROM settings for third-part devices (such as
the NVMe products, optical drives and USB flash drives). If this is not configured correctly, the system wi
ll fail to load the NVMe products. Please check the NVMe products’s compatibility lists for recommended
motherboards.
4. Secure Boot must be disabled. HighPoint Linux Driver capability has not been signed and certified. If
Secure Boot is enabled, the motherboard will not recognize the NVMe products, and you will be unable to
proceed with installation.
5. Make sure any non-HighPoint drivers are uninstalled for any SSD’s hosted by the NVMe products.
Drivers provided by 3rd party software and manufacturer may prevent the NVMe products from
functioning properly.
Warnings:
1) Failing to remove the NVMe products and SSDs when uninstalling the driver may result in data loss.
2) Always make sure the HighPoint Linux driver is installed before moving NVMe products & RAID
array to another Linux system.
Linux distributions will always load the default NVMe support after the HighPoint Linux driver has been
uninstalled, or if it detects the present of a card when no driver has been loaded – this driver will only
recognize the NVMe SSDs as separate disks.
If the SSDs are recognized separately, any data they contain may be lost – including RAID configuration
data.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
6
UEFI BIOS Settings
The following is a list of supported UEFI NVMe products.
Supported Controller
SSD7105
SSD7202
SSD7502
SSD7505
SSD7540
SSD7580A
SSD7580B
SSD7749M
SSD7749E
Supported Enclosure
SSD6780A
Note: Products that do not support UEFI can skip this section.
Different motherboards will provide different UEFI-related BIOS settings. Please consult your motherboard’s
user manual for more information. This section provides examples using a SuperMicro H12SSL-i
motherboard.
1. Boot the system and access the motherboard BIOS menu.
2. Under "Advanced->PCIe/PCI/PnP Configuration->, change “CPU Slot x PCI-E OPROM" to
"EFI". “x” represents the PCIE slot assignment. For this example, the SSD7505 is installed into
“CPU Slot 1”.
3. Set "Secure Boot" to "Disabled".

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
7
Driver Installation
Installing the Open-Source Driver
1. Power on the system and boot the Linux distribution.
2. Open a system terminal with root privileges, and verify that NVMe product is detected by using the
following command:
lspci -tvv
Example screenshot
Note: the picture is only for reference, please make the object as the standard.
Additionally, you can verify that the NVMe drives are detected by using the following command:
fdisk -l
Example screenshot
Note: the picture is only for reference, please make the object as the standard.
3. Download the appropriate driver from the Software Downloads web page.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
8
4. Using the system terminal with root privileges, browse to the directory where the driver download is
located, and enter the following commands to extract the Linux Open-source Driver software package:
tar zxvf HighPoint_NVMe_G5_Linux_Src_vx.x.xx_xx_xx_xx.tar.gz
Note: The driver revision shown in the screenshots may not correspond with current software releases.
Please make sure to download the latest driver updates from the product’s Software Updates page.
5. Install the open-source Driver using the following command.
sh hptnvme_g5_linux_src_vx.x.xx_xx_xx_xx.bin or
./hptnvme_g5_linux_src_vx.x.xx_xx_xx_xx.bin
6. After driver installation is complete, the system will prompt you to restart to make the driver take effect.
Manually restart the system.
7. After the distribution has rebooted, open the system terminal with root privileges and check the driver
status using the following command:
dmesg | grep hptnvme

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
9
The following screenshot shows driver v1.5.1.
Additionally, you can check the NVMe drive using the following command:
fdisk –l

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
10
Updating the Driver
As of May 2022, current open-source driver releases include our Auto-Compile feature – auto compile checks
the kernel version each time the system is booted to ensure compatibility. If a new kernel is detected, Auto
Compile will check our online database for required updates and automatically compile a new driver.
The latest open-source driver is available from the Software Downloads web pages. If you want to manually
update using this download, please follow the procedure below.
1. Prerequisites
a. Ensure that NVMe product is installed into the motherboard.
b. Open the system terminal with root privileges to check the current driver version by using the
following command: dmesg | grep hptnvme.
The screenshot below shows driver version v1.2.13 is installed:
2. Updating the driver
a. Open the directory where the latest driver version is located and open the system terminal with root
privileges. Execute the following commands to complete the installation. The illustrated driver
version is v1.5.1.
b. Extract the Linux Opensource Driver software package using the following command:
tar zxvf HighPoint_NVMe_G5_Linux_Src_vx.x.xx_xx_xx_xx.tar.gz
c. Make sure the system has an active internet connection. To manually install the latest Open-source
Driver, open the system terminal with root privileges and enter the following command:
./hptnvme_g5_linux_src_vx.x.xx_xx_xx_xx.bin

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
11
d. After the driver installation is complete, the system will prompt you to restart to allow the new driver
to take effect. Please manually restart the system.
Note: for more information about this procedure, please consult the readme file included with each
Openn-source download.
e. Once the distribution has rebooted, open the system terminal with root privileges and check the
current driver version using the following command.
dmesg | grep hptnvme.
The screenshot below shows driver v1.5.1 is installed:
f. Open the WebGUI to make sure it can connect to the NVMe product and recognize the NVMe
SSD’s/RAID array.
g. As shown below, the new driver has been successfully installed and loaded at bootup – the WebGUI
can connect to the NVMe product and recognize the SSD’s and RAID array.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
12
Uninstalling the Driver
1. Prerequisites
a. Power off the system and remove the NVMe product from the motherboard.
Note: failing to remove the NVMe product and SSDs when uninstalling the driver may result in
data loss. The Linux distribution will load the default NVMe support after the HighPoint Linux driver
has been uninstalled – this driver will only recognize the NVMe SSD’s as separate disks.
2. To uninstall the driver:
b. Open the system terminal with root privileges. Enter the following commands to uninstall the driver:
hptuninhptnvme
c. Press ’Y’ to confirm.
d. After uninstalling the driver, manually reboot the system.
e. After the distribution has rebooted, open the system terminal with root privileges. And enter the
following command to check the driver status:
lsmod | grep hptnvme
f. If the system does not display information about “hptnvme”, the driver has been successfully
uninstalled.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
13
HighPoint RAID Management (WebGUI) Installation
The HighPoint RAID Management software is used to configure and monitor the SSDs hosted by the NVMe
product.
Download the HighPoint RAID Management software package from the HighPoint website.
1. Using the system terminal with root privileges, browse to the directory where the software download, and
enter the following commands to extract the management software package:
tar zxvf RAID_Manage_Linux_v3.x.x.x_x_x_x.tgz
Note: The driver revision shown in the screenshots may not correspond with current software releases.
Please make sure to download the latest driver updates from the product’s Software Updates page.
2. Install the HighPoint RAID management software (WebGUI & CLI) using the following command:
./ RAID_Manage_Linux_v2.x.x_x_x_x.bin
3. After the software is installed, open the WebGUI to make sure it can connect to the NVMe product.
4. You can also check the NVMe product using the CLI (command line interface). Using the system
terminal, enter the following command:
hptraidconf
For more information about the CLI, please download the guide: Link.
5. If the WebGUI/CLI can connect to the NVMe product and recognized the NVMe SSD’s, the driver has
been installed and is functioning normally.
Example screenshot

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
14
Uninstalling the HighPoint RAID Management Software
(WEBGUI & CLI)
Open the system terminal with root privileges. Enter the following commands to uninstall the driver:
dpkg -r hptsvr (or rpm -e hptsvr-https)
Enter the following command to check if the WebGUI has been removed successfully:
hptraidconf
after uninstall:

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
15
Troubleshooting
WebGUI
1. The WebGUI fails to install
If you use an Ubuntu system, the system may prompt you about the lack of a readline5 package when
installing the WebGUI – this will interrupt the installation process.
Solution:
a. With root permissions enabled, you can use the following command to load readline5 at using a
terminal, and will be allowed to install the WebGUI:
apt-get install libreadline5
b. Once complete, restart the WebGUI installation procedure.
2. The WebGUI cannot connect to the NVMe product
If you are unable to access the NVMe product using the WebGUI:
a. WebGUI service did not start successfully.
Solution：
Start the WebGUI by opening the system terminal with root privileges and entering the following
command: hptsvr
b. The driver cannot be compiled.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
16
Solution：
01. Make sure at least one NVMe SSD’s has been installed into the NVMe product.
02. Make sure motherboard can recognize the NVMe product and display NVMe information during
the BIOS post.
03. If you use a CentOS system, open the system terminal with root privileges and enter the
following command to install “elfutils-libelf-devel”:
yum install elfutils-libelf-devel
Once complete, install the HighPoint NVMe Linux driver once more.
04. If you use an Ubuntu/Debian system, open the system terminal with root privileges and enter the
following command to install “libelf-dev”:
yum install libelf-dev
Once complete, install the HighPoint NVMe Linux driver once more.
3. Fail to compile gcc, make and other driver files.
For Ubuntu
When installing the driver, due to various factors, driver files such as gcc and make cannot be compiled,
thus interrupting the driver installation process:
This problem can be caused by：
a. The system is not connected to a network (internet connection)
Solution：
Double check the system’s internet connection
Once confirmed, reinstall the driver.
b. System process is occupied/busy
Solution：
Open the system terminal with root privileges and enter the following command:
apt-get update
This will prompt the system to release the process and update the download source. Install the driver
again after the system process has been released.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
17
For Redhat
When installing the driver, due to various factors, driver files such as gcc and make cannot be compiled,
thus interrupting the driver installation process:
Or a prompt with ‘subscription-manager repos’:
Solution：
a. Go to the Red Hat website and register an account:
Register for | Red Hat IDP
b. Open the system terminal with root privileges.
Enter the following command to log in:
subscription-manager register --username=*** --password=*** --auto-attach
Reinstall the driver
For Debian
When installing the driver, due to various factors, driver files such as gcc and make cannot be compiled,
thus interrupting the driver installation process:
This problem can be caused by：The system is not connected to a network (internet connection)

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
18
Solution：
a. Double check the system’s internet connection
b. Once confirmed, reinstall the driver.
If the following occurs after the network connection and reinstall driver ：
This problem can be caused by a lack of dependency packages：
Solution：
a. To install using the CD-ROM: insert the CD-ROM back and press Enter
b. Use USB startup disk to install:
01. The system needs to be resourced
For details, please refer to the official website file:
https://www.debian.org/doc/manuals/debian-faq/uptodate.en.html
Solution(Here is the process of changing the source of Debian 11.5)：
Open the system terminal with root privileges and enter the following command:
nano /etc/apt/sources.list
Replace the contents of the file with the following illustration
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye main contrib non-free
deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye main contrib non-free
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-updates main contrib non-free
deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-updates main contrib non-free
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-backports main contrib non-free
deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-backports main contrib non-free
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-security main contrib non-free
deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-security main contrib non-free
Note: You can replace https://mirrors.tuna.tsinghua.edu.cn/debian with the name of a faster
Debian mirror near you. See the mirror list at https://www.debian.org/mirror/list for more
information.

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
19
02. apt-get update
03. Reinstall the driver.
For Proxmox
When installing the driver, due to various factors, driver files such as gcc and make cannot be compiled,
thus interrupting the driver installation process:
This problem can be caused by：
a. The system is not connected to a network (internet connection)
Solution：
01. Double check the system’s internet connection
02. Once confirmed, reinstall the driver.
b. System process is occupied/busy
Solution：
Open the system terminal with root privileges and enter the following command:
apt-get update
This will prompt the system to release the process and update the download source. Install the driver
again after the system process has been released.
If you are using a completely new system, the following error occurs when installing the driver or

HighPoint NVMe G5 Data RAID Installation Guide (Linux)
20
apt-get update:
This problem can be caused by：
01. The system needs to be resourced
This article is a proxmox7.2 feeding.
The previous version of the source can refer to the official website:
https://pve.proxmox.com/wiki/Downloads#Update_a_running_Proxmox_Virtual_Environment_7.
x_to_latest_7.2
Open the system terminal with root privileges and enter the following command to delete the
source that comes with it
rm /etc/apt/sources.list.d/pve-enterprise.list
Add a domestic source:
echo 'deb http://mirrors.ustc.edu.cn/proxmox/debian/pve bullseye pve-no-
subscription' >> /etc/apt/sources.list.d/pve-no-subscription.list
Edit the source file: /etc/apt/sources.list
nano /etc/apt/sources.list
Replace the contents of the file with the following illustration
Note: You can replace https://mirrors.aliyun.com/debian with the name of a faster
Debian mirror near you. See the mirror list at https://www.debian.org/mirror/list for more
information.