If you want to install and configure the entire TripleO + Tuskar + Tuskar UI stack, you can use the devtest installation guide.
Otherwise, you can use the installation instructions for Tuskar UI below.
Installation prerequisites are:
You may find the Tuskar install guide helpful.
Tuskar UI is a Django app written in Python and has a few installation dependencies:
On a RHEL 6 system, you should install the following:
yum install git python-devel swig openssl-devel mysql-devel libxml2-devel libxslt-devel gcc gcc-c++
The above should work well for similar RPM-based distributions. For other distros or platforms, you will obviously need to convert as appropriate.
Then, you’ll want to use the easy_install utility to set up a few other tools:
easy_install pip
easy_install nose
Begin by cloning the Horizon and Tuskar UI repositories:
git clone git://github.com/openstack/horizon.git
git clone git://github.com/openstack/python-tuskarclient.git
git clone git://github.com/openstack/tuskar-ui.git
Go into horizon and install a virtual environment for your setup:
cd horizon
python tools/install_venv.py
Next, run run_tests.sh to have pip install Horizon dependencies:
./run_tests.sh
Set up your local_settings.py file:
cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py
Open up the copied local_settings.py file in your preferred text editor. You will want to customize several settings:
Install Tuskar UI with all dependencies in your virtual environment:
tools/with_venv.sh pip install -e ../python-tuskarclient/
tools/with_venv.sh pip install -e ../tuskar-ui/
And enable it in Horizon:
cp ../tuskar-ui/_50_tuskar.py.example openstack_dashboard/local/enabled/_50_tuskar.py
Then disable the other dashboards:
cp ../tuskar-ui/_10_admin.py.example openstack_dashboard/local/enabled/_10_admin.py
cp ../tuskar-ui/_20_project.py.example openstack_dashboard/local/enabled/_20_project.py
cp ../tuskar-ui/_30_identity.py.example openstack_dashboard/local/enabled/_30_identity.py
If everything has gone according to plan, you should be able to run:
tools/with_venv.sh ./manage.py runserver
and have the application start on port 8080. The Tuskar UI dashboard will be located at http://localhost:8080/infrastructure
If you wish to access it remotely (i.e., not just from localhost), you need to open port 8080 in iptables:
iptables -I INPUT -p tcp --dport 8080 -j ACCEPT
and launch the server with 0.0.0.0:8080 on the end:
tools/with_venv.sh ./manage.py runserver 0.0.0.0:8080