LookingGlass/doc/troubleshooting.rst

51 lines
1.6 KiB
ReStructuredText
Raw Normal View History

Troubleshooting
###############
There are many different issues that can arise when setting up Looking
Glass. Below is a list of known issues with potential solutions:
.. _when_launching_looking_glass_the_desktop_doesnt_appear:
2022-09-18 23:57:49 +00:00
When launching Looking Glass the desktop doesn't appear
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- **Using an AMD GPU?**
2021-07-05 16:19:10 +00:00
- After the end of the Radeon HD Series, new AMD GPUs go to sleep when no
display is connected. For this reason, one of two conditions must be met.
#. The GPU needs to remain plugged into a monitor (this is good for
testing & troubleshooting).
2021-07-05 16:19:10 +00:00
#. The GPU needs to have a dummy plug installed which presents itself as a
monitor.
.. _the_clipboard_is_not_working:
2022-09-18 23:57:49 +00:00
The clipboard is not working
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2021-07-05 16:19:10 +00:00
- **Is clipboard synchronization enabled?**
2022-09-19 00:38:03 +00:00
- Before you can copy or paste content between the guest and host,
2021-07-05 16:19:10 +00:00
:ref:`clipboard
synchronization <libvirt_clipboard_synchronization>`
2021-07-05 16:19:10 +00:00
must be enabled.
- **Did you install the Spice Guest Tools?**
2021-07-05 16:19:10 +00:00
- The `SPICE Guest Tools
driver <https://www.spice-space.org/download.html>`_ must be installed
on the host OS to synchronize the clipboard.
The download is labeled "spice-guest-tools".
.. warning::
2021-07-05 16:19:10 +00:00
Do **NOT** install the QEMU Guest Tools driver.
These are not the same.
2021-07-05 16:19:10 +00:00
- **Is it installed twice?**
- The Spice VDAgent is available in both Spice Guest Tools, and
standalone as a separate installer. Check your installed programs
and uninstall the VDAgent if it's installed separately.