openstack
/
instack-undercloud
Code Issues Proposed changes

Added docs describing how to access GUI 

Change-Id: I3d9b508045ef9f102b136a676cdc0f0b2fbe9330
This commit is contained in:
Jiri Tomasek 2015-06-03 16:32:21 +02:00
parent 81bba98b47
commit 02eed0ff74
2 changed files with 31 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/source/installation/accessing_gui.rst Normal file
View File

@ -0,0 +1,30 @@
Accessing the GUI
=================
Part of the Undercloud installation is also Tuskar-UI which you can use to drive
the deployment. It runs on the instack virtual machine on ``http://localhost/dashboard``
Example of how to access Tuskar-UI:
-----------------------------------
Considering that Tuskar-UI runs in a instack VM and virt host is a remote host
machine, to access the UI in the browser, follow these steps:
#. On host machine create ssh tunnel from instack vm to virt host::
ssh -g -L 8080:127.0.0.1:80 root@<undercloud_vm_ip>
#. On instack VM edit ``/etc/openstack-dashboard/local_settings`` and add virt host ``hostname`` to ``ALLOWED_HOSTS`` array
#. Restart Apache::
systemctl restart httpd
#. Allow port ``8080`` on host machine::
sudo iptables -A INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
#. Navigate to ``http://<virt_host_hostname>:8080/dashboard`` in the browser
When logging into the dashboard the default user and password are found in the ``/root/stackrc`` file on the instack virtual machine, ``OS_USERNAME`` and ``OS_PASSWORD``.

1
doc/source/installation/installation.rst
View File

@ -8,3 +8,4 @@ update components after installation.
Installing the Undercloud <installing>
Updating Undercloud Components <updating>
Accessing the GUI <accessing_gui>