64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
77 lines
3.7 KiB
XML
77 lines
3.7 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="using-vnc-console">
|
|
<title>Using VNC Console</title>
|
|
<para>There are several methods to interact with the VNC console,
|
|
using a VNC client directly, a special java client, or through the
|
|
web browser. For information about configuring the console,
|
|
see <xref linkend="installing-openstack-dashboard"/>.
|
|
</para>
|
|
|
|
<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="getting-an-access-url">
|
|
<title>Get an access URL</title>
|
|
<para>Nova enables you to create access_urls through the
|
|
os-consoles extension. Support for accessing this URL is
|
|
provided by the nova client:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova get-vnc-console <replaceable>[server_id]</replaceable> <replaceable>[novnc|xvpvnc]</replaceable></userinput></screen>
|
|
<para>Specify '<literal>novnc</literal>' to get a URL suitable
|
|
for pasting into a web browser.</para>
|
|
<para>Specify '<literal>xvpvnc</literal>' for a URL suitable for
|
|
pasting into the Java client.</para>
|
|
<para>To request a web browser URL:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova get-vnc-console <replaceable>[server_id]</replaceable> novnc</userinput></screen>
|
|
</section>
|
|
|
|
<section xml:id="accessing-vnc-consoles-with-a-java-client">
|
|
<info>
|
|
<title>Access VNC consoles with a Java client</title>
|
|
</info>
|
|
<para>To enable support for the OpenStack Java VNC client in
|
|
compute, run the <literal>nova-xvpvncproxy</literal> service.</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><literal>xvpvncproxy_port</literal>=<replaceable>[port]</replaceable>
|
|
- port to bind (defaults to 6081)</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><literal>xvpvncproxy_host</literal>=<replaceable>[host]</replaceable>
|
|
- host to bind (defaults to 0.0.0.0)</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>As a client, you need a special Java client, which is a
|
|
slightly modified version of TightVNC that supports our token
|
|
auth:</para>
|
|
<screen><prompt>$</prompt> <userinput>git clone https://github.com/cloudbuilders/nova-xvpvncviewer</userinput>
|
|
<prompt>$</prompt> <userinput>cd nova-xvpvncviewer/viewer</userinput>
|
|
<prompt>$</prompt> <userinput>make</userinput></screen>
|
|
<para>To create a session, request an access URL by using
|
|
<command>python-novaclient</command>. Then, run the client
|
|
as follows.</para>
|
|
<para>To get an access URL:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova get-vnc-console <replaceable>[server_id]</replaceable> xvpvnc</userinput></screen>
|
|
<para>To run the client:</para>
|
|
<screen><prompt>$</prompt> <userinput>java -jar VncViewer.jar <replaceable>[access_url]</replaceable></userinput></screen>
|
|
</section>
|
|
|
|
<section xml:id="accessing-a-vnc-console-through-a-web-browser">
|
|
<info>
|
|
<title>Access a VNC console through a web browser</title>
|
|
</info>
|
|
<para>Retrieving an access_url for a web browser is similar to
|
|
the flow for the Java client.</para>
|
|
<para>To get the access URL, run the following command:</para>
|
|
|
|
<screen><prompt>$</prompt> <userinput>nova get-vnc-console <replaceable>[server_id]</replaceable> novnc</userinput></screen>
|
|
<para>Paste the URL into your web browser.</para>
|
|
|
|
<para>Additionally, you can use the OpenStack dashboard, known
|
|
as horizon, to access browser-based VNC consoles for
|
|
instances.</para>
|
|
</section>
|
|
</section>
|