Skip to content

Commit 9715cd6

Browse files
committed
docs: update PCI unhide instructions with reboot instructions
Signed-off-by: Bryan Vaz <[email protected]>
1 parent 3218c5d commit 9715cd6

File tree

1 file changed

+18
-2
lines changed

1 file changed

+18
-2
lines changed

docs/compute.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -148,8 +148,24 @@ other-config (MRW): base_template_name: Other install media; import_task: Opaque
148148
149149
You can now attach the device to another VM or add it back to the `dom0` control domain.
150150

151-
### 6. Reattach PCI device to control domain
152-
Run `/opt/xensource/libexec/xen-cmdline --delete-dom0 xen-pciback.hide`
151+
### 6. Reattach PCI device to control domain (if desired)
152+
Run `/opt/xensource/libexec/xen-cmdline --delete-dom0 xen-pciback.hide`.
153+
154+
_Note: this command removes all PCI devices hidden from the control domain (`dom0`). If you have multiple devices, you can either: (a) add them back if they are inadvertently removed; or (b) use the previous `--set-dom0` command, to update the list of hidden PCI devices, excluding the device address that you want to add back to the control domain._
155+
156+
:::tip
157+
You can use `cat /boot/efi/EFI/xenserver/grub.cfg` see a list of devices currently hidden under during a normal boot (`menuentry 'XCP-ng'`). The grub location will vary depending on how you setup your bootloader._
158+
:::
159+
160+
:::tip
161+
This is a kernel parameter, and thus is not retained when you upgrade an XCP-ng host [using the installation ISO](upgrade.md#upgrade-via-installation-iso-recommended). Remember to re-do this step after the upgrade, if you still have some PCI devices you want to hide from the control domain.
162+
:::
163+
164+
### 7. Reboot the XCP-ng host
165+
166+
`[root@xen ~]# reboot`.
167+
_Note: Reboot is only necessary if you changed the kernel parameters, i.e. by adding or hiding devices from the control domain._
168+
153169

154170
## GPU Passthrough
155171
To passthrough a complete graphics card to a VM (not virtualize it into multiple virtual vGPUs, which is different, see the vGPU section below), just follow the regular PCI passthrough instructions, no special steps are needed. Most Nvidia and AMD video cards should work without issue.

0 commit comments

Comments
 (0)