1
0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-01-10 14:59:42 -05:00
qubes-doc/user/troubleshooting/vm-troubleshooting.rst
Marek Marczykowski-Górecki b93b3c571e
Convert to RST
2024-05-21 20:59:46 +02:00

135 lines
4.0 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

====================
Qube troubleshooting
====================
VM Kernel troubleshooting
-------------------------
This troubleshoot applies to the non-default kernel choice described in
the :ref:`Managing VM docs <user/advanced-topics/managing-vm-kernels:using kernel installed in the vm>`.
In case of problems, you can access the VM console using
``qvm-console-dispvm VMNAME`` in dom0, then access the GRUB menu. You
need to call it just after starting the VM (until ``GRUB_TIMEOUT``
expires); for example, in a separate dom0 terminal window.
In any case you can later access the VMs logs (especially the VM
console log ``/var/log/xen/console/guest-VMNAME.log``).
You can always set the kernel back to some dom0-provided value to fix a
VM kernel installation.
Qubes starts, but no VMs load
-----------------------------
First, try to start a particular VM, check any failure message and
direct further steps based on that.
This issue has been seen to occur if a dom0 update is interrupted
halfway through and/or a hard power off is done without shutting down
Qubes, which results in files getting corrupted.
Can not uninstall a VM / "ERROR: VM installed by package manager: template-vm-name"
-----------------------------------------------------------------------------------
All of the following commands should be executed in a dom0 terminal.
When a template is marked as installed by package manager, but cannot
be uninstalled there, trying to uninstall manually will result in the
error “ERROR: VM installed by package manager: template-vm-name”. Do as
follows to be able to uninstall the template:
1. Check the state of ``installed_by_rpm``
.. code:: bash
$ qvm-prefs template-vm-name
2. If ``installed_by_rpm - True``, mark the template as not installed by
package manager
.. code:: bash
$ qvm-prefs template-vm-name installed_by_rpm false
3. Re-check the state of ``installed_by_rpm``
- If ``installed_by_rpm - False``, remove the template like you would a
regular qube:
.. code:: bash
$ qvm-remove template-vm-name
- If ``installed_by_rpm`` remains ``True``, reboot your computer to
bring qubes.xml in sync with qubesd, and try again to remove the
template.
Fixing package installation errors
----------------------------------
By default, templates in 4.0 only have a loopback interface.
Some packages will throw an error on installation in this situation. For
example, Samba expects to be configured using a network interface post
installation.
One solution is to add a dummy interface to allow the package to install
correctly:
.. code:: bash
ip link add d0 type dummy
ip addr add 192.168.0.1/24 dev d0
ip link set d0 up
"Cannot connect to qrexec agent" error
--------------------------------------
If you face this error when starting a VM, look into the VM logs at
``/var/log/xen/console/guest-VMNAME.log``. Common reasons that may be
revealed are: too low memory, corrupted files or a VM crash on startup.
If the error occurs as a result of too little initial memory, increase
the initial memory from 200MB to 400MB by navigating to VM settings »
Advanced » Initial memory.
"No match found" when trying to install a template
--------------------------------------------------
For example:
.. code:: bash
[user@dom0 ~]$ sudo qubes-dom0-update --enablerepo=qubes-templates-itl qubes-template-debian-10
Using sys-whonix as UpdateVM to download updates for Dom0; this may take some time...
No Match for argument qubes-template-debian-10
Nothing to download
This normally means you already have the template installed. It may be
that you have the matching package installed, but you removed or renamed
the template. Check ``rpm -q qubes-template-<name>``. If it lists the
package, but you dont really have the template present (``qvm-ls``
doesnt list it), you need to clean up leftovers of the package with
``rpm -e --noscripts qubes-template-<name>``, then install it normally.