diff --git a/doc/source/installation/accessing_gui.rst b/doc/source/installation/accessing_gui.rst new file mode 100644 index 000000000..d9b2670a7 --- /dev/null +++ b/doc/source/installation/accessing_gui.rst @@ -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@ + +#. 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://: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``. diff --git a/doc/source/installation/installation.rst b/doc/source/installation/installation.rst index 9df28317c..1a9b18601 100644 --- a/doc/source/installation/installation.rst +++ b/doc/source/installation/installation.rst @@ -8,3 +8,4 @@ update components after installation. Installing the Undercloud Updating Undercloud Components + Accessing the GUI