Add MANA driver-presence test suite and runbook (ICM 809802825)

[vtahiliani]

Summary

Adds a dedicated MANA (Microsoft Azure Network Adapter) test suite (area="mana") plus a runbook, to close the coverage gap identified for ICM 809802825.

In that incident, an AzureLinux 3.0 kernel-mshv build shipped without CONFIG_MICROSOFT_MANA. When the platform attached a MANA VF (1414:00ba), no driver bound it, the VF sat orphaned on the PCI bus, and the VM silently fell back to synthetic hv_netvsc networking — while platform monitoring still reported the VM healthy (AccelNet effectively unavailable).

Changes

• lisa/microsoft/testsuites/network/mana.py — new Mana suite:
  • verify_mana_driver_present (Linux): when a MANA VF is present, asserts CONFIG_MICROSOFT_MANA is enabled, the mana module is loaded, and the VF is paired with a synthetic NIC.
  • verify_mana_driver_present_windows (Windows): asserts the MANA VF PnP device (VEN_1414&DEV_00BA) is present and reports Status = OK (driver bound, not orphaned).
  • Both self-skip on VMs where the platform does not expose a MANA VF.
• lisa/microsoft/runbook/mana.yml — selects area:mana and defaults to a MANA-capable VM size (Standard_D8s_v6).

How to run

lisa -r ./lisa/microsoft/runbook/mana.yml -v subscription_id:<sub> -v admin_private_key_file:<key> -v "marketplace_image:microsoftcblmariner azure-linux-3 azure-linux-3-gen2 latest"

Validation

• flake8 / black / isort: pass
• Suite registers with both cases; runbook YAML parses

Test suggestion

Key Test Cases: verify_mana_driver_present|verify_mana_driver_present_windows
Impacted LISA Features: Sriov, NetworkInterface
Tested Azure Marketplace Images:

• microsoftcblmariner azure-linux-3 azure-linux-3-gen2 latest
• microsoftcblmariner azure-linux-3 azure-linux-3 latest

Related: ICM 809802825

[Copilot]

Pull request overview

Adds a dedicated LISA test suite and runbook to detect regressions where a MANA VF is exposed but the guest lacks a bound MANA driver (leading to silent fallback to synthetic networking), addressing the gap described in ICM 809802825.

Changes:

• Introduces a new mana test suite with Linux and Windows cases to verify MANA VF presence and driver binding.
• Adds a mana.yml runbook selecting area: mana and a MANA-capable default VM size for validation runs.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
lisa/microsoft/testsuites/network/mana.py	New MANA driver-presence test suite for Linux/Windows.
lisa/microsoft/runbook/mana.yml	New runbook to execute the mana area on Azure with a default MANA-capable SKU.

Suppressed comments (1)

lisa/microsoft/testsuites/network/mana.py:130

• The Windows case sets fail_on_error=False for the Get-PnpDevice query. If the cmdlet fails (missing module, transient PS error, etc.), run_cmdlet can return empty output and the test will incorrectly self-skip as if no MANA VF is present. Let the cmdlet failure surface as a real test failure and only skip when the query succeeds but returns no matching devices.

        devices = powershell.run_cmdlet(
            "Get-PnpDevice -PresentOnly | "
            "Where-Object { $_.InstanceId -match 'VEN_1414&DEV_00BA' } | "
            "Select-Object Status, Class, FriendlyName, InstanceId",
            output_json=True,
            fail_on_error=False,
        )

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[LiliDeng]

Please avoid including internal ICM IDs here since this is a public code repository.

[LiliDeng]

no need this file

[LiliDeng]

vtahiliani Since we already collect whether the MANA driver is enabled in the information, we can leverage that information for this validation.

If we add this as a standalone test case, many existing/older images without the MANA driver enabled would fail, even though that is expected for those images. It may be better to use the existing information to determine whether the validation is applicable, rather than making the case fail for images that don't support MANA.

Johnson (@johnsongeorge-w) FYI.