Skip to content

Docs: VirtIO-Win driver compatibility with MS SQL Server workloads#455

Open
jasnoyaeger wants to merge 1 commit into
mainfrom
docs/virtio-win-mssql-compatibility
Open

Docs: VirtIO-Win driver compatibility with MS SQL Server workloads#455
jasnoyaeger wants to merge 1 commit into
mainfrom
docs/virtio-win-mssql-compatibility

Conversation

@jasnoyaeger
Copy link
Copy Markdown
Member

Summary

  • New KB article: docs/knowledge-base/posts/virtio-win-mssql-compatibility.md
  • Documents the vioscsi/viostor SRB ID race condition in virtio-win v0.1.285 and v0.1.292 (commit 1bbc422) that surfaces as SQL Server read-retry log entries on heavily loaded Windows VMs, most acutely on Windows Server 2025
  • Recommends downgrade to v0.1.271 as the stable workaround, with a clean uninstall/reinstall procedure (including the 0x80070643 rollback workaround)
  • Cross-links existing KBs (loading-virtio-drivers-in-windows-recovery-console, database-best-practices) using slug-style absolute URLs so they survive file renames

Refines the original issue framing: upstream confirms these are read-retry messages with matching expected/actual values, not on-disk corruption — DBCC CHECKDB typically comes back clean. The article reflects this so customers aren't sent chasing a corruption hunt.

Closes #454

Test plan

  • mkdocs serve — confirm the article renders, admonitions display correctly, and there are no broken-link warnings
  • Visually verify the inter-KB links (/knowledge-base/loading-virtio-drivers-in-windows-recovery-console and /knowledge-base/database-best-practices) resolve in the served site
  • SME review (Rich Stark or virtio-win subject matter expert): confirm the trailing-revision heuristic for matching driver version to ISO version (.28500 → 0.1.285, .27100 → 0.1.271) holds in observed customer environments
  • SME review: confirm the Windows guest tools uninstall path (Apps & features → reboot → install v0.1.271 ISO) matches the procedure VergeOS support recommends
  • Frontmatter validation passes in CI

🤖 Generated with Claude Code

Documents the vioscsi/viostor SRB ID race condition in virtio-win
v0.1.285 and v0.1.292 (upstream issue #1453) that produces SQL Server
read-retry errors on heavily loaded Windows VMs, especially on Windows
Server 2025. Includes driver version verification, the recommended
v0.1.271 downgrade path, and the clean uninstall procedure.

Refs #454

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jasnoyaeger jasnoyaeger requested a review from rstark-verge May 22, 2026 14:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: VirtIO Windows Driver Version Compatibility with MS SQL

1 participant