[doc] Import from wiki

Imported Installation, FAQ, Troubleshooting, OBS, and Technical FAQ pages
from wiki. Edits done to content as this is no longer a wiki, but versioned
in-repo documentation

doc/troubleshooting.rst

@@ -0,0 +1,92 @@
+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:
+
+When Launching Looking Glass the Desktop Doesn't Appear
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+-  **Using an AMD GPU?**
+
+   -  After the end of the Radeon HD Series AMD started incorporating a
+      feature into their GPU's that effectively puts the card to sleep
+      when no display is connected. For this reason one of two
+      conditions need to be met.
+
+#. The GPU needs to remain plugged into a monitor (this is good for
+   testing & troubleshooting).
+#. The GPU needs to have a plug like the ones used in GPU Crypto mining
+   installed to trick the card into thinking that a display is
+   connected.
+
+.. _the_clipboard_is_not_working:
+
+The Clipboard is not Working
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+-  **Did you enable it?**
+
+   -  Before you can Copy/Paste content between the Guest and the Host
+      you must `Enable Clipboard
+      Synchronization <https://looking-glass.hostfission.com/wiki/FAQ#How_to_enable_clipboard_synchronization_via_SPICE>`_
+
+-  **Did you install the Spice Guest Tools?**
+
+   -  Before you can Copy/Paste content between the Guest and the Host
+      you must install the `SPICE Guest Tools
+      driver <https://www.spice-space.org/download.html>`_. The
+      download is labeled as "spice-guest-tools".
+
+      .. warning::
+
+         **NOTE: Do make sure that you do NOT install the QEMU Guest
+         Tools driver. These are not the same.**
+
+-  **Are you using Wayland?**
+
+   -  Clipboard functionality is not compatible with Wayland. If you are
+      using it you need to disable it for the clipboard to work.
+
+.. _followed_installation_instructions_but_looking_glass_still_doesnt_launch:
+
+Followed Installation Instructions but Looking Glass Still Doesn't Launch
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+At times depending on your distribution circumstances can cause Looking
+Glass to still not run. Below is a list of known issues that can prevent
+Looking Glass from running properly.
+
+AppArmor
+^^^^^^^^
+
+AppArmor is a security application that can prevent Looking Glass from
+running. How to add security exceptions may vary on your distribution:
+
+Debian(Ubuntu)
+''''''''''''''
+
+Start by opening the file ``/etc/apparmor.d/abstractions/libvirt-qemu``.
+Now locate and edit the following lines to represent how they appear in
+the example:
+
+.. code:: text
+
+   # for usb access
+      /dev/bus/usb/** rw,
+      /etc/udev/udev.conf r,
+      /sys/bus/ r,
+      /sys/class/ r,
+      /run/udev/data/* rw,
+      /dev/input/* rw,
+
+   # Looking Glass
+      /dev/shm/looking-glass rw,
+
+Save, exit, and restart AppArmor:
+
+.. code:: text
+
+   sudo systemctl restart apparmor