Add configuring direct console access via the OpenStack GUI to User Guide

The intent of this commit is to add instructions on how to configure
and use direct console access via the OpenStack GUI to the JOID User Guide.

JIRA: JOID-53

Change-Id: I2092e0f9213b6f152d67c5d51579641e243b442d
Signed-off-by: Dave Urschatz <dave.urschatz@cengn.ca>
(cherry picked from commit 2731ed245ee66fcebae651368fab411c3609d7bd)

diff --git a/docs/userguide/userguide.rst b/docs/userguide/userguide.rst
index 41a1155..ce94981 100644 (file)
--- a/docs/userguide/userguide.rst
+++ b/docs/userguide/userguide.rst
@@ -669,6 +669,17 @@ The following are the common issues we have collected from the community:
       use the command juju status --format=tabular and make sure all service containers receive an IP address and they are executing code. Ensure there is no service in the error state.
 - In case the cleanup process hangs,remove the files from the ~/.juju/ directory except environments.yaml and shutdown all nodes manually.
 
+**Direct console access** via the OpenStack GUI can be quite helpful if you need to login to a VM but cannot get to it over the network.
+It can be enabled by setting the ``console-access-protocol`` in the ``nova-cloud-controller`` to ``vnc``.  One option is to directly edit the juju-deployer bundle and set it there prior to deploying OpenStack.
+
+::
+
+      nova-cloud-controller:
+      options:
+        console-access-protocol: vnc
+
+To access the console, just click on the instance in the OpenStack GUI and select the Console tab.
+
 Post Installation Configuration
 ===============================
 Configuring OpenStack