889229d732
Detailed the differences between the varying console types available. Also censored live IP with internal address and linked to a security guide page for further information on VNC/SPICE connections, which will be updated with more information. Closes-Bug: 1364877 Change-Id: I5590a76d89b9d08ffb2bf690fda3b3f80df63ee7
48 lines
2.8 KiB
XML
48 lines
2.8 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="instance_console">
|
|
<title>Access an instance through a console</title>
|
|
<para>In order to see the console output of an instance, regardless
|
|
of whether or not the console log has output, either VNC or SPICE
|
|
is used. This allows for relaying keyboard and mouse activity to
|
|
and from the instance in question.</para>
|
|
<para>There are three common remote console access methods in use
|
|
with OpenStack:</para>
|
|
<variablelist>
|
|
<varlistentry><term>novnc</term>
|
|
<listitem><para>An in-browser VNC client implemented
|
|
using HTML5 Canvas and WebSockets</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>spice</term>
|
|
<listitem><para>A complete in-browser client solution for
|
|
interaction with virtualized instances</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>xvpvnc</term>
|
|
<listitem><para>A Java client offering console access to
|
|
an instance</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para>Example:</para>
|
|
<para>To access an instance through a remote console, run the
|
|
following command:</para> <screen><prompt>$</prompt> <userinput>nova <command>get-vnc-console</command> <replaceable>INSTANCE_NAME</replaceable> <replaceable>VNC_TYPE</replaceable></userinput></screen>
|
|
<para>The command returns a URL from which you can access your instance:</para>
|
|
<screen><computeroutput>+--------+------------------------------------------------------------------------------+
|
|
| Type | Url |
|
|
+--------+------------------------------------------------------------------------------+
|
|
| xvpvnc | http://192.168.5.96:6081/console?token=c83ae3a3-15c4-4890-8d45-aefb494a8d6c |
|
|
+--------+------------------------------------------------------------------------------+</computeroutput></screen>
|
|
<para><replaceable>VNC_TYPE</replaceable> can be replaced by any of
|
|
the above values as connection types.</para>
|
|
<para>When using SPICE to view the console of an instance,
|
|
a browser plugin can be used directly on the instance page,
|
|
or the <command>get-vnc-console</command> command can be
|
|
used with it, as well, by returning a token-authenticated
|
|
address such as the one above.</para>
|
|
<para>For further information and comparisons (including security
|
|
considerations, please see the
|
|
<link xlink:href="http://docs.openstack.org/security-guide/content/ch026_compute.html">security guide</link>.</para>
|
|
</section>
|