diff options
Diffstat (limited to 'docs/02-getting-started/01-install-and-first-run.md')
| -rw-r--r-- | docs/02-getting-started/01-install-and-first-run.md | 18 |
1 files changed, 12 insertions, 6 deletions
diff --git a/docs/02-getting-started/01-install-and-first-run.md b/docs/02-getting-started/01-install-and-first-run.md index e0e71cb..f323dbb 100644 --- a/docs/02-getting-started/01-install-and-first-run.md +++ b/docs/02-getting-started/01-install-and-first-run.md @@ -100,8 +100,12 @@ Inside the guest (the reference guest has SSH and a guest agent configured): ```bash sudo apt update sudo apt install -y linux-headers-generic build-essential -# Install the stock NVIDIA driver matching the firmware/driver profile -sudo apt install -y nvidia-driver-570-open +# Install the stock NVIDIA driver matching the emulation profile. +# The validated combination is the stock 570.144 Linux runfile (same driver +# version as the emulation target). The distro 570.x package can install a +# different 570 build; if you use it, keep the version notes from the +# hardware/software matrix at hand. +sudo sh ./NVIDIA-Linux-x86_64-570.144.run sudo reboot ``` @@ -126,10 +130,12 @@ cd cuda-samples/Samples/1_Utilities/deviceQuery && make && ./deviceQuery ``` **Expectation today:** driver probe, `nvidia-smi`, device enumeration, and the -early CUDA start-up path work; full kernel execution is the active work item. -Read the honest status in +first CUDA calls (`cuInit`, device queries) work. `cuCtxCreate` still fails +with `999` because the emulated engine list is missing the async copy engine; +full kernel execution is not reached yet. Before drawing conclusions from a +CUDA failure, read the honest status in [`../04-implementation/01-known-knowns-and-unknowns.md`](../04-implementation/01-known-knowns-and-unknowns.md) -before drawing conclusions from a CUDA failure. +and the debugger's guide [`../../userspace/cuda/READ-ME-FIRST.md`](../../userspace/cuda/READ-ME-FIRST.md). ## 7. Day-to-day operations @@ -166,7 +172,7 @@ Developer debug knobs (module parameters) are documented in | No mdev type for your GPU | [hardware matrix](../06-portability/hardware-software-matrix.md) | | Guest sees wrong PCIe link speed/width | root-port attachment + config-space mirror (debugging doc) | | `nvidia.ko` probe fails in guest | guest dmesg + `lspci -vvv` + handoff "driver lifecycle" | -| `nvidia-smi` works, CUDA does not | expected today; see the known-knowns doc | +| `nvidia-smi` works, CUDA does not | expected today (`cuCtxCreate` = 999, engine-list gap); see [`../04-implementation/01-known-knowns-and-unknowns.md`](../04-implementation/01-known-knowns-and-unknowns.md) and [`../../userspace/cuda/READ-ME-FIRST.md`](../../userspace/cuda/READ-ME-FIRST.md) | | VM boot fails or the guest hangs | `scripts/stack_manager.sh cleanup-crash`, then reboot | ## 10. Uninstall |