功能教程：RAID/HBA 固件升级

固件（Firmware）是硬件设备的灵魂，定期更新固件可以修复已知问题、提升性能和增强兼容性。HrnrOS 提供了针对主流 RAID 和 HBA 控制器的远程固件升级功能，让您无需进入复杂的 UEFI/BIOS 界面即可完成升级操作。

警告： 固件升级是一项高风险操作，过程中如果发生意外（如断电），可能导致硬件永久性损坏。请在操作前确保您已备份所有重要数据，并了解所用固件的全部信息。

固件升级功能概览

• 主流厂商支持： 支持对业界广泛使用的 LSI/Broadcom 系列 RAID 卡和 HBA 卡进行固件升级。
• 智能设备检测： 能够自动检测客户端上已安装的受支持的控制器型号及其当前的固件版本。
• 文件上传与管理： 通过 Web 界面直接上传固件包，系统在后端进行管理。
• 实时进度监控： 升级过程中，通过 WebSocket 实时反馈详细的升级日志和进度百分比。
• 状态持久化： 即使刷新页面，正在进行的或已完成的升级状态也会被保留和恢复。

步骤 1: 准备固件包 (关键步骤)

为了让系统能够正确执行升级，您必须严格遵守文件命名和打包约定：

1. 获取固件： 从服务器或 RAID 卡制造商的官方网站下载适用于您设备型号的固件文件。
2. 命名压缩包：
   • 创建一个 .zip 格式的压缩包。
   • 压缩包的文件名必须遵循格式：设备型号_目标版本号.zip。
   • 示例： RAID-LSI-9361-8i_24.21.0-0076.zip 或 HBA-LSI-3008IT_16.00.12.00.zip
3. 打包内容：
   • 将该型号所需的所有固件相关文件（如 .bin, .rom 文件）直接放入 .zip 包的根目录，不要包含任何子文件夹。

步骤 2: 检测客户端上的设备

1. 进入页面： 在 Web 界面左侧导航栏，点击 “固件更新”。
2. 定位客户端： 在客户端列表中找到您希望升级的在线客户端。
3. 开始检测： 点击该行“操作”列下的 “ 检测设备” 按钮。

按钮会变为 “隐藏设备”，同时下方会展开一个区域，显示检测到的 RAID/HBA 卡设备信息。

步骤 3: 上传固件并开始升级

1. 上传固件包： 在检测到的设备卡片中，点击 “上传固件包” 区域的 选择文件 按钮，选择您在步骤 1 中准备好的、命名规范的 .zip 文件。
2. 开始升级： 点击 “ 开始升级” 按钮。
3. 确认操作： 系统会弹出确认框，再次提醒您操作风险。确认后，升级流程正式开始。

步骤 4: 监控升级进度

升级开始后，设备卡片下方会自动显示进度条和实时日志窗口。

• 进度条： 直观地显示当前升级的完成百分比。
• 实时日志： 滚动显示后端升级工具输出的详细信息，包括每一步的操作、成功或失败的提示。

(/assets/images/fw_upgrade_tutorial_progress.png)

当进度条达到 100% 并显示 “成功” 时，固件升级即告完成。部分固件升级可能需要您手动重启服务器才能完全生效，请密切关注日志中的提示信息。