d-bis/loc_az_hci
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c39465c2bdadf4e119b35453a6add452d79afcfa
loc_az_hci/docs/architecture/driver-matrix.md
defiQUG c39465c2bd
Some checks failed
Test / test (push) Has been cancelled
Details
Initial commit: loc_az_hci (smom-dbis-138 excluded via .gitignore) 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-08 09:04:46 -08:00

276 lines
8.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Driver Version Matrix
## Driver Compatibility and Version Information
This document provides a comprehensive driver version matrix for all hardware components in the Azure Stack HCI environment.
## Network Interface Cards
### Intel i350-T4 (4× 1GbE WAN)
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | Intel PROSet | 27.0 | Latest | [Intel Download Center](https://www.intel.com/content/www/us/en/download-center/home.html) |
| Linux | igb | 5.15+ (kernel) | Latest kernel | Kernel built-in |
| OpenWrt | igb | Included in OpenWrt | Latest OpenWrt build | OpenWrt packages |
**Installation:**
- Windows: Use Intel PROSet installer
- Linux: Kernel module (usually built-in)
- OpenWrt: Included in standard builds
### Intel i350-T8 (8× 1GbE LAN)
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | Intel PROSet | 27.0 | Latest | [Intel Download Center](https://www.intel.com/content/www/us/en/download-center/home.html) |
| Linux | igb | 5.15+ (kernel) | Latest kernel | Kernel built-in |
| OpenWrt | igb | Included in OpenWrt | Latest OpenWrt build | OpenWrt packages |
**Installation:**
- Windows: Use Intel PROSet installer
- Linux: Kernel module (usually built-in)
- OpenWrt: Included in standard builds
### Intel X550-T2 (2× 10GbE)
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | Intel PROSet | 27.0 | Latest | [Intel Download Center](https://www.intel.com/content/www/us/en/download-center/home.html) |
| Linux | ixgbe | 5.15+ (kernel) | Latest kernel | Kernel built-in |
| OpenWrt | ixgbe | Included in OpenWrt | Latest OpenWrt build | OpenWrt packages |
**Installation:**
- Windows: Use Intel PROSet installer
- Linux: Kernel module (usually built-in)
- OpenWrt: Included in standard builds
### Intel i225 Quad-Port (4× 2.5GbE)
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | Intel PROSet | 27.0 | Latest | [Intel Download Center](https://www.intel.com/content/www/us/en/download-center/home.html) |
| Linux | igc | 5.15+ (kernel) | Latest kernel | Kernel built-in |
| OpenWrt | igc | Included in OpenWrt | Latest OpenWrt build | OpenWrt packages |
**Installation:**
- Windows: Use Intel PROSet installer
- Linux: Kernel module (usually built-in)
- OpenWrt: Included in OpenWrt 22.03+ builds
## Storage HBAs
### LSI 9207-8e (SAS2308)
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | mpt3sas | 2.00.00.00 | Latest | [Broadcom Support](https://www.broadcom.com/support) |
| Linux | mpt3sas | 5.15+ (kernel) | Latest kernel | Kernel built-in |
| OpenWrt | mpt3sas | Included in OpenWrt | Latest OpenWrt build | OpenWrt packages |
**Firmware:**
- IT Mode Firmware: P20 (recommended)
- IR Mode Firmware: P20 (if RAID needed, not recommended for this setup)
**Installation:**
- Windows: Download from Broadcom support site
- Linux: Kernel module (usually built-in)
- OpenWrt: Included in standard builds
**Firmware Flash:**
- Use `sas2flash` or `sas3flash` utilities
- Ensure IT mode firmware is flashed before use
## Crypto Accelerator
### Intel QAT 8970
| Component | Driver | Minimum Version | Recommended Version | Source |
|-----------|--------|----------------|---------------------|--------|
| Windows | qatlib | 1.7.0 | Latest | [Intel QAT Downloads](https://www.intel.com/content/www/us/en/download-center/home.html) |
| Linux | qatlib | 1.7.0 | Latest | [Intel QAT Downloads](https://www.intel.com/content/www/us/en/download-center/home.html) |
**OpenSSL Engine:**
- OpenSSL QAT Engine: 0.6.0+ (bundled with qatlib)
- OpenSSL Version: 1.1.1+ or 3.0+
**Installation:**
- Windows: Use Intel QAT installer
- Linux: Build from source or use distribution packages
**Verification:**
```bash
# Linux
qat_service status
openssl speed -engine qat -elapsed -async_jobs 36 rsa2048
# Windows
qat_service.exe status
```
## Operating System Compatibility
### Windows Server Core
| Component | Windows Server 2019 | Windows Server 2022 | Notes |
|-----------|---------------------|---------------------|-------|
| Intel NICs | ✓ | ✓ | PROSet 27.0+ |
| LSI HBAs | ✓ | ✓ | mpt3sas 2.00.00.00+ |
| Intel QAT | ✓ | ✓ | qatlib 1.7.0+ |
### Proxmox VE
| Component | Proxmox VE 7.x | Proxmox VE 8.x | Notes |
|-----------|----------------|----------------|-------|
| Intel NICs | ✓ | ✓ | Kernel 5.15+ |
| LSI HBAs | ✓ | ✓ | Kernel 5.15+ |
| Intel QAT | ✓ | ✓ | Requires qatlib installation |
### Ubuntu LTS
| Component | Ubuntu 20.04 | Ubuntu 22.04 | Ubuntu 24.04 | Notes |
|-----------|--------------|--------------|--------------|-------|
| Intel NICs | ✓ | ✓ | ✓ | Kernel 5.15+ |
| LSI HBAs | ✓ | ✓ | ✓ | Kernel 5.15+ |
| Intel QAT | ✓ | ✓ | ✓ | Requires qatlib installation |
### OpenWrt
| Component | OpenWrt 21.02 | OpenWrt 22.03 | OpenWrt 23.05+ | Notes |
|-----------|--------------|---------------|---------------|-------|
| Intel NICs | ✓ | ✓ | ✓ | Included in builds |
| LSI HBAs | ✓ | ✓ | ✓ | Included in builds |
| Intel QAT | Limited | Limited | Limited | Requires custom build |
## Driver Installation Order
### Windows Server Core
1. **Base OS Installation**
- Install Windows Server Core
- Install Windows Updates
2. **Network Drivers**
- Install Intel PROSet for all NICs
- Verify all ports detected
3. **Storage Drivers**
- Install LSI mpt3sas driver
- Flash HBAs to IT mode
- Verify shelves detected
4. **Crypto Drivers**
- Install Intel QAT drivers (qatlib)
- Install OpenSSL QAT engine
- Verify QAT acceleration
### Linux/Proxmox VE
1. **Base OS Installation**
- Install Proxmox VE or Ubuntu
- Update kernel to latest
2. **Network Drivers**
- Verify kernel modules loaded (igb, ixgbe, igc)
- Configure network interfaces
3. **Storage Drivers**
- Verify mpt3sas module loaded
- Flash HBAs to IT mode (if needed)
- Verify shelves detected
4. **Crypto Drivers**
- Install qatlib from source or packages
- Configure OpenSSL QAT engine
- Verify QAT acceleration
### OpenWrt
1. **Base OS Installation**
- Install OpenWrt x86 build
- Update packages
2. **Network Drivers**
- Verify kernel modules loaded
- Configure network interfaces
3. **Storage Drivers**
- Verify mpt3sas module loaded
- Configure storage if needed
## Driver Verification Commands
### Windows
```powershell
# List all network adapters
Get-NetAdapter | Select-Object Name, InterfaceDescription, Status
# List all storage controllers
Get-StorageController | Select-Object FriendlyName, Status
# Check QAT status
qat_service.exe status
```
### Linux
```bash
# List network interfaces
ip link show
lspci | grep -i network
# List storage controllers
lspci | grep -i storage
lsblk
# Check QAT status
qat_service status
lsmod | grep qat
```
### OpenWrt
```bash
# List network interfaces
ip link show
uci show network
# List storage controllers
lspci | grep -i storage
lsblk
```
## Troubleshooting
### Network Driver Issues
**Problem:** NIC not detected
- **Solution:** Verify PCIe slot connection, check BIOS settings, update driver
**Problem:** Slow performance
- **Solution:** Verify driver version, check for firmware updates, verify PCIe lane allocation
### Storage Driver Issues
**Problem:** HBA not detected
- **Solution:** Verify PCIe slot connection, check BIOS settings, verify IT mode firmware
**Problem:** Shelves not detected
- **Solution:** Verify cable connections, check HBA firmware, verify shelf power
### QAT Driver Issues
**Problem:** QAT not detected
- **Solution:** Verify PCIe slot connection, check BIOS settings, verify driver installation
**Problem:** QAT acceleration not working
- **Solution:** Verify OpenSSL engine configuration, check QAT service status, verify application configuration
## Related Documentation
- [Hardware BOM](hardware-bom.md) - Complete bill of materials
- [PCIe Allocation](pcie-allocation.md) - Slot allocation map
- [Bring-Up Checklist](bring-up-checklist.md) - Installation guide
Reference in New Issue View Git Blame Copy Permalink