murano-docs/dashboard/doc/source/index.rst

Welcome to Tabula, the Keero Project Web UI!

Tabula is a project that provides Web UI to Keero Project.

This document describes Tabula for contributors of the project, and assumes that you are already familiar with Portas from an end-user perspective.

This documentation is generated by the Sphinx toolkit and lives in the source tree.

Installation Guide

Install

1. Check out sources to some directory (<home>/keero):

   user@work:~/$ git clone ssh://<user>@gerrit.mirantis.com:29418/keero/keero.git

2. Install virtualenv:

   user@work:~/$ cd keero/tabula && sudo python ./tools/install_venv.py

Configure

1. Copy configuration file from template:

   user@work:~/$ cp keero/tabula/tabula/local/local_settings.py.example keero/tabula/tabula/local/local_settings.py

2. Open configuration file for editing:

   user@work:~/$ cd keero/tabula/tabula/local/ && nano local_settings.py

3. Configure according to you environment:

   ...
   SECRET_KEY = 'some_random_value'
   ...
   OPENSTACK_HOST = "localhost"
   ...

Run

Run Tabula in virtualenv:

user@work:~/$ cd keero/tabula && sudo ./tools/with_venv.sh python manage.py runserver 0.0.0.0:8080