> For the complete documentation index, see [llms.txt](https://asus-isg-aidc.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asus-isg-aidc.gitbook.io/guide/latest/portal/firmwareintroduction/updatehistory.md). # Firmware History | Developer | Last modified | | --------- | ------------- | | AIDC Team | 2026/05/04 | ## Feature Description The Update History page records the execution history of all firmware update tasks. Here you can view the status and execution progress of each task, as well as detailed update results for each device, facilitating tracking and troubleshooting. ![UpdateHistory](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/firmwareManagement/update-history.png) *** ## Page Structure The page is divided into two areas: * **Main content area (left)**: Displays task list, search, firmware type filters, date filters, and pagination controls * **Status filter sidebar (right)**: Filter by task status *** ## Top Toolbar ![HistoryToolbar](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/firmwareManagement/history-toolbar.png) | Component | Function | | ------------------ | ---------------------------------------------------------------------- | | Search field | Search by task name, description, firmware filename, or IAC tool name | | Type filter | Filter by firmware type: All / BIOS / BMC / NIC / NVMe | | Quick date filters | Switch between All / This Week / This Month / Last Three Months | | Custom date range | Use a date-range picker to define start and end dates | | Pagination control | Previous/Next page buttons, showing current range (e.g., 1 - 10 of 45) | *** ## Right Side Status Filter ![HistoryFilter](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/firmwareManagement/history-filter.png) Click right-side buttons to quickly filter tasks of specific status: | Status | Description | | ----------- | ---------------------------------------- | | All | Show all tasks | | In Progress | Tasks currently executing | | Failed | Failed tasks | | Completed | Successfully completed tasks | | Timeout | Tasks that exceeded execution time limit | > When selecting "All", tasks are displayed grouped by status; when selecting a specific status, only tasks of that status are shown. *** ## Task Cards (Collapsed State) Each task is presented in card format. Color bars on the left side of cards represent task status for quick identification. Cards are collapsed by default, showing the following summary information: | Field | Description | | ---------------------------- | --------------------------------------------------------- | | Firmware type tag | Distinguished by icon and color (BIOS / BMC / NIC / NVMe) | | Task name | Task name displayed in large font | | IAC tool name | Displayed if there's an associated tool | | Job ID | Task number | | Delete record button | Available when the task is not in progress | | Execution progress indicator | Shows completion status of three phases | ![DeleteTaskHistory](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/firmwareManagement/delete-task-history.png) ### Execution Progress Indicator The progress indicator presents overall task progress as three connected nodes: ``` ● ────────────────── ● ──────────── ● Ready to Start Updating Updated ``` Colors of each node represent the status of that phase: | Color | Description | | ------------------------ | -------------------------- | | Gray | Not yet started (Upcoming) | | Blue (animated blinking) | In progress (Active) | | Green | Completed (Done) | | Red | Failed | *** ## Task Cards (Expanded State) Click a task card to expand and view detailed information. ### Execution Information ![ExecutionInfo](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/firmwareManagement/executions-info.png) | Field | Description | | ---------------------- | ------------------------------------------------------------------------ | | Execution number & ID | Displays execution count badge (e.g., #1) and execution ID (if provided) | | Start time | Timestamp when task was initiated | | Completion time | Timestamp when task ended (displayed after completion) | | Duration | Total time spent | | Firmware file | Name of firmware file used | | Triggered by | User or system that initiated this task | | Device completion rate | Progress bar + percentage showing what proportion of devices completed | ### Target Devices Shows completion count summary as "X / Y completed" and execution results for each target device. Summary information for each device includes: | Field | Description | | ----------------- | ------------------------------------------------ | | Device status dot | Color represents device update result | | Device name | Hostname | | Status label | Completed / Failed / In Progress / Timeout, etc. | If step details have not been returned yet, the page shows a waiting placeholder until execution details become available. *** ## Device Execution Steps (Expand Device Card) Click a device row to further expand and view step-by-step execution records for that device. Each step displays: * **Step name**: Such as "MST Initialization Failed" * **Step result label**: | Label | Description | | -------- | ------------------------------------------ | | OK | Step executed successfully with no changes | | CHANGED | Step executed successfully with changes | | FAILED | Step execution failed | | FATAL | Critical error, task aborted | | SKIPPING | Currently skipping this step | | SKIPPED | This step has been skipped | *** ## Task Status Description | Status Label | Color | Description | | ------------ | ------ | ---------------------------------- | | Completed | Green | Task successfully completed | | In Progress | Blue | Task currently executing | | Failed | Red | Task execution failed | | Timeout | Orange | Task exceeded execution time limit | *** ## Pagination Description * Each page displays **10 tasks** by default * Pagination control bar shows current viewing range, e.g.: `1 - 10 of 45` * Click **Previous (‹)** or **Next (›)** buttons to switch pages * When on first page, previous page button is grayed out and not clickable; when on last page, next page button is similarly disabled *** ## Empty State Messages | Situation | Display Content | | ------------------------------ | ------------------------------------------------- | | Initial page loading | Clock icon + loading message | | No results after search/filter | Inbox icon + "No tasks matching criteria" message | *** ## Common Operation Tips 1. After creating a task, search for the task name or Job ID on this page to quickly find the corresponding record 2. If task status is "Failed", expand the task card and then expand individual devices to find failure causes through step records 3. Use in conjunction with Firmware Overview page: Overview shows overall summary, History provides detailed records for each item 4. Use right-side status filter + top type filter to quickly narrow down search scope 5. In-progress tasks cannot be deleted; deletion is only available after the task leaves the running state