openstack-manuals/doc/common/section_compute-configure-spice.xml
Gauvain Pocentek 2c6e20f2a4 VNC must be disabled to enable SPICE
The SPICE console is available only if the VNC console is disabled.
Provide this information in the config-reference.

Change-Id: I4b84bb4c9a29ee1702bc1643556cc0090c721791
2014-02-02 21:16:58 +01:00

26 lines
1.4 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="spice-console">
<title>SPICE console</title>
<para>OpenStack Compute supports VNC consoles to guests. The VNC
protocol is fairly limited, lacking support for multiple monitors,
bi-directional audio, reliable cut-and-paste, video streaming and
more. SPICE is a new protocol that aims to address the limitations
in VNC and provide good remote desktop support.</para>
<para>SPICE support in OpenStack Compute shares a similar
architecture to the VNC implementation. The OpenStack dashboard
uses a SPICE-HTML5 widget in its console tab that communicates to
the <systemitem class="service">nova-spicehtml5proxy</systemitem>
service by using SPICE-over-websockets. The <systemitem
class="service">nova-spicehtml5proxy</systemitem> service
communicates directly with the hypervisor process by using SPICE.</para>
<para>VNC must be explicitly disabled to get access to the SPICE console.
Set the <option>vnc_enabled</option> option to <literal>False</literal> in
the <literal>[DEFAULT]</literal> section to disable the VNC console.</para>
<para>The following table shows the options to configure SPICE as
the console for OpenStack Compute:</para>
<xi:include href="../common/tables/nova-spice.xml"/>
</section>